1
0
mirror of git://git.sv.gnu.org/coreutils.git synced 2026-02-11 09:51:56 +02:00

doc: split,tac: document $TMPDIR usage

Following commit v9.3-92-g1b86b70dd
$TMPDIR is part of the interface and an important behavioral
characteristic of a command, which should be documented.

* doc/coreutils.texi (split invocation): Mention $TMPDIR is honored.
(tac invocation): Likewise.
* src/split.c (usage): Likewise.
* src/tac.c (usage): Likewise.
This commit is contained in:
Pádraig Brady
2025-12-18 23:54:52 +00:00
parent a2c3896b51
commit 7be8402e1e
3 changed files with 17 additions and 2 deletions

View File

@@ -1837,6 +1837,11 @@ I.e., input and output items are delimited with ASCII NUL.
On systems like MS-DOS that distinguish between text and binary files,
@command{tac} reads and writes in binary mode.
@vindex TMPDIR
Non-seekable input is buffered to @env{$TMPDIR}, defaulting to @file{/tmp},
if the @env{TMPDIR} environment variable is not set
or the location is not available.
@exitstatus
Example:
@@ -3346,10 +3351,13 @@ are not split even if they overlap a partition, the files written
can be larger or smaller than the partition size, and even empty
if a line/record is so long as to completely overlap the partition.
@vindex TMPDIR
When the input is a pipe or some other special file where the size
cannot easily be determined, there is no trouble for @samp{r} mode
because the size of the input is irrelevant. For other modes, such an
input is first copied to a temporary to determine its size.
because the size of the input is irrelevant. For other modes,
such an input's size is determined by first copying to @env{$TMPDIR},
or @file{/tmp} if the @env{TMPDIR} environment variable is not set
or the location is not available.
@optItem{split,-a,@w{ }@var{length}}
@optItemx{split,--suffix-length,=@var{length}}

View File

@@ -268,6 +268,10 @@ CHUNKS may be:\n\
l/K/N output Kth of N to standard output without splitting lines/records\n\
r/N like 'l' but use round robin distribution\n\
r/K/N likewise but only output Kth of N to standard output\n\
"), stdout);
fputs (_("\n\
-n (except -nr) will buffer to $TMPDIR, defaulting to /tmp,\n\
if the input size cannot easily be determined.\n\
"), stdout);
emit_ancillary_info (PROGRAM_NAME);
}

View File

@@ -133,6 +133,9 @@ Write each FILE to standard output, last line first.\n\
"), stdout);
fputs (HELP_OPTION_DESCRIPTION, stdout);
fputs (VERSION_OPTION_DESCRIPTION, stdout);
fputs (_("\n\
Non-seekable input is buffered to $TMPDIR, defaulting to /tmp.\n\
"), stdout);
emit_ancillary_info (PROGRAM_NAME);
}
exit (status);