version 1.32, 2009/08/20 12:08:40 |
version 1.35, 2009/08/21 12:12:12 |
Line 139 are generally structured as follows: |
|
Line 139 are generally structured as follows: |
|
\&. |
\&. |
\&.SH NAME |
\&.SH NAME |
\efBfoo\efR \e(en a description goes here |
\efBfoo\efR \e(en a description goes here |
|
\&.\e\*q The next is for sections 2 & 3 only. |
|
\&.\e\*q .SH LIBRARY |
\&. |
\&. |
\&.SH SYNOPSIS |
\&.SH SYNOPSIS |
\efBfoo\efR [\efB\e-options\efR] arguments... |
\efBfoo\efR [\efB\e-options\efR] arguments... |
\&. |
\&. |
\&.SH DESCRIPTION |
\&.SH DESCRIPTION |
The \efBfoo\efR utility does... |
The \efBfoo\efR utility processes files... |
\&. |
\&. |
|
\&.\e\*q .SH IMPLEMENTATION NOTES |
|
\&.\e\*q The next is for sections 1 & 8 only. |
|
\&.\e\*q .SH EXIT STATUS |
|
\&.\e\*q The next is for sections 2, 3, & 9 only. |
\&.\e\*q .SH RETURN VALUES |
\&.\e\*q .SH RETURN VALUES |
|
\&.\e\*q The next is for sections 1, 6, 7, & 8 only. |
\&.\e\*q .SH ENVIRONMENT |
\&.\e\*q .SH ENVIRONMENT |
\&.\e\*q .SH FILES |
\&.\e\*q .SH FILES |
\&.\e\*q .SH EXAMPLES |
\&.\e\*q .SH EXAMPLES |
|
\&.\e\*q The next is for sections 1, 4, 6, 7, & 8 only. |
\&.\e\*q .SH DIAGNOSTICS |
\&.\e\*q .SH DIAGNOSTICS |
|
\&.\e\*q The next is for sections 2, 3, & 9 only. |
\&.\e\*q .SH ERRORS |
\&.\e\*q .SH ERRORS |
\&.\e\*q .SH SEE ALSO |
\&.\e\*q .SH SEE ALSO |
\&.\e\*q \efBbar\efR(1) |
\&.\e\*q \efBbar\efR(1) |
Line 159 The \efBfoo\efR utility does... |
|
Line 168 The \efBfoo\efR utility does... |
|
\&.\e\*q .SH AUTHORS |
\&.\e\*q .SH AUTHORS |
\&.\e\*q .SH CAVEATS |
\&.\e\*q .SH CAVEATS |
\&.\e\*q .SH BUGS |
\&.\e\*q .SH BUGS |
|
\&.\e\*q .SH SECURITY CONSIDERATIONS |
.Ed |
.Ed |
. |
. |
. |
. |
|
|
.Pp |
.Pp |
is equivalent to |
is equivalent to |
.Sq \&.I foo . |
.Sq \&.I foo . |
.\" PARAGRAPH |
If next-line macros are invoked consecutively, only the last is used. |
Consecutive next-line scope invocations are disallowed. |
If a next-line macro is proceded by a block macro, it is ignored. |
.Bd -literal -offset indent |
.Bd -literal -offset indent |
\&.YO \(lBbody...\(rB |
\&.YO \(lBbody...\(rB |
\(lBbody...\(rB |
\(lBbody...\(rB |
.Ed |
.Ed |
. |
. |
.Pp |
.Pp |
It is considered an error when next-line scope is open at the end of |
|
file. |
|
. |
|
.Pp |
|
.Bl -column -compact -offset indent "MacroX" "ArgumentsX" "ScopeXXXXX" |
.Bl -column -compact -offset indent "MacroX" "ArgumentsX" "ScopeXXXXX" |
.It Em Macro Ta Em Arguments Ta Em Scope |
.It Em Macro Ta Em Arguments Ta Em Scope |
.It B Ta n Ta next-line |
.It B Ta n Ta next-line |
|
|
No closure refers to an explicit block closing macro. |
No closure refers to an explicit block closing macro. |
. |
. |
.Pp |
.Pp |
It is considered an error when part or next-line scope is open at the |
|
end of file. |
|
. |
|
.Pp |
|
.Bl -column "MacroX" "ArgumentsX" "Head ScopeX" "sub-sectionX" -compact -offset indent |
.Bl -column "MacroX" "ArgumentsX" "Head ScopeX" "sub-sectionX" -compact -offset indent |
.It Em Macro Ta Em Arguments Ta Em Head Scope Ta Em Body Scope |
.It Em Macro Ta Em Arguments Ta Em Head Scope Ta Em Body Scope |
.It HP Ta <2 Ta current Ta paragraph |
.It HP Ta <2 Ta current Ta paragraph |
|
|
.It PP Ta 0 Ta current Ta paragraph |
.It PP Ta 0 Ta current Ta paragraph |
.It RE Ta 0 Ta current Ta none |
.It RE Ta 0 Ta current Ta none |
.It RS Ta 1 Ta current Ta part |
.It RS Ta 1 Ta current Ta part |
.It SH Ta >0 Ta current Ta section |
.It SH Ta >0 Ta next-line Ta section |
.It SS Ta >0 Ta current Ta sub-section |
.It SS Ta >0 Ta next-line Ta sub-section |
.It TP Ta n Ta next-line Ta paragraph |
.It TP Ta n Ta next-line Ta paragraph |
.El |
.El |
. |
. |