Jon Dowland wrote:
> The dd manpage is rather spartan and does not list possible
> values for the "conv=" argument.

It is a tradeoff.  If the --help and man pages get too long other
people complain that the output scrolls off of the page.  (I wish I
had a bug number handy to reference.)  The list of conversions is
rather long.

> It does, however, state that the info page might be more
> useful. Indeed it is. I mistakenly tried "info dd" rather
> than "info coreutils dd", and was confused to be facing the
> infopage for "ddd" -- but that's probably not a bug.

Well known issue.  Please see these reports for more information:

  http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=139569
  http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=180127
  http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=235517
  http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=262596

> Maybe the accepted values to the conv argument should be
> included in the manpage

The coreutils info pages are automatically generated from the --help
output of the command using help2man.  In this way as long as the
program source code is up to date then --help documentation and man
documentation will be in sync.  Therefore generally the way to improve
man pages is to improve the --help output.  But should the long list
of conversions really appear there?  Alternatively help2man can
include additional prose into the man page.

Just adding information...  I don't really have an opinion.

Bob


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]

Reply via email to