[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