summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/showlabels
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-06-09 22:09:12 +0000
committerKarl Berry <karl@freefriends.org>2016-06-09 22:09:12 +0000
commitc2dd4a1f282809d86d6dce3fca10225d9da37a3f (patch)
treec3d953104c5ab416c27dd6d195e15e70ebc073ef /Master/texmf-dist/doc/latex/showlabels
parent9bbb661832e0d0f03721cd45084b8c0b6e1abf15 (diff)
showlabels (9jun16)
git-svn-id: svn://tug.org/texlive/trunk@41322 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/showlabels')
-rw-r--r--Master/texmf-dist/doc/latex/showlabels/README10
-rw-r--r--Master/texmf-dist/doc/latex/showlabels/VERSION2
-rw-r--r--Master/texmf-dist/doc/latex/showlabels/showlabels.html347
-rw-r--r--Master/texmf-dist/doc/latex/showlabels/showlabels.pdfbin156501 -> 156657 bytes
4 files changed, 321 insertions, 38 deletions
diff --git a/Master/texmf-dist/doc/latex/showlabels/README b/Master/texmf-dist/doc/latex/showlabels/README
index 5043b5ecde0..73daacd6bbb 100644
--- a/Master/texmf-dist/doc/latex/showlabels/README
+++ b/Master/texmf-dist/doc/latex/showlabels/README
@@ -4,7 +4,7 @@ Showlabels
Put the names of `\labels` and other commands into the margins of a draft
document.
-Version 1.7, 2015 December 8, http://purl.org/nxg/dist/showlabels.
+Version 1.8, 2016 June 9, http://purl.org/nxg/dist/showlabels.
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
@@ -25,8 +25,12 @@ it can be useful for `\ref` or `\begin` as well.
The source code for the package is maintained at
[bitbucket.org](https://bitbucket.org/nxg/showlabels). This site
-includes an issue tracker, where you can report bugs (or just mail
-me).
+includes an issue tracker, where you can report bugs (or just mail me).
+
+This work is Copyright 1999, 2001-09, 2013-16, Norman Gray, and may be
+distributed and/or modified under the conditions of the LaTeX Project
+Public Licence, either version 1.3 of this licence or (at your option)
+any later version. See the distributed file lppl.txt for details.
For more information, see showlabels.html in the distribution.
diff --git a/Master/texmf-dist/doc/latex/showlabels/VERSION b/Master/texmf-dist/doc/latex/showlabels/VERSION
index 4d9033d7ddc..6259340971b 100644
--- a/Master/texmf-dist/doc/latex/showlabels/VERSION
+++ b/Master/texmf-dist/doc/latex/showlabels/VERSION
@@ -1 +1 @@
-showlabels-1.7
+1.8
diff --git a/Master/texmf-dist/doc/latex/showlabels/showlabels.html b/Master/texmf-dist/doc/latex/showlabels/showlabels.html
index 896a35fd7d3..f809112b5a7 100644
--- a/Master/texmf-dist/doc/latex/showlabels/showlabels.html
+++ b/Master/texmf-dist/doc/latex/showlabels/showlabels.html
@@ -4,8 +4,269 @@
<head>
<title>Showlabels</title>
<link href="http://nxg.me.uk" rev="author"/>
-<link type="text/css" rel="stylesheet"
- href="style.css"/>
+<!-- content of style file, to make this document standalone... -->
+<style type='text/css'>
+body {
+ color: #333;
+ background: white;
+ margin-left: +30%;
+ width: 50%; /* body is 50% of screen width */
+ padding: 0.5em; /* this will make a difference if I decide to
+ have the background a different colour */
+ /* I can't decide on font: Optima's always nice, but Gill looks
+ agreeably intense. Helvetica's a decent fallback. */
+ font-family: "Helvetica Neue", Helvetica, "Gill Sans", gill, sans-serif;
+ /* font-family: Optima, "Gill Sans", gill, Helvetica, sans-serif; */
+ /* font-family: "Gill Sans", gill, Helvetica, sans-serif; */
+ /* I seem to have used 11pt at some point in the past, but this
+ is far too big -- did I ever have a reason for that, or is it
+ just due to browser changes? */
+ font-size: 10pt;
+ line-height: 150%;
+}
+
+/* adapt to wider screens */
+@media screen and (min-width: 700pt) {
+ body {
+ margin-left: 210pt;
+ width: 350pt;
+ }
+}
+
+/* The following appears not to work in Safari or Chrome
+ -- don't know why, yet.
+@media print {
+ @page :right {
+ size: auto;
+ body {
+ margin-top: 2cm;
+ margin-bottom: 3cm;
+ margin-left: 10%;
+ width: 60%;
+ margin-right: 30%;
+ color: #d33;
+ }
+ }
+ @page :left {
+ size: auto;
+ body {
+ margin-top: 2cm;
+ margin-bottom: 3cm;
+ margin-left: 30%;
+ width: 60%;
+ margin-right: 10%;
+ color: #33d;
+ }
+ }
+}
+*/
+
+div.topsidebar {
+ float: right;
+ width: 50%; /* ...of the body width (ie, 50% x 50% of screen) */
+ font-size: smaller;
+ margin-left: 1em;
+ padding-left: 1em;
+ border-left: solid thin #AAA;
+}
+
+/* On wider screens, move the sidebar out to the right hand side */
+/* This uses CSS3 media queries: http://www.w3.org/TR/css3-mediaqueries/ */
+@media screen and (min-width: 700pt) and (max-width: 850pt) {
+ body {
+ margin-left: 210pt;
+ width: 350pt; /* 50% of 700pt */
+ margin-right: auto;
+ }
+ div.topsidebar {
+ position: absolute;
+ /* I feel this size should be 595pt (350 + 210 + 0.05*700),
+ but that's clearly not right -- I don't think I understand what the -5%
+ in the h1 spec below is actually 5% of! */
+ left: 570pt;
+ width: auto;
+ margin-left: 0pt;
+ padding-left: 0pt;
+ border: none;
+ }
+}
+/* On still-wider screens, expand the left-margin, keeping the sidebar attached to the right-hand edge.
+ When the screen is 850pt wide (expanding from the @media case above),
+ the left margin will be 210pt, the width 350pt, and the right margin therefore 290pt.*/
+@media screen and (min-width: 850pt) {
+ body {
+ margin-right: 290pt; /* 290 = 850-(210+350) */
+ width: 350pt;
+ margin-left: auto; /* ...takes up the slack */
+ }
+ div.topsidebar {
+ position: absolute;
+ width: 290pt; /* same 290pt as above */
+ left: auto;
+ right: 0%;
+ padding-left: 0pt;
+ border: none;
+ }
+}
+
+
+code, pre {
+ font-family: Monaco, fixed;
+ font-size: 9pt;
+}
+
+a { text-decoration: none; }
+a:link { color: #66C; }
+a:visited { color: #669; }
+a[href]:hover { background: #EEE; }
+
+div.abstract {
+ font-style: oblique;
+ text-align: left;
+}
+div.abstract em { font-style: normal; }
+div.abstract code {
+ font-style: normal;
+ font-size: 80%;
+}
+
+h1, h2, h3, h4, h5, h6 {
+ color: #822;
+ font-weight: 100; /* few fonts have ultra-light weights */
+ line-height: 100%; /* no need to spread out titles */
+}
+h1 {
+ margin-left: -40%;
+ margin-right: -5%;
+ padding: 0.5em;
+ border: solid thin #666;
+ text-align: right;
+}
+h2 {
+ margin-left: -40%;
+ margin-right: -5%;
+ padding: 0.2em;
+ border-top: solid thin #666;
+ clear: both;
+}
+
+h2.appendices {
+ margin-top: 10ex;
+ border-top: double medium #666;
+}
+h3 {
+ margin-left: -30%;
+ float: left;
+ width: 25%;
+ display: block;
+ text-align: right;
+ vertical-align: bottom;
+ padding-top: 0pt;
+ padding-right: 0.5em;
+ margin-top: 0pt;
+ line-height: 120%;
+}
+
+/*
+h4 {
+ color: #C66;
+}
+*/
+
+pre, table { background: #dde; }
+
+pre {
+ padding: 1em;
+ line-height: 130%;
+}
+
+table {
+ font-size: smaller;
+}
+td {
+ padding: 0.5ex;
+}
+
+Q:before { content: "“"; }
+Q:after { content: "”"; }
+
+img.smallimage {
+ float: right;
+ margin: 24pt;
+ margin-right: -30%;
+}
+
+div.signature {
+ margin-left: -40%;
+ margin-right: -5%;
+ margin-top: 4ex;
+ text-align: right;
+ border: solid thin #666;
+ padding: 0.3em;
+ clear: both;
+}
+
+/* ============================================================
+ * Some other curiosities of my one-time formatting for web pages
+ */
+.doc-history {
+ font-size: xx-small;
+ background: #eee;
+ line-height: 100%;
+}
+
+div.subtoc, div.subsubtoc { display: none; }
+
+/* ============================================================
+ * Special formatting for ToC
+ */
+
+/*
+ If there's significant amount of text in front of the first subsection,
+ then the following are good to put in the per-document stylesheet:
+ width: 25%;
+ float: right;
+*/
+div#toc {
+ color: #888;
+ padding: 0;
+ font-size: smaller;
+ text-align: right;
+}
+div#toc a:link { color: #888; }
+div#toc > ul {
+ padding: 0pt;
+ margin: 0pt;
+ list-style: none;
+}
+div#toc li {
+ padding: 0pt;
+ display: inline-block;
+}
+div#toc li:before {
+ content: "§ ";
+ margin-left: 1em;
+}
+/* the following elements aren't currently generated by structure.lx */
+div#toc li ul {
+ padding-left: 1em;
+ margin-left: 0;
+ font-style: italic;
+ display: inline;
+}
+div#toc li ul:before {
+ content: "( ";
+}
+div#toc li ul:after {
+ content: " ) ";
+}
+div#toc li li {
+ padding-left: 0pt;
+}
+div#toc li li:after {
+ content: "; ";
+}
+</style>
<style type='text/css'>
/* a span/div style for attracting attention */
.attention {
@@ -19,8 +280,8 @@
<div class="abstract">
<p>Put the names of <code>\label</code>s and other commands into
the margins of a draft document.</p>
-<!-- This is revision aa6f5b4db751, 2015-12-08 -->
-<p>Version 1.7, 2015 December 8,
+<!-- This is revision 95a544e6b41b, 2016-06-09T16:51:03+01:00 -->
+<p>Version 1.8, 2016 June 9,
<a href='http://purl.org/nxg/dist/showlabels'
><code>http://purl.org/nxg/dist/showlabels</code></a>.</p>
</div>
@@ -35,7 +296,7 @@ equation is automatically numbered. It is compatible with the
<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 --
+where the labels appear &#x2013; in the margins or in the interline gaps &#x2013;
and you can change the appearance of the formatted labels to some
extent.</p>
@@ -49,12 +310,6 @@ the <code>\cite</code> command, but it can be useful for
<code>[inner]</code> and <code>[outer]</code> will be ignored, and the
label will be placed in the nearer margin.</p>
-<p>The source code for the package is maintained at
-<a href='http://bitbucket.org/nxg/showlabels/'>bitbucket.org</a>,
-which also includes an
-<a href='https://bitbucket.org/nxg/showlabels/issues' >issue tracker</a>,
-where you can report bugs (or you can just mail me).</p>
-
<h3>Compatibility and problems</h3>
<p>For reasonably obvious reasons, this package will <em>not</em> work at
@@ -62,19 +317,19 @@ 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
+in the wrong margins, near the top of a page &#x2013; see the documentation
for a discussion of this.</p>
<h3>Download and installation</h3>
<ol>
<li>Download the file
-<a href="showlabels-1.7.tar.gz" >showlabels-1.7.tar.gz</a>
+<a href="showlabels-1.8.tar.gz" >showlabels-1.8.tar.gz</a>
or
-<a href="showlabels-1.7.zip" >showlabels-1.7.zip</a>
+<a href="showlabels-1.8.zip" >showlabels-1.8.zip</a>
and unpack it.</li>
-<li>Run LaTeX on the file <code>showlabels.ins</code> -- this will
+<li>Run LaTeX on the file <code>showlabels.ins</code> &#x2013; this will
unpack the style file <code>showlabels.sty</code> amongst other files.
Place this somewhere where TeX can find it. </li>
@@ -82,26 +337,43 @@ Place this somewhere where TeX can find it. </li>
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
+<p>Links:</p>
+<ul>
+<li>Canonical package home page:
<a href="http://purl.org/nxg/dist/showlabels"
- ><code>http://purl.org/nxg/dist/showlabels</code></a></p>
+ ><code>http://purl.org/nxg/dist/showlabels</code></a></li>
+
+<li>On CTAN:
+<a href='https://www.ctan.org/pkg/showlabels'
+ >macros/latex/contrib/showlabels</a></li>
-<p>The sources are in a Mercurial repository at
-<a href='http://bitbucket.org/nxg/showlabels/'>bitbucket.org</a>.</p>
+<li>The source code for the package is maintained at
+<a href='http://bitbucket.org/nxg/showlabels/'>bitbucket.org</a>,
+which also includes an
+<a href='https://bitbucket.org/nxg/showlabels/issues' >issue tracker</a>,
+where you can report bugs (or you can just mail me).</li>
+
+</ul>
+
+<p>This work is Copyright 1999, 2001-09, 2013-16, Norman Gray, and may be distributed and/or modified under the
+conditions of the <a href='http://www.latex-project.org/lppl.txt'>LaTeX Project Public Licence</a>,
+either version 1.3 of this licence or (at your option) any later version.</p>
<h3>History</h3>
<dl>
-<dt><span class='attention'><strong>1.7, 2015 December 8</strong></span></dt>
+<dt><span class='attention'><strong>1.8, 2016 June 9</strong></span></dt>
+<dd>The <code>ntheorem</code> package exposed an apparently
+long-standing incompleteness in the handling of <code>amsmath</code>
+documents.
+Fixes <a href='https://bitbucket.org/nxg/showlabels/issues/9/'>issue 9</a>.</dd>
+
+<dt><strong>1.7, 2015 December 8</strong></dt>
<dd>Release v1.7.</dd>
<dt>1.7b2, 2015 December 7</dt>
<dd>Make the combination of amsmath and [inline] mode work
(fixes <a href='https://bitbucket.org/nxg/showlabels/issue/8/'>issue 8</a>
-– thanks to A L Dukeman for the report;
+&#x2013; thanks to A L Dukeman for the report;
what is it about showlabels and 6 December?!).</dd>
<dt>1.7b1, 2014 December 6</dt>
@@ -110,22 +382,22 @@ what is it about showlabels and 6 December?!).</dd>
<ul>
<li>Give <code>\showlabels</code> an optional formatting argument
(implements <a href='https://bitbucket.org/nxg/showlabels/issue/1/'>issue 1</a>
-– thanks to Francesco Biccari for the suggestion).</li>
+&#x2013; thanks to Francesco Biccari for the suggestion).</li>
<li>Special-case the IEEEtrantools package
(fixes <a href='https://bitbucket.org/nxg/showlabels/issue/2/'>issue 2</a>
-– thanks to Boris Kheyfets for the report and test case, and to
+&#x2013; thanks to Boris Kheyfets for the report and test case, and to
Ben William Carabelli for additional analysis and a draft fix).</li>
<li>The <code>[final]</code> option now works with the
<code>{amsmath}</code> package
(fixes <a href='https://bitbucket.org/nxg/showlabels/issue/3/'>issue 3</a>
-– thanks to Guillermo Garza and Enno Nagel for the report, and to
+&#x2013; thanks to Guillermo Garza and Enno Nagel for the report, and to
Guillermo for the test case).</li>
<li>Handle the hyperref package's <code>\ref*{label}</code> variant
(fixes <a href='https://bitbucket.org/nxg/showlabels/issue/4/'>issue 4</a>
-– thanks to Alex Watson for the report and test case).</li>
+&#x2013; thanks to Alex Watson for the report and test case).</li>
<li>Handle the case where a label is in a display, but not in maths mode
(fixes <a href='https://bitbucket.org/nxg/showlabels/issue/5/'>issue 5</a>
-– thanks to ‘bartgol’ on Stackexchange for the report and test case).</li>
+&#x2013; thanks to &#x2018;bartgol&#x2019; on Stackexchange for the report and test case).</li>
</ul></dd>
<dt>1.6.6, 2013 December 6</dt>
@@ -141,7 +413,7 @@ ensure that <code>\color</code> works in
<dt>1.6.5, 2009 May 27</dt>
<dd>Fixed a bug in the way that labels including underscores (and
-other 'exotic' characters) were displayed.</dd>
+other &#x2018;exotic&#x2019; characters) were displayed.</dd>
<dt>1.6.4, 2008 October 10</dt>
<dd>Fixed another poor interaction between eqnarray and amsart. Now
@@ -225,7 +497,7 @@ the <code>\usepackage{amsmath}</code> command. Bug-sightings here
will be warmly appreciated.</li>
<li>I haven't worried too much about the precise formatting of the
-labels -- this is, after all, supposed to be a draft-only
+labels &#x2013; this is, after all, supposed to be a draft-only
package.</li>
</ul>
</dd>
@@ -240,18 +512,25 @@ the <code>\usepackage{showlabels}</code> command <em>must</em> appear
after the <code>\usepackage{amsmath}</code> if it is to detect that
you are using the amsmath package. Note also that, since these
additions appeared, AMS-LaTeX and the <code>amstex</code> package seem
-to have been declared `obsolete' in favour of the <code>amsmath</code>
+to have been declared &#x2018;obsolete&#x2019; in favour of the <code>amsmath</code>
package. This package now claims conformance with the
<code>amsmath</code> package alone, though it will probably work with
older versions in fact.
</dd>
+<dt>Original release</dt>
+<dd>The package was originally released by me on 1991 September 21, under the name
+<code>labels.sty</code>.
+On 1992 January 29, Darrel Hankerson
+(<code>hank@ducvax.auburn.edu</code>), made the update to NFSS, and
+changed the name to <code>showlabel.sty</code>.</dd>
+
</dl>
<div class="signature">
<a href="http://www.astro.gla.ac.uk/users/norman/"
>Norman Gray</a><br/>
-2015 December 8
+2016 June 9
</div>
</body>
diff --git a/Master/texmf-dist/doc/latex/showlabels/showlabels.pdf b/Master/texmf-dist/doc/latex/showlabels/showlabels.pdf
index f7a4f6a7bec..71be316ed37 100644
--- a/Master/texmf-dist/doc/latex/showlabels/showlabels.pdf
+++ b/Master/texmf-dist/doc/latex/showlabels/showlabels.pdf
Binary files differ