Remove misleading macros from -width arguments

Also, remove $FreeBSD$ tag from manual page examples.

MFC after: 1 week

Remove macros from the width arguments passed to Bl macros

I've not removed the Er macro from one of the lists in example.9, however,
because it seems to be doing some special kind of magic. Let's l

Remove macros from the width arguments passed to Bl macros

I've not removed the Er macro from one of the lists in example.9, however,
because it seems to be doing some special kind of magic. Let's leave it
there for now.

show more ...

Add SPDX tags to example manual pages and POSIX copyright.

Reviewed by: eadler
Approved by: mat (mentor)
Differential Revision: https://reviews.freebsd.org/D14958

Remove 'All Rights Reserved' from the collection copyright and templates.

The original Berkeley Software Distributions were made in the 1980's
and 1990's. At that time, the Buenos Ares Convention of

Remove 'All Rights Reserved' from the collection copyright and templates.

The original Berkeley Software Distributions were made in the 1980's
and 1990's. At that time, the Buenos Ares Convention of 1910 was in
force in most of the countries in the Americas. It required an
affirmative statement of rights reservation, typically using 'All
Rights Reserved.' The Regents included this phrase in their copyright
notices to invoke this treaty to ensure maximal copyright protection.

In the 1990's, Latin America coutries ratifeid the Berne Convention on
copyrights which prohibited them from requiring an affirmative
statement to reserve the rights. When Nicaragua ratified in 2000, the
Buenos Ares Convention of 1910 was effectively repealed. This made all
the 'All Rights Reserved' phrases obsolete and legal deadweight most
of the time, and certainly in the cases removed here.

Since it's no longer required, and is in fact meaningless, core has
decided to dropped it from the project's collection copyright and
sample templates. It encourages other rights holders to do the same
after consultation with their legal department.

More see https://en.wikipedia.org/wiki/Buenos_Aires_Convention for
more information.

Approved by: core@ (emaste@, jhb@)
Differential Review: https://reviews.freebsd.org/D15264

show more ...

Join excessive split lines.

MFC after: 1 week

use .Mt to mark up email addresses consistently (part1)

PR: 191174
Submitted by: Franco Fichtner <[email protected]>

Sync example file with mdoc changes made in rev 235450.

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.

- Avoid using second person.
- Demonstrate how .Nm can be used without the side effect of causing
a line break in the SYNOPSIS section.

Make this example more real world usable: When the manpage first appeared
is not interesting, when the driver appeared is. Most people who use this
example leave the manpage appearance date in and

Make this example more real world usable: When the manpage first appeared
is not interesting, when the driver appeared is. Most people who use this
example leave the manpage appearance date in and the driver date out.

MFC after: 3 days

show more ...

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