~sircmpwn/scdoc

b16de454afc736a87c0386390c4cc91ba3cc8f29 — Humm 23 days ago 5061ecc
scdoc(1), scdoc(5): follow conventions more closely

The man page title must be all caps.

Always traditionally and usually today, man page references using -man
set the name in italic type:

	See
	.IR man (1).
2 files changed, 10 insertions(+), 10 deletions(-)

M scdoc.1.scd
M scdoc.5.scd
M scdoc.1.scd => scdoc.1.scd +5 -5
@@ 1,8 1,8 @@
scdoc(1)
SCDOC(1)

# NAME

scdoc - generate *man*(7) manual pages
scdoc - generate _man_(7) manual pages

# SYNOPSIS



@@ 10,12 10,12 @@ scdoc - generate *man*(7) manual pages

# DESCRIPTION

The scdoc utility reads *scdoc*(5) syntax from the standard input and writes
*man*(7) style roff to the standard output.
The scdoc utility reads _scdoc_(5) syntax from the standard input and writes
_man_(7) style roff to the standard output.

# SEE ALSO

*scdoc*(5)
_scdoc_(5)

# AUTHORS


M scdoc.5.scd => scdoc.5.scd +5 -5
@@ 1,4 1,4 @@
scdoc(5)
SCDOC(5)

# NAME



@@ 12,10 12,10 @@ Input files must use the UTF-8 encoding.

Each scdoc file must begin with the following preamble:

	_name_(_section_) ["left\_footer" ["center\_header"]]
	_NAME_(_section_) ["left\_footer" ["center\_header"]]

_name_ is the name of the man page you are writing, and _section_ is the section
you're writing for (see *man*(1) for information on manual sections).
_NAME_ is the name of the man page you are writing, and _section_ is the section
you're writing for (see _man_(1) for information on manual sections).

_left\_footer_ and _center\_header_ are optional arguments which set the text
positioned at those locations in the generated man page, and *must* be


@@ 204,7 204,7 @@ By convention, all scdoc documents should be hard wrapped at 80 columns.

# SEE ALSO

*scdoc*(1)
_scdoc_(1)

# AUTHORS