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:
@@ -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}}
|
||||
|
||||
@@ -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);
|
||||
}
|
||||
|
||||
@@ -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);
|
||||
|
||||
Reference in New Issue
Block a user