X-Git-Url: https://pd.if.org/git/?a=blobdiff_plain;f=doc%2Fzpm-fetchurl.8;h=d5487e5908eee133a29dbdd99140b2cb512677e6;hb=HEAD;hp=c6f748c1f546ee44c5d6ca4be02a47b01288a8da;hpb=28c32424d04f982985b685ce891ed7db6237504e;p=zpackage

diff --git a/doc/zpm-fetchurl.8 b/doc/zpm-fetchurl.8
index c6f748c..d5487e5 100644
--- a/doc/zpm-fetchurl.8
+++ b/doc/zpm-fetchurl.8
@@ -1,10 +1,19 @@
-.TH zpm-fetchurl 8 2018-12-09 "ZPM 0.4"
+.TH zpm-fetchurl 8 2019-03-05 "ZPM 0.7.0"
 .SH NAME
 zpm-fetchurl \- download files
 .SH SYNOPSIS
 .B zpm fetchurl
 [
-.B -ISkKr
+.B -OIrRfnp
+]
+[
+.BI -L " redirlimit"
+]
+[
+.BI -z " lastmodfile"
+]
+[
+.BI \-U " useragent"
 ]
 [
 .BI -o file
@@ -21,13 +30,21 @@ used.
 While this program can be used directly, it is intended for use by zpm scripts
 for downloading repositories and packages without requiring an external
 dependency.
+.PP
+URLs of the file scheme have an http style response header generated
+internally so the same code and output are used.
 .SH OPTIONS
 .TP
 .B \-I
-output the response header only, implies -r
+output the response header only, implies \-r.  The output file
+is ignored and the header is written to stdout.
 .TP
 .B \-r
-output the entire response header, including the header
+output the entire response, including the header
+.TP
+.BI -L " limit"
+Limit the maximum number of redirects to \fIlimit\fR.  The default is
+50.
 .TP
 .B \-S
 output the response status code only
@@ -41,8 +58,8 @@ TLS, but zpm-fetchurl uses a trust on first use policy instead.  Root
 certificates are found by default in /etc/zpm/roots.pem, but the ZPM_ROOTFILE
 environment variable can be used to override this.
 .TP
-.BI \-R " limit"
-set the limit on following redirects, defaults to 50
+.B \-R
+Output the request header.
 .TP
 .BI \-z " path"
 Only download if remote is newer than the file given by path
@@ -51,19 +68,31 @@ Only download if remote is newer than the file given by path
 Write the output to the file given by \fIpath\fR.  Output is
 written to stdout by default.
 .TP
+.B \-O
+Calculate the output file name from the url.
+.TP
+.B \-n
+Only if newer.  Like \-z, except use the output file name, if any.
+.TP
 .B \-f
 Fail silently on errors.
 .TP
-.B \-#
-Output a progress bar.
+.B \-p \-#
+Output a progress bar.  A '#' is accepted for compatibility with curl.
+.TP
+.BI \-U " useragent"
+Set the User-Agent header to \fIuseragent\fR.
 .SH EXAMPLES
 .TP
 zpm fetchurl -o zpm-0.1.2.zpm https://zoranix.net/repo/packages/zpm-0.1.2.zpm
 .SH EXIT STATUS
 0 on success non zero on failure
+.PP
+Failure is any exit status code >= 400.
 .SH FILES
 /var/lib/zpm/known_hosts
 ~/.zpm/known_hosts
+/etc/zpm/roots.pem
 .SH ENVIRONMENT
 ZPM_KNOWNHOSTS
 ZPM_ROOTFILE