diff options
author | Paul A. Patience <paul@apatience.com> | 2022-02-09 08:28:02 +0000 |
---|---|---|
committer | Kaz Kylheku <kaz@kylheku.com> | 2022-02-09 13:06:40 -0800 |
commit | 1c26268239530d58baebfbb43dcdc39b4bf5982b (patch) | |
tree | 3d1c692b65ab87e1c247a958f8f360d7b103fa81 /txr.1 | |
parent | 32a730285a7da8d9f784b29779294af700c409ff (diff) | |
download | txr-1c26268239530d58baebfbb43dcdc39b4bf5982b.tar.gz txr-1c26268239530d58baebfbb43dcdc39b4bf5982b.tar.bz2 txr-1c26268239530d58baebfbb43dcdc39b4bf5982b.zip |
doc: fix issues in arguments to .I macros.
* txr.1: Correct .I to .IR when the arguments include trailing
punctuation. Add quotes around multiword .I and .IR arguments to
be consistent everywhere. Unitalicize "de facto". Fix accidental
trailing sentence.
Diffstat (limited to 'txr.1')
-rw-r--r-- | txr.1 | 22 |
1 files changed, 11 insertions, 11 deletions
@@ -14487,10 +14487,10 @@ some form known as a and the corresponding environment is instantiated during the evaluation of that construct. There also exist bindings outside of any binding construct, in the so-called -.I global environment . +.IR "global environment" . Bindings in the global environment can be temporarily shadowed by lexically-established binding in the -.I dynamic environment . +.IR "dynamic environment" . See the Special Variables section above. Certain special symbols cannot be used as variable names, namely the @@ -22338,7 +22338,7 @@ expression. .syne .desc The -.I a-d accessors +.I "a-d accessors" provide a shorthand notation for accessing two to five levels deep into a cons-cell-based tree structure. For instance, the the equivalent of the nested function call expression @@ -50347,7 +50347,7 @@ symbols must be specified for a useful effect to take place. If exactly two symbols are specified, then, subject to error checks, .code defex makes the left symbol an -.I exception subtype +.I "exception subtype" of the right symbol. This behavior generalizes to three or more arguments: if three or more symbols @@ -60267,7 +60267,7 @@ is reduced to .strn "/" . The resulting trimmed path is the -.I "effective path" . +.IR "effective path" . If the effective path is an empty string, then .code dir-name @@ -62225,9 +62225,8 @@ type, the object inherits the type tag from the FFI type. Although .code cptr objects are conceptually non-aggregate values, corresponding to pointers, -they are -.I "de facto" -aggregates due to their implementation as references to heap objects. +they are de facto aggregates +due to their implementation as references to heap objects. When a .code cptr object is passed to a foreign function by pointer, for @@ -67836,7 +67835,7 @@ options and others. The .code *args-eff* variable holds the list of -.I "effective arguments" , +.IR "effective arguments" , which is the argument list after these transformations are applied. This variable is established and set to the same value as .code *args-full* @@ -77217,7 +77216,7 @@ Depending on whether the tentative pathname is suffixed, .code load tries to make one or more attempts to open several variations of that name. These variations are called -.I "actual paths" . +.IR "actual paths" . If any attempt fails due to an error other than non-existence, such as a permission error, then no further attempts are made; the error exception propagates to @@ -81890,7 +81889,8 @@ If denotes an incomplete array or structure type, and the .meta object-expr argument is present, then a -.I "dynamic size" is computed: the actual number of bytes required to store +.I "dynamic size" +is computed: the actual number of bytes required to store that object value as a foreign representation. The |