summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/textpos
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-06-09 22:53:55 +0000
committerKarl Berry <karl@freefriends.org>2016-06-09 22:53:55 +0000
commit29b2df230459512a0f73e5769a1cfc16e4125510 (patch)
tree7ace3eb84f9786277a63ea0d04585d170d44d897 /Master/texmf-dist/doc/latex/textpos
parent96152b37515359e17b9cbe19a6186cec57a15eda (diff)
textpos (8jun16)
git-svn-id: svn://tug.org/texlive/trunk@41331 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/textpos')
-rw-r--r--Master/texmf-dist/doc/latex/textpos/README6
-rw-r--r--Master/texmf-dist/doc/latex/textpos/VERSION-1.7j1
-rw-r--r--Master/texmf-dist/doc/latex/textpos/VERSION-1.81
-rw-r--r--Master/texmf-dist/doc/latex/textpos/examples/README.examples (renamed from Master/texmf-dist/doc/latex/textpos/examples/README-examples)0
-rw-r--r--Master/texmf-dist/doc/latex/textpos/examples/t10.tex46
-rw-r--r--Master/texmf-dist/doc/latex/textpos/examples/t6.tex10
-rw-r--r--Master/texmf-dist/doc/latex/textpos/examples/t9.tex67
-rw-r--r--Master/texmf-dist/doc/latex/textpos/textpos-example.tex4
-rw-r--r--Master/texmf-dist/doc/latex/textpos/textpos.html116
-rw-r--r--Master/texmf-dist/doc/latex/textpos/textpos.pdfbin239198 -> 255281 bytes
10 files changed, 189 insertions, 62 deletions
diff --git a/Master/texmf-dist/doc/latex/textpos/README b/Master/texmf-dist/doc/latex/textpos/README
index b4ffc126aac..f5217dcc6f4 100644
--- a/Master/texmf-dist/doc/latex/textpos/README
+++ b/Master/texmf-dist/doc/latex/textpos/README
@@ -2,12 +2,12 @@
Textpos: absolute positioning of text on the LaTeX page
-------------------------------------------------------
-Version 1.7j, 2014 January 3
+Version 1.8, 2016 June 7
This package facilitates placing boxes at absolute positions on the
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.
+large-format conference poster.
This package provides a single environment, plus a starred variant,
which contains the text (or graphics, or table, or whatever) which is
@@ -36,7 +36,7 @@ or one of the other CTAN hosts.
Licence
-------
-This software is copyright, 1999, 2001--2003, 2005-7, 2009-12, 2014, Norman Gray.
+This software is copyright, 1999, 2001-03, 2005-7, 2009-12, 2014-16., Norman Gray.
It is released under the terms of the [LaTeX Project Public License][lppl],
which is included in the file LICENCE.
diff --git a/Master/texmf-dist/doc/latex/textpos/VERSION-1.7j b/Master/texmf-dist/doc/latex/textpos/VERSION-1.7j
deleted file mode 100644
index 5dfd917b354..00000000000
--- a/Master/texmf-dist/doc/latex/textpos/VERSION-1.7j
+++ /dev/null
@@ -1 +0,0 @@
-textpos-1.7j, released 2014 January 3
diff --git a/Master/texmf-dist/doc/latex/textpos/VERSION-1.8 b/Master/texmf-dist/doc/latex/textpos/VERSION-1.8
new file mode 100644
index 00000000000..c152fe5986f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/textpos/VERSION-1.8
@@ -0,0 +1 @@
+textpos-1.8, released 2016 June 7
diff --git a/Master/texmf-dist/doc/latex/textpos/examples/README-examples b/Master/texmf-dist/doc/latex/textpos/examples/README.examples
index 16b23fb6977..16b23fb6977 100644
--- a/Master/texmf-dist/doc/latex/textpos/examples/README-examples
+++ b/Master/texmf-dist/doc/latex/textpos/examples/README.examples
diff --git a/Master/texmf-dist/doc/latex/textpos/examples/t10.tex b/Master/texmf-dist/doc/latex/textpos/examples/t10.tex
new file mode 100644
index 00000000000..3c8677353d8
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/textpos/examples/t10.tex
@@ -0,0 +1,46 @@
+%%% Testing:interactions between (x,y)-positioning and \TPMargin
+% See https://bitbucket.org/nxg/textpos/issues/3/
+% Thanks to Richard Schreiber for the report and initial test code.
+
+\documentclass{minimal}
+\usepackage[top=0mm,bottom=0mm,left=0mm,right=0mm,a5paper]{geometry}
+\usepackage{color}
+\usepackage[absolute,showboxes]{textpos}
+
+\parindent0mm
+\begin{document}
+
+\textblockrulecolour{magenta}
+\TPGrid[0mm,0mm]{6}{9}%
+\TPMargin{5mm}%
+
+\null\vskip 4cm
+\noindent \hrule width 2\TPHorizModule
+\smallskip
+\hbox to 2\TPHorizModule{$\leftarrow$\hfil two units wide\hfil $\rightarrow$}
+
+\begin{textblock}{2}(0,0)
+ This box is top-left.
+ The top and left margin lines touch the edge of the page.
+\end{textblock}
+
+\begin{textblock}{2}[0,1](0,9)
+ This box should sit at the bottom left.
+ The box should be two units wide, and the text correspondingly narrower.
+ The bottom and left margin lines should touch the edge of the page.
+\end{textblock}
+
+\TPMargin*{5mm}
+\begin{textblock}{2}[1,0](6,0)
+ This box should sit at the top right of the page, and the text
+ should be two units wide. The top and right margin lines should be
+ off the page.
+\end{textblock}
+
+\TPMargin{0mm}%
+\begin{textblock}{2}[1,1](6,9)
+ This box sits at the bottom right edge.
+ The text and box are two units wide.
+ The bottom and right margin lines touch the edge of the page.
+\end{textblock}
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/textpos/examples/t6.tex b/Master/texmf-dist/doc/latex/textpos/examples/t6.tex
index 93e3cefaeb9..5c479987b65 100644
--- a/Master/texmf-dist/doc/latex/textpos/examples/t6.tex
+++ b/Master/texmf-dist/doc/latex/textpos/examples/t6.tex
@@ -20,15 +20,21 @@
Blue
\end{textblock}
-\begin{textblock}{8}(14,0)
+\begin{textblock}{12}(4,-1)
+ \hrule width 12\TPHorizModule
+ \vbox to 0pt{\hbox{12 units}\vss}
+ \vskip1\TPVertModule
\hrule width 8\TPHorizModule
+ \vbox to 0pt{\hbox{8 units}\vss}
\vskip1\TPVertModule
\hrule width 4\TPHorizModule
+ \vbox to 0pt{\hbox{4 units}\vss}
\vskip1\TPVertModule
\hrule width 2\TPHorizModule
+ \vbox to 0pt{\hbox{2 units}\vss}
\vskip1\TPVertModule
\hrule width 1\TPHorizModule
-\end{textblock}
+\end{textblock}
\begin{textblock}{12}(4,4)
This text is inside a box with a blue background. The text is flush
diff --git a/Master/texmf-dist/doc/latex/textpos/examples/t9.tex b/Master/texmf-dist/doc/latex/textpos/examples/t9.tex
new file mode 100644
index 00000000000..b86cf388929
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/textpos/examples/t9.tex
@@ -0,0 +1,67 @@
+%%% Testing: switching between absolute and relative mode
+
+\documentclass{article}
+
+\usepackage[absolute,showboxes]{textpos}
+\setlength{\parindent}{0pt}
+\TPHorizModule=1cm
+\TPVertModule=1cm
+
+\begin{document}
+
+Here is some text, which appears in the body of the page.
+\begin{textblock}{5}(0,0)
+This text is at (0,0), and should appear at the very top-left corner.
+\end{textblock}
+
+Here is more text, which also appears in the body.
+\begin{textblock}{5}(1,1)
+This text is at (1,1), and should appear near the top-left corner, 1cm
+in and down.
+\end{textblock}
+
+\newpage
+\TPoptions{ absolute=false,
+ showboxes = false}
+
+Here is some text, which appears in the body of page two.
+\begin{textblock}{5}(0,0)
+This text is at (0,0), and appears at the top-left of the text block,
+just under `Here is some text'.
+It should not have a box around it.
+\end{textblock}
+
+\vskip4cm
+Here is more text, which also appears in the body of p.2.
+\begin{textblock}{5}(1,1)
+This text is at (1,1), and also appears in the text block 1cm along
+and down from the `Here is more text', and without a surrounding box.
+\end{textblock}
+
+\TPoptions{absolute=true, showboxes=true, showtext=false}
+
+\vskip4cm
+Text. The corresponding text block should appear only as a box, with
+no text inside it. It appears in the top-left corner of the page.
+\begin{textblock}{5}(0,0)
+This text should not appear (just the box, positioned 2cm along and
+down from `Text.'
+\end{textblock}
+
+\TPoptions{absolute=false, showboxes=true, showtext=true}
+
+\vskip4cm
+Text 2.
+\begin{textblock}{5}(6,0)
+This text should appear surrounded by a box, level with, but along from, `Text 2'.
+\end{textblock}
+
+\newpage
+\TPoptions{absolute=true}
+
+Page 3.
+\begin{textblock}{5}(0,0)
+This text appears at the extreme top-left of page three.
+\end{textblock}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/textpos/textpos-example.tex b/Master/texmf-dist/doc/latex/textpos/textpos-example.tex
index 0b7ab253308..1f8f44f7997 100644
--- a/Master/texmf-dist/doc/latex/textpos/textpos-example.tex
+++ b/Master/texmf-dist/doc/latex/textpos/textpos-example.tex
@@ -7,7 +7,7 @@
%% textpos.dtx (with options: `example')
%% Textpos: absolute positioning of text on the page
%%%% File: textpos.dtx
-%%%% Copyright 1999, 2001--2003, 2005-7, 2009-12, 2014, Norman Gray
+%%%% Copyright 1999, 2001-03, 2005-7, 2009-12, 2014-16., Norman Gray
%%
%% This work may be distributed and/or modified under the
%% conditions of the LaTeX Project Public License, either version 1.3
@@ -29,7 +29,7 @@
%%
%% See the file LICENCE for a copy of the LPPL.
%%
-%% Mercurial ident: 41b12ce5565c, 2014-01-03 19:15 +0000
+%% Mercurial ident: 8aa202e2b283, 2016-06-07 23:52 +0100
%%
\documentclass{article}
diff --git a/Master/texmf-dist/doc/latex/textpos/textpos.html b/Master/texmf-dist/doc/latex/textpos/textpos.html
index 8ef009c7242..ebc494edc96 100644
--- a/Master/texmf-dist/doc/latex/textpos/textpos.html
+++ b/Master/texmf-dist/doc/latex/textpos/textpos.html
@@ -1,65 +1,97 @@
<?xml version="1.0"?>
-
<html xmlns="http://www.w3.org/1999/xhtml">
<head profile="http://dublincore.org/documents/dcq-html/">
<title>Textpos</title>
-<meta name='DC.subject' content='latex, textpos, absolute positioning'/>
-<meta name='DC.title' content='Textpos'/>
-<meta name='DC.date' content='2006-8-24'/> <!-- 1.7 release date -->
-<meta name='rcsdate' content='$Date$'/>
-<link rel="schema.DC" href="http://purl.org/dc/elements/1.1/" />
-<link href="http://nxg.me.uk" rev="author"/>
-<link type="text/css" rel="stylesheet"
- href="style.css"/>
+<meta name="DC.subject" content="latex, textpos, absolute positioning"/>
+<meta name="DC.title" content="Textpos"/>
+<meta name="DC.date" content="2016-06-07"/>
+<link rel="schema.DC" href="http://purl.org/dc/elements/1.1/"/>
+<link href="https://nxg.me.uk/norman" rev="author"/>
+<link type="text/css" rel="stylesheet" href="style.css"/>
</head>
<body>
<h1>Textpos</h1>
<div class="abstract">
<p>Lay out text and graphics at arbitrary positions on the LaTeX page.</p>
-<p>The textpos home page is at <a href='http://purl.org/nxg/dist/textpos'
- ><code>http://purl.org/nxg/dist/textpos</code></a>;
+
+<p>
+
+<span class="distpage">The textpos home page is at
+<a href="http://purl.org/nxg/dist/textpos"><code>http://purl.org/nxg/dist/textpos</code></a>;</span>
please quote this URL rather than the URL it resolves to.</p>
-<p>Version 1.7j, 2014 January 3.</p>
+<p>Version 1.8, 2016 June 7.</p>
</div>
<p>This package facilitates placing boxes at absolute positions on the
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="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=abspos">TeX FAQ
entry on absolute positioning</a>.</p>
<p>This package provides a single environment, which contains the text
(or graphics, or table, or whatever) which is to be placed on the
page, and which specifies where it is to be placed. The environment
-is accompanied by various configuration commands. See the <a
-href="textpos.pdf" >manual (pdf)</a>.</p>
+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="http://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="http://purl.org/nxg/note/posters">creating
conference posters with LaTeX</a>.</p>
<p>Rolf Niepraschk provided me with a wonderful demo
-(<a href="niepraschk-eso-pic.tex" >tex</a>,
-<a href="niepraschk-eso-pic.pdf" >pdf</a>)
+(<a href="niepraschk-eso-pic.tex">tex</a>,
+<a href="niepraschk-eso-pic.pdf">pdf</a>)
of using Textpos along with his <code>eso-pic</code> package,
and the <code>calc</code> package, to produce a grid which can help lay out
material on the page.</p>
<p>The source is held at
-<a href='https://bitbucket.org/nxg/textpos'>bitbucket</a>,
+<a href="https://bitbucket.org/nxg/textpos">bitbucket</a>,
and there is an issues list there, for bug reports.</p>
-<h3>History</h3>
+
+<div class="distpage">
+ <h2>Installation and further information</h2>
+</div>
+
+<ol>
+
+
+
+<li>Run LaTeX on the file <code>textpos.ins</code> – this will
+unpack the style file <code>textpos.sty</code> amongst other files.
+Place this somewhere where TeX can find it.</li>
+
+<li>Run LaTeX on the file <code>textpos.dtx</code> to obtain the
+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><code>Textpos</code> is also available on CTAN:
+<a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/textpos/">/tex-archive/macros/latex/contrib/textpos/</a></p>
+
+
+
+<h2>History</h2>
<dl>
+<dt><strong>1.8, 2016 June 5</strong></dt>
+<dd><ul>
+<li>Added the <code>\TPoptions</code> command, to switch modes on and
+off within the document. Various documentation tweaks.</li>
+<li>The behaviour of <code>\TPMargin</code> and
+<code>\TPMargin*</code> were somewhat underspecified in versions of
+Textpos before v1.8, and in consequence inconsistently implemented.
+This has now been rationalised, but the change <em>may</em> change
+documents which relied on the previous behaviour.
+Thanks to Richard Schreiber for the detailed bug report.</li>
+</ul></dd>
+
<dt>1.7j, 2014 January 3</dt>
<dd>Re-released under the LPPL.</dd>
@@ -74,7 +106,7 @@ Pointers to bitbucket repository.</dd>
<dt>1.7g, 2010 September 30</dt>
<dd>Bugfix: change the way we handle the {color} package not being
-loaded -- replacement <code>\color</code> command is now robust.
+loaded – replacement <code>\color</code> command is now robust.
Thanks to Joseph Wright for the bugreport.
Also adjusted documentation of reference points.</dd>
@@ -175,7 +207,7 @@ which leaves box255 holding an hbox at the wrong moment</dd>
<dt>1.2a, 2002 April 28</dt>
<dd>Version 1.2 had an error, which caused a confusing error
if you gave any fractional part in the arguments to the
-<code>{textblock}</code> environment. This was fixed in version 1.2a,
+<code>{textblock}</code> environment. This was fixed in version 1.2a,
which adds a <code>{textblock*}</code> environment (fully compatible
with <code>calc</code>), and does not attempt to support calc-style
expressions in the parameters to the unstarred
@@ -185,40 +217,16 @@ expressions in the parameters to the unstarred
<dd>Rolf Niepraschk <code>niepraschk@ptb.de</code> provided code to
make textpos compatible with the <code>calc</code> package</dd>
-<dt>Version 1.1 was released in 1999</dt>
+<dt>Version 1.1</dt>
+<dd>Released in 1999</dd>
</dl>
-<h3>Installation and further information</h3>
-
-<ol>
-
-<li>Run LaTeX on the file <code>textpos.ins</code> -- this will
-unpack the style file <code>textpos.sty</code> amongst other files.
-Place this somewhere where TeX can find it.</li>
-
-<li>Run LaTeX on the file <code>textpos.dtx</code> to obtain the
-documentation.</li>
-</ol>
-
-<p>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><code>Textpos</code> is also available on CTAN:
-<a href='http://www.tex.ac.uk/tex-archive/macros/latex/contrib/textpos/'
- >/tex-archive/macros/latex/contrib/textpos/</a></p>
-
<div class="signature">
-<a href="http://nxg.me.uk" >Norman Gray</a><br />
-2014 January 3
+<a href="http://nxg.me.uk">Norman Gray</a><br/>
+2016 June 7
</div>
</body>
</html>
-
-
-<!-- Local Variables: -->
-<!-- mode: nxml -->
-<!-- End: -->
diff --git a/Master/texmf-dist/doc/latex/textpos/textpos.pdf b/Master/texmf-dist/doc/latex/textpos/textpos.pdf
index 285d5746816..12c9d0ca19a 100644
--- a/Master/texmf-dist/doc/latex/textpos/textpos.pdf
+++ b/Master/texmf-dist/doc/latex/textpos/textpos.pdf
Binary files differ