]> pd.if.org Git - zpackage/blobdiff - doc/zpm-fetchurl.8
remove stray debug fprintf
[zpackage] / doc / zpm-fetchurl.8
index 7a005c486c576d50bc04574a36bc7ab335b9ff2f..d5487e5908eee133a29dbdd99140b2cb512677e6 100644 (file)
@@ -1,4 +1,4 @@
-.TH zpm-fetchurl 8 2019-03-04 "ZPM 0.7.0"
+.TH zpm-fetchurl 8 2019-03-05 "ZPM 0.7.0"
 .SH NAME
 zpm-fetchurl \- download files
 .SH SYNOPSIS
 .SH NAME
 zpm-fetchurl \- download files
 .SH SYNOPSIS
@@ -13,7 +13,8 @@ zpm-fetchurl \- download files
 .BI -z " lastmodfile"
 ]
 [
 .BI -z " lastmodfile"
 ]
 [
-.BI \-U " useragent""
+.BI \-U " useragent"
+]
 [
 .BI -o file
 ]
 [
 .BI -o file
 ]
@@ -29,10 +30,14 @@ 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.
 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
 .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
 .B \-r
 output the entire response, including the header
@@ -74,11 +79,16 @@ Fail silently on errors.
 .TP
 .B \-p \-#
 Output a progress bar.  A '#' is accepted for compatibility with curl.
 .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
 .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
 .SH FILES
 /var/lib/zpm/known_hosts
 ~/.zpm/known_hosts