diff options
Diffstat (limited to 'fref.1')
| -rw-r--r-- | fref.1 | 142 |
1 files changed, 142 insertions, 0 deletions
@@ -0,0 +1,142 @@ +.Dd July 20, 2021 +.Dt FREF 1 +.Os +.Sh NAME +.Nm fref +.Nd format references +. +.Sh SYNOPSIS +.Nm +. +.Sh DESCRIPTION +.Pp +.Nm +is a +.Xr troff 1 +preprocessor that formats reference lists in Harvard style. +It does not handle inline citations. +.Pp +Unlike +.Xr refer 1 , +.Nm +does not re-arrange references. +They are inserted in the places they are specified in the +.Xr troff 1 +source code. +.Pp +.Pa fref.lex +contains a number of hardcoded strings +that should be manually changed +depending on the desired output language: +.Bl -tag -width AVAIL -offset indent +.It AND +.Dq and : +Inserted between next to last and last author. +.It AVAIL +.Dq available : +Inserted before a hypertext reference. +.It ED +.Dq editor : +Inserted before the name of the editor. +.It P +.Dq page : +Inserted before a single page. +.It PP +.Dq pages : +Inserted before multiple pages. +.It TR +.Dq translator : +Inserted before the name of the translator. +.It VOL +.Dq volume : +Inserted before the volume number. +.El +. +.Sh SYNTAX +.Pp +Lines beginning with +.Ql % +(percent) are treated as reference fields. +The percent sign is followed by a two-letter identifier, +signifying the type of field. +The field identifier is followed by a space or tab +and the contents of the field, spanning the rest of the line. +.Pp +The following fields are available: +.Bl -tag -width xxx -offset indent +.It Sy %ad +Access date. +.It Sy %bo +Book. +.It Sy %ci +City. +.It Sy %da +Date (year). +.It Sy %ed +Editor. +.It Sy %hr +Hypertext reference. +.It Sy %jo +Journal. +.It Sy %la +Label. +.It Sy %no +TODO: Issue number. +.It Sy %pp +Pages. +.It Sy %pu +Publisher. +.It Sy %se +TODO: Series. +.It Sy %ti +Title. +.It Sy %tr +Translator. +.It Sy %vo +Volume. +.It Sy %xx +Extra information. +.El +. +.Sh EXAMPLES +.Pp +The following +.Xr troff 1 +source code +.Bd -literal -offset indent +\&.SH +References +\&.XP +%au Baudouin de Courtenay, J. +%da 1972 +%ti The Difference between Phonetics and Psychophonetics +%bo A Baudouin de Courtenay Anthology +%ed T. A. Sebeok et al. +%tr Edward Stankiewicz +%ci Bloomington +%pu Indiana University Press +%xx Extra information +.Ed +.Pp +results in the following output: +.Bd -literal -offset indent +\&.SH +References +\&.XP +Baudouin de Courtenay, J. (1972). +The Difference between Phonetics and Psychophonetics. +\\fIA Baudouin de Courtenay Anthology\\fP (red. T. A. Sebeok et al.). +Övers. Edward Stankiewicz. +Bloomington: Indiana University Press. +Extra information. +.Ed +. +.Sh SEE ALSO +.Pp +.Xr refer 1 +. +.Sh AUTHORS +.Pp +.Nm +is written by John Ankarström +.Aq Mt "john (at) ankarstrom.se" . |