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

[Fernando Apesteguía]

On Thu, Oct 29, 2020 at 7:52 PM <xtouqh at icloud.com> wrote:

> 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?
>

Thanks for catching this. It should be fixed by now.

Cheers.


>
> > +.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
>
>