present 1.0 (13oct10)

git-svn-id: svn://tug.org/texlive/trunk@20080 c570f23f-e606-0410-a88d-b1316a301751

4 files changed, 98 insertions, 55 deletions

diff --git a/Master/texmf-dist/doc/plain/present/HowToTalkTeX.pdf b/Master/texmf-dist/doc/plain/present/HowToTalkTeX.pdf
index ef01feca012..ee95501836a 100644
--- a/Master/texmf-dist/doc/plain/present/HowToTalkTeX.pdf
+++ b/Master/texmf-dist/doc/plain/present/HowToTalkTeX.pdf
diff --git a/Master/texmf-dist/doc/plain/present/HowToTalkTeX.tex b/Master/texmf-dist/doc/plain/present/HowToTalkTeX.tex
index 6012ec92cf1..9714988d578 100644
--- a/Master/texmf-dist/doc/plain/present/HowToTalkTeX.tex
+++ b/Master/texmf-dist/doc/plain/present/HowToTalkTeX.tex
@@ -1,22 +1,28 @@
 %
+%
 % HOW TO DO A TALK IN TeX
 %
 % Author: Matthias Meister
-% Version 1.0, August 2010
+% Version 2.0, October 2010
 %
 % This file is part of a work distributed under the LaTeX Project Public License
 %
 
 \input present % Load presentation specific macros
-
+\setcolour\textcolour
+\setbgcolour\backgroundcolour
+\overfullrule=0pt
+%\WideAspect
 \vskip20mm plus 5mm minus 5mm
 \line{\pagelink{NextPage}{\hfil\titlefont How To Do A Talk In \TeX\hfil}}
 \vskip 5mm plus 2mm minus 1mm
 \line{\hfil\font\subtitlefont=cmssbx10 at 15pt\subtitlefont One Of Many Solutions\hfil}
-\vskip 30mm plus 2mm minus 1mm
+\vskip 5mm plus 2mm minus 1mm
+\line{\hfil\linkbarfont Version 2.0\hfil}
+\vskip 20mm plus 2mm minus 1mm
 \line{\hfil\normalfont Matthias Meister\hfil}\target{title}
 \vskip 5mm plus 2mm minus 1mm
-\line{\hfil\normalfont Regensburg, August 2010\hfil}
+\line{\hfil\normalfont Regensburg, October 2010\hfil}
 \NewSlide
 \pageno=1% Don't want to count the titlepage
 \normalfont
@@ -28,31 +34,28 @@
 \SlideFoot 	% "Activates" the footline, titlepage had an empty footline
 \vglue7mm
 \leftskip5mm
-\item{$\bullet$}\textcolor{text}{Make it possible to prepare presentations in \TeX}
+\item{$\bullet$}Make it possible to prepare presentations in \TeX
 \vskip3mm
-\item{$\bullet$}\textcolor{text}{Without having to learn lots of extra syntax}
+\item{$\bullet$}Without having to learn lots of extra syntax
 \vskip3mm
