Add a standard boilerplate to the SYNOPSIS section that mentions how
to load a kernel module.

MFC after: 3 days

Join two lines.

Cross-reference the newly added example.9

Add a HARDWARE section to the example section 4 manual page.

Reviewed by: ru
MFC after: 3 days

Removed the comment that required all FreeBSD manpages
to have the $FreeBSD$ keyword, as this is now enforced
by the CVSROOT/commit_prep.pl script.

Fold multi-word macro arguments into a single argu

Removed the comment that required all FreeBSD manpages
to have the $FreeBSD$ keyword, as this is now enforced
by the CVSROOT/commit_prep.pl script.

Fold multi-word macro arguments into a single argument
by putting the surrounding double quotes - this speeds
up the -mdoc processing drastically (of course if used
systematically).

Use the new features of -mdoc: exact -width specifiers,
.In macro as an ``.Fd #include'' replacement.

show more ...

Remove an example of bad sentence breaking style.

Remove whitespace at EOL.

The semantics of the .Os call has been changed. For CURRENT,
this currently implies the default argument of "FreeBSD 5.0".

mdoc.samples(7) is superseded by mdoc(7).

We don't use the "pseudo-device" configuration option any longer,
so update the example to use the correct definition.

Add an example for documenting kernel compile options, along with
a small examp

We don't use the "pseudo-device" configuration option any longer,
so update the example to use the correct definition.

Add an example for documenting kernel compile options, along with
a small example of how to reference them in the main text of the
man page (I.e. the .Dv macro).

Inspired-by: a brief exchange I saw in in the commit messages mail

show more ...

mdoc(7) police: removed history info from the .Os FreeBSD call.

mdoc(7) police: use the new features of the Nm macro.

Make share/examples/mdoc and share/misc/mdoc.template internally
consistent, and consistent with mdoc(7) and mdoc.samples(7).

PR: doc/15352, doc/15353

Add $FreeBSD$ lines to these example man pages, along with a note
that says all man pages should contain a FreeBSD revision control
id to make it easier for translation teams.

.Sh AUTHOR -> .Sh AUTHORS.

Use the .An macro in the AUTHOR section.

Synced with the C example copyright. Cosmetic except for removing
clause 3, which was removed on 1996/08/03 in the C example.

These will appear in 2.2, not 3.0.

Pointed out by: wosch

some stylistic changes... "you name here" and "you name" to "your name"

2.2 Candidate

Update the copyright notices to match our bsd-copyright example.

Add some real example diagnostics to example.[14]

Add all of the possible errno's to example.3.

Show examples of the .Bx (BSD) and .At (AT&T UNIX) macros
in the various HISTORY sections.

Add some

Add some real example diagnostics to example.[14]

Add all of the possible errno's to example.3.

Show examples of the .Bx (BSD) and .At (AT&T UNIX) macros
in the various HISTORY sections.

Add some .Rs/.Re (used for referencing things other
than man pages) in the SEE ALSO sections.

Suggested by: wollman

show more ...

Moved these from /usr/share/misc/mdoc to /usr/share/examples/mdoc,
since it seemed like a better place, and the makefiles for
/usr/share/examples didn't need to be fussed with.

The old stuff can be

Moved these from /usr/share/misc/mdoc to /usr/share/examples/mdoc,
since it seemed like a better place, and the makefiles for
/usr/share/examples didn't need to be fussed with.

The old stuff can be removed from the Attic.

show more ...

Revert my previous change as it does not seem to be entirely correct and
popular.

Remove second person from the sentece and rephrase a bit.

Approved by: trhodes (mentor), keramida (mentor)

Fix wording to what I intended originally.