plan9port/man/man1/mkdir.1
Russ Cox 977b25a76a tmac: introduce real manual reference macro instead of overloading IR
The overloading of IR emits magic \X'...' sequences that turn into HTML manual links.
But not all such IR invocations should be manual links;
those had to be written to avoid the IR macro before.
Worse, the \X'...' ending the IR causes troff to emit only a single space after a period.

Defining a new IM macro for manual references fixes both problems.

Fixes #441.
2020-08-13 23:43:43 -04:00

43 lines
716 B
Groff

.TH MKDIR 1
.SH NAME
mkdir \- make a directory
.SH SYNOPSIS
.B mkdir
[
.B -p
] [
.B -m
. I mode
]
.I dirname ...
.SH DESCRIPTION
.I Mkdir
creates the specified directories.
It
requires write permission in the parent directory.
.PP
If the
.B -p
flag is given,
.I mkdir
creates any necessary parent directories
and does not complain if the target directory already exists.
.PP
The
.B -m
flag sets the permissions to be used when creating the directory.
The default is 0777.
.SH "SEE ALSO"
.IM rm (1)
.br
.IR cd
in
.IM rc (1)
.SH SOURCE
.B \*9/src/cmd/mkdir.c
.SH DIAGNOSTICS
.I Mkdir
returns null exit status if all directories were successfully made.
Otherwise it prints a diagnostic and returns
.B \&"error"
status.