Put the names of \label
s and other commands into
the margins of a draft document.
Version 1.6.2, 2008 June 27,
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.
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.
\showlabels
command will now work with commands
(such as \cite
or \includegraphics
) which
take an optional argument.\showlabelfont
using
\ttfamily
rather than \tt
(I'd
avoided doing this before to avoid a seemingly pointless
incompatibility with LaTeX 2.09, but (a) I imagine the
package is incompatible with that for other reasons, and (b)
it's really not worth the hassle...).\showlabelfont
and
\showlabelsetlabel
commands, allowing
customisation of the printed labels. Added and documented
options [final], [draft] (the former makes this package do
nothing; the latter is the default behaviour).
[left]
and
[right]
options, and fixed a bug which affected
\label
commands in captions.\showlabels
command, to have the package display
references to commands other than \label
(\cite
and \ref
are obvious ones),
and an [inline]
option to have labels (etc.)
displayed inline where possible, rather than always in the
margin.\label
command. This will
work, however, only if the showlabels package is loaded after
other packages which do this. Notwithstanding Sebastian
Rahtz's excellent general advice on this, showlabels should
indeed be loaded after hyperref.After a long delay, here is an updated version of my showlabels package. It corrects all the reported bugs which I could reproduce, namely:
\label
command appears outside either an equation or a
\caption
(silly of me).\usepackage{showlabels}
command must come after
the \usepackage{amsmath}
command. Bug-sightings here
will be warmly appreciated.amsmath
uses to produce equation
numbers. I don't habitually use amsmath
, so I won't
discover any bugs or weaknesses with its support here, and I'd
consequently be glad to be informed of any that appear. Do note that
the \usepackage{showlabels}
command must appear
after the \usepackage{amsmath}
if it is to detect that
you are using the amsmath package. Note also that, since these
additions appeared, AMS-LaTeX and the amstex
package seem
to have been declared `obsolete' in favour of the amsmath
package. This package now claims conformance with the
amsmath
package alone, though it will probably work with
older versions in fact.
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.
showlabels.ins
-- this will
unpack the style file showlabels.sty
amongst other files.
Place this somewhere where TeX can find it. showlabels.dtx
to obtain the
documentation.On CTAN: /tex-archive/macros/latex/contrib/supported/showlabels/
On the web
http://purl.org/nxg/dist/showlabels