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

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

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

commit d7f4e2377f23909e8339567b6a09119630a49395
Author:     Fernando Apesteguía <fernape@FreeBSD.org>
AuthorDate: 2023-08-26 17:00:12 +0000
Commit:     Fernando Apesteguía <fernape@FreeBSD.org>
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]