summaryrefslogtreecommitdiff
path: root/Master/texmf-dist
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2008-11-18 00:39:59 +0000
committerKarl Berry <karl@freefriends.org>2008-11-18 00:39:59 +0000
commit5d9728c50066dca3017faa37fee2e0daec8b0d52 (patch)
tree772f1c6340720d3add003a45335487ed933805f4 /Master/texmf-dist
parent702dcf050b18dfde338853a56a85375afce44ecf (diff)
showlabels update (17nov08)
git-svn-id: svn://tug.org/texlive/trunk@11336 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist')
-rw-r--r--Master/texmf-dist/doc/latex/showlabels/README82
-rw-r--r--Master/texmf-dist/doc/latex/showlabels/VERSION2
-rw-r--r--Master/texmf-dist/doc/latex/showlabels/showlabels.html107
-rw-r--r--Master/texmf-dist/doc/latex/showlabels/showlabels.pdfbin87529 -> 87669 bytes
-rw-r--r--Master/texmf-dist/source/latex/showlabels/showlabels.drv65
-rw-r--r--Master/texmf-dist/source/latex/showlabels/showlabels.dtx47
-rw-r--r--Master/texmf-dist/tex/latex/showlabels/showlabels.sty15
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
index aac05201c57..fbdeb2b259e 100644
--- a/Master/texmf-dist/doc/latex/showlabels/showlabels.pdf
+++ b/Master/texmf-dist/doc/latex/showlabels/showlabels.pdf
Binary files differ
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