aboutsummaryrefslogtreecommitdiff
path: root/rf.1
diff options
context:
space:
mode:
Diffstat (limited to 'rf.1')
-rw-r--r--rf.118
1 files changed, 11 insertions, 7 deletions
diff --git a/rf.1 b/rf.1
index a3461fc..605bac3 100644
--- a/rf.1
+++ b/rf.1
@@ -50,7 +50,7 @@ On my HP Compaq dc5700 from 2007, the relationship between number of entries in
.It 182 Ta 0.24s
.El
.Pp
-I would deem it rare to have more than a couple of hundred references in a troff document.
+I would deem it rare to have more than a couple of hundred unique references in a troff document.
.
.Sh USAGE
.Nm
@@ -168,11 +168,12 @@ Defines the
of publication.
.El
.Pp
-Of these macros,
-.Sy \&Ra
-and
-.Sy \&Ry
-are the most important.
+In the final output,
+.Nm
+prints a formatted version of each reference entry in place of its definition.
+.Nm
+does not change the order of reference entries.
+This means that you can arrange your references freely.
.Sh FORMAT SYNTAX
In a format definition, use a percent (%)
sigil followed by a single letter to interpolate any given field of the reference.
@@ -192,6 +193,9 @@ Note that all fields are inserted literally, except
.Em %a ,
from which the forenames of the authors are removed.
.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
+.Nm .
+.Pp
Finally, you usually don't need to worry about excessive spaces and stray punctuation marks, as
.Nm
removes many of these these automatically.
@@ -199,4 +203,4 @@ removes many of these these automatically.
.Sh AUTHORS
.Nm
was written by John Ankarström
-.Aq Mt john (on) ankarstrom.se .
+.Aq Mt john (at) ankarstrom.se .