--- 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 +\fBprt-get\fP(8), \fBports\fP(8), \fBPkgfile\fP(5) +.SH AUTHORS +Johannes Winkelmann , John McQuah .RE .PP