texlive[63962] Master/texmf-dist: textpos (23jul22)
commits+karl at tug.org
commits+karl at tug.org
Sat Jul 23 23:38:40 CEST 2022
Revision: 63962
http://tug.org/svn/texlive?view=revision&revision=63962
Author: karl
Date: 2022-07-23 23:38:40 +0200 (Sat, 23 Jul 2022)
Log Message:
-----------
textpos (23jul22)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/latex/textpos/LICENCE
trunk/Master/texmf-dist/doc/latex/textpos/README
trunk/Master/texmf-dist/doc/latex/textpos/examples/README.examples
trunk/Master/texmf-dist/doc/latex/textpos/examples/t3.tex
trunk/Master/texmf-dist/doc/latex/textpos/examples/t7.tex
trunk/Master/texmf-dist/doc/latex/textpos/examples/t9.tex
trunk/Master/texmf-dist/doc/latex/textpos/niepraschk-eso-pic.pdf
trunk/Master/texmf-dist/doc/latex/textpos/textpos-example.tex
trunk/Master/texmf-dist/doc/latex/textpos/textpos.html
trunk/Master/texmf-dist/doc/latex/textpos/textpos.pdf
trunk/Master/texmf-dist/source/latex/textpos/textpos.drv
trunk/Master/texmf-dist/source/latex/textpos/textpos.dtx
trunk/Master/texmf-dist/tex/latex/textpos/textpos.sty
Added Paths:
-----------
trunk/Master/texmf-dist/doc/latex/textpos/VERSION-
Removed Paths:
-------------
trunk/Master/texmf-dist/doc/latex/textpos/VERSION-1.10
Modified: trunk/Master/texmf-dist/doc/latex/textpos/LICENCE
===================================================================
--- trunk/Master/texmf-dist/doc/latex/textpos/LICENCE 2022-07-23 06:41:02 UTC (rev 63961)
+++ trunk/Master/texmf-dist/doc/latex/textpos/LICENCE 2022-07-23 21:38:40 UTC (rev 63962)
@@ -16,8 +16,8 @@
You may use this license for any work of which you hold the copyright
and which you wish to distribute. This license may be particularly
-suitable if your work is TeX-related (such as a LaTeX package), but
-it is written in such a way that you can use it even if your work is
+suitable if your work is TeX-related (such as a LaTeX package), but
+it is written in such a way that you can use it even if your work is
unrelated to TeX.
The section `WHETHER AND HOW TO DISTRIBUTE WORKS UNDER THIS LICENSE',
@@ -44,11 +44,11 @@
`Work'
Any work being distributed under this License.
-
+
`Derived Work'
Any work that under any applicable law is derived from the Work.
- `Modification'
+ `Modification'
Any procedure that produces a Derived Work under any applicable
law -- for example, the production of a file containing an
original file associated with the Work or a significant portion of
@@ -58,7 +58,7 @@
`Modify'
To apply any procedure that produces a Derived Work under any
applicable law.
-
+
`Distribution'
Making copies of the Work available from one person to another, in
whole or in part. Distribution includes (but is not limited to)
@@ -79,9 +79,9 @@
no such explicit nomination then it is the `Copyright Holder' under
any applicable law.
- `Base Interpreter'
+ `Base Interpreter'
A program or process that is normally needed for running or
- interpreting a part or the whole of the Work.
+ interpreting a part or the whole of the Work.
A Base Interpreter may depend on external components but these
are not considered part of the Base Interpreter provided that each
@@ -88,7 +88,7 @@
external component clearly identifies itself whenever it is used
interactively. Unless explicitly specified when applying the
license to the Work, the only applicable Base Interpreter is a
- `LaTeX-Format' or in the case of files belonging to the
+ `LaTeX-Format' or in the case of files belonging to the
`LaTeX-format' a program implementing the `TeX language'.
@@ -129,8 +129,8 @@
distribute a Derived Work provided the following conditions are met
for every component of the Work unless that component clearly states
in the copyright notice that it is exempt from that condition. Only
-the Current Maintainer is allowed to add such statements of exemption
-to a component of the Work.
+the Current Maintainer is allowed to add such statements of exemption
+to a component of the Work.
a. If a component of this Derived Work can be a direct replacement
for a component of the Work when that component is used with the
@@ -140,13 +140,13 @@
clearly and unambiguously identifies itself as a modified version
of this component to the user when used interactively with that
Base Interpreter.
-
+
b. Every component of the Derived Work contains prominent notices
detailing the nature of the changes to that component, or a
prominent reference to another file that is distributed as part
of the Derived Work and that contains a complete and accurate log
of the changes.
-
+
c. No information in the Derived Work implies that any persons,
including (but not limited to) the authors of the original version
of the Work, provide any support, including (but not limited to)
@@ -156,7 +156,7 @@
d. You distribute at least one of the following with the Derived Work:
- 1. A complete, unmodified copy of the Work;
+ 1. A complete, unmodified copy of the Work;
if your distribution of a modified component is made by
offering access to copy the modified component from a
designated place, then offering equivalent access to copy
@@ -183,15 +183,15 @@
then produced by applying some process to that format, does not relax or
nullify any sections of this license as they pertain to the results of
applying that process.
-
+
10. a. A Derived Work may be distributed under a different license
provided that license itself honors the conditions listed in
Clause 6 above, in regard to the Work, though it does not have
to honor the rest of the conditions in this license.
-
+
b. If a Derived Work is distributed under a different license, that
Derived Work must provide sufficient documentation as part of
- itself to allow each recipient of that Derived Work to honor the
+ itself to allow each recipient of that Derived Work to honor the
restrictions in Clause 6 above, concerning changes from the Work.
11. This license places no restrictions on works that are unrelated to
@@ -260,7 +260,7 @@
a. If it is being maintained, then ask the Current Maintainer
to update their communication data within one month.
-
+
b. If the search is unsuccessful or no action to resume active
maintenance is taken by the Current Maintainer, then announce
within the pertinent community your intention to take over
@@ -270,17 +270,17 @@
3a. If the Current Maintainer is reachable and agrees to pass
maintenance of the Work to you, then this takes effect
immediately upon announcement.
-
+
b. If the Current Maintainer is not reachable and the Copyright
Holder agrees that maintenance of the Work be passed to you,
- then this takes effect immediately upon announcement.
-
+ then this takes effect immediately upon announcement.
+
4. If you make an `intention announcement' as described in 2b. above
and after three months your intention is challenged neither by
the Current Maintainer nor by the Copyright Holder nor by other
people, then you may arrange for the Work to be changed so as
to name you as the (new) Current Maintainer.
-
+
5. If the previously unreachable Current Maintainer becomes
reachable once more within three months of a change completed
under the terms of 3b) or 4), then that Current Maintainer must
@@ -358,12 +358,12 @@
% conditions of the LaTeX Project Public License, either version 1.3
% of this license or (at your option) any later version.
% The latest version of this license is in
- % http://www.latex-project.org/lppl.txt
+ % https://www.latex-project.org/lppl.txt
% and version 1.3 or later is part of all distributions of LaTeX
% version 2005/12/01 or later.
%
% This work has the LPPL maintenance status `maintained'.
- %
+ %
% The Current Maintainer of this work is M. Y. Name.
%
% This work consists of the files pig.dtx and pig.ins
@@ -377,7 +377,7 @@
`Current Maintainer' referring to the person `M. Y. Name'.
If you do not want the Maintenance section of LPPL to apply to your
-Work, change `maintained' above into `author-maintained'.
+Work, change `maintained' above into `author-maintained'.
However, we recommend that you use `maintained', as the Maintenance
section was added in order to ensure that your Work remains useful to
the community even when you can no longer maintain and support it
@@ -407,10 +407,9 @@
using a line such as:
% This work consists of all files listed in manifest.txt.
-
+
in that place. In the absence of an unequivocal list it might be
impossible for the licensee to determine what is considered by you
to comprise the Work and, in such a case, the licensee would be
entitled to make reasonable conjectures as to which files comprise
the Work.
-
Modified: trunk/Master/texmf-dist/doc/latex/textpos/README
===================================================================
--- trunk/Master/texmf-dist/doc/latex/textpos/README 2022-07-23 06:41:02 UTC (rev 63961)
+++ trunk/Master/texmf-dist/doc/latex/textpos/README 2022-07-23 21:38:40 UTC (rev 63962)
@@ -1,7 +1,7 @@
Textpos: absolute positioning of text on the LaTeX page
=======================================================
-Version 1.10, 2020 September 26
+Version 1.10.1, 2022 July 23
This package facilitates placing boxes at absolute positions on the
LaTeX page. There are several reasons why this might be useful, but
@@ -14,9 +14,9 @@
placed. The environment is accompanied by various configuration
commands.
-Textpos has a canonical home page at <http://purl.org/nxg/dist/textpos>.
+Textpos has a canonical home page at <https://purl.org/nxg/dist/textpos>.
The CTAN URL for Textpos is <https://ctan.org/pkg/textpos>.
-The source is hosted at [code.nxg.name](https://code.nxg.name/nxg/tex/textpos).
+The source is hosted [online](https://heptapod.host/nxg/textpos).
For the change history, see textpos.html.
@@ -25,7 +25,7 @@
------------
Download or find the file `textpos.sty`. Install `textpos.sty` somewhere
-LaTeX will find it (see [the TeX FAQ](http://www.tex.ac.uk/cgi-bin/texfaq2html?label=inst-wlcf)).
+LaTeX will find it (see [the TeX FAQ](https://texfaq.org/FAQ-inst-wlcf)).
This package requires the services of Martin Schroeder's package
[everyshi][everyshi]. You will need to download this package from CTAN first.
@@ -42,5 +42,5 @@
Norman Gray
<https://nxg.me.uk>
-[lppl]: http://www.latex-project.org/lppl.txt
+[lppl]: https://www.latex-project.org/lppl.txt
[everyshi]: https://www.ctan.org/pkg/everyshi
Added: trunk/Master/texmf-dist/doc/latex/textpos/VERSION-
===================================================================
--- trunk/Master/texmf-dist/doc/latex/textpos/VERSION- (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/textpos/VERSION- 2022-07-23 21:38:40 UTC (rev 63962)
@@ -0,0 +1 @@
+1.10.1
Deleted: trunk/Master/texmf-dist/doc/latex/textpos/VERSION-1.10
===================================================================
--- trunk/Master/texmf-dist/doc/latex/textpos/VERSION-1.10 2022-07-23 06:41:02 UTC (rev 63961)
+++ trunk/Master/texmf-dist/doc/latex/textpos/VERSION-1.10 2022-07-23 21:38:40 UTC (rev 63962)
@@ -1 +0,0 @@
-textpos-1.10, released 2020 September 26
Modified: trunk/Master/texmf-dist/doc/latex/textpos/examples/README.examples
===================================================================
--- trunk/Master/texmf-dist/doc/latex/textpos/examples/README.examples 2022-07-23 06:41:02 UTC (rev 63961)
+++ trunk/Master/texmf-dist/doc/latex/textpos/examples/README.examples 2022-07-23 21:38:40 UTC (rev 63962)
@@ -2,10 +2,12 @@
rather than strictly as examples. They nonetheless serve to illustrate
some of what textpos can do.
-Not all of them actually work, as regression tests, right now, but
-this is because when comparing binary formats such as .dvi files,
+The later test files explain within the file what they are supposed to
+look like. The t*-correct.pdf are visually correct versions.
+
+These don't really work as regression tests right now.
+This is because when comparing binary formats such as .dvi files,
it's not always completely obvious what counts as a significant
change. Any comments and suggestions would be welcome.
Norman
-2006 September 2
Modified: trunk/Master/texmf-dist/doc/latex/textpos/examples/t3.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/textpos/examples/t3.tex 2022-07-23 06:41:02 UTC (rev 63961)
+++ trunk/Master/texmf-dist/doc/latex/textpos/examples/t3.tex 2022-07-23 21:38:40 UTC (rev 63962)
@@ -1,3 +1,4 @@
+%%% Testing:interaction with fancybox
%From Wybo at Servalys.Nl Fri Jun 28 14:28:41 2002
%From: Wybo Dekker <Wybo at Servalys.Nl>
%To: Norman at Astro.Gla.Ac.Uk
Modified: trunk/Master/texmf-dist/doc/latex/textpos/examples/t7.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/textpos/examples/t7.tex 2022-07-23 06:41:02 UTC (rev 63961)
+++ trunk/Master/texmf-dist/doc/latex/textpos/examples/t7.tex 2022-07-23 21:38:40 UTC (rev 63962)
@@ -1,3 +1,4 @@
+%%% Testing:interaction with \newpage
\documentclass{article}
%\usepackage[showboxes]{textpos}
Modified: trunk/Master/texmf-dist/doc/latex/textpos/examples/t9.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/textpos/examples/t9.tex 2022-07-23 06:41:02 UTC (rev 63961)
+++ trunk/Master/texmf-dist/doc/latex/textpos/examples/t9.tex 2022-07-23 21:38:40 UTC (rev 63962)
@@ -7,6 +7,8 @@
\TPHorizModule=1cm
\TPVertModule=1cm
+\usepackage{color}
+
\begin{document}
Here is some text, which appears in the body of the page.
@@ -57,11 +59,21 @@
\end{textblock}
\newpage
-\TPoptions{absolute=true}
+\TPoptions{absolute=true,overlay=true} % the overlay option is ignored
-Page 3.
+Page 3. Page 3. Page 3. Page 3. Page 3. Page 3. Page 3. Page 3.
+Page 3. Page 3. Page 3. Page 3. Page 3. Page 3. Page 3. Page 3.
+
\begin{textblock}{5}(0,0)
This text appears at the extreme top-left of page three.
\end{textblock}
+\textblockcolour{yellow}
+\begin{textblock}{5}(4,4.5)
+ This text appears at (4,5). It appears \emph{below} the text: that
+ is, the \texttt{overlay=true} option is currently ignored (this
+ might potentially change in future, but I've no current plans to
+ implement that).
+\end{textblock}
+
\end{document}
Modified: trunk/Master/texmf-dist/doc/latex/textpos/niepraschk-eso-pic.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/textpos/textpos-example.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/textpos/textpos-example.tex 2022-07-23 06:41:02 UTC (rev 63961)
+++ trunk/Master/texmf-dist/doc/latex/textpos/textpos-example.tex 2022-07-23 21:38:40 UTC (rev 63962)
@@ -13,7 +13,7 @@
%% conditions of the LaTeX Project Public License, either version 1.3
%% of this license or (at your option) any later version.
%% The latest version of this license is in
-%% http://www.latex-project.org/lppl.txt
+%% https://www.latex-project.org/lppl.txt
%% and version 1.3 or later is part of all distributions of LaTeX
%% version 2005/12/01 or later.
%%
@@ -29,7 +29,7 @@
%%
%% See the file LICENCE for a copy of the LPPL.
%%
-%% Mercurial ident: c834991c867a (1.10+1), 2020-09-26 17:44 +0100
+%% Mercurial ident: 1.10.1 (@VCSINFO)
%%
\documentclass{article}
Modified: trunk/Master/texmf-dist/doc/latex/textpos/textpos.html
===================================================================
--- trunk/Master/texmf-dist/doc/latex/textpos/textpos.html 2022-07-23 06:41:02 UTC (rev 63961)
+++ trunk/Master/texmf-dist/doc/latex/textpos/textpos.html 2022-07-23 21:38:40 UTC (rev 63962)
@@ -5,7 +5,7 @@
<title>Textpos</title>
<meta property="dcterms:subject" content="latex, textpos, absolute positioning"/>
-<meta property="dcterms:date" content="2020-09-26"/>
+<meta property="dcterms:date" content="@RELEASEDATEISO@"/>
<link href="https://nxg.me.uk/norman" rev="author" rel="dcterms:creator"/>
</head>
@@ -17,9 +17,9 @@
<p class="distpage">The textpos home page is at
-<a href="http://purl.org/nxg/dist/textpos"><code>https://purl.org/nxg/dist/textpos</code></a>;
+<a href="https://purl.org/nxg/dist/textpos"><code>https://purl.org/nxg/dist/textpos</code></a>;
please quote this URL rather than the URL it resolves to.</p>
-<p>Version 1.10, 2020 September 26.</p>
+<p>Version 1.10.1, 2022 July 23.</p>
</div>
<p>This package facilitates placing boxes at absolute positions on the
@@ -26,7 +26,7 @@
LaTeX page. There are several reasons why this might be useful, but
the main one (or at least my motivating one) is to help produce a
large-format conference poster. Other applications include placing
-material within, say, figures. Textpos is also discussed in the <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=abspos">TeX FAQ
+material within, say, figures. Textpos is also discussed in the <a href="https://texfaq.org/FAQ-abspos">TeX FAQ
entry on absolute positioning</a>.</p>
<p>This package provides a single environment, which contains the text
@@ -35,10 +35,10 @@
is accompanied by various configuration commands. See the <a href="textpos.pdf">manual (pdf)</a>.</p>
<p>An article describing Textpos appeared in TUGboat in 2002:
-<a href="http://www.tug.org/TUGboat/tb23-3-4/tb75gray.pdf">Norman Gray, <em>Absolute Positioning with Textpos</em>,
+<a href="https://www.tug.org/TUGboat/tb23-3-4/tb75gray.pdf">Norman Gray, <em>Absolute Positioning with Textpos</em>,
TUGboat <strong>23</strong> (3/4), pp341–4, 2002.</a></p>
-<p>I have a collection of general advice about <a href="http://purl.org/nxg/note/posters">creating
+<p>I have a collection of general advice about <a href="https://purl.org/nxg/note/posters">creating
conference posters with LaTeX</a>.</p>
<p>Rolf Niepraschk provided me with a wonderful demo
@@ -48,14 +48,10 @@
and the <code>calc</code> package, to produce a grid which can help lay out
material on the page.</p>
-<p class="distpage">The source is held
-<a href="https://code.nxg.name/nxg/tex/textpos">online</a></p>
+<p>The source is held <a href="https://heptapod.host/nxg/textpos">online</a>,
+where you can find an issues list</p>
-
-
-
-
<h2 class="distpage">Installation and further information</h2>
<ol>
@@ -70,7 +66,7 @@
documentation.</li>
</ol>
-<p class="distpage">The <code>textpos</code> home page is at <a href="http://purl.org/nxg/dist/textpos"><code>http://purl.org/nxg/dist/textpos</code></a>, and there may be more up-to-date versions available there.</p>
+<p class="distpage">The <code>textpos</code> home page is at <a href="https://purl.org/nxg/dist/textpos"><code>https://purl.org/nxg/dist/textpos</code></a>, and there may be more up-to-date versions available there.</p>
<p><code>Textpos</code> is also available on CTAN:
<a href="https://www.ctan.org/pkg/textpos">macros/latex/contrib/textpos/</a></p>
@@ -80,6 +76,19 @@
<h2>History</h2>
<dl>
+<dt><strong>Release 1.10.1, 2022 July 23</strong></dt>
+<dd>
+ <ul>
+ <li>Mildly improve the handling of a missing <code>{color}</code> package.</li>
+ <li>The <code>overlay</code> option isn't changeable in
+ <code>\TPoptions</code>; attempting to do so now produces a
+ warning.</li>
+ <li>Various mild documentation improvements.</li>
+ <li>The code repository has moved again, to
+ <a href="https://heptapod.host/nxg/textpos">heptapod</a>.</li>
+ </ul>
+</dd>
+
<dt><strong>1.10, 2020 September 26</strong></dt>
<dd>
<ul>
@@ -280,7 +289,7 @@
<div class="signature">
<a href="https://nxg.me.uk">Norman Gray</a><br/>
-2020 September 26
+ at REPODATE@
</div>
</body>
Modified: trunk/Master/texmf-dist/doc/latex/textpos/textpos.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/source/latex/textpos/textpos.drv
===================================================================
--- trunk/Master/texmf-dist/source/latex/textpos/textpos.drv 2022-07-23 06:41:02 UTC (rev 63961)
+++ trunk/Master/texmf-dist/source/latex/textpos/textpos.drv 2022-07-23 21:38:40 UTC (rev 63962)
@@ -13,7 +13,7 @@
%% conditions of the LaTeX Project Public License, either version 1.3
%% of this license or (at your option) any later version.
%% The latest version of this license is in
-%% http://www.latex-project.org/lppl.txt
+%% https://www.latex-project.org/lppl.txt
%% and version 1.3 or later is part of all distributions of LaTeX
%% version 2005/12/01 or later.
%%
@@ -29,16 +29,15 @@
%%
%% See the file LICENCE for a copy of the LPPL.
%%
-%% Mercurial ident: c834991c867a (1.10+1), 2020-09-26 17:44 +0100
+%% Mercurial ident: 1.10.1 (@VCSINFO)
%%
\documentclass{ltxdoc}
\title{Textpos: absolute positioning of text on the page}
\author{Norman Gray\\(\texttt{https://nxg.me.uk})}
-\date{Version 1.10, 2020 September 26\footnote{Mercurial ident: c834991c867a (1.10+1), 2020-09-26 17:44 +0100.
-This software is copyright, 1999-2020 Norman Gray.
+\date{Version 1.10.1, 2022 July 23\footnote{This software is copyright, 1999-2020 Norman Gray.
It is released under the terms of the LaTeX Project Public License,
either version 1.3 of this licence or (at your option) any later version.
-The latest version of this license is at \texttt{http://www.latex-project.org/lppl.txt}.}}
+The latest version of this license is at \texttt{https://www.latex-project.org/lppl.txt}.}}
\newcommand\Lopt[1]{\textsf {\small [#1]}}
\newcommand\file[1]{\texttt {#1}}
\newcommand\Lcount[1]{\textsl{\small#1}}
Modified: trunk/Master/texmf-dist/source/latex/textpos/textpos.dtx
===================================================================
--- trunk/Master/texmf-dist/source/latex/textpos/textpos.dtx 2022-07-23 06:41:02 UTC (rev 63961)
+++ trunk/Master/texmf-dist/source/latex/textpos/textpos.dtx 2022-07-23 21:38:40 UTC (rev 63962)
@@ -9,7 +9,7 @@
%% conditions of the LaTeX Project Public License, either version 1.3
%% of this license or (at your option) any later version.
%% The latest version of this license is in
-%% http://www.latex-project.org/lppl.txt
+%% https://www.latex-project.org/lppl.txt
%% and version 1.3 or later is part of all distributions of LaTeX
%% version 2005/12/01 or later.
%%
@@ -25,21 +25,19 @@
%%
%% See the file LICENCE for a copy of the LPPL.
%%
-%% Mercurial ident: c834991c867a (1.10+1), 2020-09-26 17:44 +0100
+%% Mercurial ident: 1.10.1 (@VCSINFO)
%%
%<+package>\NeedsTeXFormat{LaTeX2e}
-%<+package>\ProvidesPackage{textpos}[2020/09/26 v1.10]
-%<+package>\typeout{Package: textpos 2020/09/26 1.10, absolute positioning of text on the page}
+%<+package>\ProvidesPackage{textpos}[2022/07/23 v1.10.1]
%
%<*driver>
\documentclass{ltxdoc}
\title{Textpos: absolute positioning of text on the page}
\author{Norman Gray\\(\texttt{https://nxg.me.uk})}
-\date{Version 1.10, 2020 September 26\footnote{Mercurial ident: c834991c867a (1.10+1), 2020-09-26 17:44 +0100.
-This software is copyright, 1999-2020 Norman Gray.
+\date{Version 1.10.1, 2022 July 23\footnote{This software is copyright, 1999-2020 Norman Gray.
It is released under the terms of the LaTeX Project Public License,
either version 1.3 of this licence or (at your option) any later version.
-The latest version of this license is at \texttt{http://www.latex-project.org/lppl.txt}.}}
+The latest version of this license is at \texttt{https://www.latex-project.org/lppl.txt}.}}
\newcommand\Lopt[1]{\textsf {\small [#1]}}
\newcommand\file[1]{\texttt {#1}}
\newcommand\Lcount[1]{\textsl{\small#1}}
@@ -122,8 +120,8 @@
% \url{https://www.ctan.org/pkg/everyshi}.
%
% The canonical CTAN URL for Textpos is \url{https://ctan.org/pkg/textpos}.
-% Textpos has a home page at \url{http://purl.org/nxg/dist/textpos}.
-% The source is held at \url{https://code.nxg.name/nxg/tex/textpos}.
+% Textpos has a home page at \url{https://purl.org/nxg/dist/textpos}.
+% The source is held at \url{https://heptapod.host/nxg/textpos}.
% \iffalse and there is an issues list there, for bug reports.\fi
% Code
% contributions or fixes are welcome, but note that I feel that
@@ -135,7 +133,7 @@
% An article describing Textpos appeared in TUGboat in 2002:
% Norman Gray, `Absolute Positioning with
% Textpos', TUGboat \textbf{23} (3/4), pp341--4, 2002, available at
-% \url{http://www.tug.org/TUGboat/tb23-3-4/tb75gray.pdf}.
+% \url{https://www.tug.org/TUGboat/tb23-3-4/tb75gray.pdf}.
%
% \section{Description}
%
@@ -276,6 +274,10 @@
% irritating, so you can turn them off with the \Lopt{quiet} option or
% on with the \Lopt{verbose} option. The default is currently
% \Lopt{verbose}, but this might change in future.
+% \item[\Lopt{discardcontent}] This discards box content in a way
+% which might make the |{textblock}| content compatible with TikZ.
+% This behaviour is still somewhat experimental (since v1.9), should
+% probably be used only rarely, and is more fully discussed in Sect.~\ref{s:absrelmode}.
% \end{description}
%
% \subsection{Changing options on the fly}
@@ -282,13 +284,14 @@
% \label{s:changing-options}
%
% \begin{macro}{\TPoptions}
-% Each of the options mentioned in the previous section can be changed within the body of the text,
+% Each of the options mentioned in the previous section can be changed
+% within the body of the text\footnote{Available since v1.8},
% using the command |\TPoptions| with a comma-separated list of
% keywords
% \textit{$\langle$keyword$\rangle$}\texttt{=true} or
% \textit{$\langle$keyword$\rangle$}\texttt{=false}.
-% The recognised keywords are `absolute', `overlay', `verbose',
-% `showboxes' and `showtext'. Thus the command
+% The recognised keywords are `absolute', `verbose',
+% `showboxes', `showtext', and `discardcontent'. Thus the command
% \begin{quote}
% |\TPoptions{absolute=false , showboxes = true }|
% \end{quote}
@@ -301,6 +304,12 @@
% a document is to use absolute mode \emph{anywhere} within it,
% however, it must be \emph{started} in absolute mode, with the
% \Lopt{absolute} option to the |\usepackage| command.
+%
+% Note that (at least in v1.10), the presence or absence of the \texttt{overlay}
+% package option takes effect at the time the package is loaded, and
+% it cannot be changed thereafter. It's not impossible that this would
+% change in future, but I have no current plans to implement that.
+%
% \end{macro}
%
% \subsection{Configuration commands, and variants}
@@ -639,7 +648,7 @@
% printing to a large-format postscript printer.
%
% I have a collection of suggestions for producing such posters at
-% \url{http://purl.org/nxg/note/posters}.
+% \url{https://purl.org/nxg/note/posters}.
%
% The text on a large poster will typically use a very large font. It
% can be a hassle to create (or have dvips create) these fonts, and
@@ -667,7 +676,7 @@
% \TeX\ to respect the page-break.
%
% This happens for the same reason that, also quite surprisingly, two
-% |\newline| commands in a row do not produce a blank page.
+% |\newpage| commands in a row do not produce a blank page.
%
% \subsection{Absolute or relative mode?}
% \label{s:absrelmode}
@@ -698,9 +707,9 @@
% |{textblock}| boxes, in a way which should make it compatible with
% TikZ. This option is \emph{experimental} in Textpos v1.9, and may
% change or disappear in future versions -- the author would be
-% particular interested to get feedback regarding this
+% particular interested in feedback regarding this
% option.\footnote{My understanding of the problem here is derived from an excellent Stackoverflow answer
-% by `JLDiaz' \url{http://tex.stackexchange.com/a/66853}, a Textpos
+% by `JLDiaz' \url{https://tex.stackexchange.com/a/66853}, a Textpos
% bugreport by Michael H\"upkes, and a discussion on the PGF bugparade
% \url{https://github.com/pgf-tikz/pgf/issues/393}.}
%
@@ -740,16 +749,18 @@
% for the initial report, and to Heiko Oberdiek for one of the
% workarounds}.
%
+% In older versions of the beamer package,\marginpar{textpos \&
+% beamer} there were at least some cases where beamer's background
+% frame would overlay textpos material. It appears this is no longer
+% the case (at least with beamer 3.59), and the packages are fully
+% compatible. But if you see a problem here you should use the
+% \Lopt{overlay} option to tell textpos to delay its
+% work.\footnote{Thanks to Marius Arenz for the explanation here, and
+% to Matthias Braun for reporting that the problem has gone away.}
+%
% \subsection{Other interactions}
% \label{s:interactions}
%
-% The Beamer package's\marginpar{textpos \& beamer}
-% background frame overlays the textpos material, unless the
-% \Lopt{overlay} option is used to tell textpos to delay it.
-% Therefore, you should use the \Lopt{overlay,absolute}
-% options with Beamer.\footnote{Thanks to Marius Arenz for
-% the explanation here.}
-%
% Gabriel Zachmann suggested having Textpos put a grid on the
% page\marginpar{page grid}, so
% that it is easier to work out \Lenv{textblock} coordinates. I have
@@ -759,8 +770,8 @@
% \texttt{eso-pic} package. There is a vivid example of using Textpos along with Rolf's
% \texttt{eso-pic} package and the \texttt{calc} package on the
% Textpos web pages, at
-% \url{http://purl.org/nxg/dist/textpos}, and an example of how to
-% create a grid with TikZ at \url{http://tex.stackexchange.com/a/85088/96}.
+% \url{https://heptapod.host/nxg/textpos}, and an example of how to
+% create a grid with TikZ at \url{https://tex.stackexchange.com/a/85088/96}.
%
% Finally, Robert Wenner reported a problem when using Textpos along
% with the \texttt{texdraw} package\marginpar{textpos \& texdraw}, with
@@ -791,6 +802,19 @@
% \section{History}
% \iffalse @RELEASENOTES@ \fi
% \begin{description}
+% \item[\textbf{Release 1.10.1, 2022 July 23}]\relax
+%
+% \begin{itemize}
+% \item Mildly improve the handling of a missing |{color}| package.
+% \item The |overlay| option isn't changeable in
+% |\TPoptions|; attempting to do so now produces a
+% warning.
+% \item Various mild documentation improvements.
+% \item The code repository has moved again, to
+% heptapod\footnote{\url{https://heptapod.host/nxg/textpos}}.
+% \end{itemize}
+%
+%
% \item[\textbf{1.10, 2020 September 26}]\relax
%
% \begin{itemize}
@@ -986,8 +1010,7 @@
% \item[Version 1.1]\relax
% Released in 1999
%
-% \end{description}
-%
+% \end{description}%
% \section{Credits}
%
% Olaf Maibaum, \texttt{Olaf.Maibaum at informatik.uni-oldenburg.de},
@@ -1158,11 +1181,17 @@
%
% This code aims to be compatible with both \LaTeXiie\ and \LaTeX3. This
% means that it must use the \pstyle{everyshi} package in the \LaTeXiie\
-% case, and can use the corresponding built-in \LaTeX3 mechanism otherwise.
-% For documentation on the latter, see the `ltshipout' package documentation.
+% case, and must use the corresponding built-in \LaTeX3 mechanism otherwise.
+% For documentation on the latter, see the `ltshipout' package
+% documentation.\footnote{Thanks to Ulrike Fischer for detailed advice
+% on the steps to take here}
%
% There are a couple of places in where we must switch behaviour.
% Conditionalise them with a single switch.
+% Note that we can't use the (apparently preferable)
+% |\IfFormatAtLeastTF| command to do this test: we want to continue to
+% work even when we're using a \LaTeX\ which is too old for this
+% command to be defined.
% \begin{macrocode}
\newif\ifTP at Liii
\@ifl at t@r\fmtversion{2020/10/01}\TP at Liiitrue\TP at Liiifalse
@@ -1171,13 +1200,11 @@
%
% \subsection{Required Packages}
%
-% To manipulate |\box255| when using \LaTeXiie,
-% this package needs the package
-% \pstyle{everyshi}, which provides the command |\EveryShipout|.
+% To manipulate |\box255| when using \LaTeXiie (and only in that case),
+% this package needs the package \pstyle{everyshi},
+% which provides the command |\EveryShipout|.
% \begin{macrocode}
-\ifTP at Liii
- % avoid everyshi package
-\else
+\ifTP at Liii\else
\ifTP at abspos
\RequirePackage{everyshi}
\fi
@@ -1188,14 +1215,21 @@
% \subsection{Changing options within the text}
%
% Define a |\TPoptions| macro which supports constructions like |\TPoptions{verbose=true}|.
+% \iffalse This was I think prompted by the SE question https://tex.stackexchange.com/questions/172902/
+% It was a comment to question
+% https://tex.stackexchange.com/questions/248504/ that made me realise
+% the overlay option wasn't changeable here.
+% \fi
% \begin{macrocode}
\define at key{tp}{absolute}{\csname TP at abspos#1\endcsname}
-\define at key{tp}{overlay}{\csname TP at overlay#1\endcsname}
+\define at key{tp}{overlay}{\PackageWarning{textpos}{The overlay option
+ to TPoptions is not implemented and has been ignored}}
\define at key{tp}{verbose}{\csname TP at chatter#1\endcsname}
\define at key{tp}{showboxes}{\csname TPshowboxes#1\endcsname}
\define at key{tp}{showtext}{\csname TP at showtext#1\endcsname}
-\define at key{tp}{discardcontent}{\csname @tempswa#1\endcsname
- \if at tempswa\TP at displayholdboxfalse\else\TP at displayholdboxtrue\fi}
+\define at key{tp}{discardcontent}{%
+ \csname @tempswa#1\endcsname
+ \if at tempswa\TP at displayholdboxfalse\else\TP at displayholdboxtrue\fi}
\def\TPoptions{\setkeys{tp}}
% \end{macrocode}
%
@@ -1507,18 +1541,26 @@
% here, since the document, or another package, may load the color
% package later. Instead, define a command which will create dummy
% no-op definitions for the package commands we use, and invoke this
-% just before we invoke any of the color package's commands (see above
-% for usage).
+% at the beginning of the document, unless the color package is in
+% fact loaded.
+% Note that the |\@ifundefined{color}| test is redundant in the
+% \LaTeX3 case; we retain it for the \LaTeXiie\ case.
% \begin{macrocode}
\gdef\TP at color[#1]#2{}
-\def\TP at checkdummycolorpackage{%
- \@ifundefined{color}%
+\def\TP at dummycolorpackage{
+ \@ifundefined{color}
{\globaldefs=1
- \DeclareRobustCommand\color[2][]{}%
- \def\color at block##1##2##3{}%
- \globaldefs=0 }{}%
- \global\let\TP at checkdummycolorpackage\relax % don't come here again
+ \DeclareRobustCommand\color[2][]{}
+ \def\color at block##1##2##3{}
+ \globaldefs=0 }
+ {}
}
+\ifTP at Liii
+ \AddToHook{env/document/before}{\TP at dummycolorpackage}
+ \AddToHook{file/color.sty/after}{\let\TP at dummycolorpackage\relax}
+\else
+ \AtBeginDocument{\TP at dummycolorpackage}
+\fi
% \end{macrocode}
%
% Default the reference position, and support the command to override it.
@@ -1611,7 +1653,6 @@
% If we're showing boxes, then draw a rule here
% \begin{macrocode}
\ifTPshowboxes
- \TP at checkdummycolorpackage
{\color{\TP at rulecolour}\hrule height0pt depth \TPboxrulesize }%
\vskip-\TPboxrulesize
\fi
@@ -1785,8 +1826,7 @@
\setbox0=\vbox to 0pt{\vskip\@tempdimb
\hbox to 0pt{\hskip\@tempdima
\ifx\TP at blockcolour\@empty \else
- {\TP at checkdummycolorpackage
- \color{\TP at blockcolour}%
+ {\color{\TP at blockcolour}%
\color at block{\wd\TP at textbox}{\ht\TP at textbox}{\dp\TP at textbox}%
}%
\fi
@@ -1899,8 +1939,9 @@
% \end{macrocode}
%
% Second, the \LaTeXiie\ case: use the macros provided by the \pstyle{everyshi} package.
-% We set up the output routine with |\EveryShipout|, and . Respect the
-% \Lopt{overlay} option by putting the |\TP at holdbox| contents
+% We set up the output routine with |\EveryShipout|.
+%
+% Respect the \Lopt{overlay} option by putting the |\TP at holdbox| contents
% \emph{after} the |\@cclv| contents, putting the latter into a size-0
% box (could this cause a problem with spacing? I don't think so, at
% this stage).
@@ -1928,9 +1969,12 @@
}%
\fi}%
\fi
- \fi
+ \fi % ifTP at Liii
+% \end{macrocode}
+% Finally, set the textblockorigin to the (default) upper-left corner of the paper.
+% \begin{macrocode}
\textblockorigin{0pt}{0pt}%
-\fi
+\fi % ifTP at abspos
% \end{macrocode}
% Done!
% \begin{macrocode}
Modified: trunk/Master/texmf-dist/tex/latex/textpos/textpos.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/textpos/textpos.sty 2022-07-23 06:41:02 UTC (rev 63961)
+++ trunk/Master/texmf-dist/tex/latex/textpos/textpos.sty 2022-07-23 21:38:40 UTC (rev 63962)
@@ -13,7 +13,7 @@
%% conditions of the LaTeX Project Public License, either version 1.3
%% of this license or (at your option) any later version.
%% The latest version of this license is in
-%% http://www.latex-project.org/lppl.txt
+%% https://www.latex-project.org/lppl.txt
%% and version 1.3 or later is part of all distributions of LaTeX
%% version 2005/12/01 or later.
%%
@@ -29,11 +29,10 @@
%%
%% See the file LICENCE for a copy of the LPPL.
%%
-%% Mercurial ident: c834991c867a (1.10+1), 2020-09-26 17:44 +0100
+%% Mercurial ident: 1.10.1 (@VCSINFO)
%%
\NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{textpos}[2020/09/26 v1.10]
-\typeout{Package: textpos 2020/09/26 1.10, absolute positioning of text on the page}
+\ProvidesPackage{textpos}[2022/07/23 v1.10.1]
\newif\ifTPshowboxes
\TPshowboxesfalse
@@ -59,9 +58,7 @@
\newif\ifTP at Liii
\@ifl at t@r\fmtversion{2020/10/01}\TP at Liiitrue\TP at Liiifalse
\PackageInfo{textpos}{choosing support for \ifTP at Liii LaTeX3\else LaTeX2e\fi}
-\ifTP at Liii
- % avoid everyshi package
-\else
+\ifTP at Liii\else
\ifTP at abspos
\RequirePackage{everyshi}
\fi
@@ -68,12 +65,14 @@
\fi
\RequirePackage{keyval}
\define at key{tp}{absolute}{\csname TP at abspos#1\endcsname}
-\define at key{tp}{overlay}{\csname TP at overlay#1\endcsname}
+\define at key{tp}{overlay}{\PackageWarning{textpos}{The overlay option
+ to TPoptions is not implemented and has been ignored}}
\define at key{tp}{verbose}{\csname TP at chatter#1\endcsname}
\define at key{tp}{showboxes}{\csname TPshowboxes#1\endcsname}
\define at key{tp}{showtext}{\csname TP at showtext#1\endcsname}
-\define at key{tp}{discardcontent}{\csname @tempswa#1\endcsname
- \if at tempswa\TP at displayholdboxfalse\else\TP at displayholdboxtrue\fi}
+\define at key{tp}{discardcontent}{%
+ \csname @tempswa#1\endcsname
+ \if at tempswa\TP at displayholdboxfalse\else\TP at displayholdboxtrue\fi}
\def\TPoptions{\setkeys{tp}}
\def\TP at xfloat#1[#2]{
\par\def\@captype{#1}%
@@ -208,14 +207,20 @@
\let\textblockrulecolor\textblockrulecolour
\let\tekstblokroolkulur\textblockrulecolour
\gdef\TP at color[#1]#2{}
-\def\TP at checkdummycolorpackage{%
- \@ifundefined{color}%
+\def\TP at dummycolorpackage{
+ \@ifundefined{color}
{\globaldefs=1
- \DeclareRobustCommand\color[2][]{}%
- \def\color at block##1##2##3{}%
- \globaldefs=0 }{}%
- \global\let\TP at checkdummycolorpackage\relax % don't come here again
+ \DeclareRobustCommand\color[2][]{}
+ \def\color at block##1##2##3{}
+ \globaldefs=0 }
+ {}
}
+\ifTP at Liii
+ \AddToHook{env/document/before}{\TP at dummycolorpackage}
+ \AddToHook{file/color.sty/after}{\let\TP at dummycolorpackage\relax}
+\else
+ \AtBeginDocument{\TP at dummycolorpackage}
+\fi
\def\TP at referenceposition{0,0}
\def\TPReferencePosition#1{\def\TP at referenceposition{#1}}
\def\textblock#1{%
@@ -251,7 +256,6 @@
\let\@xympar\TP at xympar
\setbox\TP at textbox=\vbox\bgroup
\ifTPshowboxes
- \TP at checkdummycolorpackage
{\color{\TP at rulecolour}\hrule height0pt depth \TPboxrulesize }%
\vskip-\TPboxrulesize
\fi
@@ -322,8 +326,7 @@
\setbox0=\vbox to 0pt{\vskip\@tempdimb
\hbox to 0pt{\hskip\@tempdima
\ifx\TP at blockcolour\@empty \else
- {\TP at checkdummycolorpackage
- \color{\TP at blockcolour}%
+ {\color{\TP at blockcolour}%
\color at block{\wd\TP at textbox}{\ht\TP at textbox}{\dp\TP at textbox}%
}%
\fi
@@ -408,9 +411,9 @@
}%
\fi}%
\fi
- \fi
+ \fi % ifTP at Liii
\textblockorigin{0pt}{0pt}%
-\fi
+\fi % ifTP at abspos
\endinput
%%
%% End of file `textpos.sty'.
More information about the tex-live-commits
mailing list.