Hi arky

cpio does have a man page, but it's not helpful.

What it does do:
- lists the set of possible flags that the binary will accept.
- supplies a command line ("info cpio") for external documentation.
- supplies a URL to external documentation.

The problem is:
- the external (info) tool for external documentation has an esoteric and 
poorly discoverable user interface.
- the external documentation (info pages) are uninformative.
- the external documentation on the web is similarly uninformative.

So instead of a man page that documents what the tool is for and the
common invocations of the tool (eg. extracting and repacking an initrd),
there's a list of unexplained command line options and pointers to poor
external sources of further confusion.

So you could consider that the man page is "proper", if by proper you
mean that it's syntactically correct and not actually false, but I think
the statement that the man page is not helpful is still accurate and the
page could and should be improved.

Is that fair?

-- 
cpio man page is not helpful
https://bugs.launchpad.net/bugs/416788
You received this bug notification because you are a member of Ubuntu
Bugs, which is subscribed to Ubuntu.

-- 
ubuntu-bugs mailing list
[email protected]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-bugs

Reply via email to