git: d7f4e2377f - main - [phb]: Clarify pkg-plist items order

From: Fernando Apesteguía <>
Date: Tue, 29 Aug 2023 11:11:56 UTC
The branch main has been updated by fernape:


commit d7f4e2377f23909e8339567b6a09119630a49395
Author:     Fernando Apesteguía <>
AuthorDate: 2023-08-26 17:00:12 +0000
Commit:     Fernando Apesteguía <>
CommitDate: 2023-08-29 11:10:45 +0000

    [phb]: Clarify pkg-plist items order
    PR:             233697
    Reported by:    salvadore@
    Reviewed by:    carlavilla@, ceri@
    Differential Revision:
 .../content/en/books/porters-handbook/quick-porting/_index.adoc         | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/documentation/content/en/books/porters-handbook/quick-porting/_index.adoc b/documentation/content/en/books/porters-handbook/quick-porting/_index.adoc
index 32e42b0228..c6afb28497 100644
--- a/documentation/content/en/books/porters-handbook/quick-porting/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/quick-porting/_index.adoc
@@ -149,6 +149,8 @@ Refer to the man:pkg-create[8] manual page for details on the packing list.
 It is recommended to keep all the filenames in this file sorted alphabetically.
 It will make verifying changes when upgrading the port much easier.
+The sorting should be applied after variable expansion takes place.
+The framework does this correctly when the package list is crossref:plist[plist-autoplist,generated automatically].