diff options
author | Karl Berry <karl@freefriends.org> | 2016-03-25 22:06:44 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2016-03-25 22:06:44 +0000 |
commit | ff79e08c4e182a0ca600f033c8baa842056f92f9 (patch) | |
tree | a5cf18fac0e1ce9a0193c9b5c08070bf18e366e1 /Master/texmf-dist/doc/support/bibtexperllibs | |
parent | f9e5222a931d1b2671fa84b5c93a4605c00c2373 (diff) |
bibtexperllibs (25mar16)
git-svn-id: svn://tug.org/texlive/trunk@40139 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/support/bibtexperllibs')
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. |