From cf79f696236666c6f695eb6b7fa9046b5f9fcbc5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?John=20Ankarstr=C3=B6m?= <john@ankarstrom.se>
Date: Wed, 11 Nov 2020 12:56:02 +0100
Subject: clarify manual

---
 rf.1 | 18 +++++++++++-------
 1 file changed, 11 insertions(+), 7 deletions(-)

(limited to 'rf.1')

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 .
-- 
cgit v1.2.3