summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/cite
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-09-13 19:16:35 +0000
committerKarl Berry <karl@freefriends.org>2010-09-13 19:16:35 +0000
commit8ac4866fb38af45e87b21dff99b0d56b506721a6 (patch)
treeca1b1afa5303dd8db10076f8046bef5b82ac5fe1 /Master/texmf-dist/doc/latex/cite
parent815cea44e9f0f8cdc1b7b8d69dcd507d010301c2 (diff)
cite update (12sep10)
git-svn-id: svn://tug.org/texlive/trunk@19710 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/cite')
-rw-r--r--Master/texmf-dist/doc/latex/cite/README5
-rw-r--r--Master/texmf-dist/doc/latex/cite/chapterbib.ltx243
-rw-r--r--Master/texmf-dist/doc/latex/cite/chapterbib.pdfbin0 -> 147894 bytes
-rw-r--r--Master/texmf-dist/doc/latex/cite/cite.ltx248
-rw-r--r--Master/texmf-dist/doc/latex/cite/cite.pdfbin0 -> 141446 bytes
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
Binary files differ
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
Binary files differ