diff options
Diffstat (limited to 'Master/texmf-dist')
-rw-r--r-- | Master/texmf-dist/doc/latex/showlabels/README | 82 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/showlabels/VERSION | 2 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/showlabels/showlabels.html | 107 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/showlabels/showlabels.pdf | bin | 87529 -> 87669 bytes | |||
-rw-r--r-- | Master/texmf-dist/source/latex/showlabels/showlabels.drv | 65 | ||||
-rw-r--r-- | Master/texmf-dist/source/latex/showlabels/showlabels.dtx | 47 | ||||
-rw-r--r-- | Master/texmf-dist/tex/latex/showlabels/showlabels.sty | 15 |
7 files changed, 213 insertions, 105 deletions
diff --git a/Master/texmf-dist/doc/latex/showlabels/README b/Master/texmf-dist/doc/latex/showlabels/README index ccf99ddcdae..764533b88c9 100644 --- a/Master/texmf-dist/doc/latex/showlabels/README +++ b/Master/texmf-dist/doc/latex/showlabels/README @@ -3,21 +3,60 @@ Put the names of \labels and other commands into the margins of a draft document. - Version 1.6.3, 2008 July 24, http://purl.org/nxg/dist/showlabels. + Version 1.6.4, 2008 October 10, http://purl.org/nxg/dist/showlabels. - This class option introduces no new commands, it just helps you keep - track of all the labels by putting the name of the new label into the - margin whenever either the \label command is used, or an equation is - automatically numbered (by replacing the internal \@eqnnum command). - There are therefore no usage instructions. You invoke this package with - the command \usepackage{showlabels} in the preamble, and you may give - the options [inner] or [outer] (the default) to have the labels placed - in the inner or outer margin of the text. + This class option helps you keep track of all the labels in your + documents, by putting the name of the new label into the margin + whenever either the \label command is used, or an equation is + automatically numbered. It is compatible with the amsmath and hyperref + packages. + + It is similar to, but does a little more than, the showkeys package. + + You invoke this package with the command \usepackage{showlabels} in the + preamble. You can control where the labels appear -- in the margins or + in the interline gaps -- and you can change the appearance of the + formatted labels to some extent. + + As well, you can have the arguments to other commands besides \label + displayed. This is fairly obviously useful for the \cite command, but + it can be useful for \ref or \begin as well. The package will also work in the presence of the [twocolumn] option. In this case, the options [inner] and [outer] will be ignored, and the label will be placed in the nearer margin. + Compatibility and problems + + For reasonably obvious reasons, this package will not work at all well + with the multicol package, and for possibly less obvious reasons, it + won't work with the [leqno] option either (at some point it should be + modified to at least recognise and warn of the conflict in either + case). The package can occasionally place labels in the wrong margins, + near the top of a page -- see the documentation for a discussion of + this. + + Download and installation + + 1. Download the file showlabels-1.6.4.tar.gz or + showlabels-1.6.4.zip and unpack it. + 2. Run LaTeX on the file showlabels.ins -- this will unpack the style + file showlabels.sty amongst other files. Place this somewhere where + TeX can find it. + 3. Run LaTeX on the file showlabels.dtx to obtain the documentation. + + On CTAN: /tex-archive/macros/latex/contrib/showlabels/ + + On the web http://purl.org/nxg/dist/showlabels + + History + + 1.6.4, 2008 October 10 + Fixed another poor interaction between eqnarray and amsart. Now + we get equation labels in eqnarray, and we don't get marginal + notes about \eqref (which is good; might this finally be + fixed?). + 1.6.3, 2008 July 24 Release 1.6.2 broke compatibility with the rest of amsmath (eqnarray became the only thing that worked within amsmath)! @@ -101,28 +140,5 @@ package alone, though it will probably work with older versions in fact. - Compatibility and problems - - For reasonably obvious reasons, this package will not work at all well - with the multicol package, and for possibly less obvious reasons, it - won't work with the [leqno] option either (at some point it should be - modified to at least recognise and warn of the conflict in either - case). The package can occasionally place labels in the wrong margins, - near the top of a page -- see the documentation for a discussion of - this. - - Download and installation - - 1. Download the file showlabels-1.6.3.tar.gz or - showlabels-1.6.3.zip and unpack it. - 2. Run LaTeX on the file showlabels.ins -- this will unpack the style - file showlabels.sty amongst other files. Place this somewhere where - TeX can find it. - 3. Run LaTeX on the file showlabels.dtx to obtain the documentation. - - On CTAN: /tex-archive/macros/latex/contrib/showlabels/ - - On the web http://purl.org/nxg/dist/showlabels - Norman Gray - 2008 July 24 + 2008 October 10 diff --git a/Master/texmf-dist/doc/latex/showlabels/VERSION b/Master/texmf-dist/doc/latex/showlabels/VERSION index f74342b9e03..99e60399ca0 100644 --- a/Master/texmf-dist/doc/latex/showlabels/VERSION +++ b/Master/texmf-dist/doc/latex/showlabels/VERSION @@ -1 +1 @@ -showlabels-1.6.3 +showlabels-1.6.4 diff --git a/Master/texmf-dist/doc/latex/showlabels/showlabels.html b/Master/texmf-dist/doc/latex/showlabels/showlabels.html index 33b0198d962..03bcfe29a4b 100644 --- a/Master/texmf-dist/doc/latex/showlabels/showlabels.html +++ b/Master/texmf-dist/doc/latex/showlabels/showlabels.html @@ -13,28 +13,78 @@ <div class="abstract"> <p>Put the names of <code>\label</code>s and other commands into the margins of a draft document.</p> -<p>Version 1.6.3, 2008 July 24, +<p>Version 1.6.4, 2008 October 10, <a href='http://purl.org/nxg/dist/showlabels' ><code>http://purl.org/nxg/dist/showlabels</code></a>.</p> </div> -<p>This class option introduces no new commands, it just helps you -keep track of all the labels by putting the name of the new label into -the margin whenever either the <code>\label</code> command is used, or -an equation is automatically numbered (by replacing the internal -<code>\@eqnnum</code> command). There are therefore no usage -instructions. You invoke this package with the command -<code>\usepackage{showlabels}</code> in the preamble, and you may give -the options <code>[inner]</code> or <code>[outer]</code> (the default) -to have the labels placed in the inner or outer margin of the text.</p> +<p>This class option helps you keep track of all the labels in your +documents, by putting the name of the new label into the margin +whenever either the <code>\label</code> command is used, or an +equation is automatically numbered. It is compatible with the +<code>amsmath</code> and <code>hyperref</code> packages.</p> + +<p>It is similar to, but does a little more than, the showkeys package.</p> + +<p>You invoke this package with the command +<code>\usepackage{showlabels}</code> in the preamble. You can control +where the labels appear -- in the margins or in the interline gaps -- +and you can change the appearance of the formatted labels to some +extent.</p> + +<p>As well, you can have the arguments to other commands besides +<code>\label</code> displayed. This is fairly obviously useful for +the <code>\cite</code> command, but it can be useful for +<code>\ref</code> or <code>\begin</code> as well.</p> <p>The package will also work in the presence of the <code>[twocolumn]</code> option. In this case, the options <code>[inner]</code> and <code>[outer]</code> will be ignored, and the label will be placed in the nearer margin.</p> +<h3>Compatibility and problems</h3> + +<p>For reasonably obvious reasons, this package will <em>not</em> work at +all well with the multicol package, and for possibly less obvious +reasons, it won't work with the <code>[leqno]</code> option either (at +some point it should be modified to at least recognise and warn of the +conflict in either case). The package can occasionally place labels +in the wrong margins, near the top of a page -- see the documentation +for a discussion of this.</p> + +<h3>Download and installation</h3> + +<ol> +<li>Download the file +<a href="showlabels-1.6.4.tar.gz" >showlabels-1.6.4.tar.gz</a> +or +<a href="showlabels-1.6.4.zip" >showlabels-1.6.4.zip</a> +and unpack it.</li> + +<li>Run LaTeX on the file <code>showlabels.ins</code> -- this will +unpack the style file <code>showlabels.sty</code> amongst other files. +Place this somewhere where TeX can find it. </li> + +<li>Run LaTeX on the file <code>showlabels.dtx</code> to obtain the +documentation.</li> +</ol> + +<p>On CTAN: +<a href='http://www.tex.ac.uk/tex-archive/macros/latex/contrib/showlabels/' + >/tex-archive/macros/latex/contrib/showlabels/</a></p> + +<p>On the web +<a href="http://purl.org/nxg/dist/showlabels" + ><code>http://purl.org/nxg/dist/showlabels</code></a></p> + +<h3>History</h3> <dl> +<dt>1.6.4, 2008 October 10</dt> +<dd>Fixed another poor interaction between eqnarray and amsart. Now +we get equation labels in eqnarray, and we don't get marginal notes +about <code>\eqref</code> (which is good; might this finally be fixed?).</dd> + <dt>1.6.3, 2008 July 24</dt> <dd>Release 1.6.2 broke compatibility with the <em>rest</em> of amsmath (<code>eqnarray</code> became the only thing that worked @@ -135,45 +185,10 @@ older versions in fact. </dl> -<h3>Compatibility and problems</h3> - -<p>For reasonably obvious reasons, this package will <em>not</em> work at -all well with the multicol package, and for possibly less obvious -reasons, it won't work with the <code>[leqno]</code> option either (at -some point it should be modified to at least recognise and warn of the -conflict in either case). The package can occasionally place labels -in the wrong margins, near the top of a page -- see the documentation -for a discussion of this.</p> - -<h3>Download and installation</h3> - -<ol> -<li>Download the file -<a href="showlabels-1.6.3.tar.gz" >showlabels-1.6.3.tar.gz</a> -or -<a href="showlabels-1.6.3.zip" >showlabels-1.6.3.zip</a> -and unpack it.</li> - -<li>Run LaTeX on the file <code>showlabels.ins</code> -- this will -unpack the style file <code>showlabels.sty</code> amongst other files. -Place this somewhere where TeX can find it. </li> - -<li>Run LaTeX on the file <code>showlabels.dtx</code> to obtain the -documentation.</li> -</ol> - -<p>On CTAN: -<a href='http://www.tex.ac.uk/tex-archive/macros/latex/contrib/showlabels/' - >/tex-archive/macros/latex/contrib/showlabels/</a></p> - -<p>On the web -<a href="http://purl.org/nxg/dist/showlabels" - ><code>http://purl.org/nxg/dist/showlabels</code></a></p> - <div class="signature"> <a href="http://www.astro.gla.ac.uk/users/norman/" >Norman Gray</a><br/> -2008 July 24 +2008 October 10 </div> </body> diff --git a/Master/texmf-dist/doc/latex/showlabels/showlabels.pdf b/Master/texmf-dist/doc/latex/showlabels/showlabels.pdf Binary files differindex aac05201c57..fbdeb2b259e 100644 --- a/Master/texmf-dist/doc/latex/showlabels/showlabels.pdf +++ b/Master/texmf-dist/doc/latex/showlabels/showlabels.pdf diff --git a/Master/texmf-dist/source/latex/showlabels/showlabels.drv b/Master/texmf-dist/source/latex/showlabels/showlabels.drv new file mode 100644 index 00000000000..ae2e961c032 --- /dev/null +++ b/Master/texmf-dist/source/latex/showlabels/showlabels.drv @@ -0,0 +1,65 @@ +%% +%% This is file `showlabels.drv', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% showlabels.dtx (with options: `driver') +%% Showlabels: Style to display labels in the margin +%% This is the showlabels package +%% +%% This software is copyright, 1999, 2001--2008, Norman Gray. +%% +%% This program is free software; you can redistribute it and/or +%% modify it under the terms of the GNU General Public License +%% as published by the Free Software Foundation; either version 2 +%% of the License, or (at your option) any later version. +%% +%% This program is distributed in the hope that it will be useful, +%% but WITHOUT ANY WARRANTY; without even the implied warranty of +%% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +%% GNU General Public License for more details. +%% +%% You should have received a copy of the GNU General Public License +%% along with this program; if not, write to the Free Software +%% Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. +%% +%% Author: Norman Gray, norman@astro.gla.ac.uk. +%% Department of Physics and Astronomy, University of Glasgow, UK +%% +%% See the file LICENCE for a copy of the GPL. +%% You can also find an online copy at http://www.gnu.org/copyleft/gpl.html . +%% +%% $Id: showlabels.dtx,v 1.36 2008/10/10 21:32:01 norman Exp $ +%% +\def\filename{showlabels} +\def\fileversion{1.6.4} +\def\filedate{2008/10/10} +\def\docdate{2008 October 10} +\def\filemaintainer{norman@astro.gla.ac.uk} +\documentclass{ltxdoc} +\EnableCrossrefs +\newcommand\Lopt[1]{\textsf{#1}} % package options +\newcommand\file[1]{\texttt{#1}} % filename +\newcommand\Lenv[1]{\textsl{\{#1\}}} +\newcommand\pstyle[1]{\textsf{\{#1\}}} % packages +%% \url macro (url.sty does this better, but we don't want extra dependencies) +\def\setpathdots{\discretionary{.}{}{.}} +\def\setpathslash{\discretionary{/}{}{/}} +{\catcode`\.=\active + \catcode`\/=\active + \gdef\pathcats{% + \catcode`\%=12 \catcode`\~=12 + \catcode`\.=\active \let.\setpathdots + \catcode`\/=\active \let/\setpathslash + \catcode`\#=12 \catcode`\_=12}% + } +\def\setpath#1{\ttfamily <\nobreak #1\nobreak>\endgroup} +\def\url{\begingroup\pathcats\setpath} +\begin{document} +\DocInput{showlabels.dtx} +\PrintIndex +\end{document} +\endinput +%% +%% End of file `showlabels.drv'. diff --git a/Master/texmf-dist/source/latex/showlabels/showlabels.dtx b/Master/texmf-dist/source/latex/showlabels/showlabels.dtx index c6f2c2dfe3d..b4591fd24dd 100644 --- a/Master/texmf-dist/source/latex/showlabels/showlabels.dtx +++ b/Master/texmf-dist/source/latex/showlabels/showlabels.dtx @@ -24,13 +24,13 @@ %% See the file LICENCE for a copy of the GPL. %% You can also find an online copy at http://www.gnu.org/copyleft/gpl.html . %% -%% $Id: showlabels.dtx,v 1.34 2008/07/24 10:59:31 norman Exp $ +%% $Id: showlabels.dtx,v 1.36 2008/10/10 21:32:01 norman Exp $ %% % \def\filename{showlabels} -\def\fileversion{1.6.3} -\def\filedate{2008/07/24} -\def\docdate{2008 July 24} +\def\fileversion{1.6.4} +\def\filedate{2008/10/10} +\def\docdate{2008 October 10} \def\filemaintainer{norman@astro.gla.ac.uk} % \changes{v1.4}{2001/07/23}{Avoided defining RCSDate} %<+package>\NeedsTeXFormat{LaTeX2e} @@ -246,20 +246,23 @@ % people, including % Andreas Balser, % Francis M. C. Ching, +% Sven de Vries, % Michael Friendly, % Tino G\"ortem\"oller, % Lester L. Helms, % Hagen Kleinert, +% David R. Leal Valmana, % Olivier Michel, % Sungmo Park, % Ignacy Sawicki, % Andrei Shelankov, % Patrick Sibille, -% David R. Leal Valmana, +% Mariano Su\'arez-Alvarez, % Ji\v ri Vesely, % Elmar Walhorn, % Roland Winkler. -% Many thanks to all. If I've missed your name out of this list, +% Many thanks to all. If I've missed your name out of this list +% (or indeed if I've alphabetised you incorrectly), % please accept my apologies, and do let me know. % % Back in 29-Jan-92, Darrel Hankerson @@ -271,7 +274,7 @@ % % % \StopEventually{} -% +% % \section{Implementation} % \begin{macrocode} %<*package> @@ -310,9 +313,8 @@ % |\SL@labelname| is initialised to |\relax|, redefined within the % |\label| macro, and reset to |\relax| here. If it's already equal % to |\relax| here, the equation number hasn't been labelled, and so -% `???' is put in the margin. Don't do this for the \pstyle{amsmath} case -% as it artfully incorporates the |\maketag@@@| mechanism into a -% redefined |\@eqnnum|. +% we avoid putting anything in the margin. In the \pstyle{amsmath} case +% we instead redefine |\maketag@@@|. % % \begin{macrocode} \ifSL@AMS @@ -326,19 +328,32 @@ % \Lenv{eqnarray} environment within \pstyle{amsmath}), then fall back % on the |\SL@labelname| contents instead. % \iffalse See tests t2 and t11\fi +% We must make sure to leave |\SL@labelname| equal to |\relax| at the +% end of this macro, otherwise a |{eqnarray}| followed by an (AMSTeX) +% |\eqref| can end up with the wrong label being referred to by the +% |\maketag@@@| within |\eqref| (or something like that). +% +% The test here must be |\ifx\SL@labelname\relax| with +% |\global\let\SL@labelname\relax|, not |\expandafter\ifx\SL@...| and +% |\global\def\SL@labelname{\relax}| (as it once was), since the +% latter evaluates to true when |\SL@...| is |\relax| \emph{and} when +% |\SL@...| starts with two identical characters, which is wrong (it +% took embarrassingly many goes to get this right). % \begin{macrocode} \let\SL@maketag@@@=\maketag@@@ \def\maketag@@@#1{% \SL@maketag@@@{#1}% + \message{maketag@@@: df@label=\df@label, SL@labelname=\SL@labelname, env=\@currenvir}% \ifx\df@label\@empty \ifx\SL@labelname\relax - \SL@eqnlrtext{???}% it's not clear to me when this would happen + % do nothing \else \SL@eqnlrtext{\SL@labelname}% \fi \else \SL@eqnlrtext{\df@label}% \fi + \global\let\SL@labelname\relax } \else % \end{macrocode} @@ -347,22 +362,16 @@ % how on earth had this escaped before?!?} % \changes{v1.3d}{1999/07/23}{Removed ??? when no label exists} % \changes{v1.6.1}{2007/06/17}{Fix test again.} -% The test here must be |\ifx\SL@labelname\relax| with -% |\global\let\SL@labelname\relax|, not |\expandafter\ifx\SL@...| and -% |\global\def\SL@labelname{\relax}| (as it once was), since the -% latter evaluates to true when |\SL@...| is |\relax| \emph{and} when -% |\SL@...| starts with two identical characters, which is wrong (it -% took embarrassingly many goes to get this right). % \begin{macrocode} \let\SL@eqnnum=\@eqnnum \def\@eqnnum{% \SL@eqnnum \ifx\SL@labelname\relax -% \SL@eqnlrtext{???}% + % do nothing \else \SL@eqnlrtext{\SL@labelname}% - \global\let\SL@labelname\relax \fi + \global\let\SL@labelname\relax } \fi % \end{macrocode} diff --git a/Master/texmf-dist/tex/latex/showlabels/showlabels.sty b/Master/texmf-dist/tex/latex/showlabels/showlabels.sty index 99c35d6ab24..a483be4df6c 100644 --- a/Master/texmf-dist/tex/latex/showlabels/showlabels.sty +++ b/Master/texmf-dist/tex/latex/showlabels/showlabels.sty @@ -30,12 +30,12 @@ %% See the file LICENCE for a copy of the GPL. %% You can also find an online copy at http://www.gnu.org/copyleft/gpl.html . %% -%% $Id: showlabels.dtx,v 1.34 2008/07/24 10:59:31 norman Exp $ +%% $Id: showlabels.dtx,v 1.36 2008/10/10 21:32:01 norman Exp $ %% \def\filename{showlabels} -\def\fileversion{1.6.3} -\def\filedate{2008/07/24} -\def\docdate{2008 July 24} +\def\fileversion{1.6.4} +\def\filedate{2008/10/10} +\def\docdate{2008 October 10} \def\filemaintainer{norman@astro.gla.ac.uk} \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{showlabels}[\filedate\space v\fileversion] @@ -51,25 +51,28 @@ \let\SL@maketag@@@=\maketag@@@ \def\maketag@@@#1{% \SL@maketag@@@{#1}% + \message{maketag@@@: df@label=\df@label, SL@labelname=\SL@labelname, env=\@currenvir}% \ifx\df@label\@empty \ifx\SL@labelname\relax - \SL@eqnlrtext{???}% it's not clear to me when this would happen + % do nothing \else \SL@eqnlrtext{\SL@labelname}% \fi \else \SL@eqnlrtext{\df@label}% \fi + \global\let\SL@labelname\relax } \else \let\SL@eqnnum=\@eqnnum \def\@eqnnum{% \SL@eqnnum \ifx\SL@labelname\relax + % do nothing \else \SL@eqnlrtext{\SL@labelname}% - \global\let\SL@labelname\relax \fi + \global\let\SL@labelname\relax } \fi \global\let\SL@labelname\relax |