coreutils/doc, branch masterMirror of https://https.git.savannah.gnu.org/git/coreutils.git/
https://git.shady.money/coreutils/atom?h=master2026-04-05T12:15:56Zdoc: cut: clarify that combining characters are not treated specially2026-04-05T12:15:56ZPádraig BradyP@draigBrady.com2026-03-28T16:18:41Zurn:sha1:fe008233306eebca44770d3d4411313e18ced3c3
This is for consistency with other implementations and since the
interface separates -b and -c it might in future support -g (graphemes).
Normalizing content with a filter seems like the most appropriate
approach anyway, as there are various normalizations possible including
case etc. rather than baking that into every tool
doc: cut: resintate and expand -d info2026-04-05T12:15:56ZPádraig BradyP@draigBrady.com2026-03-28T09:12:39Zurn:sha1:c3e819fadc62315e407cc5cf61cb4c81a0e14841
* doc/coreutils.texi (cut invocation): Add back the -d description,
and adjust for multi-byte support, and expand on specifying a NUL
delimitier, and detail the behavior when the delimiter matches
the line delimiter.
doc: cut: clarify that -s suppressed lines with only trimmed spaces2026-04-05T12:15:56ZPádraig BradyP@draigBrady.com2026-03-27T18:29:16Zurn:sha1:03a686a456820e1c33e473ab44f26f10f56e8fd9
* doc/coreutils.texi (cut invocation): State explicitly that
-s --whitespace-delimited=trimmed will suppress lines that
do not have field separating blanks.
doc: cut: mention the default -O used with -w2026-04-05T12:15:56ZPádraig BradyP@draigBrady.com2026-03-27T15:52:14Zurn:sha1:2c1ea231ca9df621aa7bc2da61514ff695761380
* doc/coreutils.texi (cut invocation): Mention the default
--output-delimiter is a TAB when matching runs of blanks in the input.
doc: cut: reorder -s in texi2026-04-05T12:15:56ZPádraig BradyP@draigBrady.com2026-03-20T17:08:59Zurn:sha1:f5b7d38d13d88fb4b35e0f5ab3a9b46c6dcd38e8
Keep in alphabetical order.
doc: cut: document the -w option2026-04-05T12:15:56ZPádraig BradyP@draigBrady.com2026-03-20T17:07:18Zurn:sha1:c1d7b492c65bd850b9cd620a87c0f53edb6d1c7f
* src/cut.c (usage): Mention blank characters are used to separate.
* doc/coreutils.texi (cut invocation): Likewise. Also describe
the 'trimmed' argument and the relation to -F.
cut: support -F as an alias for -f -w -O ' '2026-04-05T12:15:56ZPádraig BradyP@draigBrady.com2026-03-13T19:48:05Zurn:sha1:a14ac29629bf4a8ed5ab0f629046edb28aa0d649
To improve compatibility with toybox/busybox scripts.
cut: support -O as an alias for --output-delimiter2026-04-05T12:15:56ZPádraig BradyP@draigBrady.com2026-03-13T11:05:40Zurn:sha1:77ccacb9a7fc29481cda9ae558d47de7ddce1aed
To improve compatibility with toybox/busybox scripts.
* doc/coreutils.texi (cut invocation): Add -O description.
* src/cut.c: Support -O as well as --output-delimiter
* tests/cut/cut.pl: Adjust one case to use -O.
doc: cut: adjust for multi-byte support2026-04-05T12:15:56ZPádraig BradyP@draigBrady.com2026-03-11T22:15:38Zurn:sha1:0ae17ffd995c3cb004badd5627f0750281ba5ab7
* doc/coreutils.texi (cut invocation): Remove the note about
-c being the same as -b.
cut: implement -n to avoid outputting partial characters2026-04-05T12:15:56ZPádraig BradyP@draigBrady.com2026-03-12T17:27:00Zurn:sha1:57110d8bae0637baab050466fad2946b645b51a0
Both the i18n patch and FreeBSD/macOS support this option.
They do differ in behavior somewhat as the i18n patch
may output more bytes than requested.
$ printf '\xc3\xa9b\n' | i18n-cut -n -b1
é
There is also a bug in the i18n patch with multi-byte
at the start of a line:
$ printf '\xc3\xa9b\n' | i18n-cut -n -b1-2
éb
We follow the FreeBSD behavior since it seems more
useful to have -b be a hard limit, rather than a soft limit.
This also reduces the possibility of duplicate character output
with separate cut invocations with non overlapping byte ranges.
* src/cut.c (cut_bytes_no_split): A new function
similar to cut_characters, to handle multi-byte characters
with byte limit semantics.
* tests/cut/cut.pl: Add test cases.