From a643657f90f559e2f2059e2e70de89be3e249023 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 2 Jan 2020 22:06:59 +0000 Subject: epigraph (2jan20) git-svn-id: svn://tug.org/texlive/trunk@53298 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/epigraph/README | 78 ---------------- Master/texmf-dist/doc/latex/epigraph/README.md | 89 ++++++++++++++++++ Master/texmf-dist/doc/latex/epigraph/epigraph.pdf | Bin 183661 -> 314219 bytes .../texmf-dist/source/latex/epigraph/epigraph.dtx | 100 +++++++++++++-------- Master/texmf-dist/tex/latex/epigraph/epigraph.sty | 31 ++++--- 5 files changed, 171 insertions(+), 127 deletions(-) delete mode 100644 Master/texmf-dist/doc/latex/epigraph/README create mode 100644 Master/texmf-dist/doc/latex/epigraph/README.md diff --git a/Master/texmf-dist/doc/latex/epigraph/README b/Master/texmf-dist/doc/latex/epigraph/README deleted file mode 100644 index fa639ba1c2f..00000000000 --- a/Master/texmf-dist/doc/latex/epigraph/README +++ /dev/null @@ -1,78 +0,0 @@ -____________________ -The EPIGRAPH package - - The epigraph package is designed for typesetting epigraphs --- the -pithy quotations often found at the start (or end) of a chapter. Both -single epigraphs and lists of epigraphs are catered for. Various aspects -are easily configurable. - -______________ -Change History - -Version 1.5c (2009/09/02) -- New maintainer (Will Robertson) - -Changes in Version 1.5a (2002/10/22) -- Replaced flushleftright environment by flushepinormal environment - to avoid clash with the ccaption package's \flushleftright - -Changes in Version 1.5 (2000/02/20) -- Generalised \cleartoevenpage command - -Changes in Version 1.4 (2000/01/16) -- Added flushleftright environment - -Changes in Version 1.3 (1999/12/01) -- Added \dropchapter and \undodrop commands - -Changes in Version 1.2 (1999/09/12) -- Added \cleartoevenpage command -- Improved documentation - -Changes in Version 1.1: (1998/11/29) -- Added support for epigraphs above chapter titles. - ------------------------------------------------------------------ - Author: Peter Wilson, Herries Press - Maintainer: Will Robertson (will dot robertson at latex-project dot org) - Copyright 1998--2004 Peter R. Wilson - - This work may be distributed and/or modified under the - conditions of the LaTeX Project Public License, either - version 1.3c of this license or (at your option) any - later version: - - This work has the LPPL maintenance status "maintained". - The Current Maintainer of this work is Will Robertson. - - This work consists of the files: -README (this file) -epigraph.dtx -epigraph.ins -epigraph.pdf (user manual) - and the derived files: -epigraph.sty - -The distribution consists of the files: -README (this file) -epigraph.dtx -epigraph.ins -epigraph.pdf (user manual) - ------------------------------------------------------------------ - -To install the package: -- run: latex epigraph.ins (which will generate epigraph.sty) -- Move epigraph.sty to a location where LaTeX will find it - (typically in a local texmf tree at tex/latex/***) and refresh the - file database. See the FAQ on CTAN at help/uk-tex-faq or - http://www.tug.ac.uk/faq for more information on this. - -To process the user manual: -- run: latex epigraph.dtx -- run: makeindex -s gind.ist epigraph -- run: latex epigraph.dtx -- Print epigraph.dvi for a hardcopy of the package manual - -2004/04/22 -Peter Wilson diff --git a/Master/texmf-dist/doc/latex/epigraph/README.md b/Master/texmf-dist/doc/latex/epigraph/README.md new file mode 100644 index 00000000000..e5a7ff4849d --- /dev/null +++ b/Master/texmf-dist/doc/latex/epigraph/README.md @@ -0,0 +1,89 @@ +# The EPIGRAPH package + +The epigraph package is designed for typesetting epigraphs --- the +pithy quotations often found at the start (or end) of a chapter. Both +single epigraphs and lists of epigraphs are catered for. Various aspects +are easily configurable. + +## Change History + +Version 1.5e (2020/01/02) +- Try to prevent breaks after epigraphs +- Add \epigraphnoindent to automatically suppress indentation + after all \epigraph commands + +Version 1.5d (2011/08/07) +- Load the nextpage package for \cleartoevenpage + (this avoids loading order conflicts) + +Version 1.5c (2009/09/02) +- New maintainer (Will Robertson) + +Changes in Version 1.5a (2002/10/22) +- Replaced flushleftright environment by flushepinormal environment + to avoid clash with the ccaption package's \flushleftright + +Changes in Version 1.5 (2000/02/20) +- Generalised \cleartoevenpage command + +Changes in Version 1.4 (2000/01/16) +- Added flushleftright environment + +Changes in Version 1.3 (1999/12/01) +- Added \dropchapter and \undodrop commands + +Changes in Version 1.2 (1999/09/12) +- Added \cleartoevenpage command +- Improved documentation + +Changes in Version 1.1: (1998/11/29) +- Added support for epigraphs above chapter titles. + +## Copyright + + Author: Peter Wilson, Herries Press + Maintainer: Will Robertson + will dot robertson at latex-project dot org + Copyright 1998--2004 Peter R. Wilson + 2009--2020 Will Robertson + + This work may be distributed and/or modified under the + conditions of the LaTeX Project Public License, either + version 1.3c of this license or (at your option) any + later version: + + This work has the LPPL maintenance status "maintained". + The Current Maintainer of this work is Will Robertson. + +## Manifest + +This work consists of the files: +* README (this file) +* epigraph.dtx +* epigraph.ins +* epigraph.pdf (user manual) +and the derived files: +* epigraph.sty + +The distribution consists of the files: +* README (this file) +* epigraph.dtx +* epigraph.ins +* epigraph.pdf (user manual) + +## Installation + +To install the package: +- run: latex epigraph.ins (which will generate epigraph.sty) +- Move epigraph.sty to a location where LaTeX will find it + (typically in a local texmf tree at tex/latex/***) and refresh the + file database. See the FAQ on CTAN at help/uk-tex-faq or + http://www.tug.ac.uk/faq for more information on this. +- (or `l3build install`) + +To process the user manual: +- run: latex epigraph.dtx +- run: makeindex -s gind.ist epigraph +- run: latex epigraph.dtx +- (or `l3build doc`) + diff --git a/Master/texmf-dist/doc/latex/epigraph/epigraph.pdf b/Master/texmf-dist/doc/latex/epigraph/epigraph.pdf index 6b8773e03b6..7de33cf1978 100644 Binary files a/Master/texmf-dist/doc/latex/epigraph/epigraph.pdf and b/Master/texmf-dist/doc/latex/epigraph/epigraph.pdf differ diff --git a/Master/texmf-dist/source/latex/epigraph/epigraph.dtx b/Master/texmf-dist/source/latex/epigraph/epigraph.dtx index baec16b14d0..046530f5a59 100644 --- a/Master/texmf-dist/source/latex/epigraph/epigraph.dtx +++ b/Master/texmf-dist/source/latex/epigraph/epigraph.dtx @@ -3,6 +3,7 @@ % Author: Peter Wilson, Herries Press % Maintainer: Will Robertson (will dot robertson at latex-project dot org) % Copyright 1998--2004 Peter R. Wilson +% Copyright 2011 Will Robertson % % This work may be distributed and/or modified under the % conditions of the LaTeX Project Public License, either @@ -27,7 +28,7 @@ % % \fi % -% \CheckSum{242} +% \CheckSum{244} % % \DoNotIndex{\',\.,\@M,\@@input,\@addtoreset,\@arabic,\@badmath} % \DoNotIndex{\@centercr,\@cite} @@ -80,12 +81,15 @@ % \changes{v1.5a}{2002/10/22}{Fixed class with ccaption package} % \changes{v1.5b}{2004/04/22}{Updated license and contact details} % \changes{v1.5c}{2009/09/02}{New maintainer (Will Robertson)} +% \changes{v1.5d}{2011/08/07}{Load package `nextpage' for \cs{cleartoevenpage}} % % \def\dtxfile{epigraph.dtx} % \def\fileversion{v1.5} \def\filedate{2000/02/20} % \def\fileversion{v1.5a} \def\filedate{2002/10/22} % \def\fileversion{v1.5b} \def\filedate{2004/04/22} % \def\fileversion{v1.5c} \def\filedate{2009/09/02} +% \def\fileversion{v1.5d} \def\filedate{2011/08/07} +% \def\fileversion{v1.5e} \def\filedate{2020/01/02} % \newcommand*{\Lpack}[1]{\textsf {#1}} ^^A typeset a package % \newcommand*{\Lopt}[1]{\textsf {#1}} ^^A typeset an option % \newcommand*{\file}[1]{\texttt {#1}} ^^A typeset a file @@ -111,7 +115,7 @@ % Maintainer: Will Robertson\\ % \texttt{will dot robertson at latex-project dot org} % } -% \date{\filedate} +% \date{\fileversion\qquad\filedate} % \maketitle % \begin{abstract} % The \Lpack{epigraph} package can be used to typeset a relevant @@ -151,7 +155,7 @@ % The \Lpack{epigraph} package provides commands for typesetting % a single epigraph and environments for typesetting a list of epigraphs. % Epigraphs can be typeset at either the left, the center or the right of -% the typeblock. A few example eipgraphs are exhibited here, and +% the typeblock. A few example epigraphs are exhibited here, and % others can be found in an article by % Christina Thiele~\cite{TTC199}. % @@ -181,7 +185,7 @@ % % \DescribeMacro{\qitem} % Each epigraph in the list is specified by a -% |\qitem{|\meta{text}|}{|\meta{source}|}| command (analagous to the |\item| +% |\qitem{|\meta{text}|}{|\meta{source}|}| command (analogous to the |\item| % command in ordinary list environments). % By default, the \meta{source} is typeset at the bottom right of the % \meta{text}. @@ -194,22 +198,30 @@ % {\textit{Letters on a Regicide Peace}\\ \textsc{Edmund Burke}} % % The commands described in this section apply to both the |\epigraph| -% command and the |epigraphs| environment. But first of all, note that an -% epigraph immediately after a heading will cause the first paragraph -% of the following text to be indented. If you want the initial paragraph -% to have no indentation, then start it with the |\noindent| command. +% command and the |epigraphs| environment. +% +% An epigraph immediately after a heading will cause the first paragraph +% of the following text to be indented. +% If you want the initial paragraph +% to have no indentation, then start it with the |\noindent| command, or +% \DescribeMacro{\epigraphnoindent} +% add |\epigraphnoindent| to your document preamble. +% (|\epigraphnoindentfalse| will reverse the setting.) +% This command only affects the |\epigraph| command; for the |epigraphs| environment +% the |\noindent| approach must still be used. % % \DescribeMacro{\epigraphwidth} -% \DescribeMacro{\textflush} % The epigraphs are typeset in a minipage of width |\epigraphwidth|. The default % value for this can be changed using the |\setlength| command. Typically, -% epigraphs are typset in a measure much less than the width of the textblock. +% epigraphs are typeset in a measure much less than the width of the textblock. +% +% \DescribeMacro{\textflush} % In order to avoid bad line breaks, the \meta{text} is normally typeset -% raggedright. +% ragged right. % The |\textflush| command controls the \meta{text} typesetting style, % and it can be redefined from its default value of -% \texttt{flushleft} (which produces raggedright). The sensible values -% are \texttt{center} for centered text, \texttt{flushright} for raggedleft +% \texttt{flushleft} (which produces ragged right). The sensible values +% are \texttt{center} for centered text, \texttt{flushright} for ragged left % text, and \texttt{flushepinormal} for normal justified text. % % If by any chance you want the \meta{text} to be typeset in some @@ -261,7 +273,7 @@ % \DescribeMacro{\afterepigraphskip} % The two |...skip| commands specify the amount of vertical space inserted % before and after typeset epigraphs. Again, these can be changed by -% |\setlength|. It is desireable that the sum of their values should be an +% |\setlength|. It is desirable that the sum of their values should be an % integer multiple of the |\baselineskip|. % % Note that you can use normal \LaTeX{} commands in the \meta{text} and @@ -288,8 +300,8 @@ % for printing at \meta{distance} below the header on a page. % \meta{text} can be ordinary text or, more likely, can be either an % |\epigraph| command or an |epigraphs| environment. By default, the -% epigraph will be typeset at the righthand margin. -% If the command is immediately preceeded by a |\chapter| or |\chapter*| +% epigraph will be typeset at the right-hand margin. +% If the command is immediately preceded by a |\chapter| or |\chapter*| % command, the epigraph is typeset on the chapter title page. % % The default value for the optional \meta{distance} argument is set so @@ -347,12 +359,13 @@ % of a chapter, where the something belongs to the chapter that is about to % start rather than the chapter that has just ended. In order to do this % in a document that is going to be printed -% doublesided, the chapter must start on an odd numbered page and the -% pre-chapter material put on the immediately preceeding even numbered page. +% double-sided, the chapter must start on an odd numbered page and the +% pre-chapter material put on the immediately preceding even numbered page. % The |\cleartoevenpage| command is like the |\cleardoublepage| except % that the page following the command will be an even numbered page, and the % command takes an optional argument, i.e., |\cleartoevenpage{|[arg|]|, % which is applied to the skipped page (if any). +% This command is provided by the \texttt{nextpage} package. % % Here is an example: % \begin{verbatim} @@ -421,7 +434,7 @@ % The value of the optional argument may need changing to vertically adjust % the position of the epigraph. If there is any |\part| that does not have an % epigraph then an empty |\epigraphhead| command (i.e., |\epigraphhead{}|) -% must be placed immediately befor the |\part| command. +% must be placed immediately before the |\part| command. % % \end{itemize} % @@ -484,7 +497,8 @@ % \begin{macrocode} %<*usc> \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{epigraph}[2009/09/02 v1.5c typesetting epigraphs] +\ProvidesPackage{epigraph}[2020/01/02 v1.5e typesetting epigraphs] +\RequirePackage{nextpage} % \end{macrocode} % % \begin{macro}{\beforeepigraphskip} @@ -515,6 +529,16 @@ % \end{macrocode} % \end{macro} % +% \begin{macro}{\epigraphnoindent} +% \begin{macro}{\ifepigraphnoindent} +% Whether to add \cs{noindent} (false by default for backwards compatibility). +% \begin{macrocode} +\newif\ifepigraphnoindent +\newcommand\epigraphnoindent{\epigraphnoindenttrue} +% \end{macrocode} +% \end{macro} +% \end{macro} +% % \begin{macro}{\epigraphflush} % \begin{macro}{\textflush} % \begin{macro}{\sourceflush} @@ -596,11 +620,21 @@ % for a single epigraph. This is set in a minipage to prevent breaking % across a page. Position it according to |\epigraphflush|. % \begin{macrocode} -\newcommand{\epigraph}[2]{\vspace{\beforeepigraphskip} - {\epigraphsize\begin{\epigraphflush}\begin{minipage}{\epigraphwidth} - \@epitext{#1}\\ \@episource{#2} - \end{minipage}\end{\epigraphflush} - \vspace{\afterepigraphskip}}} +\newcommand{\epigraph}[2]{% + \vspace{\beforeepigraphskip} + \vbox{% + \epigraphsize + \begin{\epigraphflush} + \begin{minipage}{\epigraphwidth} + \@epitext{#1}\\ + \@episource{#2}% + \end{minipage}% + \end{\epigraphflush}% + }% + \nointerlineskip + \vspace*{\afterepigraphskip}% + \ifepigraphnoindent\@afterheading\fi +} % \end{macrocode} % \end{macro} % @@ -643,25 +677,13 @@ \leftmargin\z@ \rightmargin\z@ \let\makelabel\qitemlabel}}% {\endlist\end{minipage}\end{\epigraphflush} - \vspace{\afterepigraphskip}} + \vspace{\afterepigraphskip}% +} % \end{macrocode} % \end{environment} % % \subsection{Epigraphs before a chapter title} % -% \begin{macro}{\cleartoevenpage} -% Like |\cleardoublepage| except that it skips pages until an even one, and -% its optional argument is applied to the skipped page, if any. -% The code is based on the kernel |\cleardoublepage| in \file{ltoutput.dtx}. -% \changes{v1.2}{1999/09/12}{Added \cs{cleartoevenpage} command} -% \changes{v1.5}{2000/02/20}{Added optional arg to \cs{cleartoevenpage}} -% \begin{macrocode} -\providecommand{\cleartoevenpage}[1][\@empty]{% - \clearpage% - \ifodd\c@page\hbox{}#1\clearpage\fi} -% \end{macrocode} -% \end{macro} -% % \begin{macro}{\@epichapapp} % \begin{macro}{\dropchapter} % \begin{macro}{\undodrop} diff --git a/Master/texmf-dist/tex/latex/epigraph/epigraph.sty b/Master/texmf-dist/tex/latex/epigraph/epigraph.sty index 57f0a71154a..f403da44319 100644 --- a/Master/texmf-dist/tex/latex/epigraph/epigraph.sty +++ b/Master/texmf-dist/tex/latex/epigraph/epigraph.sty @@ -23,7 +23,8 @@ %% ----------------------------------------------------------------- %% \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{epigraph}[2009/09/02 v1.5c typesetting epigraphs] +\ProvidesPackage{epigraph}[2020/01/02 v1.5e typesetting epigraphs] +\RequirePackage{nextpage} \newlength{\beforeepigraphskip} \setlength{\beforeepigraphskip}{.5\baselineskip} \newlength{\afterepigraphskip} @@ -33,6 +34,8 @@ \newlength{\epigraphrule} \setlength{\epigraphrule}{.4\p@} \newcommand{\epigraphsize}{\small} +\newif\ifepigraphnoindent +\newcommand\epigraphnoindent{\epigraphnoindenttrue} \newcommand{\epigraphflush}{flushright} \newcommand{\textflush}{flushleft} \newcommand{\sourceflush}{flushright} @@ -57,11 +60,21 @@ \newcommand{\@episource}[1]{% \begin{minipage}{\epigraphwidth}\begin{\sourceflush} #1\end{\sourceflush} \end{minipage}} -\newcommand{\epigraph}[2]{\vspace{\beforeepigraphskip} - {\epigraphsize\begin{\epigraphflush}\begin{minipage}{\epigraphwidth} - \@epitext{#1}\\ \@episource{#2} - \end{minipage}\end{\epigraphflush} - \vspace{\afterepigraphskip}}} +\newcommand{\epigraph}[2]{% + \vspace{\beforeepigraphskip} + \vbox{% + \epigraphsize + \begin{\epigraphflush} + \begin{minipage}{\epigraphwidth} + \@epitext{#1}\\ + \@episource{#2}% + \end{minipage}% + \end{\epigraphflush}% + }% + \nointerlineskip + \vspace*{\afterepigraphskip}% + \ifepigraphnoindent\@afterheading\fi +} \newcommand{\qitem}[2]{{\raggedright\item \begin{minipage}{\epigraphwidth} \@epitext{#1}\\ \@episource{#2} \end{minipage}}} @@ -75,10 +88,8 @@ \leftmargin\z@ \rightmargin\z@ \let\makelabel\qitemlabel}}% {\endlist\end{minipage}\end{\epigraphflush} - \vspace{\afterepigraphskip}} -\providecommand{\cleartoevenpage}[1][\@empty]{% - \clearpage% - \ifodd\c@page\hbox{}#1\clearpage\fi} + \vspace{\afterepigraphskip}% +} \newcommand{\dropchapter}[1]{% \let\@epichapapp\@chapapp \renewcommand{\@chapapp}{\vspace*{#1}\@epichapapp}} -- cgit v1.2.3