[Top][All Lists]
[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.
- Minor documentation inconsistency between ls and nohup,
Steven Mocking <=