docs/122470: [patch] exit status on fetch(1) manual page

[Jaakko Heinonen]

>Number:         122470
>Category:       docs
>Synopsis:       [patch] exit status on fetch(1) manual page
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Apr 05 16:00:09 UTC 2008
>Closed-Date:
>Last-Modified:
>Originator:     Jaakko Heinonen
>Release:        FreeBSD 7.0-RELEASE amd64
>Organization:
>Environment:
System: FreeBSD x 7.0-RELEASE FreeBSD 7.0-RELEASE #0: Sun Feb 24 10:35:36 UTC 2008 root at driscoll.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC amd64


	
>Description:

fetch(1) manual page states that fetch(1) exits with status zero or one:

EXIT STATUS
     The fetch command returns zero on success, or one on failure.  If multi-
     ple URLs are listed on the command line, fetch will attempt to retrieve
     each one of them in turn, and will return zero only if they were all suc-
     cessfully retrieved.

However it's possible that it exits with status other than zero or one:

$ fetch -h foo
usage: fetch [-146AFMPRUadlmnpqrsv] [-N netrc] [-o outputfile]
             [-S bytes] [-B bytes] [-T seconds] [-w seconds]
             [-h host -f file [-c dir] | URL ...]
$ echo $?
64

>How-To-Repeat:
	
>Fix:
--- fetch.1-exit-status.diff begins here ---
Index: fetch.1
===================================================================
RCS file: /home/ncvs/src/usr.bin/fetch/fetch.1,v
retrieving revision 1.68
diff -p -u -r1.68 fetch.1
--- fetch.1	28 Dec 2007 19:47:37 -0000	1.68
+++ fetch.1	8 Mar 2008 16:10:18 -0000
@@ -238,7 +238,7 @@ for a description of additional environm
 .Sh EXIT STATUS
 The
 .Nm
-command returns zero on success, or one on failure.
+command returns zero on success, or non-zero on failure.
 If multiple URLs are listed on the command line,
 .Nm
 will attempt to retrieve each one of them in turn, and will return
--- fetch.1-exit-status.diff ends here ---


>Release-Note:
>Audit-Trail:
>Unformatted: