Return to sortbib.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / refer / sortbib

Annotation of 43BSDReno/usr.bin/refer/sortbib/sortbib.1, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1983, 1990 Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\" Redistribution and use in source and binary forms are permitted provided
                      5: .\" that: (1) source distributions retain this entire copyright notice and
                      6: .\" comment, and (2) distributions including binaries display the following
                      7: .\" acknowledgement:  ``This product includes software developed by the
                      8: .\" University of California, Berkeley and its contributors'' in the
                      9: .\" documentation or other materials provided with the distribution and in
                     10: .\" all advertising materials mentioning features or use of this software.
                     11: .\" Neither the name of the University nor the names of its contributors may
                     12: .\" be used to endorse or promote products derived from this software without
                     13: .\" specific prior written permission.
                     14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
                     15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
                     16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     17: .\"
                     18: .\"     @(#)sortbib.1  6.2 (Berkeley) 6/24/90
                     19: .\"
                     20: .TH SORTBIB 1 "%Q"
                     21: .UC 5
                     22: sortbib \- sort bibliographic database
                     23: .SH SYNOPSIS
                     24: .B sortbib
                     25: [
                     26: .BR \-s KEYS
                     27: ] database  ...
                     28: .SH DESCRIPTION
                     29: .I Sortbib
                     30: sorts files of records containing
                     31: .I refer
                     32: key-letters by user-specified keys.
                     33: Records may be separated by blank lines,
                     34: or by \&.[ and \&.] delimiters,
                     35: but the two styles may not be mixed together.
                     36: This program reads through each
                     37: .I database
                     38: and pulls out key fields, which are sorted separately.
                     39: The sorted key fields contain the file pointer,
                     40: byte offset, and length of corresponding records.
                     41: These records are delivered using disk seeks and reads, so
                     42: .I sortbib
                     43: may not be used in a pipeline to read standard input.
                     44: .PP
                     45: By default,
                     46: .I sortbib
                     47: alphabetizes by the first %A and the %D fields,
                     48: which contain the senior author and date.
                     49: The
                     50: .B \-s
                     51: option is used to specify new
                     52: .IR \s-1KEYS\s0 .
                     53: For instance,
                     54: .BR \-s ATD
                     55: will sort by author, title, and date,
                     56: while
                     57: .BR \-s A+D
                     58: will sort by all authors, and date.
                     59: Sort keys past the fourth are not meaningful.
                     60: No more than 16 databases may be sorted together at one time.
                     61: Records longer than 4096 characters will be truncated.
                     62: .PP
                     63: .I Sortbib
                     64: sorts on the last word on the %A line,
                     65: which is assumed to be the author's last name.
                     66: A word in the final position, such as ``jr.'' or ``ed.'',
                     67: will be ignored if the name beforehand ends with a comma.
                     68: Authors with two-word last names or unusual constructions
                     69: can be sorted correctly by using the
                     70: .I nroff
                     71: convention ``\e0'' in place of a blank.
                     72: A %Q field is considered to be the same as %A,
                     73: except sorting begins with the first, not the last, word.
                     74: .I Sortbib
                     75: sorts on the last word of the %D line, usually the year.
                     76: It also ignores leading articles (like ``A'' or ``The'')
                     77: when sorting by titles in the %T or %J fields;
                     78: it will ignore articles of any modern European language.
                     79: If a sort-significant field is absent from a record,
                     80: .I sortbib
                     81: places that record before other records containing that field.
                     82: .SH SEE ALSO
                     83: refer(1), addbib(1), roffbib(1), indxbib(1), lookbib(1)
                     84: .SH AUTHORS
                     85: Greg Shenaut, Bill Tuthill
                     86: .SH BUGS
                     87: Records with missing author fields
                     88: 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.