aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/roff.7
diff options
context:
space:
mode:
authorIngo Schwarze <schwarze@openbsd.org>2018-08-10 04:41:25 +0000
committerIngo Schwarze <schwarze@openbsd.org>2018-08-10 04:41:25 +0000
commitfbc87aa03d8f797ab884fc9f06443bd748a82ca1 (patch)
treea7907c49ead2603c71b7e21f62f1c7f8028f7499 /roff.7
parent7196a1d3dfecffb71c9eafd071a2a7bfcfb9b23c (diff)
downloadmandoc-fbc87aa03d8f797ab884fc9f06443bd748a82ca1.tar.gz
mandoc-fbc87aa03d8f797ab884fc9f06443bd748a82ca1.tar.zst
mandoc-fbc87aa03d8f797ab884fc9f06443bd748a82ca1.zip
Implement the roff(7) .nop (no operation) request.
Examples of manual pages (ab)using it include groff(7), chem(1), groff_mom(7), and groff_hdtbl(7).
Diffstat (limited to 'roff.7')
-rw-r--r--roff.715
1 files changed, 9 insertions, 6 deletions
diff --git a/roff.7 b/roff.7
index 8cb922c7..f079c28c 100644
--- a/roff.7
+++ b/roff.7
@@ -1,4 +1,4 @@
-.\" $Id: roff.7,v 1.96 2018/04/10 00:52:30 schwarze Exp $
+.\" $Id: roff.7,v 1.97 2018/08/10 04:41:25 schwarze Exp $
.\"
.\" Copyright (c) 2010, 2011, 2012 Kristaps Dzonsons <kristaps@bsd.lv>
.\" Copyright (c) 2010-2018 Ingo Schwarze <schwarze@openbsd.org>
@@ -15,7 +15,7 @@
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: April 10 2018 $
+.Dd $Mdocdate: August 10 2018 $
.Dt ROFF 7
.Os
.Sh NAME
@@ -206,7 +206,7 @@ Unescaped trailing spaces are stripped from text line input unless in a
literal context.
In general, trailing whitespace on any input line is discouraged for
reasons of portability.
-In the rare case that a blank character is needed at the end of an
+In the rare case that a space character is needed at the end of an
input line, it may be forced by
.Sq \e\ \e& .
.Pp
@@ -665,7 +665,7 @@ produces
.Pp
in the input stream, and thus in the output: \fI\^XtFree\^\fP.
Each occurrence of \e\e$* is replaced with all the arguments,
-joined together with single blank characters.
+joined together with single space characters.
.Pp
Since macros and user-defined strings share a common string table,
defining a macro
@@ -1346,8 +1346,11 @@ Currently unsupported.
Temporarily turn off line numbering.
Currently unsupported.
.It Ic \&nop Ar body
-Execute the rest of the input line as a request or macro line.
-Currently unsupported.
+Execute the rest of the input line as a request, macro, or text line,
+skipping the
+.Ic \&nop
+request and any space characters immediately following it.
+This is mostly used to indent text lines inside macro definitions.
.It Ic \&nr Ar register Oo Cm + Ns | Ns Cm - Oc Ns Ar expression Op Ar stepsize
Define or change a register.
A register is an arbitrary string value that defines some sort of state,