Discussion:
bug#29807: mktemp documentation does not clearly document the use of TMPDIR
(too old to reply)
Martin Schwenke
2017-12-22 03:42:44 UTC
Permalink
Looking at the source code of mktemp suggests that it generally
uses the TMPDIR environment variable to specify an alternative to /tmp
when options such -p and -t are not given.

However, the documentation only mentions TMPDIR in the context of the -p
and -t options. The info page has an example that seems to imply the
general use of of TMPDIR but that is as far as it goes.

I think there should be an "ENVIRONMENT VARIABLES" section that lists
TMPDIR and explains how it is used.

I would supply a patch but I don't understand enough texinfo to be
able to figure out how to do this in doc/coreutils.texi. :-(

peace & happiness,
martin
Martin Schwenke
2017-12-22 04:45:33 UTC
Permalink
After reading the documentation again, I realise that it is actually
complete (i.e. no arguments implies --tmpdir).

I would, however, regard the documentation to be structured in a way
that makes it hard to find the information about TMPDIR. That is,
searching for TMPDIR doesn't find the answer. You need to carefully
read that no arguments implies --tmpdir and that this implies the use
of TMPDIR. A separate discussion of TMPDIR would be more helpful.

Thanks...

peace & happiness,
martin
Assaf Gordon
2018-10-30 02:22:08 UTC
Permalink
tags 29807 notabug
close 29807
stop

(triaging old bugs)
Post by Martin Schwenke
After reading the documentation again, I realise that it is actually
complete (i.e. no arguments implies --tmpdir).
Given the above, I'm closing this bug.
Post by Martin Schwenke
[...] A separate discussion of TMPDIR would be more helpful.
Patches and wording suggestions are always welcomed.

regards,
- assaf

Loading...