coreutils
[Top][All Lists]
Advanced

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

[PATCH 3/4] doc: update ls classify with optional arg


From: Jason Kim
Subject: [PATCH 3/4] doc: update ls classify with optional arg
Date: Sun, 19 Apr 2020 01:40:18 -0700

Update Texinfo docs for `ls --classify=when`.
---
 doc/coreutils.texi | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 24e424c54..0e1dc48bd 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -8004,7 +8004,7 @@ and on a @code{dirent.d_type}-capable file system, 
@command{ls}
 will perform only one @code{stat} call per command line argument.
 
 @item -F
-@itemx --classify
+@itemx --classify [=@var{when}]
 @itemx --indicator-style=classify
 @opindex -F
 @opindex --classify
@@ -8016,6 +8016,21 @@ for regular files that are executable, append @samp{*}.  
The file type
 indicators are @samp{/} for directories, @samp{@@} for symbolic links,
 @samp{|} for FIFOs, @samp{=} for sockets, @samp{>} for doors,
 and nothing for regular files.
+@var{when} may be omitted, or one of:
+@itemize @bullet
+@item none
+@vindex none @r{classify option}
+- Do not classify.  This is the default.
+@item auto
+@vindex auto @r{classify option}
+@cindex terminal, using classify iff
+- Only classify if standard output is a terminal.
+@item always
+@vindex always @r{classify option}
+- Always classify.
+@end itemize
+Specifying @option{--classify} and no @var{when} is equivalent to
+@option{--classify=always}.
 @c The following sentence is the same as the one for -d.
 Do not follow symbolic links listed on the
 command line unless the @option{--dereference-command-line} (@option{-H}),
-- 
2.26.1




reply via email to

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