1
0
mirror of git://git.sv.gnu.org/coreutils.git synced 2026-06-09 03:06:33 +02:00

doc: clarify what's counted by wc

* src/wc.c (usage): State that only printable characters are considered
when counting words.  This also disambiguates wether we're talking
about bytes or characters in this context.
* doc/coreutils.texi (wc invocation): Likewise.  Also clarify
that --characters counts valid locale aware characters,
and that --lines does not count a trailing "line" unless
it ends with a newline character.
Fixes https://bugs.gnu.org/47702
This commit is contained in:
Pádraig Brady
2021-04-11 16:24:07 +01:00
parent ef772bf97f
commit 512fe04902
2 changed files with 12 additions and 7 deletions
+11 -6
View File
@@ -3754,9 +3754,10 @@ contents of files.
@cindex word count
@cindex line count
@command{wc} counts the number of bytes, characters, whitespace-separated
words, and newlines in each given @var{file}, or standard input if none
are given or for a @var{file} of @samp{-}. Synopsis:
@command{wc} counts the number of bytes, characters, words, and newlines
in each given @var{file}, or standard input if none are given
or for a @var{file} of @samp{-}. A word is a nonzero length
sequence of printable characters delimited by white space. Synopsis:
@example
wc [@var{option}]@dots{} [@var{file}]@dots{}
@@ -3807,19 +3808,23 @@ Print only the byte counts.
@itemx --chars
@opindex -m
@opindex --chars
Print only the character counts.
Print only the character counts, as per the current locale.
Invalid characters are not counted.
@item -w
@itemx --words
@opindex -w
@opindex --words
Print only the word counts.
Print only the word counts. A word is a nonzero length
sequence of printable characters separated by white space.
@item -l
@itemx --lines
@opindex -l
@opindex --lines
Print only the newline counts.
Print only the newline character counts.
Note a file without a trailing newline character,
will not have that last portion included in the line count.
@item -L
@itemx --max-line-length
+1 -1
View File
@@ -123,7 +123,7 @@ Usage: %s [OPTION]... [FILE]...\n\
fputs (_("\
Print newline, word, and byte counts for each FILE, and a total line if\n\
more than one FILE is specified. A word is a non-zero-length sequence of\n\
characters delimited by white space.\n\
printable characters delimited by white space.\n\
"), stdout);
emit_stdin_note ();