groff-commit
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[groff] 40/49: groff(7): Add "Control characters" section.


From: G. Branden Robinson
Subject: [groff] 40/49: groff(7): Add "Control characters" section.
Date: Sun, 25 Sep 2022 17:03:04 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 69a6b62bc4f934eb59ffb60f5da34b04c251cd5a
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Sep 25 13:55:30 2022 -0500

    groff(7): Add "Control characters" section.
    
    This largely mirrors the node of the same name in our Texinfo manual.
---
 man/groff.7.man | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/man/groff.7.man b/man/groff.7.man
index add97c126..61e76f18f 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -1390,6 +1390,53 @@ No other object types do.
 .
 .
 .\" ====================================================================
+.SH "Control characters"
+.\" ====================================================================
+.
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Control
+.\" Characters".
+.\" The mechanism of using @code{roff}'s control characters to invoke
+.\" requests and call macros was introduced in @ref{Requests and Macros}.
+Control characters are recognized only at the beginning of an input
+line,
+or at the beginning of the branch of a control structure request;
+.\" see @ref{Conditionals and Loops}.
+see section \[lq]Control structures\[rq] below.
+.
+.
+.P
+A few requests cause a break implicitly;
+use the no-break control character to prevent the break.
+.
+Break suppression is its sole behavioral distinction.
+.
+Employing the no-break control character to invoke requests that don't
+cause breaks is harmless but poor style.
+.
+.
+.P
+The control character
+.RB \[lq] .\& \[rq]
+and the no-break control character
+.RB \[lq] \|\[aq]\| \[rq]
+can be changed with the
+.B cc
+and
+.B c2
+requests,
+respectively.
+.
+When writing a macro,
+.\" you might wish to know
+use the
+.B .br
+register to determine
+which control character was used to call it.
+.\" END Keep (roughly) parallel with groff.texi node "Control
+.\" Characters".
+.
+.
+.\" ====================================================================
 .SH "Control structures"
 .\" ====================================================================
 .



reply via email to

[Prev in Thread] Current Thread [Next in Thread]