svn commit: r367141 - head/usr.bin/fetch

[xtouqh at icloud.com]

Fernando Apesteguía wrote:
> Author: fernape (ports committer)
> Date: Thu Oct 29 18:34:47 2020
> New Revision: 367141
> URL: https://svnweb.freebsd.org/changeset/base/367141
> 
> Log:
>    fetch(1): Add EXAMPLES section
>    
>    Add a few examples covering flags: 1, R, a, o, q, r, s, v
>    
>    Approved by:	manpages (bcr@)
>    Differential Revision:		https://reviews.freebsd.org/D26946
> 
> Modified:
>    head/usr.bin/fetch/fetch.1
> 
> Modified: head/usr.bin/fetch/fetch.1
> ==============================================================================
> --- head/usr.bin/fetch/fetch.1	Thu Oct 29 18:29:22 2020	(r367140)
> +++ head/usr.bin/fetch/fetch.1	Thu Oct 29 18:34:47 2020	(r367141)
> @@ -30,7 +30,7 @@
>   .\"
>   .\" $FreeBSD$
>   .\"
> -.Dd May 6, 2018
> +.Dd October 29, 2020
>   .Dt FETCH 1
>   .Os
>   .Sh NAME
> @@ -384,6 +384,51 @@ If the
>   argument is used and the remote file is not newer than the
>   specified file then the command will still return success,
>   although no file is transferred.
> +.Sh EXAMPLES
> +Silently try to fetch the URLs passed as parameters.
> +The first one will fail.
> +If the second URL succeeds the third one will not be tried:
> +.Bd -literal -offset indent
> +$ fetch -1 -q https://www.freebsd.org/bad.html \\
> +	ftp.freebsd.org/pub/FreeBSD/README.TXT \\
> +	https://www.fake.url
> +fetch: https://www.freebsd.org/bad.html: Not Found
> +.Ed
> +.Pp
> +Be verbose when retrieving the
> +.Ql README.TXT
> +file:
> +.Bd -literal -offset indent
> +$ fetch -v ftp.freebsd.org/pub/FreeBSD/README.TXT
> +resolving server address: ftp.freebsd.org:80
> +requesting http://ftp.freebsd.org/pub/FreeBSD/README.TXT
> +local size / mtime: 4259 / 1431015519
> +remote size / mtime: 4259 / 1431015519
> +README.TXT                                            4259  B   44 MBps    00s
> +.Ed
> +.Pp
> +Quietly save the
> +.Ql README.TXT file as

"file as" should be on separate line, otherwise it's treated as part of 
.Ql argument.  BTW, why are we not using .Pa for these?

> +.Ql myreadme.txt
> +and do not delete the output file under any circumstances:
> +.Bd -literal -offset indent
> +fetch -o myreadme.txt -q -R ftp.freebsd.org/pub/FreeBSD/README.TXT
> +.Ed
> +.Pp
> +Print the size of the requested file and identify the request with a custom user
> +agent string:
> +.Bd -literal -offset indent
> +$ fetch -s ftp.freebsd.org/pub/FreeBSD/README.TXT
> +--user-agent="Mozilla/5.0 (X11; FreeBSD x86_64; rv:78.0) Gecko/20100101"
> +3513231
> +.Ed
> +.Pp
> +Restart the transfer of the
> +.Ql README.TXT
> +file and retry the transfer upon soft failures:
> +.Bd -literal -offset indent
> +$ fetch -a -r http://ftp.freebsd.org/pub/FreeBSD/README.TXT
> +.Ed
>   .Sh SEE ALSO
>   .Xr fetch 3 ,
>   .Xr phttpget 8