summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support/bibtexperllibs
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/support/bibtexperllibs')
-rw-r--r--Master/texmf-dist/doc/support/bibtexperllibs/BibTeXParser.3pm26
-rw-r--r--Master/texmf-dist/doc/support/bibtexperllibs/BibTeXParserAuthor.3pm38
-rw-r--r--Master/texmf-dist/doc/support/bibtexperllibs/BibTeXParserEntry.3pm37
-rw-r--r--Master/texmf-dist/doc/support/bibtexperllibs/LaTeXToUnicode.3pm8
-rw-r--r--Master/texmf-dist/doc/support/bibtexperllibs/LaTeXToUnicodeTables.3pm8
5 files changed, 68 insertions, 49 deletions
diff --git a/Master/texmf-dist/doc/support/bibtexperllibs/BibTeXParser.3pm b/Master/texmf-dist/doc/support/bibtexperllibs/BibTeXParser.3pm
index fa79185547d..fb4922b4805 100644
--- a/Master/texmf-dist/doc/support/bibtexperllibs/BibTeXParser.3pm
+++ b/Master/texmf-dist/doc/support/bibtexperllibs/BibTeXParser.3pm
@@ -124,16 +124,13 @@
.\" ========================================================================
.\"
.IX Title "BibTeX::Parser 3pm"
-.TH BibTeX::Parser 3pm "2015-10-24" "perl v5.10.1" "User Contributed Perl Documentation"
+.TH BibTeX::Parser 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 \- A pure perl BibTeX parser
-.SH "VERSION"
-.IX Header "VERSION"
-version 0.65
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
Parses BibTeX files.
@@ -168,11 +165,6 @@ Parses BibTeX files.
\& }
\& }
.Ve
-.SH "NAME"
-BibTeX::Parser \- A pure perl BibTeX parser
-.SH "VERSION"
-.IX Header "VERSION"
-version 0.65
.SH "FUNCTIONS"
.IX Header "FUNCTIONS"
.SS "new"
@@ -187,18 +179,26 @@ Parameters:
.SS "next"
.IX Subsection "next"
Returns the next parsed entry or undef.
-.SS "\s-1SEE\s0 \s-1ALSO\s0"
-.IX Subsection "SEE ALSO"
+.SH "NOTES"
+.IX Header "NOTES"
+The fields \f(CW\*(C`author\*(C'\fR and \f(CW\*(C`editor\*(C'\fR are canonized, see
+BibTeX::Parser::Author
+.SH "SEE ALSO"
+.IX Header "SEE ALSO"
.IP "\(bu" 4
BibTeX::Parser::Entry
.IP "\(bu" 4
BibTeX::Parser::Author
+.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.
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.
diff --git a/Master/texmf-dist/doc/support/bibtexperllibs/BibTeXParserEntry.3pm b/Master/texmf-dist/doc/support/bibtexperllibs/BibTeXParserEntry.3pm
index c145295b33a..e2d9405b1cf 100644
--- a/Master/texmf-dist/doc/support/bibtexperllibs/BibTeXParserEntry.3pm
+++ b/Master/texmf-dist/doc/support/bibtexperllibs/BibTeXParserEntry.3pm
@@ -124,16 +124,13 @@
.\" ========================================================================
.\"
.IX Title "BibTeX::Parser::Entry 3pm"
-.TH BibTeX::Parser::Entry 3pm "2015-10-24" "perl v5.10.1" "User Contributed Perl Documentation"
+.TH BibTeX::Parser::Entry 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::Entry
-.SH "VERSION"
-.IX Header "VERSION"
-version 0.65
+BibTeX::Parser::Entry \- Contains a single entry of a BibTeX document.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
This class ist a wrapper for a single BibTeX entry. It is usually created
@@ -152,13 +149,10 @@ by a BibTeX::Parser.
\& my @editors = $entry\->editor;
\&
\& ...
+\&
+\& print $entry\->to_string;
\& }
.Ve
-.SH "NAME"
-BibTeX::Entry \- Contains a single entry of a BibTeX document.
-.SH "VERSION"
-.IX Header "VERSION"
-version 0.65
.SH "FUNCTIONS"
.IX Header "FUNCTIONS"
.SS "new"
@@ -207,21 +201,32 @@ objects. The parameters can either be BibTeX::Author objects
or strings.
.PP
Note: You can also change the authors with \f(CW$entry\fR\->field('editor', \f(CW$editors_string\fR)
-.SS "\fIfieldlist()\fP"
-.IX Subsection "fieldlist()"
+.SS "fieldlist ()"
+.IX Subsection "fieldlist ()"
Returns a list of all the fields used in this entry.
.SS "has($fieldname)"
.IX Subsection "has($fieldname)"
Returns a true value if this entry has a value for \f(CW$fieldname\fR.
-.SS "raw_bibtex"
-.IX Subsection "raw_bibtex"
+.SS "raw_bibtex ()"
+.IX Subsection "raw_bibtex ()"
Return raw BibTeX entry (if available).
+.SS "to_string ([options])"
+.IX Subsection "to_string ([options])"
+Returns a text of the BibTeX entry in BibTeX format. Options is
+a hash. Currently only the option \f(CW\*(C`canonize_names\*(C'\fR
+is supported. If true (the default), authors' and editors'
+names are translated into canonical bibtex form. The command
+\&\f(CW\*(C`$entry\->to_string(canonize_names=>0)\*(C'\fR overrides this behavior.
+.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.
diff --git a/Master/texmf-dist/doc/support/bibtexperllibs/LaTeXToUnicode.3pm b/Master/texmf-dist/doc/support/bibtexperllibs/LaTeXToUnicode.3pm
index 8c53a9fb0ec..32f5e8a75bf 100644
--- a/Master/texmf-dist/doc/support/bibtexperllibs/LaTeXToUnicode.3pm
+++ b/Master/texmf-dist/doc/support/bibtexperllibs/LaTeXToUnicode.3pm
@@ -124,7 +124,7 @@
.\" ========================================================================
.\"
.IX Title "LaTeX::ToUnicode 3pm"
-.TH LaTeX::ToUnicode 3pm "2015-10-24" "perl v5.10.1" "User Contributed Perl Documentation"
+.TH LaTeX::ToUnicode 3pm "2015-12-28" "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
@@ -133,7 +133,7 @@
LaTeX::ToUnicode \- Convert LaTeX commands to Unicode
.SH "VERSION"
.IX Header "VERSION"
-version 0.03
+version 0.04
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
@@ -171,10 +171,10 @@ If true, the commands introduced by the package `german' (e.g. \f(CW\*(C`"a\*(C'
note the missing backslash) are also handled.
.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) 2010 by Gerhard Gossen.
+This software is copyright (c) 2010\-2015 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.
diff --git a/Master/texmf-dist/doc/support/bibtexperllibs/LaTeXToUnicodeTables.3pm b/Master/texmf-dist/doc/support/bibtexperllibs/LaTeXToUnicodeTables.3pm
index 5ffd04ef9b8..1092bb89be4 100644
--- a/Master/texmf-dist/doc/support/bibtexperllibs/LaTeXToUnicodeTables.3pm
+++ b/Master/texmf-dist/doc/support/bibtexperllibs/LaTeXToUnicodeTables.3pm
@@ -124,7 +124,7 @@
.\" ========================================================================
.\"
.IX Title "LaTeX::ToUnicode::Tables 3pm"
-.TH LaTeX::ToUnicode::Tables 3pm "2015-10-24" "perl v5.10.1" "User Contributed Perl Documentation"
+.TH LaTeX::ToUnicode::Tables 3pm "2015-12-28" "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
@@ -133,7 +133,7 @@
LaTeX::ToUnicode::Tables \- Character tables for LaTeX::ToUnicode
.SH "VERSION"
.IX Header "VERSION"
-version 0.03
+version 0.04
.SH "CONSTANTS"
.IX Header "CONSTANTS"
.ie n .SS "%COMMANDS"
@@ -170,10 +170,10 @@ The keys of this hash are the literal escape sequences.
Command names of formatting commands like \f(CW\*(C`\ett\*(C'\fR
.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) 2010 by Gerhard Gossen.
+This software is copyright (c) 2010\-2015 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.