cruxports/prt-utils/dllist.1.patch

60 lines
2.2 KiB
Diff

--- prt-utils-1.1.4/dllist.1 2020-10-15 05:16:54.000000000 -0400
+++ prt-utils-1.1.4d/dllist.1 2021-06-26 14:12:30.860942185 -0400
@@ -1,5 +1,5 @@
." Text automatically generated by txt2man-1.4.7
-.TH dllist "October 20, 2004" "" ""
+.TH dllist "June 25, 2021" "" ""
.SH NAME
\fBdllist \fP- Show sources to be downloaded for compiling a port
\fB
@@ -12,21 +12,29 @@
.fi
.SH DESCRIPTION
\fBdllist\fP displays a list of URLs that have to be downloaded for compiling
-the given \fBport\fP(s).
+the given \fBport\fP(s), using \fBprt-get\fP(8) to collect information on
+ports and installation status.
.PP
-The script can operate in two modes: list files needed for sepcified
-ports or list files needed to update the system.
+The script can operate in two modes: list files needed for specified
+ports, or list files needed to update the system.
.PP
-Only files from ports not already installed are considered,
+The list is restricted to packages not currently installed,
unless the --all option is specified.
.PP
-\fBdllist\fP uses \fBprt-get\fP(8) to collect information on ports
-and installation status.
+\fBdllist\fP filters the list based on the contents of $PKGMK_SOURCE_DIR,
+reporting only those source files that are not found in the expected download
+location on the filesystem. It is the user's responsibility to ensure that
+$PKGMK_SOURCE_DIR is consistent for all invocations of \fBpkgmk\fB; otherwise
+\fBdllist\fP might exaggerate the number of downloads needed. For a similar reason,
+moving or renaming downloaded source files using a mechanism other
+than the \(oqrenames\(cq array of \fBPkgfile\fB(5) will cause \fBdllist\fP
+to report them as needing a fresh download.
.SH OPTIONS
.TP
.B
--all
-also display URLs that
+read the source array of each dependency (even those already installed)
+and print the URLs that have no corresponding file in $PKGMK_SOURCE_DIR
.TP
.B
--diff
@@ -46,9 +54,9 @@
\fBdllist\fP --diff
list files to be downloaded for a system upgrade
.SH SEE ALSO
-\fBprt-get\fP(8), \fBports\fP(8)
-.SH AUTHOR
-Johannes Winkelmann <jw@tks6.net>
+\fBprt-get\fP(8), \fBports\fP(8), \fBPkgfile\fP(5)
+.SH AUTHORS
+Johannes Winkelmann <jw at tks6 dot net>, John McQuah <jmcquah at disroot dot org>
.RE
.PP