Improve the phrasing that the default clean stage already calls world/image-clean, then order the macros alphabetically like in the section header as well as the order in which they are usually called.
Signed-off-by: Roland Hieber <[email protected]> --- doc/ref_make_macros.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/doc/ref_make_macros.rst b/doc/ref_make_macros.rst index fe300c45757a..a81d54961298 100644 --- a/doc/ref_make_macros.rst +++ b/doc/ref_make_macros.rst @@ -155,19 +155,15 @@ Usage: .. code-block:: none - @$(call world/image-clean, <PKG>) @$(call ptx/image-install, <PKG>, $(<PKG>_BUILD_DIR)/<source-image-name>[, <image-name>]) @$(call ptx/image-install-link, <PKG>, <link-target>, <link-name>) + @$(call world/image-clean, <PKG>) These macros are used to install files to ``|ptxdistPlatformDir|/images``. They are only allowed in the *targetinstall* stage. They are used by packages that produce files that are not part of a filesystem. Bootloaders are typical packages that do this. -``world/image-clean`` will remove the files that were created by the other -two macros in a previous run of the *targetinstall* stage. This also -happens implicitly when the package is cleaned. - ``ptx/image-install`` copies a file. The source must be an absolute path. The destination must be relative to the image directory. If the destination file name is the source file without the path, then this argument can be @@ -175,6 +171,10 @@ omitted. ``ptx/image-install-link`` creates a symlink in the image directory. +``world/image-clean`` will remove the files that were created by the other +two macros in a previous run of the *targetinstall* stage. This macro is also +called automatically by PTXdist's default *clean* stage. + .. _world_image_fit: world/image-fit -- 2.39.2
