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

diff --git a/doc/zpm-fetchurl.8 b/doc/zpm-fetchurl.8
index 6df17c8..d5487e5 100644
--- a/doc/zpm-fetchurl.8
+++ b/doc/zpm-fetchurl.8
@@ -1,10 +1,19 @@
-.TH zpm-fetchurl 8 2019-02-27 "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 -ISkKrOnp
+.B -OIrRfnp
+]
+[
+.BI -L " redirlimit"
+]
+[
+.BI -z " lastmodfile"
+]
+[
+.BI \-U " useragent"
 ]
 [
 .BI -o file
@@ -21,14 +30,22 @@ 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, 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
 .TP
@@ -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
@@ -62,11 +79,16 @@ Fail silently on errors.
 .TP
 .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