bug-coreutils
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Minor documentation inconsistency between ls and nohup


From: Steven Mocking
Subject: Minor documentation inconsistency between ls and nohup
Date: Fri, 11 Jul 2003 11:58:14 +0200

l.s.

This is not really a bug, but I ran into this (what I think is a small 
inconsistency) while working on a nohup patch for a -o switch[0]. The ls info 
page states:

""
   By default, the output is sorted alphabetically, according to the
locale settings in effect. (1) If standard output is a terminal, the
output is in columns (sorted vertically) and control characters are
output as question marks; otherwise, the output is listed one per line
and control characters are output as-is.
""

and the nohup info page states:

""
   If standard output is a terminal, it is redirected so that it is
appended to the file `nohup.out'; if that cannot be written to, it is
appended to the file `$HOME/nohup.out'.  If that cannot be written to,
the command is not run.
""

Note the small difference. The ls documentation informs what is done when the 
standard output is a terminal *and* what is done when stdout is _not_ a 
terminal. The nohup docs, on the other hand, only inform about behaviour _if_ 
stdout is a terminal, not what happens if it isn't. Both ls and nohup have 
the property of acting differently in both cases, but in my opinion the ls 
documentation is a lot clearer. My proposal is to add following line to the 
mentioned paragraph in the info page of nohup:

""
If standard output is not a terminal, the output from COMMAND is 
redirected to the standard output of nohup.
""

Sincerely,
  Steven Mocking

[0] Yes, that patch for an -o switch would have been a reinvention of a 
practically undocumented wheel.




reply via email to

[Prev in Thread] Current Thread [Next in Thread]