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     ! 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.