summaryrefslogtreecommitdiffstats
path: root/txr.1
diff options
context:
space:
mode:
authorKaz Kylheku <kaz@kylheku.com>2015-12-13 19:45:03 -0800
committerKaz Kylheku <kaz@kylheku.com>2015-12-13 19:45:03 -0800
commit2d30093f0c679d4c5b18ad3808b93db74199df43 (patch)
tree907dba99e09d720f6f16beab4fd97e63641542cb /txr.1
parent67e5cc234528ee01d75580039de50f36fb3b678c (diff)
downloadtxr-2d30093f0c679d4c5b18ad3808b93db74199df43.tar.gz
txr-2d30093f0c679d4c5b18ad3808b93db74199df43.tar.bz2
txr-2d30093f0c679d4c5b18ad3808b93db74199df43.zip
Clean up formatting in conventions section.
txr.1: Lose the useless use of conditional evaluation. Everything is doable with the meIP macro. Only one piece of conditional evaluation is needed for different wording: textual man page says "angle brackets" whereas formatted page refers to italic font.
Diffstat (limited to 'txr.1')
-rw-r--r--txr.131
1 files changed, 5 insertions, 26 deletions
diff --git a/txr.1 b/txr.1
index d5a76891..4d0796b0 100644
--- a/txr.1
+++ b/txr.1
@@ -10578,12 +10578,11 @@ and functions in \*(TL.
In these sections Syntax is indicated using these conventions:
+.meIP < word
.ie n \{\
-. coIP <word>
A symbol in angle brackets
.\}
.el \{\
-. coIP \f[5]word\f[]
A symbol in
.meta fixed-width-italic
font
@@ -10592,21 +10591,11 @@ denotes some syntactic unit: it
may be a symbol or compound form. The syntactic unit is explained
in the Description section.
-.ie n \{\
-.coIP {syntax}* <word>*
-.\}
-.el \{\
-.coIP {syntax}* \f[5]word\f[]*
-.\}
+.meIP {syntax}* << word *
This indicates a repetition of zero or more of the given
syntax enclosed in the braces or syntactic unit.
-.ie n \{\
-.coIP {syntax}+ <word>+
-.\}
-.el \{\
-.coIP {syntax}+ \f[5]word\f[]+
-.\}
+.meIP {syntax}+ << word +
This indicates a repetition of one or more of the given
syntax enclosed in the braces or syntactic unit.
@@ -10618,24 +10607,14 @@ or
.code *
repetition.
-.ie n \{\
-.coIP [syntax] [<word>]
-.\}
-.el \{\
-.coIP [syntax] [\f[5]word\f[]]
-.\}
+.meIP [syntax] <> [ word ]
Square brackets indicate optional syntax.
.coIP alternative1 | alternative2 | ... | alternativeN
Multiple syntactic variations allowed in one place are
indicated as bar-separated items.
-.ie n \{\
-.coIP syntax @ -> <result>
-.\}
-.el \{\
-.coIP syntax @ -> [\f[5]result\f[]]
-.\}
+.meIP syntax -> < result
The arrow notation is used in examples to indicate that the evaluation
of the given syntax produces a value, whose printed representation is
.metn result .