diff --git a/docs/manual/common-usage.txt b/docs/manual/common-usage.txt index 76e4023b95..96bc513f15 100644 --- a/docs/manual/common-usage.txt +++ b/docs/manual/common-usage.txt @@ -211,7 +211,7 @@ When the build of a system takes a long time, it is sometimes useful to be able to understand which packages are the longest to build, to see if anything can be done to speed up the build. In order to help such build time analysis, Buildroot collects the build time of each -step of each package, and allows to generate graphs from these data. +step of each package, and allows to generate graphs from this data. To generate the build time graph after a build, run: @@ -221,13 +221,13 @@ make graph-build This will generate a set of files in +output/graphs+ : -* +build.hist-build.pdf+, an histogram of the build time for each +* +build.hist-build.pdf+, a histogram of the build time for each package, ordered in the build order. -* +build.hist-duration.pdf+, an histogram of the build time for each +* +build.hist-duration.pdf+, a histogram of the build time for each package, ordered by duration (longest first) -* +build.hist-name.pdf+, an histogram of the build time for each +* +build.hist-name.pdf+, a histogram of the build time for each package, order by package name. * +build.pie-packages.pdf+, a pie chart of the build time per package diff --git a/docs/manual/rebuilding-packages.txt b/docs/manual/rebuilding-packages.txt index 26e244c5af..b2d10decc7 100644 --- a/docs/manual/rebuilding-packages.txt +++ b/docs/manual/rebuilding-packages.txt @@ -62,7 +62,7 @@ can help you understand how to work with Buildroot: * When a change to the root filesystem skeleton is made, a full rebuild is needed. However, when changes to the root filesystem - overlay, to a post-build script or a post-image script are made, + overlay, a post-build script or a post-image script are made, there is no need for a full rebuild: a simple +make+ invocation will take the changes into account. @@ -104,7 +104,7 @@ On the other hand, if you only want to restart the build process of a package from its compilation step, you can run +make -rebuild+, followed by +make+ or +make +. It will restart the compilation and installation of the package, but not from -scratch: it basically simply re-executes +make+ and +make install+ +scratch: it basically re-executes +make+ and +make install+ inside the package, so it will only rebuild files that changed. If you want to restart the build process of a package from its diff --git a/docs/manual/using-buildroot-development.txt b/docs/manual/using-buildroot-development.txt index 83c4a927f7..eaebeaf9fe 100644 --- a/docs/manual/using-buildroot-development.txt +++ b/docs/manual/using-buildroot-development.txt @@ -23,7 +23,7 @@ source code of one package, and be able to quickly rebuild the system with Buildroot. Making changes directly in +output/build/-+ is not -appropriate solution, because this directory is removed on +make +an appropriate solution, because this directory is removed on +make clean+. Therefore, Buildroot provides a specific mechanism for this use case: