NAME

Biblio::Util - Package Frontend for bp_util (Perl Bibliography Package)

SYNOPSIS

  use Biblio::Util;

DESCRIPTION

well, I guess it\'s better if you check the source or the original docs for now .... sorry ... ;-)

METHODS

$bool = ordnumber($text)

Convert ordinal number in text representatin to integer value. Return undef if $text is no ordinal number.

$defaultCiteKey = defaultCiteKey($rec)

Generate Default CiteKey for record in pbib format.

($author, $author_type) = getAuthors($rec)

split_names($names_string, $type)

        $type = 'names': the string contains names
        $type = 'org': the string contains a company
        $type = 'xname': return the advanced name array

@parts = split_nameparts($name_string, $xname_flag)

        e.g.
        /John/von/Jones/Jr./
        /Ed/Krol/
        /Ludwig/von/Beethoven/
        /Frederick P.//Brooks/Jr./
        /Sandra/Da Campo/               -- a space within the last name
        /Dan R.//Olsen/Jr./             -- middle initial / several firstnames
        i.e.
                1 -> "/Company/"
                2 -> "/Firstnames/Lastname/"
                3 -> hm ... "/Firstnames/von/Lastname/"
                4 -> "/Firstnames/von/Lastname/Jr/"

        if $xname_flag is undef or 0
        return: [firstnames .... "von last, Jr."]
        --> no separate handling of "von" and "Jr." possible.
        --> ["one-name-only"] = company
        --> "et al." = and others

        if $xname_flag is set
        return: [firstnames, [von, last, jr]]   in case 4
        or              [firstnames, [von, last]]               in case 3
        or              [firstnames, [last]]                    in case 2
        or              [company]                                       in case 1

@parts = split_namepartsold($name_string)

        /Jones/von/John/Jr./,/Krol/Ed/,/Beethoven/von/Ludwig/
        i.e.
                2 "/" -> "/Company/"
                3 "/" -> "/Lastname/Firstnames/"
                4 "/" -> hm ... "/Lastname/von/Firstnames/"
                5 "/" -> "/Lastname/von/Firstnames/Jr/"

        currently return: [firstnames .... "von last, Jr."]
        --> no separate handling of "von" and "Jr." possible.
        --> ["one-name-only"] = company
        --> ["et al."] = and others

EXPORT

# # # Major functions available for users to call: # # # bp_util'mname_to_canon($names_string); # bp_util'mname_to_canon($names_string, $flag_reverse_author); # # bp_util'name_to_canon($name_string); # bp_util'name_to_canon($name_string, $flag_reverse_author); # # bp_util'canon_to_name($name_string); # bp_util'canon_to_name($name_string, $how_formatted); # # bp_util'parsename($name_string); # bp_util'parsename($name_string, $how_formatted); # # bp_util'parsedate($date_string); # # bp_util'canon_month($month_string); # # bp_util'genkey(%canon_record); # # bp_util'regkey($key); #

AUTHOR

Biblio::Util frontend to bp_util by Peter Tandler <pbib@tandlers.de>

# The bp package is written by Dana Jacobsen (dana@acm.org). # Copyright 1992-1996 by Dana Jacobsen. # # Permission is given to use and distribute this package without charge. # The author will not be liable for any damage caused by the package, nor # are any warranties implied.

HISTORY

$Log: Util.pm,v $ Revision 1.7 2003/12/22 21:51:45 tandler new function "first_initials" to format first names as initials

Revision 1.6 2003/09/23 11:38:00 tandler splitnames improved changed format /// syntax. now: /first/von/last/jr/

Revision 1.5 2003/06/12 22:13:29 tandler improved split_names() - et al. handling - support /Jones/von/John/Jr./,/Krol/Ed/,/Beethoven/von/Ludwig/ new join_and_list()

Revision 1.4 2003/05/22 11:48:36 tandler theoretically it is now possible to use several words of the title for generated default CiteKEys. (not tested ...)

Revision 1.3 2003/02/20 09:24:16 ptandler improved defaultCiteKey

Revision 1.2 2003/01/27 21:09:19 ptandler create normailzed CiteKeys for ACM/DL bibtex entries

Revision 1.1 2002/10/11 10:17:22 peter access bp_util methods and others ...