nmbib (26jul15)

git-svn-id: svn://tug.org/texlive/trunk@37964 c570f23f-e606-0410-a88d-b1316a301751

9 files changed, 518 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/nmbib/Makefile b/Master/texmf-dist/doc/latex/nmbib/Makefile
new file mode 100644
index 00000000000..1221e712ad2
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/nmbib/Makefile
@@ -0,0 +1,70 @@
+#
+# Makefile for multibibliography package
+#
+# This file is in public domain
+#
+# $Id: Makefile,v 1.8 2015-04-27 19:29:03 boris Exp $
+#
+
+PACKAGE=nmbib
+SAMPLES = nmsample.tex
+
+PERLSCRIPTS = nmbibtex.pl
+
+MANPAGES = ${PERLSCRIPTS:%.pl=%.1}
+
+all:  $(PACKAGE).pdf ${SAMPLES:%.tex=%.pdf}  ${MANPAGES}
+	chmod a+x ${PERLSCRIPTS}
+
+%.pdf:  %.dtx   $(PACKAGE).sty 
+	pdflatex $<
+	perl nmbibtex.pl $*
+	pdflatex $<
+	- makeindex -s gind.ist -o $*.ind $*.idx
+	- makeindex -s gglo.ist -o $*.gls $*.glo
+	pdflatex $<
+	while ( grep -q '^LaTeX Warning: Label(s) may have changed' $*.log) \
+	do pdflatex $<; done
+
+
+
+
+%.sty:   %.ins %.dtx  
+	pdflatex $<
+
+%.pdf:  %.tex $(PACKAGE).sty
+	pdflatex $<
+	perl nmbibtex.pl $*
+	pdflatex $<
+	pdflatex $<
+	while ( grep -q '^LaTeX Warning: Label(s) may have changed' $*.log) \
+	do pdflatex $<; done
+
+
+.PRECIOUS:  $(PACKAGE).cfg $(PACKAGE).sty
+
+%.1: %.pl
+	pod2man $< $@
+
+clean:
+	$(RM)  $(PACKAGE).sty *.log *.aux \
+	*.cfg *.glo *.idx *.toc \
+	*.ilg *.ind *.out *.lof \
+	*.lot *.bbl *.blg *.gls *.hd \
+	*.dvi *.ps *.tgz *.zip *.brf
+
+veryclean: clean
+	$(RM) $(PACKAGE).pdf ${SAMPLES:%.tex=%.pdf} ${MANPAGES}
+
+distclean: veryclean
+
+#
+# Archive for the distribution. Includes typeset documentation
+#
+archive:  all clean
+	tar -czvf $(PACKAGE).tgz -C .. --exclude '*~' --exclude '*.tgz' --exclude CVS $(PACKAGE)
+
+zip:  all clean
+	${MAKE} $(PACKAGE).sty
+	$(RM) *.log
+	zip -r  $(PACKAGE).zip * -x '*~' -x '*.tgz' -x '*.zip' -x CVS -x 'CVS/*'
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/nmbib/README b/Master/texmf-dist/doc/latex/nmbib/README
new file mode 100644
index 00000000000..37f5f170b59
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/nmbib/README
@@ -0,0 +1,8 @@
+		    New Multibibliography Package
+		   Michael Cohen and Boris Veytsman
+
+The nmbib package is a rewrite of multibiliography package providing
+multiple bibliographies with different sorting.  The new version
+offers a number of citation commands, streamlines the creation of
+bibliographies, ensures the compatibility with natbib package and
+provides other improvments.
diff --git a/Master/texmf-dist/doc/latex/nmbib/nmbib.bib b/Master/texmf-dist/doc/latex/nmbib/nmbib.bib
new file mode 100644
index 00000000000..c98b87240ed
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/nmbib/nmbib.bib
@@ -0,0 +1,35 @@
+@Manual{Multibibliography,
+  title = 	 {The {M}ultibiliography package},
+  author =	 {Michael Cohen and Yannis Haralambous and Boris Veytsman},
+  month =	 {March},
+  year =	 2013,
+  note =	 {\url{http://www.ctan.org/pkg/multibibliography}}
+}
+
+@Article{Multibibliography13,
+  author = 	 {Michael Cohen and Yannis Haralambous and Boris Veytsman},
+  title = 	 {The multibibliography package},
+  journal = 	 {TUGboat},
+  year = 	 2013,
+  volume =	 34,
+  number =	 3,
+  pages =	 {340--343},
+  note =	 {\url{https://www.tug.org/members/TUGboat/tb34-3/tb108cohen.pdf}}
+}
+
+@Manual{Daly:Natbib,
+  title = 	 {Natural Sciences Citations and References
+                  (Author-Year and Numerical Schemes)},
+  author =	 {Patrick W. Daly},
+  month =	 {February},
+  year =	 2009,
+  note =	 {\url{http://mirrors.ctan.org/macros/latex/contrib/natbib}}
+}
+
+@Manual{Rahtz:Hyperref,
+  title = 	 {Hypertext Marks in \LaTeX: a Manual for Hyperref},
+  author =	 {Sebastian Rahtz and Heiko Oberdiek},
+  month =	 {November},
+  year =	 2012,
+  note =	 {\url{http://mirrors.ctan.org/macros/latex/contrib/hyperref}}
+}
diff --git a/Master/texmf-dist/doc/latex/nmbib/nmbib.pdf b/Master/texmf-dist/doc/latex/nmbib/nmbib.pdf
new file mode 100644
index 00000000000..ef337a95481
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/nmbib/nmbib.pdf
diff --git a/Master/texmf-dist/doc/latex/nmbib/nmbibtex.1 b/Master/texmf-dist/doc/latex/nmbib/nmbibtex.1
new file mode 100644
index 00000000000..bb7bb38f4bb
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/nmbib/nmbibtex.1
@@ -0,0 +1,163 @@
+.\" Automatically generated by Pod::Man 2.22 (Pod::Simple 3.07)
+.\"
+.\" Standard preamble:
+.\" ========================================================================
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.\" Set up some character translations and predefined strings.  \*(-- will
+.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
+.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
+.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
+.\" nothing in troff, for use with C<>.
+.tr \(*W-
+.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.ie n \{\
+.    ds -- \(*W-
+.    ds PI pi
+.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
+.    ds L" ""
+.    ds R" ""
+.    ds C` ""
+.    ds C' ""
+'br\}
+.el\{\
+.    ds -- \|\(em\|
+.    ds PI \(*p
+.    ds L" ``
+.    ds R" ''
+'br\}
+.\"
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\"
+.\" If the F register is turned on, we'll generate index entries on stderr for
+.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
+.\" entries marked with X<> in POD.  Of course, you'll have to process the
+.\" output yourself in some meaningful fashion.
+.ie \nF \{\
+.    de IX
+.    tm Index:\\$1\t\\n%\t"\\$2"
+..
+.    nr % 0
+.    rr F
+.\}
+.el \{\
+.    de IX
+..
+.\}
+.\"
+.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
+.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
+.    \" fudge factors for nroff and troff
+.if n \{\
+.    ds #H 0
+.    ds #V .8m
+.    ds #F .3m
+.    ds #[ \f1
+.    ds #] \fP
+.\}
+.if t \{\
+.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
+.    ds #V .6m
+.    ds #F 0
+.    ds #[ \&
+.    ds #] \&
+.\}
+.    \" simple accents for nroff and troff
+.if n \{\
+.    ds ' \&
+.    ds ` \&
+.    ds ^ \&
+.    ds , \&
+.    ds ~ ~
+.    ds /
+.\}
+.if t \{\
+.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
+.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
+.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
+.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
+.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
+.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
+.\}
+.    \" troff and (daisy-wheel) nroff accents
+.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
+.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
+.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
+.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
+.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
+.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
+.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
+.ds ae a\h'-(\w'a'u*4/10)'e
+.ds Ae A\h'-(\w'A'u*4/10)'E
+.    \" corrections for vroff
+.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
+.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
+.    \" for low resolution devices (crt and lpr)
+.if \n(.H>23 .if \n(.V>19 \
+\{\
+.    ds : e
+.    ds 8 ss
+.    ds o a
+.    ds d- d\h'-1'\(ga
+.    ds D- D\h'-1'\(hy
+.    ds th \o'bp'
+.    ds Th \o'LP'
+.    ds ae ae
+.    ds Ae AE
+.\}
+.rm #[ #] #H #V #F C
+.\" ========================================================================
+.\"
+.IX Title "NMBIBTEX 1"
+.TH NMBIBTEX 1 "2015-04-25" "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"
+nmbibtex \- a program to compile bibliographies for the package nmbib
+.SH "SYNOPSIS"
+.IX Header "SYNOPSIS"
+nmbibtex \fI\s-1OPTIONS\s0\fR \fI\s-1FILE\s0\fR
+.SH "DESCRIPTION"
+.IX Header "DESCRIPTION"
+nmbibtex calls \fIbibtex\fR\|(1) for all aux files produced by the package
+nmbib
+.SH "OPTIONS"
+.IX Header "OPTIONS"
+.IP "\fB\-h\fR" 4
+.IX Item "-h"
+Print the help information and exit
+.IP "\fB\-min\-crossrefs\fR \fInumber\fR" 4
+.IX Item "-min-crossrefs number"
+Send the option \f(CW\*(C`\-min\-crossref=NUMBER\*(C'\fR to \fIbibtex\fR\|(1)
+.IP "\fB\-terse\fR" 4
+.IX Item "-terse"
+Send the option \f(CW\*(C`\-terse\*(C'\fR to \fIbibtex\fR\|(1)
+.IP "\fB\-v\fR" 4
+.IX Item "-v"
+Print the copyright information and exit
+.SH "AUTHORS AND LICENSE"
+.IX Header "AUTHORS AND LICENSE"
+Copyright 2015, Michael Cohen mcohen@u\-aizu.ac.jp
+and Boris Veytsman borisv@lk.net
+.PP
+This work may be distributed and/or modified under the
+conditions of the LaTeX Project Public License, either
+version 1.3 of this license or (at your option) any 
+later version.
diff --git a/Master/texmf-dist/doc/latex/nmbib/nmbibtex.pl b/Master/texmf-dist/doc/latex/nmbib/nmbibtex.pl
new file mode 100755
index 00000000000..49468404d8b
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/nmbib/nmbibtex.pl
@@ -0,0 +1,120 @@
+#!/usr/bin/env perl
+# $Id: nmbibtex.pl,v 1.1 2015-04-26 00:19:37 boris Exp $
+#
+# Copyright 2015, Michael Cohen <mcohen@u-aizu.ac.jp>
+# and Boris Veytsman <borisv@lk.net>
+# This work may be distributed and/or modified under the
+# conditions of the LaTeX Project Public License, either
+# version 1.3 of this license or (at your option) any 
+# later version.
+# The latest version of the license is in
+#    http://www.latex-project.org/lppl.txt
+# and version 1.3 or later is part of all distributions of
+# LaTeX version 2003/06/01 or later.
+#
+# This work has the LPPL maintenance status `maintained'.
+#
+# The Current Maintainer of this work is Boris Veytsman
+
+=pod
+
+=head1 NAME
+
+nmbibtex - a program to compile bibliographies for the package nmbib
+
+=head1 SYNOPSIS
+
+nmbibtex I<OPTIONS> I<FILE>
+
+=head1 DESCRIPTION
+
+nmbibtex calls L<bibtex(1)> for all aux files produced by the package
+nmbib
+
+=head1 OPTIONS
+
+=over 4
+
+=item B<-h>
+
+Print the help information and exit
+
+=item B<-min-crossrefs> I<number>
+
+Send the option C<-min-crossref=NUMBER> to L<bibtex(1)>
+
+=item B<-terse>
+
+Send the option C<-terse> to L<bibtex(1)>
+
+=item B<-v>
+
+Print the copyright information and exit
+
+=back
+
+=head1 AUTHORS AND LICENSE
+
+Copyright 2015, Michael Cohen mcohen@u-aizu.ac.jp
+and Boris Veytsman borisv@lk.net
+
+This work may be distributed and/or modified under the
+conditions of the LaTeX Project Public License, either
+version 1.3 of this license or (at your option) any 
+later version.
+
+=cut
+
+    use strict;
+
+my $USAGE = <<'END';
+Usage: nmbibtex [-min-crossref NUMBER] [-terse] FILE
+
+Copyright 2015, Michael Cohen mcohen@u-aizu.ac.jp
+and Boris Veytsman borisv@lk.net
+
+This work may be distributed and/or modified under the
+conditions of the LaTeX Project Public License, either
+version 1.3 of this license or (at your option) any 
+later version.
+END
+
+    use Getopt::Long;
+
+my $help=0;
+my $terse=0;
+my $mincross=-1;
+
+GetOptions("h" => \$help, 
+	   'v' => \$help,
+	   '-terse' => \$terse,
+	   "-min-crossrefs=i" => \$mincross) or die $USAGE;
+
+if ($help){ 
+    die $USAGE;
+}
+
+my $cmdline = "bibtex ";
+if ($terse) {
+    $cmdline .= "-terse ";
+}
+if ($mincross>0) {
+    $cmdline .= "-min-crossrefs=$mincross ";
+}
+
+
+
+my $file = shift;
+
+if (!length($file)) {
+    die $USAGE;
+}
+
+# Just in case strip the suffix
+$file =~ s/\.aux$//;
+$file =~ s/\.AUX$//;
+
+my @auxfiles = glob("$file-*.aux");
+foreach my $auxfile (@auxfiles) {
+    print `$cmdline $auxfile`;
+}
diff --git a/Master/texmf-dist/doc/latex/nmbib/nmsample.pdf b/Master/texmf-dist/doc/latex/nmbib/nmsample.pdf
new file mode 100644
index 00000000000..9bc0db6880e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/nmbib/nmsample.pdf
diff --git a/Master/texmf-dist/doc/latex/nmbib/nmsample.tex b/Master/texmf-dist/doc/latex/nmbib/nmsample.tex
new file mode 100644
index 00000000000..56ff2a807a5
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/nmbib/nmsample.tex
@@ -0,0 +1,68 @@
+\documentclass{article}
+\usepackage{nmbib}
+\usepackage[colorlinks]{hyperref}
+\multibibliographystyle{timeline}{chronoplainnm}
+\multibibliographystyle{sequence}{unsrtnm}
+\multibibliographystyle{authors}{plainnm}
+\multibibliography{type,nmbib}
+\usepackage{booktabs}
+\usepackage[tableposition=top]{caption}
+\begin{document}
+
+The package \textsl{nmbib} allows several kinds of citations:
+author-year parenthetical \verb|\citep|:
+\citep{Daly:Customizing_Bibliographic_Style_Files}, author-year
+textual \verb|\citet|: \citet{kopka03}, authors only
+\verb|\citeauthor|: \citeauthor{Daly:Natbib}, year only
+\verb|\citeyear|: \citeyear{Mori:Managing_bibliographies}, numerical
+\verb|\citenum|: \citenum{Patashnik:bibtexing}, \verb|\citealn|:
+\citealn{Multibibliography}.  The \verb|\citeall| command produces the
+full citation: \citeall{Markey:Tame_the_BeaST}, close to the one
+produced by the \textsl{multibibliography} package
+\citep{Multibibliography, Multibibliography13}.
+
+Full citation command \verb|\citeall|: \citeall{Multibibliography,
+  Multibibliography13}.  The starred form: \verb|\citeall*|:
+\citeall*{Multibibliography, Multibibliography13}
+
+
+
+We can create links with a user-level universal command
+\verb|\nmbibLink|: \nmbibLink{Daly:Natbib}{authors}{Daly's package in
+  the alphabetic list}, \nmbibLink{kopka03}{sequence}{Kopka and Daly's
+  book in the sequential list}.
+
+\begin{table}
+  \centering
+  \caption{Examples of citation commands}
+  \label{tab:examples}
+  \begin{tabular}{ll}
+    \toprule
+    Command & Result\\
+    \midrule
+    \verb|\citet{Daly:Natbib}| & \citet{Daly:Natbib}\\
+    \verb|\citep{Daly:Natbib}| & \citep{Daly:Natbib}\\
+    \verb|\cite{Daly:Natbib}| & \cite{Daly:Natbib}\\
+    \verb|\citealt{Daly:Natbib}| & \citealt{Daly:Natbib}\\
+    \verb|\citealp{Daly:Natbib}| & \citealp{Daly:Natbib}\\
+    \verb|\citetext{Daly:Natbib}| & \citetext{Daly:Natbib}\\
+    \verb|\citenum{Daly:Natbib}| & \citenum{Daly:Natbib}\\
+    \verb|\citealn{Daly:Natbib}| & \citealn{Daly:Natbib}\\
+    \verb|\citeauthor{Daly:Natbib}| & \citeauthor{Daly:Natbib}\\
+    \verb|\citeyear{Daly:Natbib}| & \citeyear{Daly:Natbib}\\
+    \verb|\citefullauthor{Daly:Natbib}| &
+    \citefullauthor{Daly:Natbib}\\
+    \verb|\citeall{Daly:Natbib}| & \citeall{Daly:Natbib}\\
+    \bottomrule
+  \end{tabular}
+\end{table}
+
+\nmbibYearSuffixOff
+\clearpage
+\printbibliography{timeline}
+\clearpage
+\printbibliography{sequence}
+\clearpage
+\printbibliography{authors}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/nmbib/type.bib b/Master/texmf-dist/doc/latex/nmbib/type.bib
new file mode 100644
index 00000000000..07f730e834f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/nmbib/type.bib
@@ -0,0 +1,54 @@
+@string{TUB = "TUGboat: Communications of the {\TeX} Users Group"}
+@string{TUG = "TUG: {\TeX} Users Group Meeting"}
+
+@misc{Daly:Customizing_Bibliographic_Style_Files,
+	author = "Patrick W. Daly",
+	year = "2007",
+	title = "Customizing Bibliographic Style Files",
+	note = "\url{http://mirror.ctan.org/macros/latex/contrib/custom-bib/makebst.pdf}"
+}
+
+@misc{Daly:merlin.mbs,
+	author = "Patrick W. Daly",
+	year = "2011",
+	month = oct,
+	title = "{A Master Bibliographic Style File for numerical, author--year, multilingual applications}",
+	note = "\url{http://mirror.hmc.edu/ctan/macros/latex/contrib/custom-bib/merlin.pdf}, \url{http://ftp.jaist.ac.jp/pub/CTAN/macros/latex/contrib/custom-bib/merlin.pdf}, v.\,4.33"
+}
+
+@book{kopka03,
+	ISBN = {0-321-17385-6},
+	keywords = {Typography, LaTeX, Word Processing},
+	year = {2003},
+	author = {Helmut Kopka and Patrick W. Daly},
+	title = {Guide to LaTeX},
+	pages = {624},
+	edition = {4th},
+	publisher = {Addison-Wesley Professional}
+}
+
+@misc{Markey:Tame_the_BeaST,
+	author = "Nicolas Markey",
+	year = "2009",
+	month = oct,
+	title = "{Tame the BeaST: The B to X of Bib{\TeX}}",
+	note = "\url{ftp://ftp.tex.ac.uk/tex-archive/info/bibtex/tamethebeast/ttb_en.pdf}, v.\,1.4"
+}
+
+@article{Mori:Managing_bibliographies,
+	author = "Lapo F. Mori",
+	journal = TUG,
+	volume = 30,
+	number = 1,
+	year = 2009,
+	pages = "36-48",
+	title = "Managing bibliographies with {\LaTeX}"
+}
+
+@misc{Patashnik:bibtexing,
+	author = "Oren Patashnik",
+	year = "1998",
+	title = "Bib{\TeX}ing",
+	note = "\url{http://mirror.ctan.org/biblio/bibtex/contrib/doc/btxdoc.pdf}"
+}
+