aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJohn Ankarström <john@ankarstrom.se>2020-11-11 16:35:50 +0100
committerJohn Ankarström <john@ankarstrom.se>2020-11-11 16:35:50 +0100
commit2730af405e7a04f1ea3ed0ec81ff3cbcb6330edc (patch)
treea19d42d7e4c51d58da8bed038dc214b01f2163da
parentf6796338ea3b588d2cfbfc9e9a25a5894429a54d (diff)
downloadrf-2730af405e7a04f1ea3ed0ec81ff3cbcb6330edc.tar.gz
regenerate (backslash escapes)
-rw-r--r--index.html31
1 files changed, 23 insertions, 8 deletions
diff --git a/index.html b/index.html
index 579518a..4c3db0d 100644
--- a/index.html
+++ b/index.html
@@ -193,15 +193,30 @@ In a format definition, use a percent (%) sigil followed by a single letter to
.Ff (%a{, %y}). \&quot; Here, ', ' is removed if there is no year.
</pre>
</div>
-<p class="Pp">Note that all fields are inserted literally, except
- <i class="Em">%a</i>, from which the forenames of the authors are
- removed.</p>
-<p class="Pp">Note also that you can use troff requests and other macros in your
- format by starting with a dot. This will expand to a valid request/macro in
- the output of <code class="Nm">rf</code>.</p>
+<p class="Pp">You can include a newline in your format by ending the line with a
+ backslash and continuing on the next line. If you add a backslash
+ immediately following the macro name, the interpolated format will be joined
+ to the preceding line. By using backslashes, you can implement
+ footnote-based references. For example, using the ms macro package:</p>
+<div class="Bd Pp Bd-indent">
+<pre>
+.Fx\ \**\
+.FS\
+%A, {\fI%t\fR}, {\*Q%q\*U}, %y.\
+.FE
+</pre>
+</div>
+<p class="Pp">As you can see above, you can use troff requests and other macros
+ in your format. This will expand to a valid request/macro in the output of
+ <code class="Nm">rf</code>.</p>
+<p class="Pp">Note that all fields are inserted literally, with one exception:
+ when <i class="Em">%a</i> is used in an inline reference format, the
+ forenames of the authors are automatically removed. To include the
+ forenames, use <i class="Em">%A</i> instead.</p>
<p class="Pp">Finally, you usually don't need to worry about excessive spaces
- and stray punctuation marks, as <code class="Nm">rf</code> removes many of
- these these automatically.</p>
+ and stray punctuation marks. <code class="Nm">rf</code> removes common
+ punctuation immediately preceding and following an unsuccessful
+ interpolation.</p>
</section>
<section class="Sh">
<h2 class="Sh" id="EXAMPLE"><a class="permalink" style="color: black; text-decoration: none;" href="#EXAMPLE">EXAMPLE</a></h2>