summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support/bibtexperllibs/BibTeXParserAuthor.3pm
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/support/bibtexperllibs/BibTeXParserAuthor.3pm')
-rw-r--r--Master/texmf-dist/doc/support/bibtexperllibs/BibTeXParserAuthor.3pm38
1 files changed, 26 insertions, 12 deletions
diff --git a/Master/texmf-dist/doc/support/bibtexperllibs/BibTeXParserAuthor.3pm b/Master/texmf-dist/doc/support/bibtexperllibs/BibTeXParserAuthor.3pm
index 0f1509c5489..75f48fa183d 100644
--- a/Master/texmf-dist/doc/support/bibtexperllibs/BibTeXParserAuthor.3pm
+++ b/Master/texmf-dist/doc/support/bibtexperllibs/BibTeXParserAuthor.3pm
@@ -124,16 +124,13 @@
.\" ========================================================================
.\"
.IX Title "BibTeX::Parser::Author 3pm"
-.TH BibTeX::Parser::Author 3pm "2015-10-24" "perl v5.10.1" "User Contributed Perl Documentation"
+.TH BibTeX::Parser::Author 3pm "2016-03-24" "perl v5.10.1" "User Contributed Perl Documentation"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
-BibTeX::Parser::Author
-.SH "VERSION"
-.IX Header "VERSION"
-version 0.65
+BibTeX::Author \- Contains a single author for a BibTeX document.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
This class ist a wrapper for a single BibTeX author. It is usually created
@@ -153,11 +150,6 @@ by a BibTeX::Parser.
\&
\& my ($first, $von, $last, $jr) = BibTeX::Author\->split($fullname);
.Ve
-.SH "NAME"
-BibTeX::Author \- Contains a single author for a BibTeX document.
-.SH "VERSION"
-.IX Header "VERSION"
-version 0.65
.SH "FUNCTIONS"
.IX Header "FUNCTIONS"
.SS "new"
@@ -182,12 +174,34 @@ with four strings, some of them possibly empty.
.SS "to_string"
.IX Subsection "to_string"
Return string representation of the name.
+.SH "NOTES"
+.IX Header "NOTES"
+BibTeX allows three representations of a person's name:
+.IP "1." 4
+First von Last
+.IP "2." 4
+von Last, First
+.IP "3." 4
+von Last, Jr, First
+.PP
+The module always converts the first form to the second of third one
+to allow simple string comparisons.
+.PP
+The algorithm to determine the von part is the following: von part
+consists of tokens where the first letter at brace level 0 is in lower case.
+Anything in a \*(L"special characters\*(R" is on brace level 0. Thus the following
+tokens are considered von parts: \f(CW\*(C`von\*(C'\fR, \f(CW\*(C`\eNOOP{von}Von\*(C'\fR, and
+the following token is not: \f(CW\*(C`{von}\*(C'\fR
+.SH "VERSION"
+.IX Header "VERSION"
+version 0.69
.SH "AUTHOR"
.IX Header "AUTHOR"
-Gerhard Gossen <gerhard.gossen@googlemail.com>
+Gerhard Gossen <gerhard.gossen@googlemail.com> and
+Boris Veytsman <boris@varphi.com>
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
-This software is copyright (c) 2013 by Gerhard Gossen.
+This software is copyright (c) 2013\-\-2016 by Gerhard Gossen and Boris Veytsman.
.PP
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.