docs/158378: cpio/bsdcpio(1) man page does not document -0 and --null options

[Carl]

>Number:         158378
>Category:       docs
>Synopsis:       cpio/bsdcpio(1) man page does not document -0 and --null options
>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:   Tue Jun 28 09:10:12 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator:     Carl
>Release:        FreeBSD-8.2-RELEASE-amd64/i386
>Organization:
>Environment:
FreeBSD xxxxxxxx 8.2-RELEASE FreeBSD 8.2-RELEASE #0: Thu Feb 17 02:41:51 UTC 2011 root at mason.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC amd64
>Description:
The cpio(1), actually bsdcpio(1), man page makes no mention that the GNU cpio options -0 and --null are supported, but it turns out they actually are. The man page should be updated to reflect this fact and perhaps to include an example of use with the -print0 option of the find command.
>How-To-Repeat:
Try the -0 or --null option:

# cpio --rubbish
cpio: Option --rubbish is not supported
Brief Usage:
  List:    cpio -it < archive
  Extract: cpio -i < archive
  Create:  cpio -o < filenames > archive
  Help:    cpio --help
# cpio --null
cpio: Must specify at least one of -i, -o, or -p

>Fix:
Add missing options to cpio/bsdcpio(1) man page.

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