KASSERT(9): describe history of MPASS

The macro originates from BSD/OS, with a different etymology than what
is presented. Add a brief HISTORY section to capture this.

Reviewed by: emaste
MFC after

KASSERT(9): describe history of MPASS

The macro originates from BSD/OS, with a different etymology than what
is presented. Add a brief HISTORY section to capture this.

Reviewed by: emaste
MFC after: 1 week
Sponsored by: The FreeBSD Foundation
Differential Revision: https://reviews.freebsd.org/D44439

show more ...

KASSERT(9): add assertion message guidelines

Add some text describing how to create useful assertion messages.
Improve and add to the EXAMPLES.

See the discussion prompting this on -hackers:
https:

KASSERT(9): add assertion message guidelines

Add some text describing how to create useful assertion messages.
Improve and add to the EXAMPLES.

See the discussion prompting this on -hackers:
https://mail-archive.freebsd.org/cgi/mid.cgi?57o4rnnq-013s-3nsn-59n5-4ssn1pq81s94

Reviewed by: emaste
Discussed with: imp, bz
MFC after: 1 week
Sponsored by: The FreeBSD Foundation
Differential Revision: https://reviews.freebsd.org/D44434

show more ...

Remove $FreeBSD$: two-line nroff pattern

Remove /^\.\\"\n\.\\"\s*\$FreeBSD\$$\n/

KASSERT(9): some updates

- Add a little bit of introductory text
- Improve the existing example: ANSI C, use a better assertion than a
NULL check (which is discouraged)
- Document the widely u

KASSERT(9): some updates

- Add a little bit of introductory text
- Improve the existing example: ANSI C, use a better assertion than a
NULL check (which is discouraged)
- Document the widely used MPASS macro in this page
- Drop the cross-reference to config(8)

Reviewed by: kib, markj, rpokala, Pau Amma <pauamma@gundo.com>
MFC after: 1 week
Sponsored by: The FreeBSD Foundation
Differential Revision: https://reviews.freebsd.org/D39131

show more ...

IFC @r269962

Submitted by: Anish Gupta (akgupt3@gmail.com)

Merge head from 7/28

Sync to HEAD@r269943.

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

PR: 191174
Submitted by: Franco Fichtner <franco at lastsummer.de>

Update to current version of head.

mdoc: order prologue macros consistently by Dd/Dt/Os

Although groff_mdoc(7) gives another impression, this is the ordering
most widely used and also required by mdocml/mandoc.

Reviewed by: ru
Appro

mdoc: order prologue macros consistently by Dd/Dt/Os

Although groff_mdoc(7) gives another impression, this is the ordering
most widely used and also required by mdocml/mandoc.

Reviewed by: ru
Approved by: philip, ed (mentors)

show more ...

Remove a bogus NOTES section. Move that content elsewhere.

Approved by: des (mentor), re (scottl)

mdoc(7) police:

- logically sort the SYNOPSIS section
- add missing markup bits
- "brackets" -> "parentheses"

Update function definitions and required include files to reflect
the current state of the system.

Approved by: alfred

Removed whitespace at end-of-line; no content changes. I simply did
cd src/share; find man[1-9] -type f|xargs perl -pi -e 's/[ \t]+$//'

BTW, what editors are the culprits? I'm using vim and it shows

Removed whitespace at end-of-line; no content changes. I simply did
cd src/share; find man[1-9] -type f|xargs perl -pi -e 's/[ \t]+$//'

BTW, what editors are the culprits? I'm using vim and it shows
me whitespace at EOL in troff files with a thick blue block...

Reviewed by: Silence from cvs diff -b
MFC after: 7 days

show more ...

Abuse .Fn for macros better (don't hand-format the parameter string by
quoting it all and adding commas).

Don't say that the expression in KASSERT() is an int. It is a collection
of tokens forming

Abuse .Fn for macros better (don't hand-format the parameter string by
quoting it all and adding commas).

Don't say that the expression in KASSERT() is an int. It is a collection
of tokens forming a C expression that can be compared with 0.

show more ...

Minor style fixes: freebsd.org -> FreeBSD.org

Remove trailing comma.

As bde was kind to point out:
"Man pages shouldn't refer to higher level interfaces
built using the interfaces in the man pages."

Submitted by: bde

Fix lameness I introduced by typing the Xr as a filename, sigh.

Fix EXAMPLE -> EXAMPLES.
Add Xr's for SPLASSERT and CONDSPLASSERT.

Assorted bag o' fixes:
fix Jonathan's name, fix copyright date, man -> manual,
add const before char *msg, add email address.

Document the KASSERT() macro.

Remove a bogus NOTES section. Move that content elsewhere.

Approved by: des (mentor), re (scottl)

mdoc(7) police:

- logically sort the SYNOPSIS section
- add missing markup bits
- "brackets" -> "parentheses"

Update function definitions and required include files to reflect
the current state of the system.

Approved by: alfred