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

Fernando Apesteguía <[email protected]>
Newsgroups gmane.os.freebsd.devel.cvs.doc
Message-ID <[email protected]>
The branch main has been updated by fernape:

URL: https://cgit.FreeBSD.org/doc/commit/?id=d7f4e2377f23909e8339567b6a09119630a49395

commit d7f4e2377f23909e8339567b6a09119630a49395
Author:     Fernando Apesteguía <[email protected]>
AuthorDate: 2023-08-26 17:00:12 +0000
Commit:     Fernando Apesteguía <[email protected]>
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: https://reviews.freebsd.org/D41624
---
 .../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].
 ====
 
 [TIP]
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.