Return to sortbib.1 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man1

Annotation of 43BSDTahoe/man/man1/sortbib.1, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1983 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)sortbib.1   6.1 (Berkeley) 4/29/85
                      6: .\"
                      7: .TH SORTBIB 1 "April 29, 1985"
                      8: .UC 5
                      9: .SH NAME
                     10: sortbib \- sort bibliographic database
                     11: .SH SYNOPSIS
                     12: .B sortbib
                     13: [
                     14: .BR \-s KEYS
                     15: ] database  ...
                     16: .SH DESCRIPTION
                     17: .I Sortbib
                     18: sorts files of records containing
                     19: .I refer
                     20: key-letters by user-specified keys.
                     21: Records may be separated by blank lines,
                     22: or by \&.[ and \&.] delimiters,
                     23: but the two styles may not be mixed together.
                     24: This program reads through each
                     25: .I database
                     26: and pulls out key fields, which are sorted separately.
                     27: The sorted key fields contain the file pointer,
                     28: byte offset, and length of corresponding records.
                     29: These records are delivered using disk seeks and reads, so
                     30: .I sortbib
                     31: may not be used in a pipeline to read standard input.
                     32: .PP
                     33: By default,
                     34: .I sortbib
                     35: alphabetizes by the first %A and the %D fields,
                     36: which contain the senior author and date.
                     37: The
                     38: .B \-s
                     39: option is used to specify new
                     40: .IR \s-1KEYS\s0 .
                     41: For instance,
                     42: .BR \-s ATD
                     43: will sort by author, title, and date,
                     44: while
                     45: .BR \-s A+D
                     46: will sort by all authors, and date.
                     47: Sort keys past the fourth are not meaningful.
                     48: No more than 16 databases may be sorted together at one time.
                     49: Records longer than 4096 characters will be truncated.
                     50: .PP
                     51: .I Sortbib
                     52: sorts on the last word on the %A line,
                     53: which is assumed to be the author's last name.
                     54: A word in the final position, such as ``jr.'' or ``ed.'',
                     55: will be ignored if the name beforehand ends with a comma.
                     56: Authors with two-word last names or unusual constructions
                     57: can be sorted correctly by using the
                     58: .I nroff
                     59: convention ``\e0'' in place of a blank.
                     60: A %Q field is considered to be the same as %A,
                     61: except sorting begins with the first, not the last, word.
                     62: .I Sortbib
                     63: sorts on the last word of the %D line, usually the year.
                     64: It also ignores leading articles (like ``A'' or ``The'')
                     65: when sorting by titles in the %T or %J fields;
                     66: it will ignore articles of any modern European language.
                     67: If a sort-significant field is absent from a record,
                     68: .I sortbib
                     69: places that record before other records containing that field.
                     70: .SH SEE ALSO
                     71: refer(1), addbib(1), roffbib(1), indxbib(1), lookbib(1)
                     72: .SH AUTHORS
                     73: Greg Shenaut, Bill Tuthill
                     74: .SH BUGS
                     75: Records with missing author fields
                     76: should probably be sorted by title.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.