git: a213882b9c41 - stable/14 - stale-symlink-buildworld.sh: improve documentation

From: Wolfram Schneider <wosch_at_FreeBSD.org>
Date: Mon, 16 Sep 2024 08:30:27 UTC
The branch stable/14 has been updated by wosch:

URL: https://cgit.FreeBSD.org/src/commit/?id=a213882b9c4141bb5635eea2ddc2b4f1190cf219

commit a213882b9c4141bb5635eea2ddc2b4f1190cf219
Author:     Wolfram Schneider <wosch@FreeBSD.org>
AuthorDate: 2024-09-09 14:55:29 +0000
Commit:     Wolfram Schneider <wosch@FreeBSD.org>
CommitDate: 2024-09-16 08:30:06 +0000

    stale-symlink-buildworld.sh: improve documentation
    
    (cherry picked from commit c77ca9a72c9934c407852f00d88cba09f5c9e31f)
---
 tools/build/stale-symlink-buildworld.sh | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/tools/build/stale-symlink-buildworld.sh b/tools/build/stale-symlink-buildworld.sh
index a4515db3fccb..ee918d1c9cd9 100755
--- a/tools/build/stale-symlink-buildworld.sh
+++ b/tools/build/stale-symlink-buildworld.sh
@@ -4,8 +4,17 @@
 #
 # stale-symlink-buildworld.sh - check for stale symlinks on a FreeBSD system
 #
-# You can run the script before or after `make installworld'
+# The purpose of this script is to detect stale symlinks, report them to
+# stderr and exit with a non-zero status. All other cases are ignored,
+# such as no symlinks, missing directories, permission problems, etc.
 #
+# You can run the script before or after `make installworld', or any other
+# make targets thats installs files.
+#
+# You can also check your local ports with:
+#    
+#   env STALE_SYMLINK_BUILDWORLD_DIRS=/usr/local ./stale-symlink-buildworld.sh
+
 
 PATH="/bin:/usr/bin"; export PATH