-\item{$\bullet$}\textcolor{text}{By using simple macros that can easily be adapted to one's needs, maybe for each presentation prepared}
+\item{$\bullet$}By using simple macros that can easily be adapted to one's needs, maybe for each presentation prepared
 \vskip3mm
-\item{$\bullet$}\textcolor{text}{Without restricting the possibilities that \TeX\ offers}
+\item{$\bullet$}Without restricting the possibilities that \TeX\ offers
 \NewSlide
 \SlideTitle{\hfil Requirements}
-\definecolor{code}{rgb}{0.8,0.0,0.8}
 \font\cdfo=cmtt12
-\def\cf{\color{code}\cdfo}
-\item{+} {\cf miniltx.tex}
-\item{+} {\cf color.tex}
-\item{+} {\cf color.sty}
-
-\leftskip=0pt
-\vskip3mm
-These files are available from \weblink{www.ctan.org}{www.ctan.org}. You might already have (some of) them.
-\vskip3mm
+\def\codecolour{0 0.0 1.0}
+\def\cf{\setcolour\codecolour\cdfo}
 You need the program {\cf pdftex}, which probably is included in your \TeX-distribution.
 \vskip3mm
-You also need a pdf-viewer with fullscreen display capabilities, e.g. {\cf xpdf}.
+You need the file {\cf present.tex}, which is to be {\cf\char'134input} at the beginning of your source code.
+\vskip3mm
+You furthermore need a pdf-viewer with fullscreen display capabilities, e.g. {\cf xpdf}.
+\vskip5pt
+\att{Warning: Some pdf-viewers do not handle links in a document properly.}
 \vskip5pt
-\att{Some pdf-viewers do not handle links in a document properly.}
+Version 2.0 does no longer require the 
+files {\cf miniltx.tex}, {\cf color.tex}, {\cf color.sty}.
 %%
 %%
 %%
@@ -99,13 +102,14 @@ pdf-file with {\cf pdftex}, for viewing it with a pdf-viewer.
 \SlideTitle{\hfil Fonts}
 {\cf present.tex} defines the following fonts:\vskip5pt
 {\openup2pt
-\halign{#\hfil\kern10pt&#\hfil\kern10pt&#\hfil\cr
+\halign{#\hfil\kern5pt&#\hfil\kern5pt&#\hfil\cr
 Font Command & Purpose & Default Value\cr
 {\cf\char'134 titlefont} & presentation title & {\cf cmssbx10 at 20pt}\cr
 {\cf\char'134 slidetitlefont} & title of a slide & {\cf cmssbx10}\cr
 {\cf\char'134 normalfont} & ordinary text & {\cf cmss12}\cr
 {\cf\char'134 linkbarfont} & text in {\cf\char'134 LinkBar} & {\cf cmss8}\cr
 {\cf\char'134 it} & italic text & {\cf cmti12}\cr
+{\cf\char'134 rm} & roman text in math & {\cf cmr}\cr
 }}
 \vskip10pt
 Of course you can define further font commands or redefine the existing ones.
@@ -115,47 +119,54 @@ The default fonts are used in this presentation, so you see what they look like.
 %%%
 %%%
 \SlideTitle{\hfil Colours}
-Colour effects are handled by the {\cf color.sty}-package included via {\cf color.tex}.
-
-The following colours are
-defined in {\cf present.tex}:
+Colours are defined as control sequences, e.g.
 \vskip5pt
-{\cf background}, for the slide background 
+{\cf\char'134def\char'134mycolour\char'173}{\it R G B\/}{\cf\char'175}
 \vskip5pt
-{\cf text}, for the text, and
+where {\it R G B} are the red, green, and blue values of the colour defined, with
+$0\leq R, G, B\leq 1$.
 \vskip5pt
-{\cf attention}, an \att{attention} colour.
+Colours are used in these ways:
 \vskip5pt
-Colour names can be defined and redefined by
+{\cf\char'134setcolour\char'134mycolour} 
+
+to set the colour of following text , grouping is respected
 \vskip5pt
-{\cf\char'134 definecolor\char'173}{\it NAME\/}{\cf\char'175\char'173 rgb\char'175\char'173}{\it R,G,B\/}%
-{\cf\char'175}
+{\cf\char'134coloured\char'134mycolour\char'173}{\it Stuff\/}{\cf\char'175} 
+
+to set {\it Stuff} in colour {\cf\char'134mycolour}
 \vskip5pt
-where {\it NAME} is a colour name to be defined, like {\cf background} or {\cf mycolour}, and {\it R}, 
-{\it G}, and {\it B} are
-the red, green, and blue values describing the colour; $0\leq\hbox{ {\it R}, {\it G}, {\it B} }\leq 1$.
+{\cf\char'134setbgcolour\char'134mycolour}
+
+to set the colour of the background
 \NewSlide
 %%%
 %%%
 %%%
-Once defined, the colours are employed as follows:
-\vskip3pt
-{\cf\char'134 pagecolor\char'173 background\char'175} sets the colour of the slide background to {\cf background}.
-\vskip3pt
-{\cf\char'134 color\char'173 text\char'175} sets the colour of subsequent text to {\cf text}.
-\vskip3pt
-{\cf\char'134 textcolor\char'173 text\char'175\char'173}{\it Stuff\/}{\cf\char'175} prints {\it Stuff} 
-in colour {\cf text}.
+The following colours are
+defined in {\cf present.tex}:
+\vskip5pt
+{\cf \char'134backgroundcolour}, for the slide background 
+\vskip5pt
+{\cf \char'134textcolour}, for the text, and
+\vskip5pt
+{\cf \char'134attentioncolour}, an \att{attention} colour. 
+
+You draw attention to \att{Stuff} by saying
+{\cf\char'134att\char'173}{\it Stuff\/}{\cf\char'175}.
+\vskip5pt
+If a predefined colour is redefined, {\cf\char'134setcolour}
+must also be used for the change to take effect for text. 
 \vskip5pt
-The colour {\cf attention} is mainly used in the macro {\cf\char'134 att}, which prints 
-\att{Stuff} in attention colour by saying
-{\cf\char'134 att\char'173}{\it Stuff\/}{\cf \char'175}.
+Colour handling is different from version 1.0 of {\cf present.tex}.
+The additional files {\cf miniltx.tex}, {\cf color.tex}, {\cf color.sty} are \att{no longer} required.
 \NewSlide
 %%%
 %%%
 %%%
 \SlideTitle{\hfil Paper Size}
-The paper size is determined by the parameters {\cf\char'134 pdfpagewidth} and
+The paper size is determined by the dimensions 
+\vskip3pt {\cf\char'134 pdfpagewidth} and
 {\cf\char'134 pdfpageheight}. 
 \vskip10pt
 If you say {\cf\char'134 StandardAspect}, you get a page 120mm wide and 90mm high.
@@ -165,7 +176,7 @@ If you say {\cf\char'134 WideAspect}, you get a page 144mm wide and 90mm high.
 %%%
 %%%
 %%%
-\SlideTitle{\hfil Images}
+\SlideTitle{\vbox to 0pt{\kern-5mm\image[width10mm]{Stern.png}\vss}\hfil Images}
 Images can be included with
 \vskip5pt
 {\cf\char'134 image[}{\it dimensions}{\cf]\char'173}{\it filename}{\cf\char'175}
@@ -191,7 +202,6 @@ E.g. pdf, png, jpg should work.
 %%%
 %%%
 %%%
-\pagecolor{background}
 \SlideTitle{\hfil Slide Structure}
 Each slide has a headline, a body, and a footline.
 \vskip5pt
@@ -264,7 +274,7 @@ if a slide is to be shown incrementally.}
 the presentation where it is used.
 \vskip5pt
 {\cf\char'134 link\char'173}{\it NAME\/}{\cf\char'175\char'173}{\it Stuff\/}{\cf\char'175}
-makes {\it Stuff} a link to the target named {\it NAME}.
+turns {\it Stuff} into a link to the target named {\it NAME}.
 \vskip5pt
 {\cf\char'134 weblink\char'173}{\it URI\/}{\cf\char'175\char'173}{\it Stuff\/}{\cf\char'175}
 makes {\it Stuff} a link to the specified {\it URI}.
@@ -285,10 +295,10 @@ A further possibility can be found \link{Further}{here (click)}.
 %%%
 %%%
 {\cf\char'134 linkarea\char'173}{\it dest}{\cf\char'175\char'173}{\it rect}{\cf\char'175\char'173}{\it border}{\cf
-\char'175\char'173}{\it color}{\cf\char'175}\target{Further}
+\char'175\char'173}{\it colour}{\cf\char'175}\target{Further}
 \vskip5pt
 Creates a rectangular area which is a link to target {\it dest}; {\it rect} consists of 
-four space-separated numbers for lower left and upper right corner, {\it border} is the border width, and {\it color} is the 
+four space-separated numbers for lower left and upper right corner, {\it border} is the border width, and {\it colour} is the 
 border colour, specified as three space-separated values for red, green, and blue, all between 0 and 1.
 \vskip5pt
 \linkarea{title}{150 30 180 60}{2}{0.8 0 0}
@@ -300,9 +310,28 @@ Notice also that {\cf\char'134 LinkBar} has been redefined (on the previous slid
 %%%
 %%%
 %%%
+\SlideTitle{\hfil Background Images}
+\SetBackground{background.png}
+You can set images for the background with 
+\vskip5pt
+{\cf\char'134 SetBackground\char'173}{\it filename}{\cf\char'175}
+\vskip5pt
+where
+{\it filename} is the name of the image file.
+\vskip5pt
+The background image is unset (i.e. the background colour  will show again) with {\cf\char'134 UnsetBackground}.
+\vskip5pt
+The background image is scaled to width and height of the slide. It should have an appropriate aspect ratio.
+\vskip5pt
+\att{As you see some combinations of text colour and background image can cause visibility problems.}
+\NewSlide
+\UnsetBackground
+%%%
+%%%
+%%%
 \SlideTitle{\hfil Concluding Remarks}
 PDF provides the possibility to include movies, and to launch applications (which could be a movie player) via clickable
-elements. The usability for a presentation depends on how to manage the player together with a full-screen display of the
+elements. The usability for a presentation depends on how to manage the player together with a fullscreen display of the
 slides. Movie support is not officially included in {\cf present.tex}.
 \vskip5pt
 If you prepare a pdf-image for a presentation which is to be shown on some different computer, it would be best to
diff --git a/Master/texmf-dist/doc/plain/present/README b/Master/texmf-dist/doc/plain/present/README
index 62e6f654ae3..b57fce78260 100644
--- a/Master/texmf-dist/doc/plain/present/README
+++ b/Master/texmf-dist/doc/plain/present/README
@@ -1,5 +1,5 @@
 present.tex
-Version 1.0, August 2010
+Version 2.0, October 2010
 
 Some simple macros for preparing presentations in TeX
 Copyright 2010 Matthias Meister
@@ -15,14 +15,15 @@ HowToTalkTeX.tex
 is the corresponding source; together with the pdf it 
 is an example of how the macros are used to prepare a talk.
 
-Required: miniltx.tex, color.tex, color.sty, pdftex
+Required: pdftex
 
 The macros in present.tex allow the user to:
 +) set a colour for the background and for the text
-+) include images
++) set background images
 +) include links between parts of the presentation
 +) include weblinks
 +) include links to local files
++) include images
 
 The macros as such are simple enough so that users should
 not find it difficult to adapt them to their needs. 
@@ -30,3 +31,16 @@ not find it difficult to adapt them to their needs.
 A documentation for pdftex and the PDF-Reference might 
 occasionally be useful in the context of those macros 
 which have PDF-code in their replacement text.
+
+-----------------------
+
+Changes with respect to version 1.0:
+
+*) An image can be set on the slide background.
+*) Added control word \rm for using roman type 
+   at correct size within math.
+*) Rewritten colour support; miniltx.tex, color.tex, 
+   color.sty no longer required. As a result, control
+   sequences for handling colour have changed.
+
+ 
diff --git a/Master/texmf-dist/doc/plain/present/background.png b/Master/texmf-dist/doc/plain/present/background.png
new file mode 100644
index 00000000000..d78f8b107c3
--- /dev/null
+++ b/Master/texmf-dist/doc/plain/present/background.png