NetCube-Systems-Austria/kumquat-buildroot
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs/manual: clarify the reinstallation of a package

Browse Source 
Since <package>-rebuild implies <package>-reinstall and
<package>-reconfigure implies <package>-rebuild, it is confusing
to mention the make and make <package> commands when describing
the restart of the configuration, compilation and installation of
the package.

Therefore remove the ", followed by +make+ or +make <package>+"
portions in the "8.3. Understanding how to rebuild packages" section,
and add a new paragraph clarifying how to include the rebuilt package
in the filesystem image, if that is necessary.

Signed-off-by: Vivien Didelot <vivien.didelot@gmail.com>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@bootlin.com>
(cherry picked from commit 9155d1a38d)
Signed-off-by: Peter Korsgaard <peter@korsgaard.com>
This commit is contained in:
Vivien Didelot 2019-10-16 15:54:44 -04:00 committed by Peter Korsgaard
parent 132bbb36c8
commit d92128efe2
1 changed files with 13 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
docs/manual/rebuilding-packages.txt
View File

@ -99,16 +99,20 @@ re-configure, re-compile and re-install this package from scratch. You
can ask buildroot to do this with the +make <package>-dirclean+ command. can ask buildroot to do this with the +make <package>-dirclean+ command.
On the other hand, if you only want to restart the build process of a On the other hand, if you only want to restart the build process of a
package from its compilation step, you can run +make package from its compilation step, you can run +make <package>-rebuild+. It
<package>-rebuild+, followed by +make+ or +make <package>+. It will will restart the compilation and installation of the package, but not from
restart the compilation and installation of the package, but not from scratch: it basically re-executes +make+ and +make install+ inside the package,
scratch: it basically re-executes +make+ and +make install+ so it will only rebuild files that changed.
inside the package, so it will only rebuild files that changed.
If you want to restart the build process of a package from its If you want to restart the build process of a package from its configuration
configuration step, you can run +make <package>-reconfigure+, followed step, you can run +make <package>-reconfigure+. It will restart the
by +make+ or +make <package>+. It will restart the configuration, configuration, compilation and installation of the package.
compilation and installation of the package.
While +<package>-rebuild+ implies +<package>-reinstall+ and
+<package>-reconfigure+ implies +<package>-rebuild+, these targets as well
as +<package>+ only act on the said package, and do not trigger re-creating
the root filesystem image. If re-creating the root filesystem in necessary,
one should in addition run +make+ or +make all+.
Internally, Buildroot creates so-called _stamp files_ to keep track of Internally, Buildroot creates so-called _stamp files_ to keep track of
which build steps have been completed for each package. They are which build steps have been completed for each package. They are