summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/texpower/fulldemo.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/texpower/fulldemo.tex')
-rw-r--r--Master/texmf-dist/doc/latex/texpower/fulldemo.tex164
1 files changed, 58 insertions, 106 deletions
diff --git a/Master/texmf-dist/doc/latex/texpower/fulldemo.tex b/Master/texmf-dist/doc/latex/texpower/fulldemo.tex
index fac601aa535..a599c3fcc34 100644
--- a/Master/texmf-dist/doc/latex/texpower/fulldemo.tex
+++ b/Master/texmf-dist/doc/latex/texpower/fulldemo.tex
@@ -4,7 +4,7 @@
%%
%% The original source files were:
%%
-%% texpower-doc.dtx (with options: `fulldemo')
+%% texpower-doc.dtx (with options: `version,fulldemo')
%% texpower-doc.dtx (with options: `picexample-src')
%% texpower-doc.dtx (with options: `tabexample-src')
%% texpower-doc.dtx (with options: `mathexample-src')
@@ -17,6 +17,7 @@
%% --------------------------------------------------------------
%% TeXPower bundle - dynamic online presentations with LaTeX
%% Copyright (C) 1999-2004 Stephan Lehmke
+%% Copyright (C) 2003-2005 Hans Fredrik Nordhaug
%%
%% This program is free software; you can redistribute it and/or
%% modify it under the terms of the GNU General Public License
@@ -33,50 +34,10 @@
%% given in the file `00readme.txt'.
%%
\ProvidesFile{fulldemo.tex}%
- [2004/07/27 TeXPower full demo and manual]
-%-----------------------------------------------------------------------------------------------------------------
-% File: fulldemo.tex
-%
-% Demo & Manual for the package texpower.sty (pre-alpha release).
-%
-% This file can be compiled with pdfLaTeX or (standard) LaTeX. When using standard LaTeX, the dvi file produced should
-% be processed with
-%
-% dvips -Ppdf fulldemo
-%
-% afterwards processing the resulting ps file with
-%
-% distill fulldemo.ps
-%
-% (The syntax is for a unix system with tetex 1.0 and distiller 3. Modify appropriately for other configurations.)
-%
-% The resulting pdf file is meant for presenting `interactively' with Adobe Acrobat Reader.
-%
-%-----------------------------------------------------------------------------------------------------------------
-% Autor: Stephan Lehmke <Stephan.Lehmke@cs.uni-dortmund.de>
-%
-% v0.0.1 Oct 26, 1999: seven examples completed; parts of inline documentation
-%
-% v0.0.2 Feb 18, 2000: inline documentation of examples completed
-%
-% v0.0.3 Mar 1, 2000: added examples for \pause and page transitions; Documentation section started
-%
-% v0.0.4 Mar 10, 2000: Documentation for the first pre-alpha release completed
-%
-% v0.0.5 Mar 20, 2000: Documentation split into several files to reduce compilation problems; tested with pdflatex
-%
-% v0.0.6 May 2, 2000: Some small changes in preparation of the update to TeXpower v0.0.7.
-%
-% v0.0.7 May 24, 2000: Some small changes in preparation of the update to TeXpower v0.0.8.
-%
-% v0.0.8 Aug 29, 2000: Added backgroundstyle command for the update to TeXpower v0.0.9.
-%
-
-
-%-----------------------------------------------------------------------------------------------------------------
+ [2005/04/07 TeXPower full demo and manual]
-% Version info
-\def\tpversion{v0.0.9d of May 15, 2003 (alpha)}
+% Version info used in titles
+\def\tpversion{v0.2 of April 8, 2005}
% Enable all color emphasis and highlighting options; use a light background and slifonts.
@@ -102,6 +63,7 @@
{% Yes.
% PsTricks is used for creating the picture example.
+ \usepackage[noxcolor]{pstricks}
\usepackage{pstcol}
\usepackage{pst-node}
@@ -181,12 +143,12 @@
\newslide
\minisec{Disclaimer}
- This is a \emph{alpha} release of the \TeX Power bundle.
+ This is still work inprogress.
During the subsequent error correction and extension of the functionality, the syntax and implementation of the macros
described here are liable to change.
- The transformation to the dtx format is also not completed.
+ Even though we are using dtx-files, these are still not fully documented dtx-files.
\newslide
@@ -272,13 +234,9 @@
%
\newcommand{\tabend}{\\\hline}%
- \stepwise
- {%
- \hrule height 0pt\relax% This is neccessary to avoid a glitch in vertical spacing. Don't ask me why. I'll try to get
- % this right until the first alpha version.
+ \liststepwise{%
\begin{center}
- \step
- {%
+ \step{%
\begin{tabular}{|l|l|l|}
\hline
They can & be built & line by line%
@@ -323,7 +281,7 @@
% frame is reduced.
\setlength{\highlightboxsep}{1pt}%
%
- \begin{align}
+ \begin{align*}
\lefteqn
{%
\min
@@ -451,7 +409,7 @@
\right)
\right)
}
- \end{align}
+ \end{align*}
}%
\newslide
%
@@ -772,44 +730,11 @@ Instead of displaying incrementally, we can just `flip through' some items by hi
\addtocontents{toc}{\protect\clearpage}
-%
-%-----------------------------------------------------------------------------------------------------------------
-%
-% Documentation of the TeXPower bundle.
-%
-% Autor: Stephan Lehmke <Stephan.Lehmke@cs.uni-dortmund.de>
-%
-% v0.0.1 Mar 20, 2000: First version for the pre-alpha release of TeXPower.
-%
-% v0.0.2 Mar 29, 2000: Added `usage and basic options' section.
-%
-% v0.0.3 Apr 04, 2000: Added `Color Emphasis and Highlighting' section.
-%
-% v0.0.4 Apr 12, 2000: A lot of small additions in preparation of the update to TeXpower v0.0.7.
-%
-% v0.0.5 May 31, 2000: Updated for TeXpower v0.0.8.
-%
-% v0.0.6 Jun 09, 2000: Some updates for TeXpower v0.0.8b.
-%
-% v0.0.6a Jun 13, 2000: Some updates for TeXpower v0.0.8c.
-%
-% v0.0.6b Jun 23, 2000: Some updates for TeXpower v0.0.8e.
-%
-% v0.0.6c Jul 25, 2000: Some updates for TeXpower v0.0.8g. Colors section rewritten for new color management kernel.
-%
-% v0.0.7 May 15, 2003: Added index and updates for TeXpower v0.0.9d.
-%
-% v0.0.8 July 27, 2004: Added the "Miscellaneous commands" section. Moved the tpslifonts doc into tpslifonts.dtx.
-%
-%-----------------------------------------------------------------------------------------------------------------
-%
-\def\docversion{v0.0.8 of July 27, 2004}
-\def\tpversion{v0.1b of July 27, 2004}
\makeslidetitle
{%
Documentation%
- \thanks{Documentation \docversion\ for \TeX Power \tpversion\ (alpha).}%
+ \thanks{Documentation for \TeX Power \tpversion .}%
}%
The \TeX Power bundle contains style and class files for creating dynamic online presentations with \LaTeX.
@@ -841,9 +766,6 @@ The other, more sophisticated examples demonstrate the expressive power of the
\code{texpower} package. Look at the commented code of these examples to find out how to achieve special effects and
create your own presentation effects with \TeX Power.
-For the first \emph{alpha} release, this documentation will be completed. For the first \emph{beta} release, when the
-code is a little more stable, the \code{texpower} package will be made into a properly documented \code{.dtx} file.
-
\newslide
%-----------------------------------------------------------------------------------------------------------------
@@ -904,11 +826,22 @@ This way, not only `visible' page contents will be duplicated, but also some `in
side effects.
For instance, a \macroname{section} command creates a whatsit for writing the table of contents entry. Duplicating this
-whatsit will also duplicate the toc entry.
+whatsit will also duplicate the toc entry. So, whatsit items effecting file access are inhibited when duplicating page
+material.
\newslide
-So, whatsit items effecting file access are inhibited when duplicating page material.
+The current version of \code{texpower} is a little smarter when handling whatsits. Some commands (related to writing to
+files and hyperlinks) are made stepwise-aware. This means that links can point to the actual subpage where the
+anchor is and not to the last (sub)page of an incremental page. However, if you want the old behaviour just use
+\begin{description}
+\item[\present{option: \code{oldfiltering}}]\indexpckopt{texpower}{oldfiltering} switches on the old
+ (pre 0.2) very aggressive/robust filtering of whatsits.
+\end{description}
+The \code{oldfiltering} can be turned on and off inside the document using \macroname{oldfilteringon/off}. This command is
+useful if \code{texpower} isn't smart enough...
+
+\newslide
A second type of whatsits is created by \TeX's \macroname{special} command which is used for instance for color
management. Some drivers, like \code{dvips} and \code{textures}, use a color stack which is controlled by
@@ -991,6 +924,10 @@ There are some boolean registers provided and set automatically by \code{texpowe
\subsection{Miscellaneous commands}\label{Sec:MiscCmd}
Some important commands that don't fit in the latter sections:
\begin{description}
+\item[\present{\macroname{oldfilteringon}}]\indexmacro{oldfilteringon}
+ reverts to the old (pre v0.2) aggressive/robust filtering of whatsits.
+\item[\present{\macroname{oldfilteringoff}}]\indexmacro{oldfilteringoff}
+ turns on the new better treatment of whatsits.
\item[\present{\commandapp{currentpagevalue}{\carg{value}}}]\indexmacro{currentpagevalue}
sets how to find the number of the current page, \commandapp{value}{page} is default.
Used to name the hyper target on the first subpage of every page. Also used in the
@@ -1003,6 +940,17 @@ Some important commands that don't fit in the latter sections:
\newslide
+\subsection{Page Anchors}\label{Sec:PageAnch}
+
+For each physical page \TeX Power (when in display mode) makes a number of subpages - this is
+the dynamics. For convenience \TeX Power defines an anchor to the first subpage of physical page n,
+\code{firstpage.n}\indexcode{firstpage.n}. The standard page anchor for physical page n,
+\code{page.n}\indexcode{page.n}, points to the last subpage of physical page n. If you want to
+link to any other subpage just insert a \macroname{hyperlink} in the standard way assuming you haven't
+turned on the old filtering (\ref{Sec:Dupl}).
+
+\newslide
+
\subsection{Dependencies on other packages}
\code{textpower} always loads the packages \code{ifthen} and \code{calc}, as the extended command syntax provided by
these is indispensable for the macros to work. They are in the \code{base} and \code{tools} area of the \LaTeX{}
@@ -1043,8 +991,8 @@ The following packages are neccessary for certain features of \code{texpower}:
\subsection{What else is part of the \TeX Power bundle?}
Besides the package \code{texpower} (which is described here), there are four
more packages, \code{tpslifonts}, \code{fixseminar}, \code{automata} and
-\code{tplists}, and one document class,
-\code{powersem}, in the \TeX Power bundle which so far have no documentation
+\code{tplists}, and one document class, \code{powersem}, in the \TeX Power bundle.
+Except for \code{tpslifonts} and \code{tplists} these files have no documentation
of their own. They will be described in this section until they are turned
into \code{dtx} files producing their own documentation.
@@ -1161,7 +1109,7 @@ automata are supported so far.
\minisec{The package \code{tplists}}\indexfile{tplists}{package}
Experimental package providing easy dynamic lists. Currently there are stepped, flipped and dimmed versions of itemize
and enumerate (and corresponding lists from the \code{eqlist} and \code{paralist} package). For more information
-and an example read the start of the file \code{tplists.sty}.
+and an example, compile (and then read) the file \code{tplists.dtx}.
\newslide
@@ -1260,8 +1208,8 @@ and an example read the start of the file \code{tplists.sty}.
\emph{completely} into \carg{contents}, where \macroname{step} can be used freely (see \nameref{Sec:Ex}).
\item As \carg{contents} is read as a macro argument, constructs involving \concept{catcode} changes (like
- \macroname{verb} or language switches) won't work in \carg{contents}. Using a suggestion by \name{Ross
- Moore}, I hope to remedy this until the \emph{alpha} release.
+ \macroname{verb} or language switches) won't work in \carg{contents} \textbf{unless} you use the
+ \code{fragilesteps} environment (\ref{Sec:fragilesteps}).
\newslide
@@ -1285,13 +1233,19 @@ and an example read the start of the file \code{tplists.sty}.
Commands accessing toc files and such (like \macroname{section}) are taken care of by the whatsit suppression
mechanism (compare section \ref{Sec:Dupl}).
+ \end{enumerate}
- Labels and hyperlinks work sort of (giving a lot of warnings though).
+ \newslide
- I will try to remedy remaining problems until the first \emph{alpha} release.
- \end{enumerate}
+ \subsection{\code{fragilesteps} environment}\label{Sec:fragilesteps}%
- \newslide
+ The \code{fragilesteps}\indexcode{fragilesteps} environment is a wrapper around \macroname{stepwise}
+ that makes it possible to use verbatim. The code for this environment is based on similar code from beamer - an
+ excellent presentation class written by Till Tantau - thanks! Using the \code{fragilesteps} environment
+ enables the use of the \code{listings} package to display code line by line. There are some examples in
+ \code{verbexample.tex}.
+
+ \newslide
\subsection{\macroname{boxedsteps} and \macroname{nonboxedsteps}}\label{Sec:boxedsteps}%
By default, \carg{stepcontents} belonging to a \macroname{step} which is not yet `active' are ignored altogether. This
@@ -1338,10 +1292,8 @@ and an example read the start of the file \code{tplists.sty}.
\subsection{Custom versions of \macroname{stepwise}}%
Sometimes, it might happen that vertical spacing is different on every page of a sequence generated by
- \macroname{stepwise}, making lines `wobble'.
-
- This is caused by interactions between different ways vertical spacing is added to the page. Hopefully, problems
- caused this way can be reduced until the first \emph{alpha} release.
+ \macroname{stepwise}, making lines `wobble'. This is usually fixed if you use \macroname{liststepwise} or
+ \macroname{parstepwise} (described below) in stead of \macroname{stepwise}.
\newslide