summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2020-09-30 21:31:20 +0000
committerKarl Berry <karl@freefriends.org>2020-09-30 21:31:20 +0000
commit40798850122bd8b9651ac49ddd8cf538966bfb88 (patch)
treec53ae85decd7d6db81ccdde9bc34791ea4bc9c7d /Master/texmf-dist/doc/generic
parentde7fd969fdde34e01cd655906a1f5f678d8f67f6 (diff)
localloc now in generic (30sep20)
git-svn-id: svn://tug.org/texlive/trunk@56496 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic')
-rw-r--r--Master/texmf-dist/doc/generic/localloc/localloc.README43
-rw-r--r--Master/texmf-dist/doc/generic/localloc/localloc.pdfbin0 -> 259706 bytes
-rw-r--r--Master/texmf-dist/doc/generic/localloc/localtst.tex117
3 files changed, 160 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/localloc/localloc.README b/Master/texmf-dist/doc/generic/localloc/localloc.README
new file mode 100644
index 00000000000..395102aeaee
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/localloc/localloc.README
@@ -0,0 +1,43 @@
+Readme File for the package `localloc' by Bernd Raichle
+Copyright (C) 1991,1994,1995 Bernd Raichle. All rights reserved.
+
+ The `localloc' package reimplements plain-TeX's basic allocation
+macros to allow local allocation of registers. It can be used with
+ * plain-TeX,
+ * LaTeX2e,
+ * LaTeX 2.09,
+and all other formats which are based on plain-TeX.
+ In the past people complained about the restriction of 256
+registers imposed by TeX and want either more registers or a more
+clever way to maintain this limited resource. This package shows
+and implements a mechanism which doesn't remove this restrictions
+but allows local allocation of registers. Using this mechanism
+you can often replace global register allocations by ones local
+to a group allowing the register to be used for other purposes
+after the group is left.
+
+
+Installation:
+-------------
+
+This package contains 2 files, namely
+ * localloc.README This README file
+ * localloc.dtx The docstrip archive file containing the
+ source for the macro file `localloc.sty'
+ and the documentation.
+
+To unpack the archive file you need `docstrip.tex' version 2.x or
+newer. You can find this file in the LaTeX2e release; it can be
+used with plain-TeX _and_ LaTeX. Run `localloc.dtx' through
+plainTeX or LaTeX to unpack the archive file:
+ tex localloc.dtx
+or
+ latex localloc.dtx
+
+
+This package is supported by
+
+Bernd Raichle
+Stettener Str. 73
+D-73732 Esslingen, FRG
+Email: raichle@Informatik.Uni-Stuttgart.DE
diff --git a/Master/texmf-dist/doc/generic/localloc/localloc.pdf b/Master/texmf-dist/doc/generic/localloc/localloc.pdf
new file mode 100644
index 00000000000..3a25e8fd45f
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/localloc/localloc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/generic/localloc/localtst.tex b/Master/texmf-dist/doc/generic/localloc/localtst.tex
new file mode 100644
index 00000000000..6e39e98dcb1
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/localloc/localtst.tex
@@ -0,0 +1,117 @@
+%%
+%% This is file `localtst.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% localloc.dtx (with options: `test')
+%%
+%% This is a file of the `localloc' package reimplementing
+%% plain-TeX's and LaTeX's basic allocation macros to allow
+%% local allocation of registers.
+%%
+%% -- Copyright (C) 1991-1995 Bernd Raichle. All rights reserved --
+%%
+%% This package 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.
+%%
+%%
+%% IMPORTANT NOTICE:
+%%
+%% Copying of this file is authorized only if either
+%% (1) you make absolutely no changes to your copy, including name, or
+%% (2) if you do make changes, you name it something other than
+%% localloc.dtx, localloc.doc, localloc.tex, or localloc.sty.
+%%
+%% For error reports see original source file `localloc.dtx'.
+%%
+\begingroup\expandafter\expandafter\expandafter\endgroup
+\expandafter\ifx\csname ProvidesPackage\endcsname\relax
+\else
+ \NeedsTeXFormat{LaTeX2e}
+ \ProvidesFile{localtst.tex}%
+ [1995/09/24 v1.1b %
+ Additional LaTeX Kernel Macros (local allocation)]
+\fi
+\edef\FORMAT{%
+ \expandafter\ifx\csname documentstyle\endcsname\relax 0%
+ \else\expandafter\ifx\csname documentclass\endcsname\relax
+ 1\else 2\fi\fi}
+\immediate\write16{=====>>> You are using %
+ \ifcase\FORMAT plainTeX\or LaTeX 2.09\or LaTeX 2e\else ??\fi}
+\ifcase\FORMAT
+ \input localloc.sty\relax \or
+ \documentstyle[localloc]{article}\begin{document}\or
+ \documentclass{article}\usepackage{localloc}\begin{document}\fi
+\tracingstats=1
+\def\Message#1{\immediate\write16{#1}}
+\def\RegVal#1{\the\csname test#1\endcsname}
+\def\ShowSet#1{\if l#1local\else global\fi:
+ \RegVal{i#1} \RegVal{ii#1}/\RegVal{iii#1}
+ \RegVal{iv#1}}
+\def\ShowAll#1{\Message{#1 -- \ShowSet{g} -- \ShowSet{l}}}
+\def\ShowIns{\Message{Insertions:
+ \the\testinsi, \the\testinsii, \the\testinsiii}}
+\chardef\testig=0 \chardef\testil=0
+\chardef\testiig=0 \chardef\testiil=0
+\chardef\testiiig=0 \chardef\testiiil=0
+\chardef\testivg=0 \chardef\testivl=0
+\chardef\testinsii=0 \chardef\testinsiii=0
+\newinsert\testinsi
+{\count0=\testinsi \advance\count0 -2
+ \loop\csname newbox\endcsname\testig
+ \ifnum\testig<\count0\repeat}
+\newbox\testig \lnewbox\testil
+\ShowAll{Level 0}
+\begingroup
+ \lnewbox\testiil \newbox\testiig
+ \ShowAll{Level 1}
+ \begingroup
+ \newbox\testivg \lnewbox\testivl
+ \ShowAll{Level 2}\ShowIns
+ \endgroup
+ \lnewbox\testiiil \newbox\testiiig
+ \ShowAll{Level 1b}
+ \csname newinsert\endcsname\testinsii
+ \ShowIns
+ \begingroup
+ \newbox\testivg \lnewbox\testivl
+ \ShowAll{Level 2}
+ \endgroup
+ \ShowAll{Level 1b}
+\endgroup
+\newinsert\testinsiii
+\ShowAll{Level 0}\ShowIns
+\begingroup
+ \lnewbox\testiil \newbox\testiig
+ \lnewbox\testiiil \newbox\testiiig
+ \ShowAll{Level 1}
+ \begingroup
+ \newbox\testivg \lnewbox\testivl
+ \newbox\testvg \lnewbox\testvl
+ \ShowAll{Level 2}\ShowIns
+ \endgroup
+ \ShowAll{Level 1}
+\endgroup
+\ShowAll{Level 0}
+\end{document}
+%% \CharacterTable
+%% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
+%% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
+%% Digits \0\1\2\3\4\5\6\7\8\9
+%% Exclamation \! Double quote \" Hash (number) \#
+%% Dollar \$ Percent \% Ampersand \&
+%% Acute accent \' Left paren \( Right paren \)
+%% Asterisk \* Plus \+ Comma \,
+%% Minus \- Point \. Solidus \/
+%% Colon \: Semicolon \; Less than \<
+%% Equals \= Greater than \> Question mark \?
+%% Commercial at \@ Left bracket \[ Backslash \\
+%% Right bracket \] Circumflex \^ Underscore \_
+%% Grave accent \` Left brace \{ Vertical bar \|
+%% Right brace \} Tilde \~}
+%%
+\endinput
+%%
+%% End of file `localtst.tex'.