summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorKaz Kylheku <kaz@kylheku.com>2021-03-31 20:39:12 -0700
committerKaz Kylheku <kaz@kylheku.com>2021-03-31 20:39:12 -0700
commit6adf9be563ef029dd759d489849bafd239c4189b (patch)
treeddba146f63d88b25598fef13d42ba9a2c319bb4a
parentc7907eeebcd654271cd4819c3f338fc61e60e5b8 (diff)
downloadtxr-6adf9be563ef029dd759d489849bafd239c4189b.tar.gz
txr-6adf9be563ef029dd759d489849bafd239c4189b.tar.bz2
txr-6adf9be563ef029dd759d489849bafd239c4189b.zip
doc: formatting of notes under circle, erase notation.
* txr.1: Don't use TP* for notes and dialect notes because it doesn't fit these paragraphs that don't have an indented margin.
-rw-r--r--txr.110
1 files changed, 7 insertions, 3 deletions
diff --git a/txr.1 b/txr.1
index f8c90a4e..3541ee51 100644
--- a/txr.1
+++ b/txr.1
@@ -12421,8 +12421,10 @@ and is applied to an object which either encloses the reference,
or lexically precedes the reference. Forward references such as
.code "(#1# #1=(1 2))"
are not supported.
+.PP
+
+Note:
-.TP* "Note:"
Circular notation can span hash table literals. The syntax
.code "#1=#H((:eql-based) (#1# #1#))"
denotes an
@@ -12435,7 +12437,8 @@ hash tables. The analogous syntax
.code "#1=#H(() (#1# #1#))"
produces a hash table in an inconsistent state.
-.TP* "Dialect note:"
+Dialect Note:
+
Circle notation is taken from Common Lisp,
intended to be unsurprising to users familiar with that
language.
@@ -12454,8 +12457,9 @@ in TXR Lisp indicates that the expression
is to be read and then discarded, as if it were replaced by whitespace.
This is useful for temporarily "commenting out" an expression.
+.PP
+Notes:
-.TP* Notes:
Whereas it is valid for a \*(TL source file to be empty, it is
a syntax error if a \*(TL source file contains nothing but one or more
objects which are each suppressed by a preceding