add example document to manual

1 files changed, 69 insertions, 0 deletions

diff --git a/rf.1 b/rf.1
index 605bac3..d85121b 100644
--- a/rf.1
+++ b/rf.1
@@ -200,6 +200,75 @@ Finally, you usually don't need to worry about excessive spaces and stray punctu
 .Nm
 removes many of these these automatically.
 .
+.Sh EXAMPLE
+Below is an example of an ms-based troff document using
+.Nm rf
+references.
+.Bd -literal -offset indent
+\&.de noop
+\&..
+\&.blm noop
+
+\&.SH
+Previous work
+
+\&.LP
+Davidson
+\&.Rx '' 1991
+has performed a study [...]
+
+\&.PP
+[...] which leads to a higher total cholesterol level
+\&.Rf Smith 2007 .
+
+\&.SH
+Literature
+
+\&.XP
+\&.Ra Davidson, H.
+\&.Ry 1991
+\&.Rt Seminal Work
+\&.Rc London
+\&.Rp Another Press
+
+\&.XP
+\&.Ra Smith, P.
+\&.Ry 2007
+\&.Rt Modern Society
+\&.Rc New York
+\&.Rp Some Press
+.Ed
+.Pp
+When given the above file,
+.Nm
+will output the following code:
+.Bd -literal -offset indent
+\&.de noop
+\&..
+\&.blm noop
+
+\&.SH
+Previous work
+
+\&.LP
+Davidson
+(1991)
+has performed a study [...]
+
+\&.PP
+[...] which leads to a higher total cholesterol level
+(Smith 2007).
+
+\&.SH
+Literature
+
+\&.XP
+Davidson, H. (1991). \\fISeminal Work\\fR. London: Another Press.
+
+\&.XP
+Smith, P. (2007). \\fIModern Society\\fR. New York: Some Press.
+.Ed
+.
 .Sh AUTHORS
 .Nm
 was written by John Ankarström