Debian Codegraph @

upstream/debian-unstable/man1/refer.1

raw
1 .TH \%refer 1 "2026-04-22" "groff 1.24.1"
2 .SH Name
3 \%refer \- process bibliographic references for
4 .I groff
5 .
6 .
7 .\" ====================================================================
8 .\" Legal Terms
9 .\" ====================================================================
10 .\"
11 .\" Copyright (C) 1989-2024 Free Software Foundation, Inc.
12 .\"
13 .\" Permission is granted to make and distribute verbatim copies of this
14 .\" manual provided the copyright notice and this permission notice are
15 .\" preserved on all copies.
16 .\"
17 .\" Permission is granted to copy and distribute modified versions of
18 .\" this manual under the conditions for verbatim copying, provided that
19 .\" the entire resulting derived work is distributed under the terms of
20 .\" a permission notice identical to this one.
21 .\"
22 .\" Permission is granted to copy and distribute translations of this
23 .\" manual into another language, under the above conditions for
24 .\" modified versions, except that this permission notice may be
25 .\" included in translations approved by the Free Software Foundation
26 .\" instead of in the original English.
27 .
28 .
29 .\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
30 .do nr *groff_refer_1_man_C \n[.cp]
31 .cp 0
32 .
33 .\" Define fallback for groff 1.23's MR macro if the system lacks it.
34 .nr do-fallback 0
35 .if !\n(.f .nr do-fallback 1 \" mandoc
36 .if \n(.g .if !d MR .nr do-fallback 1 \" older groff
37 .if !\n(.g .nr do-fallback 1 \" non-groff *roff
38 .if \n[do-fallback] \{\
39 . de MR
40 . ie \\n(.$=1 \
41 . I \%\\$1
42 . el \
43 . IR \%\\$1 (\\$2)\\$3
44 . .
45 .\}
46 .rr do-fallback
47 .
48 .
49 .\" ====================================================================
50 .SH Synopsis
51 .\" ====================================================================
52 .
53 .SY \%refer
54 .RB [ \-bCenPRS ]
55 .RB [ \-a\~\c
56 .IR n ]
57 .RB [ \-B
58 .IB field . macro\c
59 ]
60 .RB [ \-c\~\c
61 .IR fields ]
62 .RB [ \-f\~\c
63 .IR n ]
64 .RB [ \-i\~\c
65 .IR fields ]
66 .RB [ \-k\~\c
67 .IR field ]
68 .RB [ \-l\~\c
69 .IR range-expression ]
70 .RB [ \-p\~\c
71 .IR database-file ]
72 .RB [ \-s\~\c
73 .IR fields ]
74 .RB [ \-t\~\c
75 .IR n ]
76 .RI [ file\~ .\|.\|.]
77 .YS
78 .
79 .
80 .P
81 .SY \%refer
82 .B \-\-help
83 .YS
84 .
85 .
86 .P
87 .SY \%refer
88 .B \-v
89 .YS
90 .
91 .SY \%refer
92 .B \%\-\-version
93 .YS
94 .
95 .
96 .\" ====================================================================
97 .SH Description
98 .\" ====================================================================
99 .
100 The GNU implementation of
101 .I \%refer \" generic
102 is part of the
103 .MR groff 1
104 document formatting system.
105 .
106 .I \%refer
107 is a
108 .MR \%troff 1
109 preprocessor that prepares bibliographic citations by looking up
110 keywords specified in a
111 .MR roff 7
112 input document,
113 obviating the need to type such annotations,
114 and permitting the citation style in formatted output to be altered
115 independently and systematically.
116 .
117 It copies the contents of each
118 .I file
119 to the standard output stream,
120 looking up each
121 .I citation
122 between lines starting with
123 .B .[
124 and
125 .B .]\&
126 and replacing it with a bibliographic reference.
127 .
128 GNU
129 .I refer \" GNU
130 furthermore interprets lines between those starting with
131 .B .R1
132 and
133 .B .R2
134 as instructions directing how citations are to be processed.
135 .
136 .I \%refer
137 interprets and generates
138 .I roff
139 .B lf
140 requests so that file names and line numbers in messages produced by
141 commands that read its output correctly describe the source document.
142 .
143 Normally,
144 .I \%refer
145 is not executed directly by the user,
146 but invoked by specifying the
147 .B \-R
148 option to
149 .MR groff 1 .
150 .
151 If no
152 .I file
153 operands are present,
154 or if
155 .I file
156 is
157 .RB \[lq] \- \[rq],
158 .I \%refer
159 reads the standard input stream.
160 .
161 .
162 .P
163 A citation identifies a work by reference to a
164 .I "bibliographic record"
165 detailing it.
166 .
167 Select a work from a database of records by listing keywords that
168 uniquely identify its entry.
169 .
170 Alternatively,
171 a document can specify a record for the work at the point its citation
172 occurs.
173 .
174 A document can use either or both strategies as desired.
175 .
176 .
177 .P
178 For each citation,
179 .I \%refer
180 produces a
181 .I mark
182 in the text,
183 like a superscripted footnote number or \[lq][Lesk1978a]\[rq].
184 .
185 A mark consists of a
186 .I label
187 between
188 .I brackets.
189 .
190 The mark can be separated from surrounding text
191 and from other labels in various ways.
192 .
193 .I \%refer
194 produces
195 .I roff
196 language requests usable by a document or a macro package
197 such as
198 .\" .IR man ,
199 .IR me ,
200 .IR mm ,
201 .IR mom ,
202 or
203 .I ms
204 to produce a formatted reference for each citation.
205 .
206 A citation's reference can be output immediately after it occurs
207 (as with footnotes),
208 or references may
209 .IR accumulate ,
210 with corresponding output appearing later in the document
211 (as with endnotes).
212 .
213 When references accumulate,
214 multiple citations of the same reference produce a single formatted
215 entry.
216 .
217 .
218 .P
219 Interpretation of lines between
220 .B .R1
221 and
222 .B .R2
223 tokens as preprocessor commands is a GNU
224 .I \%refer \" GNU
225 extension.
226 .
227 Documents employing this feature can still be processed by AT&T
228 .I \%refer \" AT&T
229 by adding the lines
230 .
231 .RS
232 .EX
233 \&.de R1
234 \&.ig R2
235 \&..
236 .EE
237 .RE
238 .
239 to the beginning of the document.
240 .
241 The foregoing input causes
242 .I troff \" generic
243 to ignore everything between
244 .B .R1
245 and
246 .BR .R2 .
247 .
248 The effects of some
249 .I \%refer \" generic
250 commands can be achieved by command-line options;
251 these are supported for compatibility with AT&T
252 .IR \%refer . \" AT&T
253 .
254 It is usually more convenient to use commands.
255 .
256 .
257 .\" ====================================================================
258 .SS "Bibliographic records"
259 .\" ====================================================================
260 .
261 A bibliographic record describes a referenced work in sufficient detail
262 that it may be cited to accepted standards of scholarly and professional
263 clarity.
264 .
265 The record format permits annotation and extension that a document may
266 use or ignore.
267 .
268 A record is a plain text sequence of
269 .I fields,
270 one per line,
271 each consisting of a percent sign
272 .BR % ,
273 an alphanumeric character classifying it,
274 one space,
275 and its contents.
276 .
277 If a field's contents are empty,
278 the field is ignored.
279 .
280 .
281 .P
282 Frequently,
283 such records are organized into a
284 .I "bibliographic database,"
285 with each entry separated by blank lines or file boundaries.
286 .
287 This practice relieves documents of the need to maintain bibliographic
288 data themselves.
289 .
290 The programs
291 .MR \%lookbib 1
292 and
293 .MR lkbib 1
294 consult a bibliographic database,
295 and
296 .MR \%indxbib 1
297 indexes one to speed retrieval from it,
298 reducing document processing time.
299 .
300 Use of these tools is optional.
301 .
302 .
303 .br
304 .ne 4v
305 .P
306 The conventional uses of the bibliographic field entries are as
307 follows.
308 .
309 Within a record,
310 fields other than
311 .B %A
312 and
313 .B %E
314 replace previous occurrences thereof.
315 .
316 The ordering of multiple
317 .B %A
318 and
319 .B %E
320 fields is significant.
321 .
322 .
323 .TP
324 .B %A
325 names an author.
326 .
327 If the name contains a suffix such as \[lq]Jr.\&\[rq]
328 or \[lq]III\[rq],
329 it should be separated from the surname by a comma.
330 .
331 We recommend always supplying an
332 .B %A
333 field or a
334 .B %Q
335 field.
336 .
337 .
338 .TP
339 .B %B
340 records the title of the book within which a cited article
341 is collected.
342 .
343 See
344 .B %J
345 and
346 .BR %T .
347 .
348 .
349 .TP
350 .B %C
351 names the city or other place of publication.
352 .
353 .
354 .TP
355 .B %D
356 indicates the date of publication.
357 .
358 Specify the year in full.
359 .\" even if the title of the conference proceedings abbreviates it
360 .
361 If the month is specified,
362 use its name rather than its number;
363 only the first three letters are required.
364 .
365 We recommend always supplying a
366 .B %D
367 field;
368 if the date is unknown,
369 use
370 .RB \[lq] "in press" \[rq]
371 or
372 .RB \[lq] unknown \[rq]
373 as its contents.
374 .
375 .
376 .TP
377 .B %E
378 names an editor of the book within which a cited article is collected.
379 .
380 Where a work has editors but no authors,
381 name the editors in
382 .B %A
383 fields and append
384 .RB \[lq] ,\~(ed.)\& \[rq]
385 or
386 .RB \[lq] ,\~(eds.)\& \[rq]
387 to the last of these.
388 .
389 .
390 .TP
391 .B %G
392 records the U.S.\& government ordering number,
393 ISBN,
394 DOI,
395 or other unique identifier.
396 .
397 .
398 .TP
399 .B %I
400 names the publisher (issuer).
401 .
402 .
403 .TP
404 .B %J
405 records the name of the journal within which a cited article is
406 collected.
407 .
408 See
409 .B %B
410 and
411 .BR %T .
412 .
413 .
414 .TP
415 .B %K
416 lists keywords intended to aid searches.
417 .
418 .
419 .TP
420 .B %L
421 is a label;
422 typically unused in database entries,
423 it can override the label format otherwise determined.
424 .
425 .
426 .TP
427 .B %N
428 records the issue number of the journal within which a cited article
429 is collected.
430 .
431 .
432 .TP
433 .B %O
434 presents additional (\[lq]other\[rq]) information,
435 typically placed at the end of the reference.
436 .
437 .
438 .TP
439 .B %P
440 lists the page numbers of a cited work that is part of a larger
441 collection.
442 .
443 Specify a range with
444 .IB m \- \c
445 .IR n .
446 .\" XXX: Why not \[en]? Does that break?
447 .
448 .
449 .TP
450 .B %Q
451 names an institutional author when no
452 .B %A
453 fields are present.
454 .
455 Only one
456 .B %Q
457 field is permitted.
458 .
459 .
460 .TP
461 .B %R
462 is an identifier for a report,
463 thesis,
464 memorandum,
465 or other unpublished work.
466 .
467 .
468 .TP
469 .B %S
470 records the title of a series to which the cited work belongs.
471 .
472 .
473 .TP
474 .B %T
475 is the work's title.
476 .
477 See
478 .B %B
479 and
480 .BR %J .
481 .
482 .
483 .TP
484 .B %V
485 is the volume number of the journal or book containing the cited work.
486 .
487 .
488 .TP
489 .B %X
490 is an annotation.
491 .
492 By convention,
493 it is not formatted in the citing document.
494 .
495 .
496 .P
497 If the obsolescent \[lq]accent strings\[rq] feature of the
498 .I ms
499 or
500 .I me
501 macro packages is used,
502 such strings should follow the character to be accented;
503 an
504 .I ms
505 document must call the
506 .B AM
507 macro before using them.
508 .
509 Do not quote accent strings:
510 use one
511 .B \e
512 rather than two.
513 .
514 See
515 .MR groff_char 7
516 for a modern approach to the problem of diacritics.
517 .
518 .
519 .\" ====================================================================
520 .SS Citations
521 .\" ====================================================================
522 .
523 Citations have a characteristic format.
524 .
525 .RS
526 .EX
527 .BI .[ opening-text
528 .IR "flags keyword\~" .\|.\|.
529 .I field
530 \&.\|.\|.
531 .BI .] closing-text
532 .EE
533 .RE
534 .
535 .
536 .P
537 .IR opening-text ,
538 .IR closing-text ,
539 and
540 .I flags
541 are optional,
542 and only one
543 .I keyword
544 or
545 .I field
546 need be specified.
547 .
548 If keywords are present,
549 .I \%refer
550 searches the bibliographic database(s) for a unique reference matching
551 them.
552 .
553 Multiple matches are an error;
554 add more keywords to disambiguate the reference.
555 .
556 In the absence of keywords,
557 .I fields
558 constitute the bibliographic record.
559 .
560 Otherwise,
561 .I fields
562 specify additional data to replace or supplement those in the reference.
563 .
564 When references are accumulating and keywords are present,
565 specify
566 additional
567 .I fields
568 at most on the first citation of a particular
569 reference;
570 they apply to all further citations thereof.
571 .
572 .
573 .br
574 .ne 2v
575 .P
576 .I opening-text
577 and
578 .I closing-text
579 are
580 .I roff
581 input used to bracket the label,
582 overriding the
583 .B \%bracket\-label
584 command.
585 .
586 Leading and trailing spaces are significant.
587 .
588 If either of these is non-empty,
589 the corresponding argument to the
590 .B \%bracket\-label
591 command is not used;
592 alter this behavior with the
593 .B [
594 and
595 .B ]
596 .I flags.
597 .
598 .
599 .br
600 .ne 3v
601 .P
602 .I flags
603 is a list of non-alphanumeric characters each of which modifies the
604 treatment of the particular citation.
605 .
606 AT&T
607 .I \%refer \" AT&T
608 ignores them since they are non-alphanumeric.
609 .
610 They direct GNU
611 .I \%refer \" GNU
612 as follows.
613 .
614 .
615 .TP
616 .B #
617 Use the label specified by the
618 .B \%short\-label
619 command,
620 if any.
621 .
622 .I \%refer
623 otherwise uses the normal label.
624 .
625 Typically,
626 a short label implements author-date citation styles consisting of a
627 name,
628 a year,
629 and a disambiguating letter if necessary.
630 .
631 .RB \[lq] # \[rq]
632 is meant to suggest such a (quasi-)numeric label.
633 .
634 .
635 .TP
636 .B [
637 Precede
638 .I opening-text
639 with the first argument given to the
640 .B \%bracket\-label
641 command.
642 .
643 .
644 .TP
645 .B ]
646 Follow
647 .I closing-text
648 with the second argument given to the
649 .B \%bracket\-label
650 command.
651 .
652 .
653 .P
654 An advantage of the
655 .B [
656 and
657 .B ]
658 flags over use of
659 .I opening-text
660 and
661 .I closing-text
662 is that you can update the document's bracketing style in one place
663 using the
664 .B \%bracket\-label
665 command.
666 .
667 Another is that sorting and merging of citations is not necessarily
668 inhibited if the flags are used.
669 .
670 .
671 .P
672 .I \%refer
673 appends any label resulting from a citation to the
674 .I roff
675 input line preceding the
676 .B .[
677 token.
678 .
679 If there is no such line,
680 .I \%refer
681 issues a warning diagnostic.
682 .
683 .
684 .P
685 There is no special notation for citing multiple references in series.
686 .
687 Use a sequence of citations,
688 one for each reference,
689 with nothing between them.
690 .
691 .I \%refer
692 attaches all of their labels to the line preceding the first.
693 .
694 These labels may be sorted or merged.
695 .
696 See the description of the
697 .B <>
698 label expression,
699 and of the
700 .B \%sort\-adjacent\-labels
701 and
702 .B \%abbreviate\-label\-ranges
703 commands.
704 .
705 A label is not merged if its citation has a non-empty
706 .I opening-text
707 or
708 .IR closing-text .
709 .
710 However,
711 the labels for two adjacent citations,
712 the former using the
713 .B ]
714 flag and without any
715 .I closing-text,
716 and the latter using the
717 .B [
718 flag and without any
719 .I opening-text,
720 may be sorted and merged
721 even if the former's
722 .I opening-text
723 or the latter's
724 .I closing-text
725 is non-empty.
726 .
727 (To prevent these operations,
728 use the dummy character escape sequence
729 .B \[rs]&
730 as the former's
731 .IR closing-text .)
732 .
733 .
734 .\" ====================================================================
735 .SS Commands
736 .\" ====================================================================
737 .
738 Commands are contained between lines starting with
739 .B .R1
740 and
741 .BR .R2 .
742 .
743 The
744 .B \-R
745 option prevents recognition of these lines.
746 .
747 When
748 .I \%refer
749 encounters a
750 .B .R1
751 line,
752 it
753 flushes any accumulated references.
754 .
755 Neither
756 .B .R1
757 nor
758 .B .R2
759 lines,
760 nor anything between them,
761 is output.
762 .
763 .
764 .P
765 Commands are separated by newlines or semicolons.
766 .
767 A number sign
768 .RB ( # )
769 introduces a comment that extends to the end of the line,
770 but does not conceal the newline.
771 .
772 Each command is broken up into words.
773 .
774 Words are separated by spaces or tabs.
775 .
776 A word that begins with a (neutral) double quote
777 .RB ( \[dq] )
778 extends to the next double quote that is not followed by another double
779 quote.
780 .
781 If there is no such double quote,
782 the word extends to the end of the line.
783 .
784 Pairs of double quotes in a word beginning with a double quote collapse
785 to one double quote.
786 .
787 Neither a number sign nor a semicolon is recognized inside double
788 quotes.
789 .
790 A line can be continued by ending it with a backslash
791 .RB \[lq]\^ \[rs] \[rq];
792 this works everywhere except after a number sign.
793 .
794 .
795 .LP
796 .ds n \fR*\fP\"
797 Each command
798 .I name
799 that is marked with \*n has an associated negative command
800 .BI no\- name
801 that undoes the effect of
802 .IR name .
803 .
804 For example,
805 the
806 .B no\-sort
807 command specifies that references should not be sorted.
808 .
809 The negative commands take no arguments.
810 .
811 .
812 .LP
813 In the following description each argument must be a single word;
814 .I field
815 is used for a single upper or lower case letter naming a field;
816 .I fields
817 is used for a sequence of such letters;
818 .I m
819 and
820 .I n
821 are used for a non-negative numbers;
822 .I string
823 is used for an arbitrary string;
824 .I file
825 is used for the name of a file.
826 .
827 .
828 .TP
829 .BI abbreviate\*n\~ fields\~string1\~string2\~string3\~string4
830 Abbreviate the first names of
831 .IR fields .
832 .
833 An initial letter will be separated from another initial letter by
834 .IR string1 ,
835 from the surname by
836 .IR string2 ,
837 and from anything else
838 (such as \[lq]von\[rq] or \[lq]de\[rq])
839 by
840 .IR string3 .
841 .
842 These default to a period followed by a space.
843 .
844 In a hyphenated first name,
845 the initial of the first part of the name will be separated from the
846 hyphen by
847 .IR string4 ;
848 this defaults to a period.
849 .
850 No attempt is made to handle any ambiguities that might
851 result from abbreviation.
852 .
853 Names are abbreviated before sorting and before label construction.
854 .
855 .
856 .TP
857 .BI abbreviate\-label\-ranges\*n\~ string
858 .
859 Three or more adjacent labels that refer to consecutive references
860 will be abbreviated to a label consisting of the first label,
861 followed by
862 .IR string ,
863 followed by the last label.
864 .
865 This is mainly useful with numeric labels.
866 .
867 If
868 .I string
869 is omitted,
870 it defaults to
871 .RB \[lq] \- \[rq].
872 .
873 .
874 .TP
875 .B accumulate\*n
876 Accumulate references instead of writing out each reference
877 as it is encountered.
878 .
879 Accumulated references will be written out whenever a reference
880 of the form
881 .
882 .RS
883 .RS
884 .EX
885 .B .[
886 .B $LIST$
887 .B .]
888 .EE
889 .RE
890 .
891 is encountered,
892 after all input files have been processed,
893 and whenever a
894 .B .R1
895 line is recognized.
896 .RE
897 .
898 .
899 .TP
900 .BI annotate\*n\~ "field string"
901 .I field
902 is an annotation;
903 print it at the end of the reference as a paragraph preceded by the line
904 .
905 .RS
906 .IP
907 .BI . string
908 .
909 .
910 .LP
911 If
912 .I string
913 is omitted,
914 it will default to
915 .BR AP ;
916 if
917 .I field
918 is also omitted it will default to
919 .BR X .
920 .
921 Only one field can be an annotation.
922 .RE
923 .
924 .
925 .TP
926 .BI articles\~ string\~\c
927 \&.\|.\|.
928 Each
929 .I string
930 is a definite or indefinite article,
931 and should be ignored at the beginning of
932 .B T
933 fields when sorting.
934 .
935 Initially,
936 \[lq]a\[rq],
937 \[lq]an\[rq],
938 and
939 \[lq]the\[rq] are recognized as articles.
940 .
941 .
942 .TP
943 .BI bibliography\~ file\~\c
944 \&.\|.\|.
945 .
946 Write out all the references contained in each bibliographic database
947 .IR file .
948 .
949 This command should come last in an
950 .BR .R1 / .R2
951 block.
952 .
953 .
954 .TP
955 .BI bracket\-label\~ "string1 string2 string3"
956 In the text,
957 bracket each label with
958 .I string1
959 and
960 .IR string2 .
961 .
962 An occurrence of
963 .I string2
964 immediately followed by
965 .I string1
966 will be turned into
967 .IR string3 .
968 .
969 The default behavior is as follows.
970 .
971 .RS \" RS twice to get inboard of the tagged paragraph indentation.
972 .RS
973 .EX
974 bracket\-label \e*([. \e*(.] \[dq], \[dq]
975 .EE
976 .RE
977 .RE
978 .
979 .
980 .TP
981 .BI capitalize\~ fields
982 Convert
983 .I fields
984 to caps and small caps.
985 .
986 .
987 .TP
988 .B compatible\*n
989 Recognize
990 .B .R1
991 and
992 .B .R2
993 even when followed by a character other than space or newline.
994 .
995 .
996 .TP
997 .BI database\~ file\~\c
998 \&.\|.\|.
999 Search each bibliographic database
1000 .IR file .
1001 .
1002 For each
1003 .IR file ,
1004 if an index
1005 .RI file \%.i
1006 created by
1007 .MR \%indxbib 1
1008 exists,
1009 then it will be searched instead;
1010 each index can cover multiple databases.
1011 .
1012 .
1013 .TP
1014 .BI date\-as\-label\*n\~ string
1015 .I string
1016 is a label expression that specifies a string with which to replace the
1017 .B D
1018 field after constructing the label.
1019 .
1020 See subsection \[lq]Label expressions\[rq] below for a description of
1021 label expressions.
1022 .
1023 This command is useful if you do not want explicit labels in the
1024 reference list,
1025 but instead want to handle any necessary disambiguation by qualifying
1026 the date in some way.
1027 .
1028 The label used in the text would typically be some combination of the
1029 author and date.
1030 .
1031 In most cases you should also use the
1032 .B \%no\-label\-in\-reference
1033 command.
1034 .
1035 For example,
1036 .
1037 .RS \" RS twice to get inboard of the tagged paragraph indentation.
1038 .RS
1039 .EX
1040 date\-as\-label D.+yD.y%a*D.\-y
1041 .EE
1042 .RE
1043 .
1044 would attach a disambiguating letter to the year part of the
1045 .B D
1046 field in the reference.
1047 .RE
1048 .
1049 .
1050 .TP
1051 .B default\-database\*n
1052 The default database should be searched.
1053 .
1054 This is the default behavior,
1055 so the negative version of this command is more useful.
1056 .
1057 .I \%refer
1058 determines whether the default database should be searched
1059 on the first occasion that it needs to do a search.
1060 .
1061 Thus a
1062 .B \%no\-default\-database
1063 command must be given before then,
1064 in order to be effective.
1065 .
1066 .
1067 .TP
1068 .BI discard\*n\~ fields
1069 When the reference is read,
1070 .I fields
1071 should be discarded;
1072 no string definitions for
1073 .I fields
1074 will be output.
1075 .
1076 Initially,
1077 .I fields
1078 are
1079 .BR XYZ .
1080 .
1081 .
1082 .TP
1083 .BI et\-al\*n\~ "string m n"
1084 Configure use of
1085 .RB \[lq] "et al" \[rq]
1086 in the evaluation of
1087 .B @
1088 expressions in label expressions.
1089 .
1090 If
1091 .I u
1092 is the number of authors needed to make the author sequence unambiguous
1093 and the total number of authors is
1094 .I t,
1095 then the last
1096 .IR t \|\-\| u
1097 authors will be replaced by
1098 .I string
1099 provided that
1100 .IR t \|\-\| u
1101 is not less than
1102 .I m
1103 and
1104 .I t
1105 is not less than
1106 .IR n .
1107 .
1108 The default behavior is as follows.
1109 .
1110 .RS \" RS twice to get inboard of the tagged paragraph indentation.
1111 .RS
1112 .EX
1113 et\-al " et al" 2 3
1114 .EE
1115 .RE
1116 .
1117 Note the absence of a dot from the end of the abbreviation,
1118 which is arguably not correct.
1119 .
1120 .RI ( "Et al" [.]
1121 is short for
1122 .IR "et alli" ,
1123 as
1124 .I etc.\&
1125 is short for
1126 .IR "et cetera".)
1127 .RE
1128 .
1129 .
1130 .TP
1131 .BI include\~ file
1132 Include
1133 .I file
1134 and interpret the contents as commands.
1135 .
1136 .
1137 .TP
1138 .BI join\-authors\~ "string1 string2 string3"
1139 Join multiple authors together with
1140 .IR string s.
1141 .
1142 When there are exactly two authors,
1143 they will be joined with
1144 .IR string1 .
1145 .
1146 When there are more than two authors,
1147 all but the last two will be joined with
1148 .IR string2 ,
1149 and the last two authors will be joined with
1150 .IR string3 .
1151 .
1152 If
1153 .I string3
1154 is omitted,
1155 it will default to
1156 .IR string1 ;
1157 if
1158 .I string2
1159 is also omitted it will also default to
1160 .IR string1 .
1161 .
1162 For example,
1163 .
1164 .RS
1165 .RS
1166 .EX
1167 join\-authors \[dq] and \[dq] \[dq], \[dq] \[dq], and \[dq]
1168 .EE
1169 .RE
1170 .
1171 will restore the default method for joining authors.
1172 .RE
1173 .
1174 .
1175 .TP
1176 .B label\-in\-reference\*n
1177 When outputting the reference,
1178 define the string
1179 .B [F
1180 to be the reference's label.
1181 .
1182 This is the default behavior,
1183 so the negative version of this command is more useful.
1184 .
1185 .
1186 .TP
1187 .B label\-in\-text\*n
1188 For each reference output a label in the text.
1189 .
1190 The label will be separated from the surrounding text as described in
1191 the
1192 .B \%bracket\-label
1193 command.
1194 .
1195 This is the default behavior,
1196 so the negative version of this command is more useful.
1197 .
1198 .
1199 .TP
1200 .BI label\~ string
1201 .I string
1202 is a label expression describing how to label each reference.
1203 .
1204 .
1205 .TP
1206 .BI separate\-label\-second\-parts\~ string
1207 When merging two-part labels,
1208 separate the second part of the second label from the first label with
1209 .IR string .
1210 .
1211 See the description of the
1212 .B <>
1213 label expression.
1214 .
1215 .
1216 .TP
1217 .B move\-punctuation\*n
1218 In the text,
1219 move any punctuation at the end of line past the label.
1220 .
1221 We recommend employing this command unless you are using superscripted
1222 numbers as labels.
1223 .
1224 .
1225 .TP
1226 .BI reverse\*n\~ string
1227 Reverse the fields whose names
1228 are in
1229 .IR string .
1230 .
1231 An optional integer after a field name limits the number of such fields
1232 to the given count;
1233 no integer means no limit.
1234 .
1235 .
1236 .TP
1237 .BI search\-ignore\*n\~ fields
1238 While searching for keys in databases for which no index exists,
1239 ignore the contents of
1240 .IR fields .
1241 .
1242 Initially,
1243 fields
1244 .B XYZ
1245 are ignored.
1246 .
1247 .
1248 .TP
1249 .BI search\-truncate\*n\~ n
1250 Only require the first
1251 .I n
1252 characters of keys to be given.
1253 .
1254 In effect when searching for a given key words in the database are
1255 truncated to the maximum of
1256 .I n
1257 and the length of the key.
1258 .
1259 Initially,
1260 .I n
1261 is\~6.
1262 .
1263 .
1264 .TP
1265 .BI short\-label\*n\~ string
1266 .I string
1267 is a label expression that specifies an alternative
1268 (usually shorter)
1269 style of label.
1270 .
1271 This is used when the
1272 .B #
1273 flag is given in the citation.
1274 .
1275 When using author-date style labels,
1276 the identity of the author or authors is sometimes clear from the
1277 context,
1278 and so it may be desirable to omit the author or authors from the label.
1279 .
1280 The
1281 .B \%short\-label
1282 command will typically be used to specify a label containing just
1283 a date and possibly a disambiguating letter.
1284 .
1285 .
1286 .TP
1287 .BI sort\*n\~ string
1288 Sort references according to
1289 .IR string .
1290 .
1291 References will automatically be accumulated.
1292 .
1293 .I string
1294 should be a list of field names,
1295 each followed by a number,
1296 indicating how many fields with the name should be used for sorting.
1297 .
1298 .RB \[lq] + \[rq]
1299 can be used to indicate that all the fields with the name should be
1300 used.
1301 .
1302 Also
1303 .B .\&
1304 can be used to indicate the references should be sorted using the
1305 (tentative) label.
1306 .
1307 (Subsection \[lq]Label expressions\[rq] below describes the concept of a
1308 tentative label.)
1309 .
1310 .
1311 .TP
1312 .B sort\-adjacent\-labels\*n
1313 Sort labels that are adjacent in the text according to their position
1314 in the reference list.
1315 .
1316 This command should usually be given if the
1317 .B \%abbreviate\-label\-ranges
1318 command has been given,
1319 or if the label expression contains a
1320 .B <>
1321 expression.
1322 .
1323 This has no effect unless references are being accumulated.
1324 .
1325 .
1326 .\" ====================================================================
1327 .SS "Label expressions"
1328 .\" ====================================================================
1329 .
1330 Label expressions can be evaluated both normally and tentatively.
1331 .
1332 The result of normal evaluation is used for output.
1333 .
1334 The result of tentative evaluation,
1335 called the
1336 .IR "tentative label" ,
1337 is used to gather the information that normal evaluation needs to
1338 disambiguate the label.
1339 .
1340 Label expressions specified by the
1341 .B \%date\-as\-label
1342 and
1343 .B \%short\-label
1344 commands are not evaluated tentatively.
1345 .
1346 Normal and tentative evaluation are the same for all types of expression
1347 other than
1348 .BR @ ,
1349 .BR * ,
1350 and
1351 .B %
1352 expressions.
1353 .
1354 The description below applies to normal evaluation,
1355 except where otherwise specified.
1356 .
1357 .
1358 .TP 8n \" "expr-n" + 2n
1359 .IR field\~ [ n ]
1360 is the
1361 .IR n th
1362 part of
1363 .IR field .
1364 .
1365 If
1366 .I n
1367 is omitted,
1368 it defaults to\~1.
1369 .
1370 .
1371 .TP
1372 .BI \[aq] string \[aq]
1373 The characters in
1374 .I string
1375 literally.
1376 .
1377 .
1378 .TP
1379 .B @
1380 All authors joined as specified by the
1381 .B \%join\-authors
1382 command.
1383 .
1384 The whole of each author's name is used.
1385 .
1386 However,
1387 if the references are sorted by author
1388 (that is,
1389 the sort specification starts with
1390 .RB \[lq] A+ \[rq]),
1391 then authors' surnames will be used instead,
1392 provided that this does not introduce ambiguity,
1393 and also an initial subsequence of the authors may be used instead of
1394 all the authors,
1395 again provided that this does not introduce ambiguity.
1396 .
1397 Given any two referenced works with
1398 .I n
1399 authors,
1400 the use of only the surname for the
1401 .IR n th
1402 author of a reference
1403 is regarded as ambiguous if
1404 the other reference
1405 shares the first
1406 .IR n \|\-\|1
1407 authors,
1408 the
1409 .IR n th
1410 authors of each reference are not identical,
1411 but the
1412 .IR n th
1413 authors' surnames
1414 .I are
1415 the same.
1416 .
1417 A proper initial subsequence of the sequence of authors for some
1418 reference is considered to be ambiguous if there is a reference with
1419 some other sequence of authors which also has that subsequence as a
1420 proper initial subsequence.
1421 .
1422 When an initial subsequence of authors is used,
1423 the remaining authors are replaced by the string specified by the
1424 .B \%et\-al
1425 command;
1426 this command may also specify additional requirements that must be
1427 met before an initial subsequence can be used.
1428 .
1429 .B @
1430 tentatively evaluates to a canonical representation of the authors,
1431 such that authors that compare equally for sorting purposes have the
1432 same representation.
1433 .
1434 .
1435 .TP
1436 .BI % n
1437 .TQ
1438 .B %a
1439 .TQ
1440 .B %A
1441 .TQ
1442 .B %i
1443 .TQ
1444 .B %I
1445 The serial number of the reference formatted according to the
1446 character following the
1447 .BR % .
1448 The serial number of a reference is\~1 plus the number of earlier
1449 references with same tentative label as this reference.
1450 .
1451 These expressions tentatively evaluate to an empty string.
1452 .
1453 .TP
1454 .IB expr *
1455 If there is another reference with the same tentative label as this
1456 reference,
1457 then
1458 .IR expr ,
1459 otherwise an empty string.
1460 .
1461 It tentatively evaluates to an empty string.
1462 .
1463 .
1464 .TP
1465 .IB expr + n
1466 .TQ
1467 .IB expr \- n
1468 The first
1469 .RB ( + )
1470 or last
1471 .RB ( \- )
1472 .I n
1473 upper or lower case letters or digits of
1474 .IR expr .
1475 .
1476 .I roff
1477 special characters
1478 (such as
1479 .BR \e(\[aq]a )
1480 count as a single letter.
1481 .
1482 Accent strings are retained but do not count toward the total.
1483 .
1484 .
1485 .TP
1486 .IB expr .l
1487 .I expr
1488 converted to lowercase.
1489 .
1490 .
1491 .TP
1492 .IB expr .u
1493 .I expr
1494 converted to uppercase.
1495 .
1496 .
1497 .TP
1498 .IB expr .c
1499 .I expr
1500 converted to caps and small caps.
1501 .
1502 .
1503 .TP
1504 .IB expr .r
1505 .I expr
1506 reversed so that the surname is first.
1507 .
1508 .
1509 .TP
1510 .IB expr .a
1511 .I expr
1512 with first names abbreviated.
1513 .
1514 Fields specified in the
1515 .B \%abbreviate
1516 command are abbreviated before any labels are evaluated.
1517 .
1518 Thus
1519 .B .a
1520 is useful only when you want a field to be abbreviated in a label
1521 but not in a reference.
1522 .
1523 .
1524 .TP
1525 .IB expr .y
1526 The year part of
1527 .IR expr .
1528 .
1529 .
1530 .TP
1531 .IB expr .+y
1532 The part of
1533 .I expr
1534 before the year,
1535 or the whole of
1536 .I expr
1537 if it does not contain a year.
1538 .
1539 .
1540 .TP
1541 .IB expr .\-y
1542 The part of
1543 .I expr
1544 after the year,
1545 or an empty string if
1546 .I expr
1547 does not contain a year.
1548 .
1549 .
1550 .TP
1551 .IB expr .n
1552 The surname part of
1553 .IR expr .
1554 .
1555 .
1556 .TP
1557 .IB expr1 \[ti] expr2
1558 .I expr1
1559 except that if the last character of
1560 .I expr1
1561 is
1562 .B \-
1563 then it will be replaced by
1564 .IR expr2 .
1565 .
1566 .
1567 .TP
1568 .I expr1 expr2
1569 The catenation of
1570 .I expr1
1571 and
1572 .IR expr2 .
1573 .
1574 .
1575 .TP
1576 .IB expr1 | expr2
1577 If
1578 .I expr1
1579 is non-empty then
1580 .I expr1
1581 otherwise
1582 .IR expr2 .
1583 .
1584 .
1585 .TP
1586 .IB expr1 & expr2
1587 If
1588 .I expr1
1589 is non-empty
1590 then
1591 .I expr2
1592 otherwise an empty string.
1593 .
1594 .
1595 .TP
1596 .IB expr1 ? expr2 : expr3
1597 If
1598 .I expr1
1599 is non-empty
1600 then
1601 .I expr2
1602 otherwise
1603 .IR expr3 .
1604 .
1605 .
1606 .TP
1607 .BI < expr >
1608 The label is in two parts,
1609 which are separated by
1610 .IR expr .
1611 .
1612 Two adjacent two-part labels which have the same first part will be
1613 merged by appending the second part of the second label onto the first
1614 label separated by the string specified in the
1615 .B \%separate\-label\-second\-parts
1616 command
1617 (initially,
1618 a comma followed by a space);
1619 the resulting label will also be a two-part label with the same first
1620 part as before merging,
1621 and so additional labels can be merged into it.
1622 .
1623 It is permissible for the first part to be empty;
1624 this may be desirable for expressions used in the
1625 .B \%short\-label
1626 command.
1627 .
1628 .
1629 .TP
1630 .BI ( expr )
1631 The same as
1632 .IR expr .
1633 .
1634 Used for grouping.
1635 .
1636 .
1637 .LP
1638 The above expressions are listed in order of precedence
1639 (highest first);
1640 .B &
1641 and
1642 .B |
1643 have the same precedence.
1644 .
1645 .
1646 .\" ====================================================================
1647 .SS "Macro interface"
1648 .\" ====================================================================
1649 .
1650 Each reference starts with a call to the macro
1651 .BR ]\- .
1652 .
1653 The string
1654 .B [F
1655 will be defined to be the label for this reference,
1656 unless the
1657 .B \%no\-label\-in\-reference
1658 command has been given.
1659 .
1660 There then follows a series of string definitions,
1661 one for each field:
1662 string
1663 .BI [ X
1664 corresponds to field
1665 .IR X .
1666 .
1667 The register
1668 .B [P
1669 is set to\~1 if the
1670 .B P
1671 field contains a range of pages.
1672 .
1673 The
1674 .BR [T ,
1675 .B [A
1676 and
1677 .B [O
1678 registers are set to\~1 according as the
1679 .BR T ,
1680 .B A
1681 and
1682 .B O
1683 fields end with any of
1684 .B .?!\&
1685 (an end-of-sentence character).
1686 .
1687 The
1688 .B [E
1689 register will be set to\~1 if the
1690 .B [E
1691 string contains more than one name.
1692 .
1693 The reference is followed by a call to the
1694 .B ][
1695 macro.
1696 .
1697 The first argument to this macro gives a number representing
1698 the type of the reference.
1699 .
1700 If a reference contains a
1701 .B J
1702 field,
1703 it will be classified as type\~1,
1704 otherwise if it contains a
1705 .B B
1706 field,
1707 it will be type\~3,
1708 otherwise if it contains a
1709 .B G
1710 or
1711 .B R
1712 field it will be type\~4,
1713 otherwise if it contains an
1714 .B I
1715 field it will be type\~2,
1716 otherwise it will be type\~0.
1717 .
1718 The second argument is a symbolic name for the type:
1719 .BR other ,
1720 .BR \%journal\-article ,
1721 .BR book ,
1722 .BR \%article\-in\-book ,
1723 or
1724 .BR \%tech\-report .
1725 .
1726 Groups of references that have been accumulated or are produced by the
1727 .B \%bibliography
1728 command are preceded by a call to the
1729 .B ]<
1730 macro and followed by a call to the
1731 .B ]>
1732 macro.
1733 .
1734 .
1735 .br
1736 .ne 5v
1737 .\" ====================================================================
1738 .SH Options
1739 .\" ====================================================================
1740 .
1741 .B \-\-help
1742 displays a usage message,
1743 while
1744 .B \-v
1745 and
1746 .B \%\-\-version
1747 show version information;
1748 all exit afterward.
1749 .
1750 .
1751 .TP
1752 .B \-R
1753 Don't recognize lines beginning with
1754 .BR .R1 / .R2 .
1755 .
1756 .
1757 .P
1758 Other options are equivalent to
1759 .I \%refer
1760 commands.
1761 .
1762 .
1763 .TP 16n
1764 .BI \-a\~ n
1765 .B reverse
1766 .BI A n
1767 .
1768 .
1769 .TP
1770 .B \-b
1771 .B "\%no\-label\-in\-text; \%no\-label\-in\-reference"
1772 .
1773 .
1774 .TP
1775 .B \-B
1776 See below.
1777 .
1778 .
1779 .TP
1780 .BI \-c\~ fields
1781 .B capitalize
1782 .I fields
1783 .
1784 .
1785 .TP
1786 .B \-C
1787 .B compatible
1788 .
1789 .
1790 .TP
1791 .B \-e
1792 .B accumulate
1793 .
1794 .
1795 .TP
1796 .BI \-f\~ n
1797 .B \%label
1798 .BI % n
1799 .
1800 .
1801 .TP
1802 .BI \-i\~ fields
1803 .B search\-ignore
1804 .I fields
1805 .
1806 .
1807 .TP
1808 .B \-k
1809 .B \%label
1810 .B L\[ti]%a
1811 .
1812 .
1813 .TP
1814 .BI \-k\~ field
1815 .B \%label
1816 .IB field \[ti]%a
1817 .
1818 .
1819 .TP
1820 .B \-l
1821 .B \%label
1822 .B A.nD.y%a
1823 .
1824 .
1825 .TP
1826 .BI \-l\~ m
1827 .B \%label
1828 .BI A.n+ m D.y%a
1829 .
1830 .
1831 .TP
1832 .BI \-l\~, n
1833 .B \%label
1834 .BI A.nD.y\- n %a
1835 .
1836 .
1837 .TP
1838 .BI \-l\~ m , n
1839 .B \%label
1840 .BI A.n+ m D.y\- n %a
1841 .
1842 .
1843 .TP
1844 .B \-n
1845 .B \%no\-default\-database
1846 .
1847 .
1848 .TP
1849 .BI \-p\~ db-file
1850 .B database
1851 .I db-file
1852 .
1853 .
1854 .TP
1855 .B \-P
1856 .B move\-punctuation
1857 .
1858 .
1859 .TP
1860 .BI \-s\~ spec
1861 .B sort
1862 .I spec
1863 .
1864 .
1865 .TP
1866 .B \-S
1867 .B \%label \[dq](A.n|Q) \[aq], \[aq] (D.y|D)\[dq]; \
1868 \%bracket-\%label \[dq]\~(\[dq]\~)\~\[dq];\~\[dq]
1869 .
1870 .
1871 .TP
1872 .BI \-t\~ n
1873 .B search\-truncate
1874 .I n
1875 .
1876 .
1877 .P
1878 The
1879 .B B
1880 option has command equivalents with the addition that the file names
1881 specified on the command line are processed as if they were arguments to
1882 the
1883 .B \%bibliography
1884 command instead of in the normal way.
1885 .
1886 .
1887 .TP 16n
1888 .B \-B
1889 .B "annotate X AP; \%no\-label\-in\-reference"
1890 .
1891 .
1892 .TP
1893 .BI \-B\~ field . macro
1894 .B annotate
1895 .I field
1896 .IB macro ;
1897 .B \%no\-label\-in\-reference
1898 .
1899 .
1900 .\" ====================================================================
1901 .SH "Exit status"
1902 .\" ====================================================================
1903 .
1904 .I \%refer
1905 exits with
1906 .RB status\~ 0
1907 on successful operation,
1908 .RB status\~ 2
1909 if the program cannot interpret its command-line arguments,
1910 and
1911 .RB status\~ 1
1912 if it encounters an error during operation.
1913 .
1914 .
1915 .\" ====================================================================
1916 .SH Environment
1917 .\" ====================================================================
1918 .
1919 .TP 9n \" "REFER" + 2n + hand-tuned for PDF
1920 .I REFER
1921 Assign this variable a file name to override the default database.
1922 .
1923 .
1924 .\" ====================================================================
1925 .SH Files
1926 .\" ====================================================================
1927 .
1928 .TP
1929 .I /usr/\:\%dict/\:\%papers/\:\%Ind
1930 Default database.
1931 .
1932 .
1933 .TP
1934 .RI file \%.i
1935 Index files.
1936 .
1937 .
1938 .TP
1939 .I /usr/\:\%share/\:\%groff/\:\%1.24.1/\:\%tmac/\:refer\:.tmac
1940 defines macros and strings facilitating integration with macro packages
1941 that wish to support
1942 .IR \%refer .
1943 .
1944 .
1945 .LP
1946 .I \%refer
1947 uses temporary files.
1948 .
1949 See the
1950 .MR groff 1
1951 man page for details of where such files are created.
1952 .
1953 .
1954 .\" ====================================================================
1955 .SH Bugs
1956 .\" ====================================================================
1957 .
1958 In label expressions,
1959 .B <>
1960 expressions are ignored inside
1961 .BI . char
1962 expressions.
1963 .
1964 .
1965 .\" ====================================================================
1966 .SH Examples
1967 .\" ====================================================================
1968 .
1969 We can illustrate the operation of
1970 .I \%refer
1971 with a sample bibliographic database containing one entry and a simple
1972 .I roff
1973 document to cite that entry.
1974 .
1975 .
1976 .P
1977 .RS
1978 .EX
1979 $ \c
1980 .B cat > my\-db\-file
1981 .B %A Daniel P.\[rs]& Friedman
1982 .B %A Matthias Felleisen
1983 .B %C Cambridge, Massachusetts
1984 .B %D 1996
1985 .B %I The MIT Press
1986 .B %T The Little Schemer, Fourth Edition
1987 $ \c
1988 .B refer -p my\-db\-file
1989 .B Read the book
1990 .B .[
1991 .B friedman
1992 .B .]
1993 .B on your summer vacation.
1994 .I <Control+D>
1995 \&.lf 1 \-
1996 Read the book\[rs]*([.1\[rs]*(.]
1997 \&.ds [F 1
1998 \&.]\-
1999 \&.ds [A Daniel P. Friedman and Matthias Felleisen
2000 \&.ds [C Cambridge, Massachusetts
2001 \&.ds [D 1996
2002 \&.ds [I The MIT Press
2003 \&.ds [T The Little Schemer, Fourth Edition
2004 \&.nr [T 0
2005 \&.nr [A 0
2006 \&.][ 2 book
2007 \&.lf 5 \-
2008 on your summer vacation.
2009 .EE
2010 .RE
2011 .
2012 .
2013 .P
2014 The foregoing shows us that
2015 .I \%refer
2016 (a) produces a label \[lq]1\[rq];
2017 (b) brackets that label with interpolations of the
2018 .RB \[lq] [. \[rq]
2019 and
2020 .RB \[lq] .] \[rq]
2021 strings;
2022 (c) calls a macro
2023 .RB \[lq] ]\- \[rq];
2024 (d) defines strings and registers containing the label and bibliographic
2025 data for the reference;
2026 (e) calls a macro
2027 .RB \[lq] ][ \[rq];
2028 and (f) uses the
2029 .B lf
2030 request to restore the line numbers of the input.
2031 .
2032 As noted in subsection \[lq]Macro interface\[rq] above,
2033 it is the document's responsibility to employ and format the information
2034 usefully.
2035 .
2036 Let us see how we might turn
2037 .MR groff_ms 7
2038 to this task.
2039 .
2040 .
2041 .P
2042 .RS
2043 .EX
2044 $ \c
2045 .B REFER=my\-db\-file groff \-R \-ms
2046 .B .LP
2047 .B Read the book
2048 .B .[
2049 .B friedman
2050 .B .]
2051 .B on your summer vacation.
2052 .B Commentary is available.\[rs]*{*\[rs]*}
2053 .B .FS \[rs]*{*\[rs]*}
2054 .B Space reserved for penetrating insight.
2055 .B .FE
2056 .EE
2057 .RE
2058 .
2059 .
2060 .LP
2061 .IR ms 's
2062 automatic footnote numbering mechanism is not aware of
2063 .IR \%refer 's
2064 label numbering,
2065 so we have manually specified a (superscripted) symbolic footnote for
2066 our non-bibliographic aside.
2067 .
2068 .
2069 .\" ====================================================================
2070 .SH "See also"
2071 .\" ====================================================================
2072 .
2073 \[lq]Refer \[em] A Bibliography System\[rq],
2074 by Bill Tuthill,
2075 1983, \" 4.2BSD, /usr/doc/refer/refer.bib
2076 Computing Services,
2077 University of California,
2078 Berkeley.
2079 .
2080 .
2081 .P
2082 \[lq]Some Applications of Inverted Indexes on the Unix System\[rq],
2083 by M.\& E.\& Lesk,
2084 1978,
2085 AT&T Bell Laboratories Computing Science Technical Report No.\& 69.
2086 .
2087 .
2088 .P
2089 .MR \%indxbib 1 ,
2090 .MR \%lookbib 1 ,
2091 .MR lkbib 1
2092 .
2093 .
2094 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
2095 .cp \n[*groff_refer_1_man_C]
2096 .do rr *groff_refer_1_man_C
2097 .
2098 .
2099 .\" Local Variables:
2100 .\" fill-column: 72
2101 .\" mode: nroff
2102 .\" End:
2103 .\" vim: set filetype=groff textwidth=72: