1
0
mirror of git://git.suckless.org/sbase synced 2025-01-02 21:12:15 +00:00
sbase/mktemp.1
Brandon Pribula d458fa2c7b fix: update man pages to standard mdoc date format
When viewing sbase's man pages the date displayed at the bottom is
the current date rather than the date entered in the <program>.1
file.

According to this:

https://mandoc.bsd.lv/mdoc/details/date.html

The traditional man date format used by sbase (.Dd year-month-day)
is no longer recommended and no longer supported by GNU troff or
Heirloom Docs and as a result the current date is displayed instead.
Although this format is still accepted by mandoc for backward
compatibility.

For portability it states the standard mdoc date format should be
used instead: .Dd month day, year

I applied the following patch to sbase's last commit b30fb56 and
it fixes the issue.
2024-09-08 08:35:39 +02:00

51 lines
1.1 KiB
Groff

.Dd October 8, 2015
.Dt MKTEMP 1
.Os sbase
.Sh NAME
.Nm mktemp
.Nd create temporary file or directory
.Sh SYNOPSIS
.Nm
.Op Fl dqtu
.Op Fl p Ar directory
.Op Ar template
.Sh DESCRIPTION
.Nm
creates a temporary file by generating a unique filename with
.Ar template ,
which has to have at least six 'X's appended to it.
If no
.Ar template
is specified, a default of 'tmp.XXXXXXXXXX' is used and the
tmpdir set to '/tmp' or, if set, the TMPDIR environment variable.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl d
Create a temporary directory instead of a file.
.It Fl p Ar directory
Use the specified
.Ar directory
as a prefix when generating the temporary filename.
The directory will be overridden by the user's
.Ev TMPDIR
environment variable if it is set.
This option implies the
.Fl t
flag (see below).
.It Fl q
Fail silently if an error occurs.
.It Fl t
Generate a path rooted in a temporary directory.
.It Fl u
Unlink file before
.Nm
exits.
This is slightly better than
.Xr mktemp 3
but still introduces a race condition.
Use of this option is not encouraged.
.El
.Sh SEE ALSO
.Xr mkdtemp 3 ,
.Xr mkstemp 3