diff options
author | Karl Berry <karl@freefriends.org> | 2016-10-16 21:36:24 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2016-10-16 21:36:24 +0000 |
commit | 64ca6a153402b7880664aba0f56df2f84ea54129 (patch) | |
tree | a7f926e0b8a2fb20b579a0b678e2338f51d7db36 /Master/texmf-dist/source/latex/imakeidx/imakeidx.dtx | |
parent | b165b0f9b0e15b177d4cc7cc721464549fee1380 (diff) |
imakeidx (16oct16)
git-svn-id: svn://tug.org/texlive/trunk@42287 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/imakeidx/imakeidx.dtx')
-rw-r--r-- | Master/texmf-dist/source/latex/imakeidx/imakeidx.dtx | 50 |
1 files changed, 27 insertions, 23 deletions
diff --git a/Master/texmf-dist/source/latex/imakeidx/imakeidx.dtx b/Master/texmf-dist/source/latex/imakeidx/imakeidx.dtx index 4c016e27b84..0a97c54d4f1 100644 --- a/Master/texmf-dist/source/latex/imakeidx/imakeidx.dtx +++ b/Master/texmf-dist/source/latex/imakeidx/imakeidx.dtx @@ -42,7 +42,7 @@ and the derived files imakeidx.sty and imakeidx.pdf. %<package>\NeedsTeXFormat{LaTeX2e}[2005/12/01] %<package>\ProvidesPackage{imakeidx}% %<*package> - [2016/05/16 v1.3d Package for typesetting indices in a synchronous mode] + [2016/10/15 v1.3e Package for typesetting indices in a synchronous mode] %</package> %<*driver> \documentclass{ltxdoc} @@ -77,7 +77,7 @@ and the derived files imakeidx.sty and imakeidx.pdf. \end{document} %</driver> % \fi -% \CheckSum{785} +% \CheckSum{788} % % \changes{v1.0}{2010/07/10}{First public version} % \changes{v1.0a}{2010/07/12}{Small bug correction} @@ -96,7 +96,8 @@ and the derived files imakeidx.sty and imakeidx.pdf. % the `nonewpage' option and the `noautomatic' option} % \changes{v1.3b}{2016/04/03}{LuaTeX 0.90 doesn't support \texttt{\char92 write18}} % \changes{v1.3c}{2016/05/16}{\pack{xpatch} is not loaded any more} -% \changes{v1.3c}{2016/06/28}{No change, bumped version number} +% \changes{v1.3d}{2016/06/28}{No change, bumped version number} +% \changes{v1.3e}{2016/10/15}{Don't leave \texttt{\char92 shellescape} defined} % % \begin{abstract} % This package exploits the |\write18| facility of modern \TeX\ system @@ -128,7 +129,7 @@ and the derived files imakeidx.sty and imakeidx.pdf. % incorporates the extensions of \eTeX\ and has the ability to open a % shell so as to call system commands with their arguments. The same % is true for \prog{xetex} and \prog{luatex}. -% +% % This facility, since the \TeX~Live 2010 distribution, is official, % but is sort of restricted, in the sense that the \TeX\ system % configuration file contains a list of ``safe'' system commands that @@ -165,10 +166,10 @@ and the derived files imakeidx.sty and imakeidx.pdf. % restricted shell escape is active or not, so the automatic procedure % will be tried anyway, unless disabled with the \texttt{noautomatic} % package option. With version 0.68 or later, the behavior is the same -% as with the other engines. Note that, starting from version 1.3b of -% this package, the automatic call of MakeIndex is done through -% \texttt{os.execute} which might not work with older versions of -% Lua\TeX{}. It has been tested with \TeX~Live from the 2012 +% as with the other engines. Note that, starting from version 1.3b of +% this package, the automatic call of MakeIndex is done through +% \texttt{os.execute} which might not work with older versions of +% Lua\TeX{}. It has been tested with \TeX~Live from the 2012 % release.\par} % % @@ -331,7 +332,7 @@ and the derived files imakeidx.sty and imakeidx.pdf. % \texttt{plain}. You might want to set it to \texttt{empty} or some % other page style defined by the class or by yourselves. This keyword % is disabled when the package \pack{fancyhdr} is loaded; any definition -% or choice of page styles must be done before typesetting the indices. +% or choice of page styles must be done before typesetting the indices. % \Item[headers] which takes two values: the left and right marks. You % might want to use this for disabling automatic uppercasing, by % saying, for example, |headers={\indexname}{\indexname}|; notice that @@ -429,7 +430,7 @@ and the derived files imakeidx.sty and imakeidx.pdf. % \texttt{-shell-escape} (which is \texttt{--enable-write18} for % MiK\TeX) typesetting program option or the \texttt{noautomatic} % option should be specified when loading \pack{imakeidx}. -% +% % Let's look at a couple of examples. In both we suppose that the % document \texttt{mybook.tex} defines two indices through %\begin{verbatim} @@ -569,7 +570,7 @@ and the derived files imakeidx.sty and imakeidx.pdf. % |\indexprologue| to write some text before the index proper gets typeset; % an optional space may be used in place of the default one-line spacing % between the index title, the prologue and the index body. -% +% % This facility relies on a particular feature of the |multicols| % environment, that \pack{imakeidx} uses to instruct the typesetting % program to typeset the index with a specified number of balanced columns. @@ -673,14 +674,14 @@ and the derived files imakeidx.sty and imakeidx.pdf. % an interaction between \pack{memoir} and \pack{showidx} that required % special attention. See below about using \pack{showidx}. % -% \subsubsection{Package \pack{showidx}} +% \subsubsection{Package \pack{showidx}} % % Up to version 1.1 this package did not allow to use it together with the \pack{showidx} % package; now it is, provided that \pack{showidx} is loaded \emph{before} \pack{imakeidx}. % See below more information on using \pack{showidx}. % % \subsubsection{Package \pack{fancyhdr}} -% +% % When using package \pack{fancyhdr} some inconveniences did show up; now we believe % we have detected the causes and we implemented the necessary corrections\footnote{Thanks % to Maïeul Rouquette, who spotted the problems and also suggested some patches.}. @@ -710,7 +711,7 @@ and the derived files imakeidx.sty and imakeidx.pdf. %\newcommand\nindex[1]{\orig@@index{#1|innote}} %\newcommand\innote[1]{#1\textit{n}} %... -%\makeindex[...] +%\makeindex[...] %... %\AtBeginDocument{% % \pretocommand{\@footnotetext}{\let\index\nindex}{}{} @@ -818,7 +819,7 @@ and the derived files imakeidx.sty and imakeidx.pdf. % % Therefore if by chance you get double entries into the table of contents, % eliminate the \Kvalue{intoc} option from your calls; your class, -% packages, and settings are already taking care of it. +% packages, and settings are already taking care of it. % The package \pack{tocbibind} should be loaded with the \Kvalue{noindex} % option, otherwise it would interfere with our redefinition of @@ -837,8 +838,8 @@ and the derived files imakeidx.sty and imakeidx.pdf. % % \subsection{Index location customization} % -% Some packages might want to use the facilities of \emph{imakeidx} to offer customized -% index commands, where the entry location is not expressed by a page number, +% Some packages might want to use the facilities of \emph{imakeidx} to offer customized +% index commands, where the entry location is not expressed by a page number, % but by an other reference value (for example: line number, entry number, etc.). % % These packages may use the low-level command \cs{imki@wrindexentry} which takes three arguments: @@ -1048,7 +1049,7 @@ and the derived files imakeidx.sty and imakeidx.pdf. % % From here on, some commands are duplicated; this depends on the % fact that the behavior must be different when using \prog{splitindex} or -% not. The memory occupied by the useless commands will be cleared at the +% not. The memory occupied by the useless commands will be cleared at the % end of package. % \begin{macrocode} \providecommand*\makeindex{} % to use \renewcommand safely @@ -1179,7 +1180,7 @@ and the derived files imakeidx.sty and imakeidx.pdf. \fi} % \end{macrocode} % -% ^^A D - \index +% ^^A D - \index % % Provide a default definition for \cs{index}; when a \cs{makeindex} % command is given and \LaTeX\ is writing on auxiliary files, @@ -1222,7 +1223,7 @@ and the derived files imakeidx.sty and imakeidx.pdf. % Therefore we use the same boolean used by \pack{memoir}, testing in advance so as not % defining it twice; then we use it to let the \pack{showidx} true or simulated macros do % their job, but we also take care of resetting the switch default value to -% false at begin document time if the \pack{memoir} class is being used. +% false at begin document time if the \pack{memoir} class is being used. % % % \begin{macrocode} @@ -1263,14 +1264,17 @@ and the derived files imakeidx.sty and imakeidx.pdf. % \prog{luatex} we can't emit the proper messages if \prog{luatex} is % not version 0.68 or later. The conditional % \cs{ifKV@imki@noautomatic} is defined by \cs{define@boolkey} above. +% \changes{v1.3e}{2016/10/15}{Don't leave \texttt{\char92 shellescape} defined} % % \begin{macrocode} \def\imki@shellwarn{} \ifdefined\imki@shellescape % luatex \else - \@ifundefined{shellescape} - {\let\imki@shellescape\pdfshellescape} % pdftex - {\let\imki@shellescape\shellescape} % xetex + \ifdefined\shellescape + \let\imki@shellescape\shellescape % xetex + \else + \let\imki@shellescape\pdfshellescape % pdftex + \fi \fi \ifnum\imki@shellescape=\z@ \let\KV@imki@noautomaticfalse\KV@imki@noautomatictrue |