| blob | f6f280fb89225741d6845ced60bcff66fd7fbf29 |
1 '\" te
2 .\" Copyright (c) 1992, Sun Microsystems, Inc.
3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 .TH SORTBIB 1 "Sep 14, 1992"
7 .SH NAME
8 sortbib \- sort a bibliographic database
9 .SH SYNOPSIS
10 .LP
11 .nf
12 \fBsortbib\fR [\fB-s\fR \fIKEYS\fR] \fIdatabase\fR...
13 .fi
15 .SH DESCRIPTION
16 .sp
17 .LP
18 \fBsortbib\fR sorts files of records containing \fBrefer\fR key-letters by
19 user-specified keys. Records may be separated by blank lines, or by
20 `\fB\&.[\fR' and `\fB\&.]\fR' delimiters, but the two styles may not be mixed
21 together. This program reads through each \fIdatabase\fR and pulls out key
22 fields, which are sorted separately. The sorted key fields contain the file
23 pointer, byte offset, and length of corresponding records. These records are
24 delivered using disk seeks and reads, so \fBsortbib\fR may not be used in a
25 pipeline to read standard input.
26 .sp
27 .LP
28 The most common key-letters and their meanings are given below.
29 .sp
30 .ne 2
31 .na
32 \fB\fB%A\fR\fR
33 .ad
34 .RS 8n
35 Author's name
36 .RE
38 .sp
39 .ne 2
40 .na
41 \fB\fB%B\fR\fR
42 .ad
43 .RS 8n
44 Book containing article referenced
45 .RE
47 .sp
48 .ne 2
49 .na
50 \fB\fB%C\fR\fR
51 .ad
52 .RS 8n
53 City (place of publication)
54 .RE
56 .sp
57 .ne 2
58 .na
59 \fB\fB%D\fR\fR
60 .ad
61 .RS 8n
62 Date of publication
63 .RE
65 .sp
66 .ne 2
67 .na
68 \fB\fB%E\fR\fR
69 .ad
70 .RS 8n
71 Editor of book containing article referenced
72 .RE
74 .sp
75 .ne 2
76 .na
77 \fB\fB%F\fR\fR
78 .ad
79 .RS 8n
80 Footnote number or label (supplied by \fBrefer\fR)
81 .RE
83 .sp
84 .ne 2
85 .na
86 \fB\fB%G\fR\fR
87 .ad
88 .RS 8n
89 Government order number
90 .RE
92 .sp
93 .ne 2
94 .na
95 \fB\fB%H\fR\fR
96 .ad
97 .RS 8n
98 Header commentary, printed before reference
99 .RE
101 .sp
102 .ne 2
103 .na
104 \fB\fB%I\fR\fR
105 .ad
106 .RS 8n
107 Issuer (publisher)
108 .RE
110 .sp
111 .ne 2
112 .na
113 \fB\fB%J\fR\fR
114 .ad
115 .RS 8n
116 Journal containing article
117 .RE
119 .sp
120 .ne 2
121 .na
122 \fB\fB%K\fR\fR
123 .ad
124 .RS 8n
125 Keywords to use in locating reference
126 .RE
128 .sp
129 .ne 2
130 .na
131 \fB\fB%L\fR\fR
132 .ad
133 .RS 8n
134 Label field used by \fB-k\fR option of \fBrefer\fR
135 .RE
137 .sp
138 .ne 2
139 .na
140 \fB\fB%M\fR\fR
141 .ad
142 .RS 8n
143 Bell Labs Memorandum (undefined)
144 .RE
146 .sp
147 .ne 2
148 .na
149 \fB\fB%N\fR\fR
150 .ad
151 .RS 8n
152 Number within volume
153 .RE
155 .sp
156 .ne 2
157 .na
158 \fB\fB%O\fR\fR
159 .ad
160 .RS 8n
161 Other commentary, printed at end of reference
162 .RE
164 .sp
165 .ne 2
166 .na
167 \fB\fB%P\fR\fR
168 .ad
169 .RS 8n
170 Page number(s)
171 .RE
173 .sp
174 .ne 2
175 .na
176 \fB\fB%Q\fR\fR
177 .ad
178 .RS 8n
179 Corporate or Foreign Author (unreversed)
180 .RE
182 .sp
183 .ne 2
184 .na
185 \fB\fB%R\fR\fR
186 .ad
187 .RS 8n
188 Report, paper, or thesis (unpublished)
189 .RE
191 .sp
192 .ne 2
193 .na
194 \fB\fB%S\fR\fR
195 .ad
196 .RS 8n
197 Series title
198 .RE
200 .sp
201 .ne 2
202 .na
203 \fB\fB%T\fR\fR
204 .ad
205 .RS 8n
206 Title of article or book
207 .RE
209 .sp
210 .ne 2
211 .na
212 \fB\fB%V\fR\fR
213 .ad
214 .RS 8n
215 Volume number
216 .RE
218 .sp
219 .ne 2
220 .na
221 \fB\fB%X\fR\fR
222 .ad
223 .RS 8n
224 Abstract \(em used by \fBroffbib\fR, not by \fBrefer\fR
225 .RE
227 .sp
228 .ne 2
229 .na
230 \fB\fB%Y,Z\fR\fR
231 .ad
232 .RS 8n
233 Ignored by \fBrefer\fR
234 .RE
236 .sp
237 .LP
238 By default, \fBsortbib\fR alphabetizes by the first \fB%A\fR and the \fB%D\fR
239 fields, which contain the senior author and date.
240 .sp
241 .LP
242 \fBsortbib\fR sorts on the last word on the \fB%A\fR line, which is assumed to
243 be the author's last name. A word in the final position, such as `\fBjr.\fR' or
244 `\fBed.\fR', will be ignored if the name beforehand ends with a comma. Authors
245 with two-word last names or unusual constructions can be sorted correctly by
246 using the \fBnroff\fR convention `\fB\e0\fR\&' in place of a blank. A \fB%Q\fR
247 field is considered to be the same as \fB%A\fR, except sorting begins with the
248 first, not the last, word. \fBsortbib\fR sorts on the last word of the \fB%D\fR
249 line, usually the year. It also ignores leading articles (like `\fBA\fR' or
250 `\fBThe\fR') when sorting by titles in the \fB%T\fR or \fB%J\fR fields; it will
251 ignore articles of any modern European language. If a sort-significant field is
252 absent from a record, \fBsortbib\fR places that record before other records
253 containing that field.
254 .sp
255 .LP
256 No more than 16 databases may be sorted together at one time. Records longer
257 than 4096 characters will be truncated.
258 .SH OPTIONS
259 .sp
260 .ne 2
261 .na
262 \fB\fB-s\fR\fIKEYS\fR\fR
263 .ad
264 .RS 10n
265 Specify new \fIKEYS\fR. For instance, \fB-sATD\fR will sort by author, title,
266 and date, while \fB-sA+D\fR will sort by all authors, and date. Sort keys past
267 the fourth are not meaningful.
268 .RE
270 .SH SEE ALSO
271 .sp
272 .LP
273 \fBaddbib\fR(1), \fBindxbib\fR(1), \fBlookbib\fR(1), \fBrefer\fR(1),
274 \fBroffbib\fR(1), \fBattributes\fR(5)
275 .SH BUGS
276 .sp
277 .LP
278 Records with missing author fields should probably be sorted by title.