From 8ac4866fb38af45e87b21dff99b0d56b506721a6 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 13 Sep 2010 19:16:35 +0000 Subject: cite update (12sep10) git-svn-id: svn://tug.org/texlive/trunk@19710 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/cite/README | 5 +- Master/texmf-dist/doc/latex/cite/chapterbib.ltx | 243 +++++++++++++++++++++++ Master/texmf-dist/doc/latex/cite/chapterbib.pdf | Bin 0 -> 147894 bytes Master/texmf-dist/doc/latex/cite/cite.ltx | 248 ++++++++++++++++++++++++ Master/texmf-dist/doc/latex/cite/cite.pdf | Bin 0 -> 141446 bytes 5 files changed, 493 insertions(+), 3 deletions(-) create mode 100644 Master/texmf-dist/doc/latex/cite/chapterbib.ltx create mode 100644 Master/texmf-dist/doc/latex/cite/chapterbib.pdf create mode 100644 Master/texmf-dist/doc/latex/cite/cite.ltx create mode 100644 Master/texmf-dist/doc/latex/cite/cite.pdf (limited to 'Master/texmf-dist/doc/latex') 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 Binary files /dev/null and b/Master/texmf-dist/doc/latex/cite/chapterbib.pdf 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 Binary files /dev/null and b/Master/texmf-dist/doc/latex/cite/cite.pdf differ -- cgit v1.2.3