cite update (12sep10)

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

5 files changed, 493 insertions, 3 deletions

diff --git a/Master/texmf-dist/doc/latex/cite/README b/Master/texmf-dist/doc/latex/cite/README
index 698a2c1b236..02ad1217160 100644
--- a/Master/texmf-dist/doc/latex/cite/README
+++ b/Master/texmf-dist/doc/latex/cite/README
@@ -10,9 +10,8 @@ drftcite.sty   Print the tags instead of the numbers for \cite and \bibitem.
 
 chapterbib.sty Do multiple bibliographies--one for each \include file.
 
-The documentation is included as plain text after the definitions in 
-each file (below \endinput).  It can be read online or printed directly, 
-but don't try to typeset it with LaTeX!
+The user manuals for cite and chapterbib are LaTeX files cite.ltx
+and chapterbib.ltx, and already typeset pdf versions.
 
 They are all released under a very simple permissive license in
 the MIT/BSD style:  They may be freely used, transmitted, reproduced, 
diff --git a/Master/texmf-dist/doc/latex/cite/chapterbib.ltx b/Master/texmf-dist/doc/latex/cite/chapterbib.ltx
new file mode 100644
index 00000000000..d0ac5dcf98a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/cite/chapterbib.ltx
@@ -0,0 +1,243 @@
+%
+%  chapterbib.ltx   Manual for chapterbib.sty
+%
+%
+%  Copyright (c) 1993-2010 by Donald Arseneau
+%
+%  Version 1.16 (5-Sep-2010)
+%
+\documentclass[12pt,a4paper]{ltxdoc}
+
+\setcounter{secnumdepth}{4}
+\renewcommand\theparagraph{\arabic{paragraph}}
+\newcommand\snugger{\vspace{-7pt}}
+
+\MakeShortVerb{\"}
+\hyphenpenalty=500
+\sloppy 
+
+\setlength\parskip{2pt}
+\raggedbottom
+
+\title{chapterbib\\ multiple bibliographies in \LaTeX}
+\author{Donald Arseneau\\ asnd@triumf.ca}
+\date{2010/09/05}
+\begin{document}
+\maketitle
+
+\begin{footnotesize}
+\noindent Chapterbib is copyright \copyright\ 1989--2010 by 
+Niel Kempson and Donald Arseneau.\\
+The package (chapterbib.sty) and this documentation (chapterbib.ltx,
+chapterbib.pdf) may be freely transmitted, reproduced, or modified 
+for any purpose provided that the copyright notice is left intact.
+(Small excerpts may of course be taken and used without any restriction.)
+\par
+\end{footnotesize}
+
+\section*{Introduction}
+
+ The chapterbib package facilitates multiple bibliographies in a 
+ \LaTeX\ document, including items \cs{cite}d (cited) in more than
+ one bibliography.  Despite the name `chapterbib',
+ the \emph{bibliographies are for each included file}, not necessarily
+ for each chapter, although a bibliography per chapter is the usual 
+ application.  The main point is to allow you to use \BibTeX: Each
+ included file should have its own \cs{bibliographystyle} and
+ \cs{bibliography} commands, and you should run bibtex on each included
+ file separately rather than on the main or root file.
+
+ Chapterbib also provides the environment |cbunit|, and the command
+ \cs{cbinput} to allow multiple bibliographies without using \cs{include}
+ (see item~\ref{cbinput}).
+ There are two added hooks, \cs{citeform} and \cs{citepunct}, which you can 
+ redefine to customize the formatting of each entry in a citation list,
+ and the declaration \cs{CitationPrefix} to use in preference to \cs{citeform}
+ for numbering-by-chapter.
+
+ Alternative packages: bibunits, biblatex.
+
+\clearpage
+
+\section*{Usage, Restrictions, and Options}
+
+\paragraph{Normal use: } \leavevmode \label{normaluse}% 1.
+Put \cs{bibliographystyle} and \cs{bibliography} commands in
+    each \cs{include}d file. Run \LaTeX; run \BibTeX\ on each included file;
+    run \LaTeX; run \LaTeX.
+
+\snugger\paragraph{Whole bibliography: } \label{whole} % 2.
+    With chapterbib, the \cs{bibliography} and |\bibliography|\-|style|
+    commands are not normally used in the root file, only in files that
+    have been \cs{include}d. To have a whole-document bibliography, see
+    items \ref{separate}--\ref{duplicate}, depending on which style of
+    whole-document bib.
+
+\snugger\paragraph{Without \textbackslash include: } \label{cbinput} % 3.
+ If you can't use \cs{include} because a new section must start below the
+    preceding bibliography on the same page (odd format!), then you can
+    use |\begin{cbunit}|\dots|\end{cbunit}| (for everything in one file)
+    or \cs{cbinput}, with a |thebibliography| environment in each unit
+    or input file.
+
+    To use \BibTeX, input separate files using \cs{cbinput}; at first use
+    the package or global option |[draft]|, run \LaTeX\ on the document,
+    then \BibTeX\ on each file that was \cs{cbinput}; finally, remove 
+    the |[draft]| option and run \LaTeX\ again (maybe twice to get page
+    references right).  The |[draft]| option only affects the treatment
+    of \cs{cbinput}, not \cs{include} or |\begin{cbunit}|.
+
+\snugger\paragraph{Package compatability: }\label{compatability} % 4.
+    Your preferred citation style (call it xxx.sty) may not work with
+    chapterbib at first, but it is easy to make it compatible:
+    In `xxx.sty' change every `|@\@citeb|' to `|@\@citeb\@extra@b@citeb|',
+    and insert the line\\[3pt]
+    \indent 
+      |\@ifundefined{@extra@b@citeb}{\def\@extra@b@citeb{}}{}|\\[3pt]
+    somewhere (but not as a comment or as part of another definition!).
+
+    If the package also redefines \cs{bibcite} then you should change that
+    definition, replacing `|@#1|' with `|@#1\@extra@binfo|', and insert
+    \\[3pt]\indent
+        |\gdef\@extra@binfo{}|\\[3pt]
+    somewhere in the file.  If the package defines a command that acts
+    similarly to \cs{bibcite} (being written to the aux file, and then 
+    executed as the aux file is processed), then it should
+    have `|\@extra@binfo|' inserted in the same way. 
+
+    Some citation packages deviate quite far from \LaTeX's own method
+    of organizing cite tags using `|b@\@citeb|'.  The instructions above
+    catch such extensions as `|Y@\@citeb|', but not more radical differences.
+    In such cases, try contacting the author of the citation package.
+
+    If a citation style does not (re)define \cs{nocite}, then that command
+    would not be converted when you make the patches at `|@\@citeb|'.
+    Chapterbib will try to detect the presence of \cs{@extra@b@citeb} 
+    in \cs{nocite} and insert it, but if that fails you may need to 
+    redefine \cs{nocite} changing any `|@\@citeb|' to 
+    `|@\@citeb\@extra@b@citeb|' in that sty file.
+
+\snugger\paragraph{Sectionbib: }\label{sectionbib} % 5.
+ The report and book document classes usually treat the bibliography as
+    an unnumbered chapter (|\chapter*|), which is not so good for
+    bibliographies \emph{in} a chapter.  You can specify\\[3pt]
+    \indent
+        |\usepackage[sectionbib]{chapterbib}| \\[3pt]
+    to convert your bibliographies from |\chapter*| to |\section*|, with an
+    entry in the table of contents and the page-header.  A bibliography in
+    the root file remains as a |\chapter*|.  The |[sectionbib]| option modifies
+    the existing |thebibliography| environment (or the \cs{bibsection}
+    command, if present already), so the other formatting in the bibliography
+    should remain unchanged.  On the other hand, if you already have a
+    non-standard bibliography defined, or if you want them numbered, it
+    may be easier to redefine \cs{thebibliography} directly, without any
+    tricky modification of existing commands.
+
+      Alternatively, you can use the \cs{sectionbib} command directly in the
+    document preamble.  It takes two parameters: the sectioning command, and
+    the name of the sectioning level.  For instance, the |[sectionbib]| option
+    executes |\sectionbib{\section*}{section}|. Again, for the most control,
+    it is better to redefine \cs{thebibliography} entirely.
+
+ 
+\snugger\paragraph{Overall separate bibliography: }   \label{separate} %6.
+ If you want a completely unrelated bibliography in the root file, perhaps
+    for a general reading list, you can provide your own bibliography there
+    using the |thebibliography| environment.  I don't suppose this will appeal
+    to \BibTeX\ users!
+
+\snugger\paragraph{Overall bibliography: }\label{overall}% 7.
+    To have a cohesive bibliography for the whole document, plus individual
+    bibs in the chapters, put \cs{bibliography} commands in the included
+    chapters plus in the root file.  Make sure the \cs{bibliographystyle}
+    for the overall bibliography appears \emph{first}, before any chapters
+    are included. Run \LaTeX; run \BibTeX\ on the root file; run \BibTeX\ on
+    each included file; run \LaTeX; run \LaTeX.
+    This produces an independent `overall' bibliography which only
+    makes sense for various `named' bibliography styles; a numbered style, or
+    one with any type of automatic enumeration (like Me2007a, Me2007b) will 
+    give unrelated numbers in each bibliography and lead to confusion.
+
+    \BibTeX\ will complain about multiple \cs{bibdata} commands when it makes
+    the whole bibliography, but it should obey the first.  If you don't 
+    want to see any error messages from bibtex, or if you don't want to put 
+    the main \cs{bibliographystyle} command first in the document, then use 
+    |\usepackage[rootbib]{chapterbib}| when you run \LaTeX\ first; run 
+    \BibTeX\ on the root file; change to |\usepackage{chapterbib}|; run 
+    \LaTeX; run \BibTeX\ on each included file; run \LaTeX; run \LaTeX.
+
+\snugger\paragraph{Chapter bibs gathered to end: }\label{gather} % 8.
+    To have a bibliography-by-chapter at the end instead of separate 
+    bibs in the chapters, use |\usepackage[gather]{chapterbib}|, put
+    \cs{bibliography} commands in each file, and at the end of the main
+    file. Run \LaTeX\ as in item~\ref{normaluse}. You can control the
+    titling of the final bibliographies by defining \cs{FinalBibTitles},
+    such as\\[3pt] 
+      \indent|\newcommand\FinalBibTitles|\\
+      \indent \indent |{References for Chapter \thechapter}|\\[3pt]
+    A similar effect may be achieved by re-defining \cs{FinalBibPrefix} as
+     \\[3pt] \indent
+      |\renewcommand\FinalBibPrefix{References for }|\\[3pt]
+    Even more control is achieved by redefining \cs{StartFinalBibs}.
+    The default definition is (like)
+\begin{verbatim}
+    \newcommand{\StartFinalBibs}{%
+      \renewcommand{\bibname}{Bibliography for chapter n}}
+\end{verbatim}
+    normally, but when using the [sectionbib] option it becomes
+\begin{verbatim}
+    \newcommand{\StartFinalBibs}{\chapter*{\bibname}%
+      \addcontentsline{toc}{chapter}{\bibname}%
+      \@mkboth{\bibname}{\bibname}%
+      \renewcommand{\bibname}{Chapter n}}
+\end{verbatim}
+    where the \cs{bibname} text is now provided by \cs{@auto@bibname},
+    which relies on bookkeeping and \cs{FinalBibPrefix}.
+
+    If your document class has neither section nor chapter, then you must
+    define \cs{StartFinalBibs} and also indicate the sectioning: for example,
+    if the main sectioning command in your document class is \cs{motif}:
+    \\[3pt]\indent
+        |\newcommand\CBMainSectioning{motif}|
+
+\snugger\paragraph{Duplicate bibliographies at end: } \label{duplicate}% 9  
+    To have bibliographies in each chapter \emph{plus} a 
+    bibliography-by-chapter at the end, follow item~\ref{gather}, 
+    but declare\\[3pt]
+    \indent  |\usepackage[duplicate]{chapterbib}|\\
+    \indent  (or |\usepackage[duplicate,sectionbib]{chapterbib}|).
+
+\snugger\paragraph{Babel: }  % 10
+ If you use Babel, load chapterbib before babel.
+
+\section*{Formatting extensions}
+\snugger\paragraph*{\textbackslash citeform}
+ Normally, the citations are formatted as given, but you can define 
+ \cs{citeform} (with one parameter) to reformat every citation.
+  Some possibilities:\\[3pt]
+  \quad |\renewcommand\citeform[1]{\romannumeral 0#1}| \hfill [iv,x]\\
+  \quad |\renewcommand\citeform[1]{(#1)}   | \hfill [(3),(4),(7)]\\[3pt]
+ If you change \cs{citeform}, you should really define \cs{@biblabel} to match.
+
+ A not-so-good way to provide a chapter-number prefix is\\[3pt]
+ \indent |\renewcommand\citeform[1]{\thechapter.#1}| \\[3pt]
+ This partially works, but has only limited applicability: it does not 
+ work with cites in the front-matter (TOC, LOF) or with hyperref.
+
+\snugger\paragraph*{\textbackslash CitationPrefix}
+ Instead, there is a \cs{CitationPrefix} command to apply a prefix to the 
+ citation numbers (or names) in the bibliographies and \cs{cite} commands 
+ for the included files. Use it by declaring something like\\[3pt]
+  \indent |\CitationPrefix{\thechapter.}| \\[3pt]
+ in the preamble.  The prefix will be applied to all the chapter-bibs
+ but will not be used in an overall (root) bibliography, if you have one.
+ This not only affects the formatting but the actual citation, therefore
+ it immediately applies to \cs{bibitem} (no need to change \cs{@biblabel})
+ and works with hyperref. (The \cs{CitationPrefix} mechanism may be
+ prone to conflicts with other packages.)
+
+\snugger\paragraph*{\textbackslash citepunct}
+ The \cs{citepunct} command gives the punctuation (comma-penalty-space)
+ between items in the \cs{cite} list, and you can redefine it.
+
+\end{document}
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/cite/chapterbib.pdf b/Master/texmf-dist/doc/latex/cite/chapterbib.pdf
new file mode 100644
index 00000000000..9cdeb1d6f0c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/cite/chapterbib.pdf
diff --git a/Master/texmf-dist/doc/latex/cite/cite.ltx b/Master/texmf-dist/doc/latex/cite/cite.ltx
new file mode 100644
index 00000000000..285569ad6f4
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/cite/cite.ltx
@@ -0,0 +1,248 @@
+%
+%  cite.ltx   Manual for cite.sty
+%
+%
+%  Copyright (c) 1989-2010 by Donald Arseneau
+%
+%  Version date (Sep 2010)
+%
+\documentclass[12pt,a4paper]{ltxdoc}
+%\overfullrule=1pt
+\addtolength{\textwidth}{1cm}
+\MakeShortVerb{\"}
+\hyphenpenalty=600
+\newcommand\snugger{\vspace{-7pt}}
+\sloppy
+
+\setlength\parskip{2pt}
+
+\title{The cite package:\\ well formed numeric citations}
+\author{Donald Arseneau\\ asnd@triumf.ca}
+\date{2010/09/10}
+\begin{document}
+\maketitle
+
+\begin{abstract}
+  The cite package modifies \LaTeX's normal citation mechanism for 
+improved handling of numeric citations. It provides compressed, sorted 
+lists of numerical or partly-numerical citations, as regular text or 
+superscripts.  Generally, no changes to the usage of \cs{cite} commands
+is required.
+\end{abstract}
+
+
+\begin{footnotesize}
+\noindent The cite package is Copyright \copyright\ 1989--2010 by 
+Donald Arseneau (Vancouver, Canada).\\
+The package (cite.sty) and this documentation (cite.ltx,cite.pdf) may be 
+freely transmitted, reproduced, or modified for any purpose provided that the
+copyright notice is left intact.
+(Small excerpts may of course be taken and used without any restriction.)
+\par
+\end{footnotesize}
+
+\section*{Normal Use}
+Insert "\usepackage{cite}" in the document's preamble for improved handling
+of numeric citations, behaving as follows:
+
+\snugger\paragraph*{Spacing} Put a comma and a small space between 
+  each citation number. The option [nospace] removes that space, and
+  the option [space] replaces it with an ordinary inter-word space.
+
+\snugger\paragraph*{Compress groups} Compress lists of three or more
+  consecutive numbers to one number range which can be split, with
+  difficulty, after the dash.  All numbers should be greater than zero.
+  E.g., if you used to get the (nonsense) list 
+  [7,5,6,?,4,9,8,Einstein,6], then this style will give [?,Einstein,4--6,6--9].
+  Compression of ranges is disabled by the [nocompress] package option.
+
+\snugger\paragraph*{Sorting} Sort citations into ascending order
+ (this is the default, but may also be declared with the package
+ option [sort]). The [nosort] package option turns off sorting.
+  Sortable citations must fit one of these forms:
+   \begin{enumerate}\itemsep=-\parsep
+    \item  \meta{number}
+    \item  \meta{optional-char}\meta{number}\meta{optional-char}
+    \item  \meta{number}\meta{separator-char}\meta{number}
+  \end{enumerate}
+  Forms 1 and 2 are really the same, and they mix well, but form 3 is
+  different, so it can't be mixed with the other forms (not that you 
+  would want to).
+  Non-sortable forms (those not listed) are printed before
+  all sortable forms.  Here \meta{number} means a positive integer (natural 
+  number) less than some limit (different for each form), \meta{optional-char}
+  is a single printable character (or nothing), and \meta{separator-char} 
+  is also a single printable character.
+
+\snugger\paragraph*{Prefix/suffix letters} Sort citations with prefix 
+  and/or suffix characters (form~2) such that
+  different prefixes are grouped separately, and suffixes form sub-lists 
+  for the same number.  Compression knows about suffixes, so you can get
+  lists like [18a--18c,19] or [A2,Q1,Q3--Q5].
+
+\snugger\paragraph*{Numbers alone}  The command "\citen" is provided to give
+  just the citation numbers without the brackets or superscript
+  and other formatting.  Aliases are "\citenum" and "\citeonline" for easy
+  conversion to other citation packages.
+
+\snugger\paragraph*{Breaks} Allow, but discourage, line breaks within
+  the group of citations (after dashes, and after punctuation). 
+  Penalties are "\citepunctpenalty" and "\citemidpenalty". 
+
+\snugger\paragraph*{Breaks and spaces before} Allow but strongly discourage
+  line-breaks before the entire citation, provided it is a regular text 
+  cite (not superscript) and no different penalty was specified there
+  (thus, "~\cite{X}" will not permit a line break).  Also, adjust the 
+  spacing: if there is no space or if there is extra space due to some 
+  punctuation, then change to one inter-word space; e.g.,   
+  "A space will be inserted here\cite{Larry,Curly,Moe}".
+
+\snugger\paragraph*{Prohibiting breaks} All breaks can be forbidden 
+  with the [nobreak] package option.  Allowance of any type of line break can 
+  be adjusted independently by setting the parameters "\citeprepenalty", 
+  "\citemidpenalty", and "\citepunctpenalty" (see Customization below).
+
+\snugger\paragraph*{Superscript} With package option [superscript] 
+  (or [super] for short), display citation numbers as superscripts.
+  But if the citation has an optional note, it is printed on-line
+  with brackets.  Superscripted citations follow these additional rules:
+  \begin{itemize}
+   \setlength\itemsep{0pt}
+
+\item Superscript citations use \emph{the same input format} as ordinary
+   citations to produce different output. Blank space before the |\cite|
+   command is discarded, and trailing punctuation is moved to come before
+   the superscript citation. For example, `"information \cite{source};"'
+   ignores the space before "\cite" and puts the semicolon before the number
+   to give `information;$^{12}$\,', just as if you typed `"information;$^{12}$"'.
+   You may disable movement with the [nomove] package option.
+
+\item The punctuation characters that will migrate before the superscript are
+   listed in the macro "\CiteMoveChars", which you can redefine (using 
+   "\renewcommand").  The default set of characters is ".,;:";  Perhaps 
+   "!"~and~"?" should be included too, but
+   they weren't listed in the APS style manual I looked at, and I agree with 
+   that design choice because they put too much visual separation between the 
+   cite and what it applies to.  Feel free to redefine "\CiteMoveChars".  Quotes
+   were listed as coming before the cite notation, but they should be typed 
+   before the "\cite" command in any case because both on-line and superscript
+   cites come after what is quoted (when citing a quotation). This gives one
+   difficulty~-- punctuation following quotes won't migrate inside the 
+   quotation: e.g., "``Transition State Theory''\cite{Eyring}." gives out
+   ``Transition State Theory''.$^8$, but you may want the period inside the
+   quotes, thus: ``Transition State Theory.''$^8$.
+
+\item Doubling of periods (.., ?., !.) is checked for and suppressed.
+   The spacing after the citation is set according to the final punctuation
+   mark moved. There is a problem with double periods after a capitalized
+   abbreviation or directly after "\@" : Both of `"N.S.A. \cite{space}."' and 
+   `"et al.\@ \cite{many}."' will give doubled periods.  Type `"\ "' (backslash 
+   space) after abbreviations like `et al.'  ("et al.\ \cite{many}.")
+   to get the right spacing within a sentence whether or not a citation follows,
+   and prevent double periods with the superscript cite. You could use "\@" to 
+   fix the N.S.A. example ("N.S.A\@. \cite{space}.") but that gives the wrong
+   spacing when there is no citation, so it should be inserted only where a
+   cite follows.
+
+\item Remember, these rules regarding punctuation only apply when the [super]
+   or [superscript] option was given (or overcite.sty used) and the [nomove]
+   option was \emph{not} given.
+
+\end{itemize}
+
+\section*{Customization}
+
+There are several options for "\usepackage{cite}", some already mentioned.
+\begin{center}
+\begin{tabular}{lp{0.75\linewidth}}
+ [superscript]& use superscripts for cites without optional notes\\\relax
+ [super]      & alias for [superscript] (like natbib)\\\relax
+ [ref]        & uses the format "[Ref.~12, given note]" (useful with 
+               the superscript option)\\\relax
+ [nospace]    & eliminates the spaces after commas in the number list\\\relax
+ [space]      & uses a full inter-word space after the commas\\\relax
+ [nobreak]    & eliminate all line-breaks\\\relax
+ [nosort]     & prevents sorting of the numbers (default is to sort, and the\dots\\\relax
+ [sort]       & option is provided for completeness).\\\relax
+ [nomove]     & prevents moving the superscript cite after punctuation\\\relax
+ [move]       & is the default\\\relax
+ [noadjust]   & disables `smart' handling of space before a cite\\\relax
+ [adjust]     & is the default\\\relax
+ [nocompress] & inhibit compression of consecutive numbers into ranges\\\relax
+ [compress]   & is the default\\\relax
+ [biblabel]   & define the bibliography label as a superscript
+\end{tabular}
+\end{center}
+
+If your citations are not numeric, and not of any near-numeric sortable form,
+then you should probably not use cite.sty; but if you must, then at least 
+use the [nosort,nocompress] options.
+
+There are several commands that you may redefine to change the 
+formatting of citation lists:
+
+\begin{center}
+\begin{tabular}{@{}lll@{}}
+command      &    function          &          default\\
+\hline
+\cs{citeform}      &  reformats each number      & nothing\\
+\cs{citepunct}     &  printed between numbers    & comma, penalty, thin space\\
+\cs{citeleft}      &  left delimiter of list     & [\\
+\cs{citeright}     &  right delimeter of list    & ]\\
+\cs{citemid}       &  printed before note        & comma, penalty, space\\
+\cs{citedash}      &  used in compressed range   & endash, penalty\\
+\cs{CiteMoveChars} &  characters that move        & \texttt{.,:;}\\
+\cs{OverciteFont}  &  font sel. for superscripts & \relax"\fontsize{\sf@size}"\dots\\
+\end{tabular}
+\end{center}
+
+The left/mid/right commands don't affect the formatting of superscript
+citations.  You may use "\renewcommand" to change any of these.  Remember,
+these commands are extensions made by this package; they are not regular
+LaTeX.  Some examples of changes:
+
+\begin{flushleft}
+"\renewcommand\citeform[1]{\romannumeral 0#1}}" $\to$  roman i,vi\\
+"\renewcommand\citeform[1]{(#1)}" $\to$  parentheses (1)--(5),(9)\\
+"\renewcommand\citeform{\thechapter.}" $\to$  by chapter: \textsuperscript{2.18--2.21}\\
+"\renewcommand\citepunct{,}" $\to$  no space and no breaks at commas\\
+"\renewcommand\citemid{; }" $\to$  semicolon before optional note\\
+"\renewcommand\citeleft{(}" $\to$  parentheses around whole\\
+"\renewcommand\citeright{)}" $\to$  parentheses around whole list\\
+\end{flushleft}
+
+The appearance of the whole citation list is governed by "\@cite", (for 
+full-sized cites) and "\@citess" (for superscripts).  For more extensive changes 
+to the formatting, redefine these.  For example, to get brackets around the 
+list of superscript numbers you can do:\\[2pt]
+\indent "\renewcommand\@citess[1]{\textsuperscript{[#1]}}"\\[2pt]
+(after "\makeatletter").
+
+Related Note:  The superscript option does not affect the numbering format
+of the bibliography; the "[12]" style is still the default.  To get
+superscripts in the bibliography (at any time) you can define\\[2pt]
+\indent
+   "\renewcommand\@biblabel[1]{\textsuperscript{#1}}"\\[2pt]
+Aw, OK, for your convenience, there is the [biblabel] package option that
+just performs this definition (sort of).
+
+Line breaking can be turned off using the [nobreak] option.  It can be
+controlled more precisely by changing three numeric values for the 
+line-break penalties:
+\begin{center}
+\begin{tabular}{lll}
+Command & Location  & Default \\
+\hline
+\cs{citeprepenalty} &  before entire cite  &  "\@highpenalty"\\
+\cs{citemidpenalty} &  used in "\citemid"  &  "\@medpenalty"\\
+\cs{citepunctpenalty}&  used in "\citepunct" &  1000
+\end{tabular}
+\end{center}
+Use "\mathchardef" to change these penalty values!  E.g., \\
+\indent "\mathchardef\citeprepenalty=9999"\\ 
+(Yes, that is obscure but I don't want to use up counters or to
+pretend they are counters.)  Alternatively, the commands "\citemid", 
+"\citedash", and "\citepunct" can be redefined to use different 
+penalty parameters, or none at all.
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/cite/cite.pdf b/Master/texmf-dist/doc/latex/cite/cite.pdf
new file mode 100644
index 00000000000..4702476963f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/cite/cite.pdf