help / color / Atom feed
* mandoc: Document the "delim" syntax and its usage.
@ 2020-01-10 11:55 schwarze
  0 siblings, 0 replies; only message in thread
From: schwarze @ 2020-01-10 11:55 UTC (permalink / raw)
  To: source

Log Message:
Document the "delim" syntax and its usage.
Closing a gap reported by bentley@, who also sent a patch,
but i'm explaining it somewhat differently.
While here, remove duplicate information from the text.
OK bentley@

Modified Files:

Revision Data
Index: eqn.7
RCS file: /home/cvs/mandoc/mandoc/eqn.7,v
retrieving revision 1.38
retrieving revision 1.39
diff -Leqn.7 -Leqn.7 -u -p -r1.38 -r1.39
--- eqn.7
+++ eqn.7
@@ -44,28 +44,16 @@ specification (see
 for references).
-Equations within
-.Xr mdoc 7
-.Xr man 7
-documents are enclosed by the standalone
-.Sq \&.EQ
-.Sq \&.EN
-Equations are multi-line blocks consisting of formulas and control
-Each equation is bracketed by
-.Sq \&.EQ
-.Sq \&.EN
-.Em Note :
-these are not the same as
-.Xr roff 7
-macros, and may only be invoked as
-.Sq \&.EQ .
+An equation starts with an input line containing exactly the characters
+.Sq \&.EQ ,
+may contain multiple input lines, and ends with an input line
+containing exactly the characters
+.Sq \&.EN .
+Equivalently, an equation can be given in the middle of a single
+text input line by surrounding it with the equation delimiters
+defined with the
+.Cm delim
 The equation grammar is as follows, where quoted strings are
 case-sensitive literals in the input:
@@ -178,6 +166,25 @@ statement is a synonym for
 .Cm tdefine
 is discarded.
+.It Cm delim
+This statement takes a string argument consisting of two bytes,
+to be used as the opening and closing delimiters for equations
+in the middle of text input lines.
+Conventionally, the dollar sign is used for both delimiters,
+as follows:
+.Bd -literal -offset indent
+delim $$
+An equation like $sin pi = 0$ can now be entered
+in the middle of a text input line.
+The special statement
+.Cm delim off
+temporarily disables previously declared delimiters and
+.Cm delim on
+reenables them.
 .It Cm gfont
 Set the default font of subsequent output.
 Its syntax is as follows:
 To unsubscribe send an email to

^ permalink raw reply	[flat|nested] only message in thread

only message in thread, back to index

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-01-10 11:55 mandoc: Document the "delim" syntax and its usage schwarze

Archives are clonable: git clone --mirror

Example config snippet for mirrors

Newsgroup available over NNTP:

AGPL code for this site: git clone