# texlive[46095] Master: beamer (18dec17)

commits+karl at tug.org commits+karl at tug.org
Tue Dec 19 01:09:02 CET 2017

Revision: 46095
http://tug.org/svn/texlive?view=revision&revision=46095
Author:   karl
Date:     2017-12-19 01:09:01 +0100 (Tue, 19 Dec 2017)
Log Message:
-----------
beamer (18dec17)

Modified Paths:
--------------
trunk/Master/texmf-dist/tex/latex/beamer/beamer.cls
trunk/Master/texmf-dist/tex/latex/beamer/beamerarticle.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerbasecolor.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerbasecompatibility.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerbasemisc.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerbasesection.sty
trunk/Master/tlpkg/libexec/ctan2tds

-----------
trunk/Master/texmf-dist/doc/latex/beamer/beamercolorthemeexample.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-conference-talk.pdf
trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-conference-talk.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-foils.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-beamer-version.pdf
trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-beamer-version.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-body.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-logo.pdf
trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic1.jpg
trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic2.jpg
trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic3.jpg
trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic4.jpg
trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic5.jpg
trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic6.jpg
trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-print-version.pdf
trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-print-version.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-style.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-prosper.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-seminar.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-texpower.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerfontthemeexample.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerinnerthemeexample.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerlogo.pdf
trunk/Master/texmf-dist/doc/latex/beamer/beamerouterthemeexample.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerthemeexample.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerthemeexamplebase.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-animations.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-color.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-compatibility.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-elements.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-emulation.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-fonts.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-frames.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-globalstructure.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-graphics.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-guidelines.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-installation.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-interaction.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-introduction.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-localstructure.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-macros.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-nonpresentation.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-notes.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-overlays.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-solutions.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-themes.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-transparencies.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-tricks.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-tutorial.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-twoscreens.tex
trunk/Master/texmf-dist/doc/latex/beamer/beamerug-workflow.tex
trunk/Master/texmf-dist/doc/latex/beamer/beameruserguide.pdf
trunk/Master/texmf-dist/doc/latex/beamer/beameruserguide.tex
trunk/Master/texmf-dist/doc/latex/beamer/conference-ornate-20min.de.tex
trunk/Master/texmf-dist/doc/latex/beamer/conference-ornate-20min.en.tex
trunk/Master/texmf-dist/doc/latex/beamer/conference-ornate-20min.fr.tex
trunk/Master/texmf-dist/doc/latex/beamer/fdl.txt
trunk/Master/texmf-dist/doc/latex/beamer/generic-ornate-15min-45min.de.tex
trunk/Master/texmf-dist/doc/latex/beamer/generic-ornate-15min-45min.en.tex
trunk/Master/texmf-dist/doc/latex/beamer/generic-ornate-15min-45min.fr.tex
trunk/Master/texmf-dist/doc/latex/beamer/gpl-2.0.txt
trunk/Master/texmf-dist/doc/latex/beamer/lppl-1-3c.txt
trunk/Master/texmf-dist/doc/latex/beamer/manifest-code.txt
trunk/Master/texmf-dist/doc/latex/beamer/manifest-documentation.txt
trunk/Master/texmf-dist/doc/latex/beamer/speaker_introduction-ornate-2min.de.tex
trunk/Master/texmf-dist/doc/latex/beamer/speaker_introduction-ornate-2min.en.tex
trunk/Master/texmf-dist/doc/latex/beamer/speaker_introduction-ornate-2min.fr.tex
trunk/Master/texmf-dist/tex/latex/beamer/beamercolorthemealbatross.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamercolorthemebeaver.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamercolorthemebeetle.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamercolorthemecrane.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamercolorthemedefault.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamercolorthemedolphin.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamercolorthemedove.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamercolorthemefly.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamercolorthemelily.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamercolorthememonarca.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamercolorthemeorchid.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamercolorthemerose.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamercolorthemeseagull.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamercolorthemeseahorse.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamercolorthemesidebartab.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamercolorthemespruce.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamercolorthemestructure.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamercolorthemewhale.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamercolorthemewolverine.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerfoils.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerfontthemedefault.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerfontthemeprofessionalfonts.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerfontthemeserif.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerfontthemestructurebold.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerfontthemestructureitalicserif.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerfontthemestructuresmallcapsserif.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamericonarticle.20.eps
trunk/Master/texmf-dist/tex/latex/beamer/beamericonarticle.20.pdf
trunk/Master/texmf-dist/tex/latex/beamer/beamericonarticle.eps
trunk/Master/texmf-dist/tex/latex/beamer/beamericonarticle.pdf
trunk/Master/texmf-dist/tex/latex/beamer/beamericonarticle.tex
trunk/Master/texmf-dist/tex/latex/beamer/beamericonbook.20.eps
trunk/Master/texmf-dist/tex/latex/beamer/beamericonbook.20.pdf
trunk/Master/texmf-dist/tex/latex/beamer/beamericonbook.eps
trunk/Master/texmf-dist/tex/latex/beamer/beamericonbook.pdf
trunk/Master/texmf-dist/tex/latex/beamer/beamericonbook.tex
trunk/Master/texmf-dist/tex/latex/beamer/beamericononline.20.eps
trunk/Master/texmf-dist/tex/latex/beamer/beamericononline.20.pdf
trunk/Master/texmf-dist/tex/latex/beamer/beamericononline.eps
trunk/Master/texmf-dist/tex/latex/beamer/beamericononline.pdf
trunk/Master/texmf-dist/tex/latex/beamer/beamerinnerthemecircles.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerinnerthemedefault.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerinnerthemeinmargin.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerinnerthemerectangles.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerinnerthemerounded.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerouterthemedefault.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerouterthemeinfolines.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerouterthememiniframes.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerouterthemesidebar.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerouterthemesmoothbars.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerouterthemesmoothtree.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerouterthemesplit.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerouterthemetree.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerpatchparalist.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerprosper.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerseminar.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamertexpower.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeAnnArbor.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeAntibes.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeBergen.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeBerkeley.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeBerlin.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeCambridgeUS.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeCopenhagen.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeDresden.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeEastLansing.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeFrankfurt.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeGoettingen.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeHannover.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeIlmenau.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeJuanLesPins.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeLuebeck.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeMalmoe.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeMarburg.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeMontpellier.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemePaloAlto.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemePittsburgh.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeRochester.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeSingapore.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeSzeged.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeWarsaw.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemebars.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeboxes.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeclassic.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemecompatibility.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemedefault.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemelined.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemeplain.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemesidebar.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemesplit.sty
trunk/Master/texmf-dist/tex/latex/beamer/beamerthemetree.sty
trunk/Master/texmf-dist/tex/latex/beamer/multimedia.sty
trunk/Master/texmf-dist/tex/latex/beamer/multimediasymbols.sty
trunk/Master/texmf-dist/tex/latex/beamer/xmpmulti.sty

Removed Paths:
-------------
trunk/Master/texmf-dist/doc/latex/beamer/doc/Makefile
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamercolorthemeexample.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerfontthemeexample.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerinnerthemeexample.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerlogo.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerouterthemeexample.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerthemeexample.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerthemeexamplebase.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-animations.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-color.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-compatibility.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-elements.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-emulation.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-fonts.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-frames.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-globalstructure.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-graphics.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-guidelines.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-installation.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-interaction.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-introduction.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-localstructure.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-macros.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-nonpresentation.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-notes.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-overlays.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-solutions.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-themes.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-transparencies.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-tricks.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-tutorial.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-twoscreens.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-workflow.tex
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugcolorthemealbatross.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugcolorthemealbatrossstylish.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugcolorthemebeaver.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugcolorthemebeetle.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugcolorthemecrane.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugcolorthemedefault.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugcolorthemedolphin.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugcolorthemedove.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugcolorthemefly.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugcolorthemelily.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugcolorthememonarca.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugcolorthemeorchid.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugcolorthemerose.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugcolorthemeseagull.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugcolorthemeseahorse.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugcolorthemesidebartab.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugcolorthemespruce.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugcolorthemestructure.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugcolorthemewhale.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugcolorthemewolverine.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugfontthemedefault.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugfontthemeserif.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugfontthemestructurebold.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugfontthemestructureitalicserif.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugfontthemestructuresmallcapsserif.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beameruginnerthemecircles.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beameruginnerthemedefault.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beameruginnerthemeinmargin.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beameruginnerthemerectangles.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beameruginnerthemerounded.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugouterthemedefault.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugouterthemeinfolines.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugouterthememiniframes.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugouterthemesidebar.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugouterthemesmoothbars.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugouterthemesmoothtree.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugouterthemesplit.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugouterthemetree.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemeAnnArbor.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemeAntibes.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemeBergen.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemeBerkeley.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemeBerlin.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemeCambridgeUS.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemeCopenhagen.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemeDresden.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemeEastLansing.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemeFrankfurt.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemeGoettingen.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemeHannover.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemeIlmenau.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemeJuanLesPins.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemeLuebeck.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemeMalmoe.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemeMarburg.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemeMontpellier.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemePaloAlto.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemePittsburgh.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemeRochester.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemeSingapore.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemeSzeged.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemeWarsaw.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemeboxes.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerugthemedefault.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beameruserguide.pdf
trunk/Master/texmf-dist/doc/latex/beamer/doc/beameruserguide.tex
trunk/Master/texmf-dist/doc/latex/beamer/examples/Makefile
trunk/Master/texmf-dist/doc/latex/beamer/examples/a-conference-talk/
trunk/Master/texmf-dist/doc/latex/beamer/examples/a-lecture/
trunk/Master/texmf-dist/doc/latex/beamer/examples/beamerexample-conference-talk.pdf
trunk/Master/texmf-dist/doc/latex/beamer/examples/beamerexample-lecture-print-version.pdf
trunk/Master/texmf-dist/doc/latex/beamer/solutions/conference-talks/
trunk/Master/texmf-dist/doc/latex/beamer/solutions/generic-talks/
trunk/Master/texmf-dist/doc/latex/beamer/solutions/short-talks/
trunk/Master/texmf-dist/tex/latex/beamer/art/
trunk/Master/texmf-dist/tex/latex/beamer/emulation/beamerfoils.sty
trunk/Master/texmf-dist/tex/latex/beamer/emulation/beamerprosper.sty
trunk/Master/texmf-dist/tex/latex/beamer/emulation/beamerseminar.sty
trunk/Master/texmf-dist/tex/latex/beamer/emulation/beamertexpower.sty
trunk/Master/texmf-dist/tex/latex/beamer/emulation/examples/
trunk/Master/texmf-dist/tex/latex/beamer/multimedia/
trunk/Master/texmf-dist/tex/latex/beamer/themes/color/
trunk/Master/texmf-dist/tex/latex/beamer/themes/font/
trunk/Master/texmf-dist/tex/latex/beamer/themes/inner/
trunk/Master/texmf-dist/tex/latex/beamer/themes/outer/
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemeAnnArbor.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemeAntibes.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemeBergen.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemeBerkeley.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemeBerlin.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemeCambridgeUS.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemeCopenhagen.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemeDresden.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemeEastLansing.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemeFrankfurt.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemeGoettingen.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemeHannover.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemeIlmenau.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemeJuanLesPins.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemeLuebeck.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemeMalmoe.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemeMarburg.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemeMontpellier.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemePaloAlto.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemePittsburgh.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemeRochester.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemeSingapore.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemeSzeged.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemeWarsaw.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemeboxes.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/beamerthemedefault.sty
trunk/Master/texmf-dist/tex/latex/beamer/themes/theme/compatibility/

===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamercolorthemeexample.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamercolorthemeexample.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,63 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\documentclass[hyperref={draft}]{beamer}
+
+\ifx\themename\undefined
+  \def\themename{default}
+\fi
+
+\useoutertheme[height=0pt]{sidebar}
+
+\def\albatrossname{albatross}
+\def\flyname{fly}
+\def\beetlename{beetle}
+\def\structurename{structure}
+
+\def\albatrossnamestylish{albatrossstylish}
+
+\ifx\themename\structurename
+  \usecolortheme[cmyk={0.69,0,0.50,0}]{\themename}
+\else
+  \ifx\themename\albatrossnamestylish
+    \usecolortheme[overlystylish]{albatross}
+    \usecolortheme{lily}
+  \else
+    \usecolortheme{\themename}
+  \fi
+\fi
+
+\ifx\themename\albatrossname
+  \makeatletter
+  \let\beamertemplatesolidbackgroundcolor=\@gobble
+  \makeatother
+\fi
+
+\ifx\themename\albatrossnamestylish
+  \makeatletter
+  \let\beamertemplatesolidbackgroundcolor=\@gobble
+  \makeatother
+\fi
+
+\ifx\themename\flyname
+  \makeatletter
+  \let\beamertemplatesolidbackgroundcolor=\@gobble
+  \makeatother
+\fi
+
+\ifx\themename\beetlename
+  \makeatletter
+  \let\beamertemplatesolidbackgroundcolor=\@gobble
+  \makeatother
+\fi
+
+
+\input{beamerthemeexamplebase}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamercolorthemeexample.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
(Binary files differ)

Index: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-conference-talk.pdf
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-conference-talk.pdf	2017-12-19 00:07:03 UTC (rev 46094)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-conference-talk.pdf	2017-12-19 00:09:01 UTC (rev 46095)

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-conference-talk.pdf
___________________________________________________________________
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-conference-talk.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-conference-talk.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,744 @@
+% Copyright 2007 by Till Tantau
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Public License.
+%
+
+
+
+\documentclass{beamer}
+
+%
+% DO NOT USE THIS FILE AS A TEMPLATE FOR YOUR OWN TALKS\xA1!!
+%
+% Use a file in the directory solutions instead.
+% They are much better suited.
+%
+
+
+% Setup appearance:
+
+\usefonttheme[onlylarge]{structurebold}
+\setbeamerfont*{frametitle}{size=\normalsize,series=\bfseries}
+
+
+% Standard packages
+
+\usepackage[english]{babel}
+\usepackage[latin1]{inputenc}
+\usepackage{times}
+\usepackage[T1]{fontenc}
+
+
+% Setup TikZ
+
+\usepackage{tikz}
+\usetikzlibrary{arrows}
+\tikzstyle{block}=[draw opacity=0.7,line width=1.4cm]
+
+
+% Author, Title, etc.
+
+\title[Block Partitioning and Perfect Phylogenies]
+{%
+  On the Complexity of SNP Block Partitioning Under the Perfect
+  Phylogeny Model%
+}
+
+\author[Gramm, Hartman, Nierhoff, Sharan, Tantau]
+{
+  Jens~Gramm\inst{1} \and
+  Tzvika~Hartman\inst{2} \and
+  Till~Nierhoff\inst{3} \and
+  Roded~Sharan\inst{4} \and
+  \textcolor{green!50!black}{Till~Tantau}\inst{5}
+}
+
+\institute[T\xFCbingen and others]
+{
+  \inst{1}%
+  Universit\xE4t T\xFCbingen, Germany
+  \and
+  \vskip-2mm
+  \inst{2}%
+  Bar-Ilan University, Ramat-Gan, Israel
+  \and
+  \vskip-2mm
+  \inst{3}%
+  International Computer Science Institute, Berkeley, USA
+  \and
+  \vskip-2mm
+  \inst{4}%
+  Tel-Aviv University, Israel
+  \and
+  \vskip-2mm
+  \inst{5}%
+  Universit\xE4t zu L\xFCbeck, Germany
+}
+
+\date[WABI 2006]
+{Workshop on Algorithms in Bioinformatics, 2006}
+
+
+
+% The main document
+
+\begin{document}
+
+\begin{frame}
+  \titlepage
+\end{frame}
+
+\begin{frame}{Outline}
+  \tableofcontents
+\end{frame}
+
+
+\section{Introduction}
+
+\subsection{The Model and the Problem}
+
+\begin{frame}{What is haplotyping and why is it important?}
+  You hopefully know this after the previous three talks\dots
+\end{frame}
+
+\begin{frame}[t]{General formalization of haplotyping.}
+  \begin{block}{Inputs}
+    \begin{itemize}
+    \item A \alert{genotype matrix} $G$.
+        characters}.
+    \end{itemize}
+  \end{block}
+  \begin{block}{Outputs}
+    \begin{itemize}
+    \item A \alert{haplotype matrix} $H$.
+    \item Pairs of rows in $H$ \alert{explain} the rows of $G$.
+    \item The haplotypes in $H$ are \alert{biologically plausible}.
+    \end{itemize}
+  \end{block}
+\end{frame}
+
+
+\begin{frame}[t]{Our formalization of haplotyping.}
+  \begin{block}{Inputs}
+    \begin{itemize}
+    \item A genotype matrix $G$.
+    \item The rows of the matrix are individuals / taxa.
+    \item The columns of the matrix are SNP sites / characters.
+      The problem is directed: one haplotype is known.
+      The input is biallelic: there are only two homozygous
+      states (0 and 1) and one heterozygous state (2).
+    \end{itemize}
+  \end{block}
+  \begin{block}{Outputs}
+    \begin{itemize}
+    \item A haplotype matrix $H$.
+    \item Pairs of rows in $H$ explain the rows of $G$.
+    \item<alert at 1> The haplotypes in $H$ form a perfect phylogeny.
+    \end{itemize}
+  \end{block}
+\end{frame}
+
+
+\begin{frame}{We can do perfect phylogeny haplotyping efficiently, but
+    \dots}
+  \begin{enumerate}
+  \item \alert{Data may be missing.}
+    \begin{itemize}
+    \item This makes the problem NP-complete \dots
+    \item \dots even for very restricted cases.
+    \end{itemize}
+    \textcolor{green!50!black}{Solutions:}
+    \begin{itemize}
+    \item Additional assumption like the rich data hypothesis.
+    \end{itemize}
+  \item \alert{No perfect phylogeny is possible.}
+    \begin{itemize}
+    \item This can be caused by chromosomal crossing-over effects.
+    \item This can be caused by incorrect data.
+    \item This can be caused by multiple mutations at the same sites.
+    \end{itemize}
+    \textcolor{green!50!black}{Solutions:}
+    \begin{itemize}
+    \item Look for phylogenetic networks.
+    \item Correct data.
+       Find blocks where a perfect phylogeny is possible.
+    \end{itemize}
+  \end{enumerate}
+\end{frame}
+
+
+\subsection{The Integrated Approach}
+
+\begin{frame}{How blocks help in perfect phylogeny haplotyping.}
+  \begin{enumerate}
+  \item Partition the site set into overlapping contiguous blocks.
+  \item Compute a perfect phylogeny for each block and combine them.
+  \item Use dynamic programming for finding the partition.
+  \end{enumerate}
+
+  \begin{tikzpicture}
+    \useasboundingbox (0,-1) rectangle (10,2);
+
+    \draw[line width=2mm,dash pattern=on 1mm off 1mm]
+      (0,1) -- (9.99,1) node[midway,above] {Genotype matrix}
+      (0,0.6666) -- (9.99,0.6666)
+      (0,0.3333) -- (9.99,0.3333)
+      (0,0) -- (9.99,0) node[midway,below] {\only<1>{no perfect phylogeny}};
+
+    \begin{scope}[xshift=-.5mm]
+      \only<2->
+      {
+        \draw[red,block]            (0,.5)   -- (3,.5)
+          node[midway,below] {perfect phylogeny};
+      }
+
+      \only<3->
+      {
+        \draw[green!50!black,block] (2.5,.5)   -- (7,.5)
+          node[pos=0.6,below] {perfect phylogeny};
+      }
+
+      \only<4->
+      {
+        \draw[blue,block]           (6.5,.5) -- (10,.5)
+          node[pos=0.6,below] {perfect phylogeny};
+      }
+    \end{scope}
+  \end{tikzpicture}
+\end{frame}
+
+\begin{frame}{Objective of the integrated approach.}
+  \begin{enumerate}
+  \item Partition the site set into \alert{noncontiguous} blocks.
+  \item Compute a perfect phylogeny for each block and combine them.
+  \item<alert at 1-> Compute partition while computing perfect
+    phylogenies.
+  \end{enumerate}
+
+  \begin{tikzpicture}
+    \useasboundingbox (0,-1) rectangle (10,2);
+
+    \draw[line width=2mm,dash pattern=on 1mm off 1mm]
+      (0,1) -- (9.99,1) node[midway,above] {Genotype matrix}
+      (0,0.6666) -- (9.99,0.6666)
+      (0,0.3333) -- (9.99,0.3333)
+      (0,0) -- (9.99,0) node[midway,below] {\only<1>{no perfect phylogeny}};
+
+    \only<2->
+    {
+      \begin{scope}[xshift=-0.5mm]
+        \draw[red,block] (0,.5)   -- (3,.5)
+          node[midway,below] {perfect phylogeny}
+                         (8,.5) -- (9,.5);
+
+        \draw[green!50!black,block]
+          (3,.5)   -- (6,.5)
+            node[pos=0.6,below] {perfect phylogeny}
+          (6.4,.5)   -- (8,.5)
+          (9,.5) -- (10,.5);
+
+        \draw[blue,block] (6,.5) -- (6.4,.5)
+          node[midway,below=5mm] {perfect phylogeny};
+      \end{scope}
+    }
+  \end{tikzpicture}
+\end{frame}
+
+
+\begin{frame}{The formal computational problem.}
+  We are interested in the computational complexity of \\
+  \alert{the function \alert{$\chi_{\operatorname{PP}}$}}:
+  \begin{itemize}
+  \item It gets genotype matrices as input.
+  \item It maps them to a number $k$.
+  \item This number is minimal such that the sites can be
+    covered by $k$ sets, each admitting a perfect phylogeny.
+    \\
+    (We call this a \alert{pp-partition}.)
+  \end{itemize}
+\end{frame}
+
+
+
+\subsection{Hardness of PP-Partitioning of Haplotype Matrices}
+
+\begin{frame}{Finding pp-partitions of haplotype matrices.}
+  \begin{itemize}
+  \item The inputs $M$ are \alert{already haplotype matrices}.
+  \item The inputs $M$ \alert{do not allow a perfect phylogeny}.
+  \item What is $\chi_{\operatorname{PP}}(M)$?
+  \end{itemize}
+  \begin{example}
+    \begin{columns}
+      \column{.3\textwidth}
+      $M\colon$
+      \footnotesize
+      \begin{tabular}{cccc}
+        0 & 0 & 0 & 1 \\
+        0 & 1 & 0 & 0 \\
+        1 & 0 & 0 & 0 \\
+        0 & 1 & 0 & 0 \\
+        1 & 0 & 0 & 0 \\
+        0 & 1 & 0 & 1 \\
+        1 & 1 & 0 & 0 \\
+        0 & 0 & 1 & 0 \\
+        1 & 0 & 1 & 0
+      \end{tabular}%
+      \only<2>
+      {%
+        \begin{tikzpicture}
+          \useasboundingbox (2.9,0);
+
+          \draw [red, opacity=0.7,line width=1cm] (1.7 ,1.9) -- (1.7 ,-1.7);
+          \draw [blue,opacity=0.7,line width=5mm] (0.85,1.9) -- (0.85,-1.7)
+                                                  (2.55,1.9) -- (2.55,-1.7);
+        \end{tikzpicture}
+      }
+      \column{.6\textwidth}
+      \begin{overprint}
+        \onslide<1>
+        No perfect phylogeny is possible.
+
+        \onslide<2>
+        \textcolor{blue!70!bg}{Perfect phylogeny}
+
+        \textcolor{red!70!bg}{Perfect phylogeny}
+
+        $\chi_{\operatorname{PP}}(M) = 2$.
+
+      \end{overprint}
+    \end{columns}
+  \end{example}
+\end{frame}
+
+  \begin{theorem}
+    Finding \alert{optimal pp-partition of haplotype matrices}\\
+    is equivalent to finding \alert{optimal graph colorings}.
+  \end{theorem}
+
+  \begin{proof}[Proof sketch for first direction]
+    \begin{enumerate}
+    \item Let $G$ be a graph.
+    \item Build a matrix with a column for each vertex of $G$.
+    \item For each edge of $G$ add four rows inducing\\the
+      submatrix $\left( + \begin{smallmatrix} + 0 & 0 \\ + 0 & 1 \\ + 1 & 0 \\ + 1 & 1 + \end{smallmatrix}\right)$.
+    \item The submatrix enforces that the columns lie in different
+      perfect phylogenies. \qedhere
+    \end{enumerate}
+  \end{proof}
+\end{frame}
+
+\begin{frame}{Implications for pp-partitions of haplotype matrices.}
+  \begin{corollary}
+    If $\chi_{\operatorname{PP}}(M) = 2$ for a haplotype matrix $M$,
+    we can find an optimal pp-partition in polynomial time.
+  \end{corollary}
+
+  \begin{corollary}
+    Computing $\chi_{\operatorname{PP}}$ for haplotype matrices is
+    \begin{itemize}
+    \item $\operatorname{NP}$-hard,
+    \item not fixed-parameter tractable, unless
+      $\operatorname{P}=\operatorname{NP}$,
+    \item very hard to approximate.
+    \end{itemize}
+  \end{corollary}
+\end{frame}
+
+
+\subsection{Hardness of PP-Partitioning of Genotype Matrices}
+
+
+\begin{frame}{Finding pp-partitions of genotype matrices.}
+  Now comes the general case:
+  \begin{itemize}
+  \item The inputs $M$ are \alert{genotype matrices}.
+  \item The inputs $M$ \alert{do not allow a perfect phylogeny}.
+  \item What is $\chi_{\operatorname{PP}}(M)$?
+  \end{itemize}
+  \begin{example}
+    \begin{columns}
+      \column{.3\textwidth}
+      $M\colon$
+      \footnotesize
+      \begin{tabular}{cccc}
+        2 & 2 & 2 & 2 \\
+        1 & 0 & 0 & 0 \\
+        0 & 0 & 0 & 1 \\
+        0 & 0 & 1 & 0 \\
+        0 & 2 & 2 & 0 \\
+        1 & 1 & 0 & 0
+      \end{tabular}%
+      \only<2>
+      {%
+        \begin{tikzpicture}
+          \useasboundingbox (2.9,0);
+
+          \draw [red, opacity=0.7,line width=1cm] (1.7 ,1.3) -- (1.7 ,-1.1);
+          \draw [blue,opacity=0.7,line width=5mm] (0.85,1.3) -- (0.85,-1.1)
+                                                  (2.55,1.3) -- (2.55,-1.1);
+        \end{tikzpicture}
+      }
+      \column{.6\textwidth}
+      \begin{overprint}
+        \onslide<1>
+        No perfect phylogeny is possible.
+
+        \onslide<2>
+        \textcolor{blue!70!bg}{Perfect phylogeny}
+
+        \textcolor{red!70!bg}{Perfect phylogeny}
+
+        $\chi_{\operatorname{PP}}(M) = 2$.
+
+      \end{overprint}
+    \end{columns}
+  \end{example}
+\end{frame}
+
+
+  \begin{theorem}
+    Finding \alert{optimal pp-partition of genotype matrices}
+    is at least as hard as finding \alert{optimal colorings of
+      3-uniform hypergraphs}.
+  \end{theorem}
+
+  \begin{proof}[Proof sketch]
+    \begin{enumerate}
+    \item Let $G$ be a 3-uniform hypergraph.
+    \item Build a matrix with a column for each vertex of $G$.
+    \item For each hyperedge of $G$ add four rows inducing\\ the submatrix
+      $\left( + \begin{smallmatrix} + 2 & 2 & 2 \\ + 1 & 0 & 0 \\ + 0 & 1 & 0 \\ + 0 & 0 & 1 + \end{smallmatrix}\right) +$.
+    \item The submatrix enforces that the three columns do not all lie
+      in the same perfect phylogeny. \qedhere
+    \end{enumerate}
+  \end{proof}
+\end{frame}
+
+\begin{frame}{Implications for pp-partitions of genotype matrices.}
+  \begin{corollary}
+    Even if we know $\chi_{\operatorname{PP}}(M) = 2$ for a genotype matrix $M$,\\
+    finding a pp-partition of any fixed size is still
+    \begin{itemize}
+    \item $\operatorname{NP}$-hard,
+    \item not fixed-parameter tractable, unless
+      $\operatorname{P}=\operatorname{NP}$,
+    \item very hard to approximate.
+    \end{itemize}
+  \end{corollary}
+\end{frame}
+
+
+\section{Good News: Tractability Results}
+
+\subsection{Perfect Path Phylogenies}
+
+\begin{frame}{Automatic optimal pp-partitioning is hopeless, but\dots}
+  \begin{itemize}
+  \item The hardness results are \alert{worst-case} results for\\
+  \item \alert{Real biological data} might have special properties
+    that make the problem \alert{tractable}.
+  \item One such property is that perfect phylogenies are often
+
+    In HapMap data, in 70\% of the blocks where a perfect phylogeny
+    is possible a perfect path phylogeny is also possible.
+  \end{itemize}
+\end{frame}
+
+
+\begin{frame}{Example of a perfect path phylogeny.}
+  \begin{columns}[t]
+    \column{.3\textwidth}
+    \begin{exampleblock}{Genotype matrix}
+      $G\colon$
+      \begin{tabular}{ccc}
+        A & B & C \\\hline
+        2 & 2 & 2 \\
+        0 & 2 & 0 \\
+        2 & 0 & 0 \\
+        0 & 2 & 2
+      \end{tabular}
+    \end{exampleblock}
+
+    \column{.3\textwidth}
+    \begin{exampleblock}{Haplotype matrix}
+      $H\colon$
+      \begin{tabular}{ccc}
+        A & B & C \\\hline
+        1 & 0 & 0 \\
+        0 & 1 & 1 \\
+        0 & 0 & 0 \\
+        0 & 1 & 0 \\
+        0 & 0 & 0 \\
+        1 & 0 & 0 \\
+        0 & 0 & 0 \\
+        0 & 1 & 1
+      \end{tabular}
+    \end{exampleblock}
+
+    \column{.4\textwidth}
+    \begin{exampleblock}{Perfect path phylogeny}
+      \begin{center}
+        \begin{tikzpicture}[auto,thick]
+          \tikzstyle{node}=%
+          [%
+            minimum size=10pt,%
+            inner sep=0pt,%
+            outer sep=0pt,%
+            ball color=example text.fg,%
+            circle%
+          ]
+
+          \node [node] {} [->]
+            child {node [node] {} edge from parent node[swap]{A}}
+            child {node [node] {}
+              child {node [node] {} edge from parent node{C}}
+              edge from parent node{B}
+            };
+        \end{tikzpicture}
+      \end{center}
+    \end{exampleblock}
+  \end{columns}
+\end{frame}
+
+
+\begin{frame}{The modified formal computational problem.}
+  We are interested in the computational complexity of \\
+  the function $\chi_{\alert{\operatorname{PPP}}}$:
+  \begin{itemize}
+  \item It gets genotype matrices as input.
+  \item It maps them to a number $k$.
+  \item This number is minimal such that the sites can be
+    covered by $k$ sets, each admitting a perfect \alert{path} phylogeny.
+    \\
+    (We call this a ppp-partition.)
+  \end{itemize}
+\end{frame}
+
+
+
+\subsection{Tractability of PPP-Partitioning of Genotype Matrices}
+
+\begin{frame}{Good news about ppp-partitions of genotype matrices.}
+  \begin{theorem}
+    \alert{Optimal ppp-partitions of genotype matrices} can be
+  \end{theorem}
+  \begin{block}{Algorithm}
+    \begin{enumerate}
+    \item Build the following partial order:
+      \begin{itemize}
+      \item Can one column be above the other in a phylogeny?
+      \item Can the columns be the two children of the root of a
+        perfect path phylogeny?
+      \end{itemize}
+    \item Cover the partial order with as few compatible chain pairs
+      as possible.
+
+      For this, a maximal matching in a special graph needs to be
+      computed.
+    \end{enumerate}
+  \end{block}
+  \hypertarget{return}{}
+\end{frame}
+
+\section*{Summary}
+
+\begin{frame}
+  \frametitle<presentation>{Summary}
+
+  \begin{itemize}
+  \item
+    Finding optimal pp-partitions is \alert{intractable}.
+  \item
+    It is even intractable to find a pp-partition when \alert{just two
+      noncontiguous  blocks are known to suffice}.
+  \item
+    For perfect \alert{path} phylogenies, optimal partitions can be
+  \end{itemize}
+\end{frame}
+
+
+\appendix
+
+\section*{Appendix}
+
+\begin{frame}[label=algorithm]{The algorithm in action.}{Computation of
+    the partial order.}
+  \begin{columns}[t]
+    \column{.4\textwidth}
+    \begin{exampleblock}{Genotype matrix}
+      $G\colon$
+      \begin{tabular}{ccccc}
+        A & B & C & D & E \\\hline
+        2 & 2 & 2 & 2 & 2 \\
+        0 & 1 & 2 & 1 & 0 \\
+        1 & 0 & 0 & 1 & 2 \\
+        0 & 2 & 2 & 0 & 0
+      \end{tabular}
+    \end{exampleblock}
+    \column{.6\textwidth}
+    \begin{exampleblock}{Partial order}
+      \begin{tikzpicture}[node distance=15mm]
+        \tikzstyle{every node}=
+        [%
+          fill=green!50!black!20,%
+          draw=green!50!black,%
+          minimum size=7mm,%
+          circle,%
+          thick%
+        ]
+
+        \node (A) {A};
+        \node (B) [right of=A] {B};
+        \node (C) [below of=B] {C};
+        \node (D) [above of=A] {D};
+        \node (E) [below of=A] {E};
+
+        \path [thick,shorten >=1pt,-stealth'] (A) edge (E)
+                         (B) edge (C)
+                         (D) edge (A)
+                             edge[bend right] (E);
+
+        \uncover<2>{
+        \path [-,blue,thick](A) edge (B)
+                                edge (C)
+                            (B) edge (E)
+                            (C) edge (E);}
+      \end{tikzpicture}
+
+      Partial order: \tikz[baseline] \draw[thick,-stealth'] (0pt,.5ex)
+      -- (5mm,.5ex);
+
+      \uncover<2>{\textcolor{blue}{Compatible as children of root:
+          \tikz[baseline] \draw[thick] (0pt,.5ex) -- (5mm,.5ex);}}
+    \end{exampleblock}
+  \end{columns}
+\end{frame}
+
+\begin{frame}{The algorithm in action.}{The matching in the special graph.}
+  \begin{columns}[t]
+    \column{.3\textwidth}
+    \begin{exampleblock}{Partial order}
+      \begin{tikzpicture}[node distance=15mm]
+        \tikzstyle{every node}=%
+        [%
+          fill=green!50!black!20,%
+          draw=green!50!black,%
+          minimum size=8mm,%
+          circle,%
+          thick%
+        ]
+
+        \node (A)              {$A$};
+        \node (B) [right of=A] {$B$};
+        \node (C) [below of=B] {$C$};
+        \node (D) [above of=A] {$D$};
+        \node (E) [below of=A] {$E$};
+
+        \path [thick,shorten >=1pt,-stealth'] (A) edge (E)
+                         (B) edge (C)
+                         (D) edge (A)
+                             edge[bend right] (E);
+
+        \path [-,blue,thick](A) edge (B)
+                                edge (C)
+                            (B) edge (E)
+                            (C) edge (E);
+
+        \only<3->
+        {
+          \path[very thick,shorten >=1pt,-stealth',red] (D) edge (A) (B) edge (C);
+          \path [-,red,very thick](E) edge (B);
+        }
+      \end{tikzpicture}
+    \end{exampleblock}
+    \column{.7\textwidth}
+    \begin{exampleblock}{Matching graph}
+      \begin{tikzpicture}[node distance=15mm]
+        \tikzstyle{every node}=%
+        [%
+          fill=green!50!black!20,%
+          draw=green!50!black,%
+          minimum size=8mm,%
+          circle,%
+          thick,%
+          inner sep=0pt%
+        ]
+
+        \node (A)              {$A$};
+        \node (B) [right of=A] {$B$};
+        \node (C) [below of=B] {$C$};
+        \node (D) [above of=A] {$D$};
+        \node (E) [below of=A] {$E$};
+
+        \begin{scope}[xshift=4.75cm]
+          \node (A')               {$A'$};
+          \node (B') [right of=A'] {$B'$};
+          \node (C') [below of=B'] {$C'$};
+          \node (D') [above of=A'] {$D'$};
+          \node (E') [below of=A'] {$E'$};
+        \end{scope}
+
+        \path [thick]    (A) edge (E')
+                         (B) edge (C')
+                         (D) edge (A')
+                             edge (E');
+
+        \path [blue,thick](A') edge (B')
+                               edge (C')
+                          (B') edge (E')
+                          (C') edge (E');
+
+        \only<2->
+        {
+          \path[very thick,red] (D) edge (A')
+                           (B) edge (C')
+                           (B') edge (E');
+        }
+      \end{tikzpicture}
+    \end{exampleblock}
+  \end{columns}
+
+  \medskip
+  \uncover<2->{A \alert{maximal matching} in the matching graph
+
+\end{frame}
+
+\end{document}
+
+

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-conference-talk.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-foils.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-foils.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,53 @@
+% Copyright 2007 by Till Tantau
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Public License.
+%
+
+% $Header$
+
+% This file is a demonstration on how a foils file should be
+% changed to make it work with beamer.
+
+
+% Since foiltex has a restricted license, I'm not able to include an
+% original example from foiltex. Instead, I'm providing a simple
+% example that shows the basic usage.
+
+
+\documentclass{beamer}
+\usepackage{beamerfoils}
+\beamertemplatetheoremsnumbered
+
+\title{A Foils-To-Beamer Example}
+
+\author{Till Tantau}
+
+\MyLogo{\tiny-- Typeset by beamer emulation of \FoilTeX\ --}
+
+
+\begin{document}
+
+\frame{
+\maketitle
+}
+
+
+Some text.
+
+\pagebreak
+
+More text on next slide.
+
+
+Some text.
+
+\endfoil
+\end{document}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-foils.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
(Binary files differ)

Index: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-beamer-version.pdf
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-beamer-version.pdf	2017-12-19 00:07:03 UTC (rev 46094)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-beamer-version.pdf	2017-12-19 00:09:01 UTC (rev 46095)

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-beamer-version.pdf
___________________________________________________________________
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-beamer-version.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-beamer-version.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,13 @@
+% Copyright 2007 by Till Tantau
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Public License.
+%
+
+\documentclass[german,10pt]{beamer}
+
+\input{beamerexample-lecture-style.tex}
+\input{beamerexample-lecture-body.tex}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-beamer-version.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-body.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-body.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,587 @@
+% Copyright 2007 by Till Tantau
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Public License.
+%
+
+%
+% DO NOT USE THIS FILE AS A TEMPLATE FOR YOUR OWN TALKS\xA1!!
+%
+% Use a file in the directory solutions instead.
+% They are much better suited.
+%
+
+
+\lecture[1]{Syntax versus Semantik}{lecture-text}
+
+\subtitle{Text und seine Bedeutung}
+
+\date{27. Oktober 2006}
+
+
+\begin{document}
+
+\begin{frame}
+  \maketitle
+\end{frame}
+
+
+\section*{Ziele und Inhalt}
+
+\begin{frame}{Die Lernziele der heutigen Vorlesung und der \xDCbungen.}
+  \begin{enumerate}
+  \item Die Begriffe Syntax und Semantik erkl\xE4ren k\xF6nnen
+  \item Syntaktische und semantische Elemente nat\xFCrlicher Sprachen und
+    von Programmiersprachen benennen k\xF6nnen
+  \item Die Begriffe Alphabet und Wort kennen
+  \item Objekte als Worte kodieren k\xF6nnen
+  \end{enumerate}
+\end{frame}
+
+\begin{frame}\frametitle<presentation>{Gliederung}
+  \tableofcontents
+\end{frame}
+
+
+\section{Was ist Syntax?}
+
+\begin{frame}{Die zwei Hauptbegriffe der heutigen Vorlesung.}
+  \begin{block}{Grobe Definition (Syntax)}
+  \end{block}
+  \begin{block}{Grobe Definition (Semantik)}
+    Unter einer \alert{Semantik} verstehen wir die Zuordnung von
+  \end{block}
+\end{frame}
+
+
+\subsection[Syntax \protect\\ nat\xFCrlicher Sprachen]{Syntax nat\xFCrlicher Sprachen}
+
+\begin{frame}{Beobachtungen zu einem \xE4gyptischen Text.}
+
+  \begin{block}{Beobachtungen}
+    \begin{itemize}
+    \item Wir haben keine Ahnung, was der Text bedeutet.
+    \item Es gibt aber \alert{Regeln}, die offenbar eingehalten wurden,
+      wie \xBBHieroglyphen stehen in Zeilen\xAB.
+    \item Solche Regeln sind \alert{syntaktische Regeln} -- man kann sie
+      \xFCberpr\xFCfen, ohne den Inhalt zu verstehen.
+    \end{itemize}
+  \end{block}
+\end{frame}
+
+
+\begin{frame}{Beobachtungen zu einem kyrillischen Text.}
+
+
+  \begin{block}{Beobachtungen}
+    \begin{itemize}
+    \item Wir haben keine Ahnung, was der Text bedeutet.
+    \item Es gibt aber \alert{Regeln}, die offenbar eingehalten wurden.
+    \item Wir kennen mehr Regeln als bei den Hieroglyphen.
+    \end{itemize}
+  \end{block}
+
+  \begin{block}{Zur Diskussion}
+    Welche syntaktischen Regeln fallen Ihnen ein, die bei dem Text
+    eingehalten wurden?
+  \end{block}
+\end{frame}
+
+
+
+\begin{frame}{Beobachtungen zu einem deutschen Text.}
+  \begin{quotation}
+    Informatiker lieben Logiker.
+  \end{quotation}
+
+  \bigskip
+  \begin{block}{Beobachtungen}
+    \begin{itemize}
+    \item Auch hier werden viele syntaktische Regeln eingehalten.
+    \item Es f\xE4llt uns aber \alert{schwerer}, diese zu erkennen.
+    \item Der Grund ist, dass wir \alert{sofort \xFCber die Bedeutung
+        nachdenken}.
+    \end{itemize}
+  \end{block}
+\end{frame}
+
+\begin{frame}{Zur Syntax von nat\xFCrlichen Sprachen.}
+  \begin{itemize}
+  \item
+    Die \alert{Syntax} einer nat\xFCrlichen Sprache ist die Menge an
+    \alert{Regeln}, nach denen S\xE4tze gebildet werden d\xFCrfen.
+  \item
+    ist dabei unerheblich.
+  \item
+    Jede Sprache hat ihre eigene Syntax; die Syntax verschiedener
+    Sprachen \xE4hneln sich aber oft.
+  \item
+    Es ist nicht immer klar, ob eine Regel noch zur Syntax geh\xF6rt
+    oder ob es schon um den Sinn geht.
+
+    \ExampleInline{Substantive werden gro\xDF geschrieben.}
+  \end{itemize}
+\end{frame}
+
+\subsection{Syntax von Programmiersprachen}
+
+\begin{frame}[fragile]{Beobachtungen zu einem Programmtext.}
+
+\begin{verbatim}
+  \pgf at process{#1}%
+  \pgf at xa=\pgf at x%
+  \pgf at ya=\pgf at y%
+  \pgf at process{#2}%
+  \advance\pgf at x by\pgf at xa%
+  \advance\pgf at y by\pgf at ya}
+\end{verbatim}
+  \begin{block}{Beobachtungen}
+    \begin{itemize}
+    \item Der Programmtext sieht sehr kryptisch aus.
+    \item Trotzdem gibt es offenbar wieder Regeln.
+    \item So scheint einem Doppelkreuz eine Ziffer zu folgen und
+      Zeilen muss man offenbar mit Prozentzeichen beenden.
+    \end{itemize}
+  \end{block}
+\end{frame}
+
+
+\begin{frame}[fragile]{Beobachtungen zu einem weiteren Programmtext.}
+
+\begin{verbatim}
+for (int i = 0; i < 100; i++)
+  a[i] = a[i];
+\end{verbatim}
+  \begin{block}{Beobachtungen}
+    \begin{itemize}
+    \item Wieder gibt es Regeln, die eingehalten werden.
+    \item Wieder f\xE4llt es uns \alert{schwerer}, diese zu erkennen, da
+      wir \alert{sofort \xFCber den Sinn nachdenken}.
+    \end{itemize}
+  \end{block}
+\end{frame}
+
+
+\begin{frame}{Zur Syntax von Programmiersprachen}
+  \begin{itemize}
+  \item Die \alert{Syntax} einer Programmiersprache ist die
+    \alert{Menge von Regeln}, nach der Programmtexte gebildet werden
+    d\xFCrfen.
+    ist dabei egal.
+  \item
+    Jede Programmiersprache hat ihre eigene Syntax; die Syntax
+    verschiedener Sprachen \xE4hneln sich aber oft.
+  \end{itemize}
+\end{frame}
+
+\begin{frame}{5-Minuten-Aufgabe}
+  Welche der folgenden Regeln sind Syntax-Regeln?
+  \begin{enumerate}
+  \item Bezeichner d\xFCrfen nicht mit einer Ziffer anfangen.
+  \item Programme m\xFCssen in endlicher Zeit ein Ergebnis produzieren.
+  \item \xD6ffnende und schlie\xDFende geschweifte Klammern  m\xFCssen
+    \xBBbalanciert\xAB sein.
+  \item Methoden von Null-Objekten d\xFCrfen nicht aufgerufen werden.
+  \item Variablen m\xFCssen vor ihrer ersten Benutzung deklariert werden.
+  \end{enumerate}
+\end{frame}
+
+
+\subsection[Syntax\protect\\ logischer Sprachen]{Syntax logischer Sprachen}
+
+\begin{frame}{Beobachtungen zu einer logischen Formel.}
+  \begin{quotation}
+    $p \to q \land \neg q$
+  \end{quotation}
+
+  \bigskip
+  \begin{block}{Beobachtungen}
+    \begin{itemize}
+    \item Auch logische Formeln haben eine syntaktische Struktur.
+    \item So w\xE4re es \alert{syntaktisch falsch}, statt einem Pfeil zwei
+      Pfeile zu benutzen.
+    \item Es w\xE4re aber \alert{syntaktisch richtig}, statt einem
+      Negationszeichen zwei Negationszeichen zu verwenden.
+    \end{itemize}
+  \end{block}
+\end{frame}
+
+\begin{frame}{Zur Syntax von logischen Sprachen}
+  \begin{itemize}
+  \item Die \alert{Syntax} einer logischen Sprache ist die
+    \alert{Menge von Regeln}, nach der Formeln gebildet werden
+    d\xFCrfen.
+    ist dabei egal.
+  \item
+    Jede logische Sprache hat ihre eigene Syntax; die Syntax
+    verschiedener Sprachen \xE4hneln sich aber oft.
+  \end{itemize}
+\end{frame}
+
+
+
+\section{Was ist Semantik?}
+
+\subsection[Semantik\protect\\ nat\xFCrlicher Sprachen]{Semantik nat\xFCrlicher Sprachen}
+
+\begin{frame}{Was bedeutet ein Satz?}
+
+  \begin{quotation}
+    Der H\xF6rsaal ist gro\xDF.
+  \end{quotation}
+
+  \bigskip
+  \begin{itemize}
+  \item Dieser Satz hat eine \alert{Bedeutung}.
+  \item Eine \alert{Semantik} legt solche Bedeutungen fest.
+  \item Syntaktisch falschen S\xE4tzen wird im Allgemeinen keine
+    Bedeutung zugewiesen.
+  \end{itemize}
+\end{frame}
+
+\begin{frame}{Ein Satz, zwei Bedeutungen.}
+  \begin{quotation}
+    Steter Tropfen h\xF6hlt den Stein.
+  \end{quotation}
+
+  \bigskip
+  \begin{itemize}
+  \item Ein Satz kann \alert{mehrere Bedeutungen haben}, welche durch
+  \item In der \alert{wortw\xF6rtlichen Semantik} sagt der Satz aus, dass
+    Steine ausgeh\xF6hlte werden, wenn man jahrelang Wasser auf
+    sie tropft.
+  \item In der \alert{\xFCbertragenen Semantik} sagt der Satz aus, dass
+    sich Beharrlichkeit auszahlt.
+  \end{itemize}
+\end{frame}
+
+\begin{frame}{Die Semantik der Hieroglyphen}
+  {Unknown Author, Public Domain, Low Resolution}
+\end{frame}
+
+
+\subsection{Semantik von Programmiersprachen}
+
+\begin{frame}[fragile]{Was bedeutet ein Programm?}
+\begin{verbatim}
+for (int i = 0; i < 100; i++)
+  a[i] = a[i];
+\end{verbatim}
+  \begin{itemize}
+  \item Auch dieser Programmtext \xBBbedeutet etwas\xAB, wir \xBBmeinen etwas\xAB
+    mit diesem Text.
+  \item Die \alert{Semantik der Programmiersprache} legt fest,
+    was mit dem Programmtext gemeint ist.
+  \end{itemize}
+\end{frame}
+
+\begin{frame}[fragile]{Ein Programm, zwei Bedeutungen.}
+\begin{verbatim}
+for (int i = 0; i < 100; i++)
+  a[i] = a[i];
+\end{verbatim}
+  \begin{itemize}
+  \item Ein Programmtext kann \alert{mehrere Bedeutungen haben},
+    welche durch \alert{unterschiedliche Semantiken} gegeben sind.
+  \item In der \alert{operationalen Semantik} bedeutet der
+    Programmtext, dass die ersten einhundert Elemente eines Arrays
+    \verb!a! nacheinander ihren eigenen Wert zugewiesen bekommen.
+  \item In der \alert{denotationellen Semantik} bedeutet der
+    Programmtext, dass nichts passiert.
+  \end{itemize}
+\end{frame}
+
+
+\subsection[Semantik\protect\\ logischer Sprachen]{Semantik logischer Sprachen}
+
+
+
+
+\section{Grundlage der Syntax: Text}
+
+\begin{frame}{Eine mathematische Sicht auf Text.}
+  \begin{itemize}
+  \item Viele (aber nicht alle!) syntaktische Systeme bauen auf
+  \item Auch solche Systeme, die nicht auf Text aufbauen, lassen sich
+    trotzdem durch Text beschreiben.
+  \item Es ist deshalb n\xFCtzlich, auf Text \text{Methoden der
+      Mathematik} anwenden zu k\xF6nnen.
+  \item Im Folgenden wird deshalb die \alert{mathematische Sicht} auf
+    Text eingef\xFChrt, die \alert{in der gesamten Theoretischen
+      Informatik} genutzt wird.
+  \end{itemize}
+\end{frame}
+
+
+\subsection{Alphabete}
+
+\begin{frame}{Formale Alphabete}
+  \begin{definition}[Alphabet]
+    Ein \alert{Alphabet} ist eine nicht-leere, endliche Menge von
+  \end{definition}
+
+  \begin{itemize}
+  \item Alphabete werden h\xE4ufig mit griechischen Gro\xDFbuchstaben
+    bezeichnet, also $\Gamma$ oder~$\Sigma$. Manchmal auch mit
+    lateinischen Gro\xDFbuchstaben, also $N$ oder~$T$.
+  \item Ein Symbol oder \xBBBuchstabe\xAB kann auch ein komplexes oder
+    komisches \xBBDing\xAB sein wie ein Pointer oder ein Leerzeichen.
+  \end{itemize}
+
+  \begin{examples}
+    \begin{itemize}
+    \item Die Gro\xDF- und Kleinbuchstaben
+    \item Die Menge $\{0,1\}$ (bei Informatikern beliebt)
+    \item Die Menge $\{A,C,G,T\}$ (bei Biologen beliebt)
+    \item Die Zeichenmenge des UNICODE.
+    \end{itemize}
+  \end{examples}
+\end{frame}
+
+
+\subsection{Worte}
+
+
+\begin{frame}{Formale Worte}
+  \begin{definition}[Wort]
+    Ein \alert{Wort} ist eine (endliche) Folge von Symbolen.
+  \end{definition}
+  \begin{itemize}
+    \item \xBBWorte\xAB sind im Prinzip dasselbe wie
+      Strings. Insbesondere k\xF6nnen in Worten Leerzeichen als Symbole
+      auftauchen.
+    \item Die Menge aller Worte \xFCber einem Alphabet $\Sigma$ hat einen
+      besonderen Namen: $\Sigma^*$.
+    \item
+      Deshalb schreibt man oft: \xBBSei $w \in \Sigma^*$, \dots\xAB
+    \item Es gibt auch ein \alert{leeres Wort}, abgek\xFCrzt
+      $\epsilon$ oder $\lambda$, das dem String
+      \texttt{\char\"\char\"} entspricht.
+    \end{itemize}
+
+  \begin{examples}
+    \begin{itemize}
+    \item \texttt{Hallo}
+    \item \texttt{TATAAAATATTA}
+    \item $\epsilon$
+    \item \texttt{Hallo Welt.}
+    \end{itemize}
+  \end{examples}
+\end{frame}
+
+
+\begin{frame}{5-Minuten-Aufgabe}
+  Die folgenden Aufgaben sind nach Schwierigkeit sortiert. L\xF6sen Sie
+  \begin{enumerate}
+  \item
+    Schreiben Sie alle Worte der L\xE4nge h\xF6chstens $2$ \xFCber dem Alphabet
+    $\Sigma = \{0,1,*\}$ auf.
+  \item
+    Wie viele Worte der L\xE4nge $n$ \xFCber dem Alphabet $\Sigma = + \{0,1,*\}$  gibt es?
+  \item
+    Wie viele Worte der L\xE4nge h\xF6chstens $n$ \xFCber einem Alphabet mit
+    $q$ Buchstaben gibt es?
+  \end{enumerate}
+\end{frame}
+
+
+\subsection{Sprachen}
+
+\begin{frame}{Formale Sprachen}{Definition}
+  \begin{itemize}
+  \item Nat\xFCrlichen Sprachen sind komplexe Dinge, bestehend aus
+    W\xF6rtern, ihrer Ausprache, einer Grammatik, Ausnahmen, Dialekten,
+    und vielem mehr.
+  \item Formale Sprachen m\xFCssen weder sinnvoll noch interessant sein.
+  \end{itemize}
+
+  \begin{definition}[Formale Sprache]
+    Eine \alert{formale Sprache} ist eine (oft unendliche!) Menge von
+    Worten f\xFCr ein festes Alphabet.
+  \end{definition}
+
+  \begin{itemize}
+  \item Statt \frqq formale Sprache\flqq\ sagt man einfach \frqq Sprache\flqq.
+  \item Als Menge von Worten ist eine Sprache eine Teilmenge von
+    $\Sigma^*$.
+  \item
+    Deshalb schreibt man oft: \frqq Sei $L \subseteq \Sigma^*$,
+    \dots\flqq
+  \end{itemize}
+\end{frame}
+
+\begin{frame}{Formale Sprachen}{Einfache Beispiele}
+  \begin{examples}
+    \begin{itemize}
+    \item Die Menge $\{AAA, AAC, AAT\}$ (endliche Sprache).
+    \item Die Menge aller Java-Programmtexte (unendliche Sprache).
+    \item Die Menge aller Basensequenzen, die \texttt{TATA} enthalten
+      (unendliche Sprache).
+    \end{itemize}
+  \end{examples}
+\end{frame}
+
+\begin{frame}{Formale Sprachen in der Medieninformatik}
+  \begin{itemize}
+  \item Ein Renderer produziert 3D-Bilder.
+  \item Dazu erh\xE4lt er eine \alert{Szenerie} als Eingabe.
+  \item Diese Szenerie ist als \alert{Text}, also als ein \alert{Wort} gegeben.
+  \item Eine \alert{Syntax} beschreibt die (formale) Sprache, die alle
+  \item Eine \alert{Semantik} beschreibt, was diese Beschreibungen bedeuten.
+  \end{itemize}
+\end{frame}
+
+\begin{frame}[fragile]{Formale Sprachen in der Medieninformatik}{Das
+    \xBBWort\xAB, das eine Szenerie beschreibt\dots}
+\only<presentation>{\scriptsize}
+\begin{verbatim*}
+global_settings { assumed_gamma 1.0 }
+
+camera {
+  location  <10.0, 10, -10.0>
+  direction 1.5*z
+  right     x*image_width/image_height
+  look_at   <0.0, 0.0,  0.0>
+}
+
+sky_sphere { pigment { color rgb <0.6,0.7,1.0> } }
+
+light_source {
+  <0, 0, 0>            // light's position (translated below)
+  color rgb <1, 1, 1>  // light's color
+  translate <-30, 30, -30>
+}
+
+#declare i = 0;
+#declare Steps = 30;
+#declare Kugel = sphere{<0,0,0>,0.5 pigment{color rgb<1,0,0>}};
+
+#while(i<Steps)
+    object{Kugel  translate<3,0,0> rotate <0,i * 360 / Steps, 0> }
+  #declare i = i + 1;
+#end
+\end{verbatim*}
+\end{frame}
+
+
+\begin{frame}{Formale Sprachen in der Medieninformatik}{\dots\ und was es bedeutet.}
+\end{frame}
+
+\begin{frame}{Formale Sprachen in der Medieninformatik}{Komplexeres Beispielbild, das ein Renderer produziert.}
+  {Copyright Giorgio Krenkel and Alex Sandri, GNU Free Documentation License, Low Resolution}
+\end{frame}
+
+
+\begin{frame}{Formale Sprachen in der Bioinformatik}
+  \begin{itemize}
+  \item In der Bioinformatik untersucht man unter anderem Proteine.
+  \item Dazu erh\xE4lt man \alert{Molek\xFClbeschreibungen} als Eingabe.
+  \item Eine solche ist auch ein \alert{Wort}.
+  \item Eine \alert{Syntax} beschreibt die (formale) Sprache, die alle
+  \item Eine \alert{Semantik} beschreibt, was diese Beschreibungen bedeuten.
+  \end{itemize}
+\end{frame}
+
+
+\begin{frame}[fragile]{Formale Sprachen in der Bioinformatik}
+  {Das \xBBWort\xAB, das ein Protein beschreibt\dots}
+\only<presentation>{\tiny}
+\only<article>{\footnotesize}
+\begin{verbatim}
+TITLE     CRYSTAL STRUCTURE OF SARS CORONAVIRUS MAIN PROTEINASE
+TITLE    2 (3CLPRO)
+COMPND    MOL_ID: 1;
+COMPND   2 MOLECULE: 3C-LIKE PROTEINASE;
+COMPND   3 CHAIN: A, B;
+COMPND   4 SYNONYM: MAIN PROTEINASE, 3CLPRO;
+COMPND   5 EC: 3.4.24.-;
+COMPND   6 ENGINEERED: YES
+SOURCE    MOL_ID: 1;
+SOURCE   2 ORGANISM_SCIENTIFIC: SARS CORONAVIRUS;
+SOURCE   3 ORGANISM_COMMON: VIRUSES;
+SOURCE   4 STRAIN: SARS;
+...
+REVDAT   1   18-NOV-03 1UJ1    0
+JRNL        AUTH   H.YANG,M.YANG,Y.DING,Y.LIU,Z.LOU,Z.ZHOU,L.SUN,L.MO,
+JRNL        AUTH 2 S.YE,H.PANG,G.F.GAO,K.ANAND,M.BARTLAM,R.HILGENFELD,
+JRNL        AUTH 3 Z.RAO
+JRNL        TITL   THE CRYSTAL STRUCTURES OF SEVERE ACUTE RESPIRATORY
+JRNL        TITL 2 SYNDROME VIRUS MAIN PROTEASE AND ITS COMPLEX WITH
+JRNL        TITL 3 AN INHIBITOR
+JRNL        REF    PROC.NAT.ACAD.SCI.USA         V. 100 13190 2003
+JRNL        REFN   ASTM PNASA6  US ISSN 0027-8424
+....
+ATOM      1  N   PHE A   3      63.478 -27.806  23.971  1.00 44.82           N
+ATOM      2  CA  PHE A   3      64.607 -26.997  24.516  1.00 42.13           C
+ATOM      3  C   PHE A   3      64.674 -25.701  23.723  1.00 41.61           C
+ATOM      4  O   PHE A   3      65.331 -25.633  22.673  1.00 40.73           O
+ATOM      5  CB  PHE A   3      65.912 -27.763  24.358  1.00 44.33           C
+ATOM      6  CG  PHE A   3      67.065 -27.162  25.108  1.00 44.20           C
+ATOM      7  CD1 PHE A   3      67.083 -27.172  26.496  1.00 43.35           C
+ATOM      8  CD2 PHE A   3      68.135 -26.595  24.422  1.00 43.49           C
+ATOM      9  CE1 PHE A   3      68.140 -26.631  27.187  1.00 43.21           C
+ATOM     10  CE2 PHE A   3      69.210 -26.046  25.108  1.00 42.91           C
+ATOM     11  CZ  PHE A   3      69.216 -26.062  26.493  1.00 43.22           C
+ATOM     12  N   ARG A   4      64.007 -24.666  24.228  1.00 34.90           N
+ATOM     13  CA  ARG A   4      63.951 -23.376  23.543  1.00 37.71           C
+...
+\end{verbatim}
+\end{frame}
+
+\begin{frame}[fragile]{Formale Sprachen in der Bioinformatik}
+  {\dots\ und das Protein, das beschrieben wird.}
+
+  {Copyright Till Tantau, Low Resultion}
+\end{frame}
+
+
+\section<article>{Zusammenfassung}
+\section<presentation>*{Zusammenfassung}
+
+\begin{frame}{Zusammenfassung}
+  \begin{enumerate}
+  \item Ein \alert{Wort} ist eine Folge von Symbolen aus einem
+  \item Eine \alert{Syntax} besteht aus Regeln, nach denen
+    Worte (Texte) gebaut werden d\xFCrfen.
+  \item Eine \alert{formale Sprache} ist eine Menge von Worten
+    \xFCber einem Alphabet.
+  \end{enumerate}
+\end{frame}
+
+\end{document}
+
+
+
+
+

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-body.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
(Binary files differ)

Index: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-logo.pdf
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-logo.pdf	2017-12-19 00:07:03 UTC (rev 46094)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-logo.pdf	2017-12-19 00:09:01 UTC (rev 46095)

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-logo.pdf
___________________________________________________________________
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
===================================================================
(Binary files differ)

Index: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic1.jpg
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic1.jpg	2017-12-19 00:07:03 UTC (rev 46094)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic1.jpg	2017-12-19 00:09:01 UTC (rev 46095)

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic1.jpg
___________________________________________________________________
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
===================================================================
(Binary files differ)

Index: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic2.jpg
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic2.jpg	2017-12-19 00:07:03 UTC (rev 46094)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic2.jpg	2017-12-19 00:09:01 UTC (rev 46095)

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic2.jpg
___________________________________________________________________
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
===================================================================
(Binary files differ)

Index: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic3.jpg
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic3.jpg	2017-12-19 00:07:03 UTC (rev 46094)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic3.jpg	2017-12-19 00:09:01 UTC (rev 46095)

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic3.jpg
___________________________________________________________________
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
===================================================================
(Binary files differ)

Index: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic4.jpg
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic4.jpg	2017-12-19 00:07:03 UTC (rev 46094)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic4.jpg	2017-12-19 00:09:01 UTC (rev 46095)

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic4.jpg
___________________________________________________________________
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
===================================================================
(Binary files differ)

Index: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic5.jpg
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic5.jpg	2017-12-19 00:07:03 UTC (rev 46094)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic5.jpg	2017-12-19 00:09:01 UTC (rev 46095)

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic5.jpg
___________________________________________________________________
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
===================================================================
(Binary files differ)

Index: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic6.jpg
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic6.jpg	2017-12-19 00:07:03 UTC (rev 46094)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic6.jpg	2017-12-19 00:09:01 UTC (rev 46095)

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-pic6.jpg
___________________________________________________________________
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property
===================================================================
(Binary files differ)

Index: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-print-version.pdf
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-print-version.pdf	2017-12-19 00:07:03 UTC (rev 46094)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-print-version.pdf	2017-12-19 00:09:01 UTC (rev 46095)

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-print-version.pdf
___________________________________________________________________
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-print-version.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-print-version.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,14 @@
+% Copyright 2007 by Till Tantau
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Public License.
+%
+
+\documentclass[german,a4paper,9pt]{extarticle}
+\usepackage{beamerarticle}
+\input{beamerexample-lecture-style.tex}
+\input{beamerexample-lecture-body.tex}
+

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-print-version.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-style.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-style.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,233 @@
+% Copyright 2007 by Till Tantau
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Public License.
+%
+
+
+% Common packages
+
+\usepackage[german]{babel}
+\usepackage[latin1]{inputenc}
+\usepackage{times}
+\mode<article>
+{
+  \usepackage{times}
+  \usepackage{mathptmx}
+  \usepackage[left=1.5cm,right=6cm,top=1.5cm,bottom=3cm]{geometry}
+}
+
+\usepackage{hyperref}
+\usepackage[T1]{fontenc}
+\usepackage{tikz}
+\usepackage{colortbl}
+\usepackage{yfonts}
+\usepackage{colortbl}
+\usepackage{translator} % comment this, if not available
+
+
+% Common settings for all lectures in this course
+
+\def\lecturename{Logik f\xFCr Informatiker}
+
+\title{\insertlecture}
+
+\author{Till Tantau}
+
+\institute
+{
+  Institut f\xFCr Theoretische Informatik\\
+  Universit\xE4t zu L\xFCbeck
+}
+
+\subject{Vorlesung \lecturename}
+
+
+
+
+% Beamer version theme settings
+
+\useoutertheme[height=0pt,width=2cm,right]{sidebar}
+\usecolortheme{rose,sidebartab}
+\useinnertheme{circles}
+\usefonttheme[only large]{structurebold}
+
+\setbeamercolor{sidebar right}{bg=black!15}
+\setbeamercolor{structure}{fg=blue}
+\setbeamercolor{author}{parent=structure}
+
+\setbeamerfont{title}{series=\normalfont,size=\LARGE}
+\setbeamerfont{title in sidebar}{series=\bfseries}
+\setbeamerfont{author in sidebar}{series=\bfseries}
+\setbeamerfont*{item}{series=}
+\setbeamerfont{frametitle}{size=}
+\setbeamerfont{block title}{size=\small}
+\setbeamerfont{subtitle}{size=\normalsize,series=\normalfont}
+
+\setbeamertemplate{bibliography item}[book]
+\setbeamertemplate{sidebar right}
+{
+  {\usebeamerfont{title in sidebar}%
+    \vskip1.5em%
+    \hskip3pt%
+    \usebeamercolor[fg]{title in sidebar}%
+    \insertshorttitle[width=\dimexpr2cm-6pt\relax,center,respectlinebreaks]\par%
+    \vskip1.25em%
+  }%
+  {%
+    \hskip1pt%
+    \usebeamercolor[fg]{author in sidebar}%
+    \usebeamerfont{author in sidebar}%
+    \insertshortauthor[width=\dimexpr2cm-2pt\relax,center,respectlinebreaks]\par%
+    \vskip1.25em%
+  }%
+  \hbox to2cm{\hss\insertlogo\hss}
+  \vskip1.25em%
+  \vfill
+  \hbox to 2cm{\hfill\usebeamerfont{subsection in
+      sidebar}\strut\usebeamercolor[fg]{subsection in
+  \vskip3pt%
+}%
+
+\setbeamertemplate{title page}
+{
+  \vbox{}
+  \vskip1em
+  {\huge Kapitel \insertshortlecture\par}
+  {\usebeamercolor[fg]{title}\usebeamerfont{title}\inserttitle\par}%
+  \ifx\insertsubtitle\@empty%
+  \else%
+    \vskip0.25em%
+    {\usebeamerfont{subtitle}\usebeamercolor[fg]{subtitle}\insertsubtitle\par}%
+  \fi%
+  \vskip1em\par
+  Vorlesung \emph{\lecturename}\ vom \insertdate\par
+  \vskip0pt plus1filll
+  \leftskip=0pt plus1fill\insertauthor\par
+  \insertinstitute\vskip1em
+}
+
+\logo{\includegraphics[width=2cm]{beamerexample-lecture-logo.pdf}}
+
+
+
+% Article version layout settings
+
+\mode<article>
+
+\makeatletter
+\def\@listI{\leftmargin\leftmargini
+  \parsep 0pt
+  \topsep 5\p@   \@plus3\p@ \@minus5\p@
+  \itemsep0pt}
+\let\@listi=\@listI
+
+
+\setbeamertemplate{frametitle}{\paragraph*{\insertframetitle\
+    \ \small\insertframesubtitle}\ \par
+}
+\setbeamertemplate{frame end}{%
+  \marginpar{\scriptsize\hbox to 1cm{\sffamily%
+\setlength{\marginparwidth}{1cm}
+\setlength{\marginparsep}{4.5cm}
+
+\def\@maketitle{\makechapter}
+
+\def\makechapter{
+  \newpage
+  \null
+  \vskip 2em%
+  {%
+    \parindent=0pt
+    \raggedright
+    \sffamily
+    \vskip8pt
+    {\fontsize{36pt}{36pt}\selectfont Kapitel \insertshortlecture \par\vskip2pt}
+    {\fontsize{24pt}{28pt}\selectfont \color{blue!50!black} \insertlecture\par\vskip4pt}
+    {\Large\selectfont \color{blue!50!black} \insertsubtitle\par}
+    \vskip10pt
+
+    \normalsize\selectfont Druckfassung der
+    Vorlesung \emph{\lecturename} vom \@date\par\vskip1.5em
+    \hfill Till Tantau, Institut f\xFCr Theoretische Informatik, Universit\xE4t zu L\xFCbeck
+  }
+  \par
+  \vskip 1.5em%
+}
+
+\let\origstartsection=\@startsection
+\def\@startsection#1#2#3#4#5#6{%
+  \origstartsection{#1}{#2}{#3}{#4}{#5}{#6\normalfont\sffamily\color{blue!50!black}\selectfont}}
+
+\makeatother
+
+\mode
+<all>
+
+
+
+
+% Typesetting Listings
+
+\usepackage{listings}
+\lstset{language=Java}
+
+\alt<presentation>
+{\lstset{%
+  basicstyle=\footnotesize\ttfamily,
+  keywordstyle=\bfseries\color{blue!50!black},
+  identifierstyle=\color{blue},
+  stringstyle=\color{orange},
+  escapechar=\#,
+  emphstyle=\color{red}}
+}
+{
+  \lstset{%
+    basicstyle=\ttfamily,
+    keywordstyle=\bfseries,
+    escapechar=\#,
+    emphstyle=\bfseries\color{red}
+  }
+}
+
+
+
+% Common theorem-like environments
+
+\theoremstyle{definition}
+\newtheorem{exercise}[theorem]{\translate{Exercise}}
+
+
+
+
+% New useful definitions:
+
+\newbox\mytempbox
+\newdimen\mytempdimen
+
+  \leavevmode\vbox{\vskip3pt\raggedright\setbox\mytempbox=\hbox{\includegraphics[#1]{#2}}%
+    \mytempdimen=\wd\mytempbox\box\mytempbox\par\vskip1pt%
+    \fontsize{3}{3.5}\selectfont{\color{black!25}{\vbox{\hsize=\mytempdimen#3}}}\vskip3pt%
+}}
+
+\newenvironment{colortabular}[1]{\medskip\rowcolors[]{1}{blue!20}{blue!10}\tabular{#1}\rowcolor{blue!40}}{\endtabular\medskip}
+
+
+\newenvironment{greencolortabular}[1]
+{\medskip\rowcolors[]{1}{green!50!black!20}{green!50!black!10}%
+  \tabular{#1}\rowcolor{green!50!black!40}}%
+{\endtabular\medskip}
+
+
+

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-style.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-prosper.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-prosper.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,80 @@
+% Copyright 2007 by Till Tantau
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Public License.
+%
+
+% $Header$
+
+\documentclass[notes]{beamer}
+
+% You might wish to try this instead of the above line:
+%\documentclass[class=article]{beamer}
+%\usepackage{beamerbasearticle}
+%\usepackage{hyperref}
+
+\usepackage[framesassubsections]{beamerprosper}
+
+\mode<presentation>
+{
+  \definecolor{beamerstructure}{RGB}{43,79,112}
+  \definecolor{sidebackground}{RGB}{230,242,250}
+  \color{beamerstructure}
+  \usetheme{Goettingen}
+  \usepackage{times}
+  \userightsidebarcolortemplate{\color{sidebackground}}
+  \beamertemplateballitem
+}
+
+
+\title{A Beamer Presentation Using (HA-)Prosper Commands}
+\subtitle{Subtitles Are Also Supported}
+\author{Till Tantau}
+\institution{The Institution is Mapped To Institute}
+
+\begin{document}
+
+\maketitle
+
+\tsectionandpart{Introduction}
+
+\overlays{2}{
+  \begin{itemstep}
+  \item
+    This is a beamer presentation.
+  \item
+    You can use the prosper and the HA-prosper syntax.
+  \item
+    This is done by mapping prosper and HA-prosper commands to beamer
+    commands.
+  \item
+    The emulation is by no means perfect.
+  \end{itemstep}
+\end{slide}
+}
+
+
+\section{Second Section}
+
+\subsection{A subsection}
+
+\frame
+{
+  \frametitle{A frame created using the \texttt{frame} command.}
+
+  \begin{itemize}[<+->]
+  \item You can still use the original beamer syntax.
+  \item The emulation is intended only to make recycling slides
+    easier, not to install a whole new syntax for beamer.
+  \end{itemize}
+}
+
+\begin{notes}{Notes for these slides}
+My notes for these slides.
+\end{notes}
+
+\end{document}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-prosper.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-seminar.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-seminar.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,331 @@
+% $Header$
+
+% This file is a demonstration on how a seminar file should be
+% changed to make it work with beamer.
+
+
+
+% Except for the changes indicated by CHANGED, this file is the original
+% file semsamp2.tex, which is part of the examples of the seminar
+% package.
+
+
+%% BEGIN semsamp2.tex
+% This is a sample document for seminar.sty, v0.93 (and maybe later).
+%
+% This file contains both landscape and portrait mode slides.
+% Choose one of the following to print them out:
+%  - If using PSTricks, try the semcolor style option.
+%  - If using Rokicki's dvips, try the semrot style option.
+%  - To print the landscape slides, put \landscapeonly in the preamble.
+%    To print the portrait slides, include the portrait style option and
+%    put \portraitonly in the preamble.
+%
+%
+
+% CHANGED: commented the following:
+%\documentstyle[%
+%  slidesonly,%  Try notes or notesonly instead.
+%  %notes,%      Use instead of slidesonly to typeset the notes.
+%  %notesonly,%  Use instead of slidesonly to typeset notes and slides.
+%  %semcolor,%   Try me if using PSTricks.
+%  %semrot,%     Try me if using Rokicki's dvips.
+%  %semhelv,%    Try me if using a PostScript printer.
+%  %article,%    Try me.
+%  %portrait,%   Try me.
+%  %sem-a4,%     Try me if using A4 paper.
+%  semlayer%     This must be included, but you need the semcolor option to
+%  ]{seminar}                                  % actually see the overlays.
+%
+%\slidesmag{5}
+%\articlemag{1}
+%
+%%\twoup                     % Try me for twoup printing.
+%
+%%\portraitonly              % To print only portrait slides
+%%\landscapeonly             % To print only landscape slides
+%
+%%\notslides{\ref{questions}-7,1}   %Try me: The slides are omitted.
+%%\onlyslides{\ref{questions}-7,1}  %Try me: Only these slides are included.
+%%\onlynotestoo                     %Try me: For selecting notes as well.
+%
+%\colorlayers{red,blue}      % Try deleting this if using the semcolor option,
+%                            % to get \blue and \red to use PostScript color.
+%
+%%\overlaysfalse             % Suppress overlays with semcolor option.
+%%\layersfalse               % Suppress color layers with semcolor option.
+%
+%\rotateheaderstrue          % Try this out if using rotation macros.
+
+% CHANGED: Added following three lines:
+\documentclass[ignorenonframetext]{beamer}
+\usepackage[accumulated]{beamerseminar}
+                                % remove accumulated'' option
+                                % for original behaviour
+\usepackage{beamerthemeclassic}
+
+\title{Example for seminar.sty}
+\author{Policarpa Salabarrieta}
+\date{July 21, 1991}
+
+\newcommand{\sref}[1]{SLIDE \ref{#1}}
+
+% CHANGED: different definition of \heading
+
+% CHANGED: Commented:
+%\newpagestyle{MH}%
+%  {University of Guaduas, March 13, 1998\hfil\thepage}{}
+%\pagestyle{MH}
+
+\begin{document}
+
+\frame{
+\maketitle          % This won't show up when \onlynotestoo is in effect.
+}
+
+% CHANGED: Commented
+%\begin{slide}
+%  \ifslidesonly              % Title slide only for slidesonly selection.
+%    \maketitle
+%    \slidepagestyle{empty}
+%  \fi
+%\end{slide}
+
+
+This is a lot of gobbledy-gook intended only to illustrate some of the
+features of seminar.sty.
+
+ The phrase information overload rings a bell with just about anyone.
+Certainly you all receive more working papers or more applications for
+
+ A message like this when you check your email conjures up the notion of
+much information, in some sense or another. But what does too much'' mean?
+(\sref{too_much}, bottom) It might just mean that people cannot process all
+the information they receive. That is certainly true for everyone. A claim
+that is much stronger, and that is implicit when people complain about
+some criterion.
+
+\frame{
+\begin{slide}\label{too_much}%
+\begin{center}
+  \large\bf
+ Information overload = Too much'' information
+\end{center}
+\smallskip
+
+\begin{verse} \bf\tt
+  You have 134 unread messages:\\
+  Do you want to read them now?
+\end{verse}
+
+\begin{enumerate}
+  {\overlay2
+  \item People {\overlay1 cannot process all} the information they receive.}
+  \item People {\em should} receive less information.
+ \end{enumerate}
+\end{slide}
+}
+
+  In this paper, I use the term information overload'' in both senses.
+(\sref{overload}, bottom). Specifically, I say that an {\em individual} is
+process. But I say that there is information overload in a {\em network} if
+there is some mechanism that  makes the senders and/or receivers better off by
+restricting the flow of  information. This latter notion of information
+overload is an equilibrium property, and it depends on what we mean by
+better off.''
+
+\frame{
+\ptsize{12}
+
+\begin{itemize}{\overlay1
+  \item There is information {\overlay0 overload in a network if} there is
+some mechanism that, compared to the {\em status quo}, makes the senders
+and/or receivers better off by restricting the flow} of information.'
+
+  \item There is information overload in a network if there is some mechanism
+that, compared to the {\em status quo}, makes the senders and/or receivers
+better off by restricting the flow of information.
+\end{itemize}
+
+\end{slide*}
+}
+
+(\sref{questions})
+  The purpose of my paper is to show why there can be information overload in
+a network and what kind of mechanisms can make the receivers and/or senders
+better off. Since the cost of communication is one factor that restricts
+communication, I am thus also going to look at how the welfare of the senders
+and receivers depends on the cost of communication.
+
+  Most messages don't become jumbled and we can choose which ones to process.
+But some of us may have a bias towards choosing to process more information
+than we should, like the graduate student who feels compelled to read every
+article on the usual lengthy reading list, and just ends up getting confused
+and ruffling through the papers.
+
+\frame{
+\begin{slide}[7.3in,5.5in] \label{questions}
+
+\begin{itemize}
+  {\overlay1\item When could {\blue there be overload} in networks?}
+  \item What mechanims make the receivers and senders better off?
+  \item How does the welfare {\red of the senders} and receivers depend on the
+cost of communication?
+\end{itemize}
+\end{slide}
+}
+
+However, experiments in consumer research and psychology have failed to find
+that such a bias is prevalent. This is in spite of the fact that it is common
+for stress and cognitive strain to increase with information load. We may
+incur such stress and strain because the information we choose to process is
+valuable to us.
+
+More commonly, then, we can and do choose to process roughly as much
+information as we can handle efficiently. This is called screening. But when
+we choose which messages to begin to process, we're ignorant of their
+contents, since otherwise there would be no reason to process them in the
+first place. Therefore, if we receive more junk mail, then some of the
+important mail gets crowded out, and we are effectively less informed.
+
+
+\frame{
+\begin{slide} \label{informed}
+\begin{center}
+    \smallskip
+  is always better,\par
+    \medskip
+  \overlay1{but it's not the same as \par
+    \smallskip
+\end{center}
+\end{slide}
+}
+
+  Why would the senders communicate too many messages in the first place? If I
+present too much material in this seminar, you have to choose which parts to
+ignore and I would rather make that decision myself, since I know what I most
+want to get across. Thus, it is in my interest not to overload you with
+information. Generally, whenever there is a single sender of messages, that
+sender will prefer to screen rather than have the receiver screen, because the
+sender has an interest in which messages the receiver processes.
+But when there are more senders, one sender's  messages tend to crowd out the
+messages of the other senders, as in this example here. If the senders don't
+take this external cost into account when sending messages, they may
+
+There are several reasons that our scarcity of attention, that is, our limited
+capacity to process information, can mean that we become less informed when we
+(\sref{akbar})
+
+\frame{
+\begin{slide}\label{akbar}\def\slidefuzz{15pt}
+  {\large A tax $\tau$ on communication is said to support
+$\tilde{\cal{X}}(c)$ if $\tilde{\cal{X}}(c)$ is an equilibrium for
+$\Gamma(c+\tau)$.}
+\medskip
+
+ {\bf Proposition 6.} {\em Assume $\tilde{\cal{X}}(c)$ is not an equilibrium
+for $\Gamma(c)$.\vspace{-3pt}
+\begin{enumerate}
+ \item If $\mbox{supp}(\gamma)=[0,1]^n$, there is no tax that supports
+$\tilde{\cal{X}}(c)$.
+ \item If $\mbox{supp}(\gamma)=S^{n-1}$, there is a tax that supports
+$\tilde{\cal{X}}(c)$ if and only if $m=1$, $p_j>c\, \forall j$, and
+   \begin{enumerate}
+     \item $n=2$; or
+     \item $n=3$ and $p_i^{-1}+p_j^{-1}\geq p_k^{-1}$ for all distinct
+$i,j,k$; or
+     \item $n=4$ and $p_1=p_2=p_3=p_4$.
+\end{enumerate}
+\end{enumerate}}
+\end{slide}
+}
+  If, by restricting communication, we eliminate the less relevant messages,
+then we can become more informed. But how can we achieve this? Restricting the
+flow of information shifts the task of screening messages from the receivers
+to the senders. Unlike the receivers, the senders do know the contents of the
+messages they originate. If the senders' interests coincide with those of the
+then the senders will choose the messages which are most relevant to the
+receivers. This may make the receivers, and even the senders, better off.
+
+  The network in Slide \ref{architectures} attains the minimal delay $c(8,24) += 6$ using 8 processors. It is an example of the efficient one-shot networks
+described by Foo. We will focus on a class of networks that are similar to the
+Foo networks but that may differ slightly. For $q$, $c$ and $n$ such that $1 +\leq q \leq \lfloor n/2 \rfloor$ and $c(q,n) \leq c \leq n$, let $R_{nqc}$ be
+the class of essential networks for adding $n$ items using  $q$ processors in
+$c$ cycles that have the following  properties:
+
+\frame{
+\begin{slide*}\label{architectures}
+
+\begin{center}
+\setlength{\unitlength}{1.65in}
+\begin{picture}(1.1,1.6)(3.5,5.0)
+\put(4.0,6.5){\circle*{.04}}
+\put(4.1,6.5){1}
+\put(4.0,6.0){\circle*{.04}}
+\put(4.1,6.0){2}
+\put(4.0,6.1){\vector(0,1){.3}}
+\put(3.5,6.0){\circle*{.04}}
+\put(3.6,6.0){3}
+\put(3.6,6.1){\vector(1,1){.3}}
+\put(4.0,5.5){\circle*{.04}}
+\put(4.1,5.5){4}
+\put(4.0,5.6){\vector(0,1){.3}}
+\put(4.5,6.0){\circle*{.04}}
+\put(4.6,6.0){5}
+\put(4.4,6.1){\vector(-1,1){.3}}
+\put(4.5,5.5){\circle*{.04}}
+\put(4.6,5.5){6}
+\put(4.4,5.6){\vector(-1,1){.3}}
+\put(3.5,5.5){\circle*{.04}}
+\put(3.6,5.5){7}
+\put(3.5,5.6){\vector(0,1){.3}}
+\put(4.0,5.0){\circle*{.04}}
+\put(4.1,5.0){8}
+\put(4.0,5.1){\vector(0,1){.3}}
+\end{picture}
+\end{center}
+\end{slide*}
+}
+
+Why would the senders communicate too many messages in the first place? If I
+present too much material in this seminar, you have to choose which parts to
+ignore and I would rather make that decision myself, since I know what I most
+want to get across. Thus, it is in my interest not to overload you with
+information.
+
+Generally, whenever there is a single sender of messages, that sender will
+prefer to screen rather than have the receiver screen, because the sender has
+an interest in which messages the receiver processes. But when there are more
+senders, one sender's  messages tend to crowd out the messages of the other
+senders, as in this example here. If the senders don't take this external cost
+into account when sending messages, they may collectively overload the
+
+\end{document}
+%% END semsamp2.tex

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-seminar.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-texpower.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-texpower.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,271 @@
+% $Header$
+
+% This file is a demonstration on how a seminar file should be
+% changed to make it work with beamer.
+
+
+
+% Except for the changes indicated by CHANGED, this file is the original
+% file texpower-0.0.9d/doc/seminardemo.tex, which is part of the
+% examples of the texpower package.
+
+
+
+% seminardemo.tex,v 1.2 2002/11/14 20:46:00 hansfn Exp
+%
+% TeXPower bundle - dynamic online presentations with LaTeX
+% Copyright (C) 1999-2002 Stephan Lehmke
+%
+% This program is free software; you can redistribute it and/or
+% modify it under the terms of the GNU General Public License
+%
+% This program 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.  See the
+% GNU General Public License for more details.
+%
+%-----------------------------------------------------------------------------------------------------------------
+% File: seminardemo.tex
+%
+% Simple examples the for combining the seminar class with the dynamic features provided by the package texpower.sty.
+%
+%-----------------------------------------------------------------------------------------------------------------
+% Autor: Stephan Lehmke <Stephan.Lehmke at cs.uni-dortmund.de>
+%
+% v0.0.1 Jun 02, 2000: First version for the pre-alpha release of TeXPower.
+%
+
+
+% CHANGED: commented
+%\documentclass{seminar}
+%
+%% We need fixseminar for setting the page size correctly.
+%
+%\usepackage{fixseminar}
+%
+%
+%%-----------------------------------------------------------------------------------------------------------------
+%% The texpower package is loaded.
+%% We give the display option so dynamic features are enabled.
+%%
+%\usepackage[display]{texpower}
+
+\documentclass[slidestop,usepdftitle=false]{beamer}
+\usepackage[accumulated]{beamerseminar}
+\usepackage{beamertexpower}
+
+
+% CHANGED: Moved \title and \author outside of slide
+\title{The \code{texpower} Package\\ {\normalfont \texttt{seminar} Demo}}
+\author[Stephan Lehmke]{Stephan Lehmke\\\code{mailto:Stephan.Lehmke at cs.uni-dortmund.de}}
+
+\begin{document}
+\begin{slide}
+
+\maketitle
+
+\newslide
+
+\tableofcontents
+\end{slide}
+
+\section{A list environment}
+\frame{
+\begin{slide}
+\centerslidesfalse
+\frametitle{A list environment}
+
+% The \pause command splits' the current page at the place it appears, producing two pages, one with everything which
+% came before the \pause command, one containing this and additionally the stuff coming after \pause. When these pages
+% are presented with acrobar reader in full screen mode (or any other viewer with this capability), the presentation
+% will appear to stop' at the point the \pause command was issued and resume' in the moment the presenter switches to
+% the next page.
+
+\pause
+
+% As \pause forces a paragraph break, it can not be used to separate a description label from the associated text. For
+% this, we use the (very flexible) \stepwise command. Inside the argument of \stepwise, an arbitrary number of \step
+% commands may occur. \stepwise will produce as many pages as there are \step commands, making the arguments of the
+% \step commands appear one by one''.
+
+\stepwise
+{%
+  \begin{description}
+  \item[foo.] \step{bar.}
+  \step{\item[baz.]} \step{qux.}
+  \end{description}
+  }
+
+
+
+\end{slide}
+}
+
+% CHANGED: Added \frame, moved \section out
+\section{An aligned equation}
+\frame{
+\begin{slide}
+\centerslidesfalse
+\frametitle{An aligned equation}
+
+\pause
+
+% Normally for \stepwise, if a \step is not yet active, its argument is ignored completely. This would disturb
+% alignments, because the width changes with every new activated \step.
+% \parstepwise is a variant of \stepwise where the argument of an inactive \step is put into a \phantom, leaving the
+% proper amount of white space.
+
+\parstepwise
+{%
+  % Using eqnarray with equation numbers here means all equation numbers will be visible from the outset, because only
+  % the contents of the lines are filled in'. See the full demo for an example of aligned equations where equation
+  % numbers appear'.
+  \begin{eqnarray}
+    %
+    % When the argument of \step is put into a box (as it happens with \parstepwise), tabulators can not go in there. As
+    % we want the equals sign to appear at the same time as the right side of the equation, we use \restep for the
+    % latter. \restep is like \step, but it appears at the same time as the previous \step command.
+    %
+    \sum_{i=1}^{n} i & \step{=} & \restep{1 + 2 + \cdots + (n-1) + n}\\
+    %
+                     & \step{=} & \restep{1 + n + 2 + (n-1) + \cdots}\\
+    %
+                     & \step{=} & \restep
+                                  {% We can nest \step commands inside each other. The order of execution is just the
+                                   % order of appearance, independent of nesting.
+                                   % \switch is a variant of \step which takes two arguments and toggles between them on
+                                   % activation. This way, we can make the \underbrace appear'.
+                                   % We insert a \vphantom in the first argument so that the equation numbers will be
+                                   % placed correctly whether or not the underbrace is didplayed.
+                                    \switch
+                                    {%
+                                      \vphantom{\underbrace{(1 + n) + \cdots + (1 + n)}_{\times\frac{n}{2}}}%
+                                      (1 + n) + \cdots + (1 + n)%
+                                      }
+                                    {\underbrace{(1 + n) + \cdots + (1 + n)}_{\times\frac{n}{2}}}%
+                                    }
+                                  \\
+    %
+    % This is another nested application of \step. Note that the spacing of \cdot has to be corrected manually by
+    % inserting {} left of it, because otherwise it would behave like a prefix operator.
+    %
+                     & \step{=} & \restep{\frac{(1 + n)\step{{}\cdot n}}{\restep{2}}}
+  \end{eqnarray}
+}
+
+
+
+
+\end{slide}
+}
+
+% CHANGED: Added \frame, moved \section out
+\section{An array}
+\frame{
+\begin{slide}
+  \centerslidesfalse
+  \frametitle{An array}
+
+\stepwise
+{% With arrays, beware of problems with automatic calculation of cell widths.
+ %
+ % If you want all widths to be calculated automatically, you need to use \parstepwise, with the consequence that
+ %   a) tabulators or newlines can not go into the argument of \step,
+ %   b) the array structure' (rules) will be completely visible right from the beginning.
+ %
+ % If you want to use \stepwise for being able to build the structure' (like \hilne's) dynamically (as done in the
+ % following), you have to make sure that the cell widths are correct from the very first line, because otherwise the
+ % array will expand horizontally, destroying the dynamic effect. This can be assured by
+ %   a) using only p cells,
+ %   b) making sure all the cells in the first line are at least as wide as the widest cell which will appear later. If
+ %      you are using the calc package, this is easiest by putting \makebox[\widthof{widest entry}]{first entry} into
+ %      the first cell. Otherwise, you can use \settowidth.
+ %
+  \begin{displaymath}
+    \begin{array}{rrrrr}
+      \step
+      {%
+            n &        \log n        &        n\log n       & \lefteqn{n^2}\phantom{25} & \lefteqn{2^n}\phantom{32} \\
+        \hline%
+        }%
+      \step{0 &} \step{\textrm{---}  &} \step{\textrm{---}  &} \step{0                  &} \step{1                  \\}%
+      \step{1 &} \step{0\phantom{.6} &} \step{0\phantom{.8} &} \step{1                  &} \step{2                  \\}%
+      \step{2 &} \step{1\phantom{.6} &} \step{2\phantom{.8} &} \step{4                  &} \step{4                  \\}%
+      \step{3 &} \step{1.6           &} \step{4.8           &} \step{9                  &} \step{8                  \\}%
+      \step{4 &} \step{2\phantom{.6} &} \step{8\phantom{.8} &} \step{16                 &} \step{16                 \\}%
+      \step{5 &} \step{2.3           &} \step{11.6          &} \step{25                 &} \step{32                   }%
+    \end{array}
+  \end{displaymath}
+}
+
+
+
+
+\end{slide}
+}
+
+% CHANGED: Added \frame, moved \section out
+\section{A picture}
+\frame{
+\begin{slide}
+\centerslidesfalse
+\frametitle{A picture}
+
+\pause
+
+\begin{center}%
+  \stepwise
+  {%
+    \setlength{\unitlength}{1.5\semcm}%
+    \delimitershortfall-1sp% Just for the nested braces
+    \begin{picture}(14,2)
+      \put(0,1){\vector(1,0){1}}
+      \put(0.5,0.5){\makebox(0,0){\small $x(t)$}}
+      \put(13,1){\vector(1,0){1}}
+      \put(13.5,0.5){\makebox(0,0){\small $y(t)$}}
+      \step
+      {
+        \put(1,1){\line(3,2){1.5}}
+        \put(1,1){\line(3,-2){1.5}}
+        \put(2.5,0){\line(0,1){2}}
+        \put(2,1){\makebox(0,0){\large $\varphi$}}
+        }
+      \step
+      {
+        \put(2.5,1){\vector(1,0){3.5}}
+        \put(4.25,0.5){\makebox(0,0){\small $F_t = \varphi\left(x(t)\right)$}}
+        }
+      \step
+      {
+        \put(6,0){\framebox(2,2){\large $\Phi$}}
+        }
+      \step
+      {
+        \put(8,1){\vector(1,0){3.5}}
+        %
+        % Here, we find another nested use of \step inside \step.
+        % \bstep is a variant of \step which _always_ puts its argument into a box for leaving the correct amount of
+        % white space. We cannot use \parstepwise here because \put can't go into a box. Hence, just using \step for
+        % building the nested formula on the next line would give the wrong size for the nested braces.
+        %
+        \put(9.75,0.5){\makebox(0,0){\footnotesize $G_t = \Phi\left(\bstep{\varphi\left(\bstep{x(t)}\right)}\right)$}}
+        }
+      \step
+      {
+        \put(13,1){\line(-3,2){1.5}}
+        \put(13,1){\line(-3,-2){1.5}}
+        \put(11.5,0){\line(0,1){2}}
+        \put(12,1){\makebox(0,0){\large $\delta$}}
+        }
+    \end{picture}%
+    }%
+\end{center}%
+\end{slide}
+}
+\end{document}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerexample-texpower.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerfontthemeexample.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerfontthemeexample.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,21 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\documentclass[hyperref={draft}]{beamer}
+
+\ifx\themename\undefined
+  \def\themename{default}
+\fi
+
+\usefonttheme{\themename}
+
+
+\input{beamerthemeexamplebase}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerfontthemeexample.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerinnerthemeexample.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerinnerthemeexample.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,29 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\documentclass[hyperref={draft}]{beamer}
+
+\ifx\themename\undefined
+  \def\themename{default}
+\fi
+
+\useinnertheme{\themename}
+
+\usecolortheme{seahorse}
+\usecolortheme{rose}
+
+\setbeamercolor*{frametitle}{parent=titlelike}
+\setbeamercolor*{author}{parent=titlelike}
+\setbeamercolor*{date}{parent=titlelike}
+\setbeamercolor*{institute}{parent=titlelike}
+
+
+\input{beamerthemeexamplebase}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerinnerthemeexample.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
(Binary files differ)

Index: trunk/Master/texmf-dist/doc/latex/beamer/beamerlogo.pdf
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerlogo.pdf	2017-12-19 00:07:03 UTC (rev 46094)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerlogo.pdf	2017-12-19 00:09:01 UTC (rev 46095)

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerlogo.pdf
___________________________________________________________________
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerouterthemeexample.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerouterthemeexample.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,21 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\documentclass[hyperref={draft}]{beamer}
+
+\ifx\themename\undefined
+  \def\themename{default}
+\fi
+
+\useoutertheme{\themename}
+\usecolortheme{seahorse}
+
+
+\input{beamerthemeexamplebase}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerouterthemeexample.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerthemeexample.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerthemeexample.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,21 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\documentclass[hyperref={draft}]{beamer}
+
+\ifx\themename\undefined
+  \def\themename{default}
+\fi
+
+\usetheme{\themename}
+
+
+\input{beamerthemeexamplebase}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerthemeexample.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerthemeexamplebase.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerthemeexamplebase.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,53 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\beamertemplatesolidbackgroundcolor{black!5}
+\beamertemplatetransparentcovered
+
+\usepackage{times}
+
+\title{There Is No Largest Prime Number}
+\subtitle{With an introduction to a new proof technique}
+
+\author[Euklid]{Euklid of Alexandria}
+\institute[Univ. Alexandria]{Department of Mathematics\\ University of Alexandria}
+\date[ISPN '80]{27th International Symposium on Prime Numbers, --280}
+
+\begin{document}
+
+\begin{frame}
+  \titlepage
+  \tableofcontents
+\end{frame}
+
+\section{Results}
+\subsection{Proof of the Main Theorem}
+
+\begin{frame}<1>
+  \frametitle{There Is No Largest Prime Number}
+  \framesubtitle{The proof uses \textit{reductio ad absurdum}.}
+
+  \begin{theorem}
+    There is no largest prime number.
+  \end{theorem}
+  \begin{proof}
+    \begin{enumerate}
+      % The strange way of typesetting math is to minimize font usage
+      % in order to keep the file sizes of the examples small.
+    \item<1-| alert at 1> Suppose $p$ were the largest prime number.
+    \item<2-> Let $q$ be the product of the first $p$ numbers.
+    \item<3-> Then $q$\;+\,$1$ is not divisible by any of them.
+    \item<1-> Thus $q$\;+\,$1$ is also prime and greater than $p$.\qedhere
+    \end{enumerate}
+  \end{proof}
+\end{frame}
+
+\end{document}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerthemeexamplebase.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-animations.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-animations.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,517 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2012,2013,2015 by Vedran Mileti\'c, Joseph Wright
+% Copyright 2016 by Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\section{Animations, Sounds, and Slide Transitions}
+
+
+\subsection{Animations}
+
+\subsubsection{Including External Animation Files}
+\label{section-multimedia}
+
+If you have created an animation using some external program (like a renderer), you can use the capabilities of the presentation program (like the Acrobat Reader) to show the animation. Unfortunately, currently there is no portable way of doing this and even the Acrobat Reader does not support this feature on all platforms.
+
+To include an animation in a presentation, you can use, for example, the package |multimedia.sty| which is part of the \beamer\ package. You have to include this package explicitly. Despite being distributed as part of the \beamer\ distribution, this package is perfectly self-sufficient and can be used independently of \beamer.
+
+\begin{package}{{multimedia}}
+  A stand-alone package that implements several commands for including external animation and sound files in a \pdf\ document. The package can be used together with both |dvips| plus |ps2pdf| and |pdflatex|, though the special sound support is available only in |pdflatex|.
+
+  When including this package, you must also include the |hyperref| package. Since you will typically want to include |hyperref| only at the very end of the preamble, |multimedia| will not include |hyperref| itself. However, |multimedia| can be included both before and after |hyperref|. Since \beamer\ includes |hyperref| automatically, you need not worry about this when creating a presentation using \beamer.
+\end{package}
+
+For including an animation in a \pdf\ file, you can use the command |\movie|, which is explained below. Depending on the used options, this command will either setup the \pdf\ file such that the viewer application (like the Acrobat Reader) itself will try to play the movie or that an external program will be called. The latter approach, though much less flexible, must be taken if the viewer application is unable to display the movie itself.
+
+\begin{command}{\movie\oarg{options}\marg{poster text}\marg{movie filename}}
+  This command will insert the movie with the filename \meta{movie filename} into the \pdf\ file. The movie file must reside at some place where the viewer application will be able to find it, which is typically only the directory in which the final \pdf\ file resides. The movie file will \emph{not} be embedded into the \pdf\ file in the sense that the actual movie data is part of the |main.pdf| file. The movie file must hence be copied and passed along with the \pdf\ file. (Nevertheless, one often says that the movie is embedded'' in the document, but that just means that one can click on the movie when viewing the document and the movie will start to play.)
+
+  The movie will use a rectangular area whose size is determined either by the |width=| and |height=| options or by the size of the \meta{poster text}. The \meta{poster text} can be any \TeX\ text; for example, it might be a |\pgfuseimage| command or an |\includegraphics| command or a |pgfpicture| environment or just plain text. The \meta{poster text} is typeset in a box, the box is inserted into the normal text, and the movie rectangle is put exactly over this box. Thus, if the \meta{poster text} is an image from the movie, this image will be shown until the movie is started, when it will be exactly replaced by the movie itself. However, there is also a different, sometimes better, way of creating a poster image, namely by using the |poster| option as explained later on.
+
+  The aspect ratio of the movie will \emph{not} be corrected automatically if the dimension of the \meta{poster text} box does not have the same aspect ratio. Most movies have an aspect ratio of 4:3 or 16:9.
+
+  Despite the name, a movie may consist only of sound with no images. In this case, the \meta{poster text} might be a symbol representing the sound. There is also a different, dedicated command for including sounds in a \pdf\ file, see the |\sound| command in Section~\ref{section-sound}.
+
+  Unless further options are given, the movie will start only when the user clicks on it. Whether the viewer application can actually display the movie depends on the application and the version. For example, the Acrobat Reader up to version~5 does not seem to be able to display any movies or sounds on Linux. On the other hand, the Acrobat Reader Version~6 on MacOS is able to display anything that QuickTime can display, which is just about everything. Embedding movies in a \pdf\ document is provided for by the \pdf\ standard and is not a peculiarity of the Acrobat Reader. In particular, one might expect other viewers like |xpdf| and |poppler|-based viewers (Okular, Evince) to support embedded movies in the future.
+
+  \example
+  |\movie{\pgfuseimage{myposterimage}}{mymovie.avi}|
+
+  \example
+  |\movie[width=3cm,height=2cm,poster]{}{mymovie.mpg}|
+
+  If your viewer application is not able to render your movie, but some external application is, you must use the |externalviewer| option. This will ask the viewer application to launch an application for showing the movie instead of displaying it itself. Since this application is started in a new window, this is not nearly as nice as having the movie displayed directly by the viewer (unless you use evil trickery to suppress the frame of the viewer application). Which application is chosen is left to the discretion of the viewer application, which tries to make its choice according to the extension of the \meta{movie filename} and according to some mapping table for mapping extensions to viewer applications. How this mapping table can be modified depends on the viewer application, please see the release notes of your viewer.
+
+  The following \meta{options} may be given:
+  \begin{itemize}
+  \item
+    \declare{|autostart|}. Causes the movie to start playing immediately when the page is shown. At most one movie can be started in this way. The viewer application will typically be able to show at most one movie at the same time anyway. When the page is no longer shown, the movie immediately stops. This can be a problem if you use the |\movie| command to include a sound that should be played on after the page has been closed. In this case, the |\sound| command must be used.
+  \item
+    \declare{|borderwidth=|}\meta{\TeX\ dimension}. Causes a border of thickness \meta{\TeX\ dimension} to be drawn around the movie. Some versions of the Acrobat Reader seem to have a bug and do not display this border if is smaller than 0.5bp (about 0.51pt).
+  \item
+    \declare{|depth=|}\meta{\TeX\ dimension}. Overrides the depth of the \meta{poster text} box and sets it to the given dimension.
+  \item
+    \declare{|duration=|}\meta{time}|s|. Specifies in seconds how long the movie should be shown. The \meta{time} may be a fractional value and must be followed by the letter |s|. For example, |duration=1.5s| will show the movie for one and a half seconds. In conjunction with the |start| option, you can cut out'' a part of a movie for display.
+  \item
+    \declare{|externalviewer|}. As explained above, this causes an external application to be launched for displaying the movie in a separate window. Most options, like |duration| or |loop|, have no effect since they are not passed along to the viewer application.
+  \item
+    \declare{|height=|}\meta{\TeX\ dimension}. Overrides the height of the \meta{poster text} box and sets it to the given dimension.
+  \item
+    \declare{|label=|}\meta{movie label}. Assigns a label to the movie such that it can later be referenced by the command |\hyperlinkmovie|, which can be used to stop the movie or to show a different part of it. The \meta{movie label} is not a normal label. It should not be too fancy, since it is inserted literally into the \pdf\ code. In particular, it should not contain closing parentheses.
+  \item
+    \declare{|loop|}. Causes the movie to start again when the end has been reached. Normally, the movie just stops at the end.
+  \item
+    \declare{|once|}. Causes the movie to just stop at the end. This is the default.
+  \item
+    \declare{|open|}. Causes the player to stay open when the movie has finished.
+  \item
+    \declare{|palindrome|}. Causes the movie to start playing backwards when the end has been reached, and to start playing forward once more when the beginning is reached, and so on.
+  \item
+    \declare{|poster|}. Asks the viewer application to show the first image of the movie when the movie is not playing. Normally, nothing is shown when the movie is not playing (and thus the box containing the \meta{poster text} is shown). For a movie that does not have any images (but sound) or for movies with an uninformative first image this option is not so useful.
+  \item
+    \declare{|repeat|} is the same as |loop|.
+  \item
+    \declare{|showcontrols=|}\meta{true or false}. Causes a control bar to be displayed below the movie while it is playing. Instead of |showcontrols=true| you can also just say |showcontrols|. By default, no control bar is shown.
+  \item
+    \declare{|start=|}\meta{time}|s|. Causes the first \meta{time} seconds of the movie to be skipped. For example, |start=10s,duration=5s| will show seconds 10 to 15 of the movie, when you play the movie.
+  \item
+    \declare{|width=|}\meta{\TeX dimension} works like the |height| option, only for the width of the poster box.
+  \end{itemize}
+
+  \example
+  The following example creates a background sound'' for the slide.
+
+\begin{verbatim}
+\movie[autostart]{}{test.wav}
+\end{verbatim}
+
+  \example
+  A movie with two extra buttons for showing different parts of the movie.
+
+\begin{verbatim}
+\movie[label=cells,width=4cm,height=3cm,poster,showcontrols,duration=5s]{}{cells.avi}
+
+
+\end{verbatim}
+\end{command}
+
+A movie can serve as the destination of a special kind of hyperlink, namely a hyperlink introduced using the following command:
+
+  Causes the \meta{text} to become a movie hyperlink. When you click on the \meta{text}, the movie with the label \meta{movie label} will start to play (or stop or pause or resume, depending on the \meta{options}). The movie must be on the same page as the hyperlink.
+
+  The following \meta{options} may be given, many of which are the same as for the |\movie| command; if a different option is given for the link than for the movie itself, the option for the link takes precedence:
+  \begin{itemize}
+  \item
+    \declare{|duration=|}\meta{time}|s|. As for |\movie|, this causes the movie to be played only for the given number of seconds.
+  \item
+    \declare{|loop|} and \declare{|repeat|}.  As for |\movie|, this causes the movie to loop.
+  \item
+    \declare{|once|}.  As for |\movie|, this causes the movie to played only once.
+  \item
+    \declare{|palindrome|}.  As for |\movie|, this causes the movie to be played forth and back.
+  \item
+    \declare{|pause|}. Causes the playback of the movie to be paused, if the movie was currently playing. If not, nothing happens.
+  \item
+    \declare{|play|}. Causes the movie to be played from whatever start position is specified. If the movie is already playing, it will be stopped and restarted at the starting position. This is the default.
+  \item
+    \declare{|resume|}. Resumes playback of the movie, if it has previously been paused. If has not been paused, but not started or is already playing, nothing happens.
+  \item
+    \declare{|showcontrols=|}\meta{true or false}. As for |\movie|, this causes a control bar to be shown or not shown during playback.
+  \item
+    \declare{|start=|}\meta{time}|s|. As for |\movie|, this causes the given number of seconds to be skipped at the beginning of the movie if |play| is used to start the movie.
+  \item
+    \declare{|stop|}. Causes the playback of the movie to be stopped.
+  \end{itemize}
+\end{command}
+
+\subsubsection{Animations Created by Showing Slides in Rapid Succession}
+
+You can create an animation in a portable way by using the overlay commands of the \beamer\ package to create a series of slides that, when shown in rapid succession, present an animation. This is a flexible approach, but such animations will typically be rather static since it will take some time to advance from one slide to the next. This approach is mostly useful for animations where you want to explain each picture'' of the animation. When you advance slides by hand,'' that is, by pressing a forward button, it typically takes at least a second for the next slide to show.
+
+More lively'' animations can be created by relying on a capability of the viewer program. Some programs support showing slides only for a certain number of seconds during a presentation (for the Acrobat Reader this works only in full-screen mode). By setting the number of seconds to zero, you can create a rapid succession of slides.
+
+To facilitate the creation of animations using this feature, the following commands can be used: |\animate| and |\animatevalue|.
+
+\begin{command}{\animate\ssarg{overlay specification}}
+  The slides specified by \meta{overlay specification} will be shown as quickly as possible.
+
+  \example
+\begin{verbatim}
+\begin{frame}
+  \frametitle{A Five Slide Animation}
+  \animate<2-4>
+
+  The first slide is shown normally. When the second slide is shown
+  (presumably after pressing a forward key), the second, third, and
+  fourth slides flash by.'' At the end, the content of the fifth
+  slide is shown.
+
+  ... code for creating an animation with five slides ...
+\end{frame}
+\end{verbatim}
+
+  \articlenote
+  This command is ignored in |article| mode.
+\end{command}
+
+\begin{command}{\animatevalue|<|\meta{start slide}|-|\meta{end slide}|>| \marg{name}\marg{start value}\marg{end value}}
+  The \meta{name} must be the name of a counter or a dimension. It will be varied between two values. For the slides in the specified range, the counter or dimension is set to an interpolated value that depends on the current slide number. On slides before the \meta{start slide}, the counter or dimension is set to \meta{start value}; on the slides after the \meta{end slide} it is set to \meta{end value}.
+
+  \example
+\begin{verbatim}
+\newcount\opaqueness
+\begin{frame}
+  \animate<2-10>
+  \animatevalue<1-10>{\opaqueness}{100}{0}
+  \begin{colormixin}{\the\opaqueness!averagebackgroundcolor}
+
+    This text (and all other frame content) will fade out when the
+    second slide is shown. This even works with
+  \end{colormixin}
+\end{frame}
+
+\newcount\opaqueness
+\newdimen\offset
+\begin{frame}
+  \frametitle{Flying Theorems (You Really Shouldn't!)}
+
+  \animate<2-14>
+
+  \animatevalue<1-15>{\opaqueness}{100}{0}
+  \animatevalue<1-15>{\offset}{0cm}{-5cm}
+  \begin{colormixin}{\the\opaqueness!averagebackgroundcolor}
+  \hskip\offset
+    \begin{minipage}{\textwidth}
+      \begin{theorem}
+        This theorem flies out.
+      \end{theorem}
+    \end{minipage}
+  \end{colormixin}
+
+  \animatevalue<1-15>{\opaqueness}{0}{100}
+  \animatevalue<1-15>{\offset}{-5cm}{0cm}
+  \begin{colormixin}{\the\opaqueness!averagebackgroundcolor}
+  \hskip\offset
+    \begin{minipage}{\textwidth}
+      \begin{theorem}
+        This theorem flies in.
+      \end{theorem}
+    \end{minipage}
+  \end{colormixin}
+\end{frame}
+\end{verbatim}
+
+  \articlenote
+  This command is ignored in |article| mode.
+\end{command}
+
+If your animation graphics'' reside in individual external graphic files, you might also consider using the |\multiinclude| command, which is explained in Section~\ref{section-mpmulti}, together with |\animate|. For example, you might create an animation like this, assuming you have created graphic files named |animation.1| through to |animation.10|:
+
+\begin{verbatim}
+\begin{frame}
+  \animate<2-9>
+  \multiinclude[start=1]{animation}
+\end{frame}
+\end{verbatim}
+
+\subsubsection{Including External Animations Residing in Multiple Image Files}
+\label{section-xmpmulti}
+\label{section-mpmulti}
+
+Some animations reside in external files in the following way: For each stage of the animation there is an image file containing an image for this stage. You can include such a series of images conveniently by using the style |mpmulti.sty| from the ppower4 package. This style, written by Klaus Guntermann, introduces a command called |\multiinclude| that takes the base name of a graphic file like |mygraphic| and will then search for files called |mygraphic.0|, |mygraphic.1|, and so on, till no more files are found. It will then include these graphics files using the |\includegraphics| command, but will put these graphics on top of each other.'' Furthermore, and this is the important part, it inserts a |\pause| command after each graphic. This command is defined in the ppower4 package and has the same effect as the |\pause| command of \beamer. For this reason, both ppower4 and also \beamer\ will first display the basic graphic and will then additionally show the next graphic on each slide.
+
+If you try to use |mpmulti.sty| directly, you will run into the problem that it includes a file called |pause.sty|, which is part of the ppower4 package.
+
+You might also consider using the style |xmpmulti.sty| that comes with \beamer. This file is mainly identical to |mpmulti|, except for two differences: First, it does not include |pause.sty|, a style that conceptually clashes with \beamer, although \beamer\ contains a workaround that sidesteps the problem. Second, it extends the |\multiinclude| command by allowing a special default overlay specification to be given. The effect of this is explained below.
+
+\begin{package}{{xmpmulti}}
+  Defines the command |\multiinclude|. The code of this package is due to Klaus Guntermann with some additions of mine. It can be used together with \beamer\ and with ppower4, i.\,e., it can be used as a replacement for |mpmulti| if the |pause| package is also included in a ppower4-presentation.
+\end{package}
+
+\begin{command}{\multiinclude\opt{|[<|\meta{default overlay specification}|>]|}\oarg{options}\marg{base file name}}
+  Except for the possibility of specifying a \meta{default overlay specification}, this command is identical to the |\multiinclude| command from the ppower4 package.
+
+  If no overlay specification is given, the command will search for files called \meta{base file name}|.|\meta{number} for increasing numbers \meta{number}, starting with zero. As long as it finds these files, it issues an |\includegraphics| command on them. The files following the first one are put on top'' of the first one. Between any two invocations of |\includegraphics|, a |\pause| command is inserted. You can modify this behavior in different ways by given suitable \meta{options}, see below.
+
+  \example
+  Assume that MetaPost has created files called |gra.0|, |gra.1|, and |gra.2|. You can then create frame consisting of three slides that incrementally show the graphic as follows:
+
+\begin{verbatim}
+\begin{frame}
+  \multiinclude{gra}
+\end{frame}
+\end{verbatim}
+
+  The effect of providing a \meta{default overlay specification} is the following: First, no |\pause| command is inserted between graphics. Instead, each graphic is surrounded by an |actionenv| environment with the overlay specification set to \meta{default overlay specification}.
+
+  \example
+  You can create the same effect as in the previous example using |\multiinclude[<+->]{gra}|.
+
+  \example
+  For a more interesting usage of the \meta{default overlay specification}, consider the following usage:
+
+\begin{verbatim}
+\end{verbatim}
+
+  This will always paint the most recently added part of the graphic in red (assuming you do not use special colors in the graphic itself).
+
+  \example
+  In order to have each graphic completely \emph{replace} the previous one, you could use |\multiinclude[<+>]{gra}|.
+
+  The following \meta{options} may be given (these are the same as for the original command from the ppower4 package):
+  \begin{itemize}
+  \item
+    \declare{|pause=|\meta{command}} replaces the default pausing command |\pause| by \meta{command}. If a \meta{default overlay specification} is given, the default pausing command is empty; otherwise it is |\pause|. Note that commands like |\pauselevel| are not available in |\beamer|.
+  \item
+    \declare{|graphics=|\meta{options}} passes the \meta{options} to the |\includegraphics| command.
+
+    \example |\multiinclude[graphics={height=5cm}]{gra}|
+  \item
+    \declare{|format=|\meta{extension}} will cause the file names for which we search change from \meta{base file name}|.|\meta{number} to \meta{base file name}|-|\meta{number}|.|\meta{extension}. Note the change from the dot to a hyphen. This option allows you to include, say, |.jpg| files.
+  \item
+    \declare{|start=|\meta{number}} specifies the start \meta{number}. The default is zero.
+  \item
+    \declare{|end=|\meta{number}} specifies the end \meta{number}. The default is infinity.
+  \end{itemize}
+\end{command}
+
+Note that, if you do not use the |format=| option, the |\includegraphics| command will be somewhat at a loss in which format your graphic file actually is. After all, it ends with the cryptic format suffix'' |.0| or |.1|. You can tell |\includegraphics| that any file having a suffix it knows nothing about is actually in format, say, |.mps|, using the following command:
+
+\begin{verbatim}
+\DeclareGraphicsRule{*}{mps}{*}{}
+\end{verbatim}
+
+
+\subsection{Sounds}
+\label{section-sound}
+
+You can include sounds in a presentation. Such sound can be played when you open a slide or when a certain button is clicked. The commands for including sounds are defined in the package |multimedia|, which is introduced in Section~\ref{section-multimedia}.
+
+As was already pointed out in Section~\ref{section-multimedia}, a sound can be included in a \pdf\ presentation by treating it as a movie and using the |\movie| command. While this is perfectly sufficient in most cases, there are two cases where this approach is not satisfactory:
+\begin{enumerate}
+\item
+  When a page is closed, any playing movie is immediately stopped. Thus, you cannot use the |\movie| command to create sounds that persist for a longer time.
+\item
+  You cannot play two movies at the same time.
+\end{enumerate}
+
+The \pdf\ specification introduces special sound objects, which are treated quite differently from movie objects. You can create a sound object using the command |\sound|, which is somewhat similar to |\movie|. There also exists a |\hyperlinksound| command, which is similar to |\hyperlinkmovie|. While it is conceptually better to use |\sound| for sounds, there are a number of things to consider before using it:
+\begin{itemize}
+\item
+  Several sounds \emph{can} be played at the same time. In particular, it is possible to play a general sound in parallel to a (hopefully silent) movie.
+\item
+  A sound playback \emph{can} persist after the current page is closed (though it need not).
+\item
+  The data of a sound file \emph{can} be completely embedded in a \pdf\ file, obliterating the need to carry around'' other files.
+\item
+  The sound objects do \emph{not} work together with |dvips| and |ps2pdf|. They only work with |pdflatex|.
+\item
+  There is much less control over what part of a sound should be played. In particular, no control bar is shown and you can specify neither the start time nor the duration.
+\item
+  A bug in some versions of the Acrobat Reader makes it necessary to provide very exact details on the encoding of the sound file. You have to provide the sampling rate, the number of channels (mono or stereo), the number of bits per sample, and the sample encoding method (raw, signed, Alaw or $\mu$law). If you do not know this data or provide it incorrectly, the sound will be played incorrectly.
+\item
+  It seems that you can only include uncompressed sound data, which can easily become huge. This is not required by the specification, but some versions of Acrobat Reader are unable to play any compressed data. Data formats that \emph{do} work are |.aif| and |.au|.
+\end{itemize}
+
+\begin{command}{\sound\oarg{options}\marg{sound poster text}\marg{sound filename}}
+  This command will insert the sound with the filename \meta{sound filename} into the \pdf\ file. As for |\movie|, the file must be accessible when the sound is to be played. Unlike |\movie|, you can however use the option |inlinesound| to actually embed the sound data in the \pdf\ file.
+
+  Also as for a movie, the \meta{sound poster text} will be be put in a box that, when clicked on, will start playing the movie. However, you might also leave this box empty and only use the |autostart| option. Once playback of a sound has started, it can only be stopped by starting the playback of a different sound or by use of the |\hyperlinkmute| command.
+
+  The supported sound formats depend on the viewer application. Some versions of Acrobat Reader support |.aif| and |.au|. Sometimes you also need to specify information like the sampling rate, even though this information could be extracted from the sound file and even though the \pdf\ standard specifies that the viewer application should do so. In this regard, some versions of Acrobat Reader seem to be non-standard-conforming.
+
+  This command only works together with |pdflatex|. If you use |dvips|, the poster is still shown, but clicking it has no effect and no sound is embedded in any way.
+
+  \example
+  |\sound[autostart,samplingrate=22050]{}{applause.au}|
+
+  The following \meta{options} may be given:
+  \begin{itemize}
+  \item
+    \declare{|autostart|}. Causes the sound to start playing immediately when the page is shown.
+  \item
+    \declare{|automute|}. Causes all sounds to be muted when the current page is left.
+  \item
+    \declare{|bitspersample=|}\meta{8 or 16}. Specifies the number of bits per sample in the sound file. If this number is 16, this option need not be specified.
+  \item
+    \declare{|channels=|}\meta{1 or 2}. Specifies whether the sound is mono or stereo. If the sound is mono, this option need not be specified.
+  \item
+    \declare{|depth=|}\meta{\TeX\ dimension}. Overrides the depth of the \meta{sound poster text} box and sets it to the given dimension.
+  \item
+    \declare{|encoding=|}\meta{method}. Specifies the encoding method, which may be |Raw|, |Signed|, |muLaw|, or |ALaw|. If the method is |muLaw|, this option need not be specified.
+  \item
+    \declare{|height=|}\meta{\TeX\ dimension}. Overrides the height of the \meta{sound poster text} box and sets it to the given dimension.
+  \item
+    \declare{|inlinesound|} causes the sound data to be stored directly in the \pdf-file.
+  \item
+    \declare{|label=|}\meta{sound label}. Assigns a label to the sound such that it can later be referenced by the command |\hyperlinksound|, which can be used to start a sound. The \meta{sound label} is not a normal label.
+  \item
+    \declare{|loop|} or \declare{|repeat|}. Causes the sound to start again when the end has been reached.
+  \item
+    \declare{|mixsound=|}\meta{true or false}. If set to |true|, the sound is played in addition to any sound that is already playing. If set to |false| all other sounds (though not sound from movies) are stopped before the sound is played. The default is |false|.
+  \item
+    \declare{|samplingrate=|}\meta{number}. Specifies the number of samples per second in the sound file. If this number is 44100, this option need not be specified.
+  \item
+    \declare{|width=|}\meta{\TeX\ dimension} works like the |height| option, only for the width of the poster box.
+  \end{itemize}
+
+  \example
+  The following example creates a background sound'' for the slide, assuming that |applause.au| is encoded correctly (44100 samples per second, mono, $\mu$law encoded, 16 bits per sample).
+
+\begin{verbatim}
+\sound[autostart]{}{applause.au}
+\end{verbatim}
+\end{command}
+
+Just like movies, sounds can also serve as  destinations of special sound hyperlinks.
+
+  Causes the \meta{text} to become a sound hyperlink. When you click on the \meta{text}, the sound with the label \meta{sound label} will start to play.
+
+  The following \meta{options} may be given:
+  \begin{itemize}
+  \item
+    \declare{|loop|} or \declare{|repeat|}. Causes the sound to start again when the end has been reached.
+  \item
+    \declare{|mixsound=|}\meta{true or false}. If set to |true|, the sound is played in addition to any sound that is already playing. If set to |false| all other sounds (though not sound from movies) are stopped before the sound is played. The default is |false|.
+  \end{itemize}
+\end{command}
+
+Since there is no direct way of stopping the playback of a sound, the following command is useful:
+
+  Causes the \meta{text} to become a hyperlink that, when clicked, stops the playback of all sounds.
+\end{command}
+
+
+\subsection{Slide Transitions}
+
+\pdf\ in general, and the Acrobat Reader in particular, offer a standardized way of defining \emph{slide transitions}. Such a transition is a visual effect that is used to show the slide. For example, instead of just showing the slide immediately, whatever was shown before might slowly dissolve'' and be replaced by the slide's content.
+
+There are a number of commands that can be used to specify what effect should be used when the current slide is presented. Consider the following example:
+\begin{verbatim}
+\frame{\pgfuseimage{youngboy}}
+\frame{
+  \transdissolve
+  \pgfuseimage{man}
+}
+\end{verbatim}
+The command |\transdissolve| causes the slide of the second frame to be shown in a dissolved way.'' Note that the dissolving is a property of the second frame, not of the first one. We could have placed the command anywhere on the frame.
+
+The transition commands are overlay-specification-aware. We could collapse the two frames into one frame like this:
+\begin{verbatim}
+\begin{frame}
+  \only<1>{\pgfuseimage{youngboy}}
+  \only<2>{\pgfuseimage{man}}
+  \transdissolve<2>
+\end{frame}
+\end{verbatim}
+This states that on the first slide the young boy should be shown, on the second slide the old man should be shown, and when the second slide is shown, it should be shown in a dissolved way.''
+
+In the following, the different commands for creating transitional effects are listed. All of them take an optional argument that may contain a list of \meta{key}|=|\meta{value} pairs. The following options are possible:
+\begin{itemize}
+\item
+  |duration=|\meta{seconds}. Specifies the number of \meta{seconds} the transition effect needs. Default is one second, but often a shorter one (like 0.2 seconds) is more appropriate. Viewer applications, especially Acrobat, may interpret this option in slightly strange ways.
+\item
+  |direction=|\meta{degree}. For directed'' effects, this option specifies the effect's direction. Allowed values are |0|, |90|, |180|, |270|, and for the glitter effect also |315|.
+\end{itemize}
+
+\articlenote
+All of these commands are ignored in |article| mode.
+
+\begin{command}{\transblindshorizontal\sarg{overlay specification}\oarg{options}}
+  Show the slide as if horizontal blinds were pulled away.
+  \example|\transblindshorizontal|
+\end{command}
+
+\begin{command}{\transblindsvertical\sarg{overlay specification}\oarg{options}}
+  Show the slide as if vertical blinds were pulled away.
+  \example|\transblindsvertical<2,3>|
+\end{command}
+
+\begin{command}{\transboxin\sarg{overlay specification}\oarg{options}}
+  Show the slide by moving to the center from all four sides.
+  \example|\transboxin<1>|
+\end{command}
+
+\begin{command}{\transboxout\sarg{overlay specification}\oarg{options}}
+  Show the slide by showing more and more of a rectangular area that is centered on the slide center.
+  \example|\transboxout|
+\end{command}
+
+\begin{command}{\transcover\sarg{overlay specification}\oarg{options}}
+  Show the slide by covering the content that was shown before.
+  \example|\transcover|
+\end{command}
+
+\begin{command}{\transdissolve\sarg{overlay specification}\oarg{options}}
+  Show the slide by slowly dissolving what was shown before.
+  \example|\transdissolve[duration=0.2]|
+\end{command}
+
+  Show the slide by slowly fading what was shown before.
+\end{command}
+
+\begin{command}{\transglitter\sarg{overlay specification}\oarg{options}}
+  Show the slide with a glitter effect that sweeps in the specified direction.
+  \example|\transglitter<2-3>[direction=90]|
+\end{command}
+
+\begin{command}{\transpush\sarg{overlay specification}\oarg{options}}
+  Show the slide by pushing what was shown before off the screen using
+  the new content.
+  \example|\transpush|
+\end{command}
+
+\begin{command}{\transreplace\sarg{overlay specification}\oarg{options}}
+  Replace the previous slide directly (default behaviour).
+\end{command}
+
+\begin{command}{\transsplitverticalin\sarg{overlay specification}\oarg{options}}
+  Show the slide by sweeping two vertical lines from the sides inward.
+  \example|\transsplitverticalin|
+\end{command}
+
+\begin{command}{\transsplitverticalout\sarg{overlay specification}\oarg{options}}
+  Show the slide by sweeping two vertical lines from the center outward.
+  \example|\transsplitverticalout|
+\end{command}
+
+\begin{command}{\transsplithorizontalin\sarg{overlay specification}\oarg{options}}
+  Show the slide by sweeping two horizontal lines from the sides inward.
+  \example|\transsplithorizontalin|
+\end{command}
+
+\begin{command}{\transsplithorizontalout\sarg{overlay specification}\oarg{options}}
+  Show the slide by sweeping two horizontal lines from the center outward.
+  \example|\transsplithorizontalout|
+\end{command}
+
+\begin{command}{\transwipe\sarg{overlay specification}\oarg{options}}
+  Show the slide by sweeping a single line in the specified direction, thereby wiping out'' the previous contents.
+  \example|\transwipe[direction=90]|
+\end{command}
+
+You can also specify how \emph{long} a given slide should be shown, using the following overlay-specification-aware command:
+\begin{command}{\transduration\sarg{overlay specification}\marg{number of seconds}}
+  In full screen mode, show the slide for \meta{number of seconds}. If zero is specified, the slide is shown as short as possible. This can be used to create interesting pseudo-animations.
+  \example|\transduration<2>{1}|
+  Notice that the \emph{duration} of a slide transition is entire separate from the \emph{type} of transition which takes place. Most notably, to cancel an existing auto-advance you need to use
+  \example|\transduration{}|
+possibly with an overlay specification.
+\end{command}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-animations.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-color.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-color.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,548 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2012,2013,2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\section{Colors}
+
+\label{section-colors}
+
+\beamer's color management allows you to specify the color of every element (like, say, the color of the section entries in a table of contents or, say, the color of the subsection entries in a mini table of contents in a sidebar). While the system is quite powerful, it is not trivial to use. To simplify the usage of the color system, you should consider using a predefined color theme, which takes care of everything for you.
+
+In the following, color themes are explained first. The rest of the section consists of explanations of how the color management works internally. You will need to read these sections only if you wish to write your own color themes; or if you are quite happy with the predefined themes but you absolutely insist that displayed mathematical text simply has to be typeset in a lovely pink.
+
+
+\subsection{Color Themes}
+
+In order to also show the effect of the different color themes on the sidebar, in the following examples the color themes are used together with the outer theme |sidebar|.
+
+\subsubsection{Default and Special-Purpose Color Themes}
+
+\begin{colorthemeexample}{default}
+  The |default| color theme is very sober. It installs little special colors and even less backgrounds. The default color theme sets up the default parent relations between the different \beamer-colors.
+
+  The main colors set in the |default| color theme are the following:
+  \begin{itemize}
+  \item
+    |normal text| is black on white.
+  \item
+  \item
+    |example text| is a dark green (green with 50\% black).
+  \item
+    |structure| is set to a light version of MidnightBlue (more precisely, 20\% red, 20\% green, and 70\% blue).
+  \end{itemize}
+  Use this theme for a no-nonsense presentation. Since this theme is loaded by default, you cannot reload'' it after having loaded another color theme.
+\end{colorthemeexample}
+
+\begin{colorthemeexample}[\oarg{options}]{structure}
+  The example was created using |\usecolortheme[named=SeaGreen]{structure}|.
+
+  This theme offers a convenient way of changing the color used for structural elements. More precisely, it just changes the foreground of the \beamer-color |structure|. You can also achieve this by directly invoking the function |\setbeamercolor|, but this color theme makes things a bit easier.
+
+  The theme offers several \meta{options}, which can be used to specify the color to be used for structural elements:
+  \begin{itemize}
+  \item
+    \declare{|rgb=|\marg{rgb tuple}} sets the |structure| foreground to the specified red-green-blue tuple. The numbers are given as decimals between 0 and 1. For example, |rgb={0.5,0,0}| yields a dark red.
+  \item
+    \declare{|RGB=|\marg{rgb tuple}} does the same as |rgb|, except that the numbers range between 0 and 255. For example, |RGB={128,0,0}|  yields a dark red.
+  \item
+    \declare{|cmyk=|\marg{cmyk tuple}} sets the |structure| foreground to the specified cyan-magenta-yellow-black tuple. The numbers are given as decimals between 0 and 1. For example, |cmyk={0,1,1,0.5}| yields a dark red.
+  \item
+    \declare{|cmy=|\marg{cmy tuple}} is similar to |cmyk|, except that the black component is not specified.
+  \item
+    \declare{|hsb=|\marg{hsb tuple}}  sets the |structure| foreground to the specified hue-saturation-brightness tuple. The numbers are given as decimals between 0 and 1. For example, |hsb={0,1,.5}| yields a dark red.
+  \item
+    \declare{|named=|\marg{color name}} sets the |structure| foreground to a named color. This color must previously have been defined using the |\DefineNamedColor| command. Adding the class option |xcolor=dvipsnames| or |xcolor=svgnames| will install a long list of standard |dvips| or SVG color names (respectively). See the file |dvipsnam.def| for the list.
+  \end{itemize}
+\end{colorthemeexample}
+
+\begin{colorthemeexample}{sidebartab}
+  This theme changes the colors in a sidebar such that the current entry in a table of contents shown there gets highlighted by showing a different background behind it.
+\end{colorthemeexample}
+
+\subsubsection{Complete Color Themes}
+
+A complete'' color theme is a color theme that completely specifies all colors for all parts of a frame. It installs specific colors and does not derive the colors from, say, the |structure| \beamer-color. Complete color themes happen to have names of flying animals.
+
+\begin{colorthemeexample}{albatross}
+  The color theme is a dark'' or inverted'' theme using yellow on blue as the main colors. The color theme also installs a slightly darker background color for blocks, which is necessary for presentation themes that use shadows, but which (in Till's opinion) is undesirable for all other presentation themes. By using the |lily| color theme together with this theme, the backgrounds for blocks can be removed.
+
+  When using a light-on-dark theme like this one, be aware that there are certain disadvantages:
+  \begin{itemize}
+  \item
+    If the room in which the talk is given has been darkened,'' using such a theme makes it more difficult for the audience to take or read notes.
+  \item
+    Since the room becomes darker, the pupil becomes larger, thus making it harder for the eye to focus. This \emph{can} make text harder to read.
+  \item
+    Printing such slides is difficult at best.
+  \end{itemize}
+
+  On the other hand, a light-on-dark presentation often appears to be more stylish'' than a plain black-on-white one.
+
+  The following \meta{options} may be given:
+  \begin{itemize}
+  \item
+    \declare{|overlystylish|} installs a background canvas that is, in Till's opinion, way too stylish. But then, it is not his intention to press his taste on other people. When using this option, it is probably a very good idea to also use the |lily| color theme.
+  \end{itemize}
+
+  \example
+  The |overlystylish| option together with the |lily| color theme: \genericthemeexample{colorthemealbatrossstylish}
+\end{colorthemeexample}
+
+\begin{colorthemeexample}{beetle}
+  The main theme behind this theme'' is to use white and black text on gray background. The white text is used for special emphasis, the black text for normal text. The outer stuff'' like the headline and the footline use, however, a bluish color. To change this color, change the background of |palette primary|.
+
+  Great care must be taken with this theme since both the white/gray and the black/gray contrasts are much lower than with other themes. Make sure that the contrast is high enough for the actual presentation.
+
+  You can change the grayish'' background by changing the background of |normal text|.
+\end{colorthemeexample}
+
+\begin{colorthemeexample}{crane}
+  This theme uses the colors of Lufthansa, whose logo is a crane. It is \emph{not} an official theme by that company, however.
+\end{colorthemeexample}
+
+\begin{colorthemeexample}{dove}
+  This theme is nearly a black and white theme and useful for creating presentations that are easy to print on a black-and-white printer. The theme uses grayscale in certain unavoidable cases, but never color. It also changes the font of alerted text to boldface.
+
+  When using this theme, you should consider using the class option |gray|, which ensures that all colors are converted to grayscale. Also consider using the |structurebold| font theme.
+\end{colorthemeexample}
+
+\begin{colorthemeexample}{fly}
+  This theme is the consequent'' version of |beetle| and uses white/black/gray throughout. It does not go particularly well with themes that use shadows.
+\end{colorthemeexample}
+
+\begin{colorthemeexample}{monarca}
+  The theme is based on the colors of the Monarch butterfly.
+
+  \themeauthor Max Dohse.
+\end{colorthemeexample}
+
+\begin{colorthemeexample}{seagull}
+  Like the |dove| color theme, this theme is useful for printing on a black-and-white printer. However, it uses different shades of gray extensively, which may or may not look good on a transparency.
+\end{colorthemeexample}
+
+\begin{colorthemeexample}{wolverine}
+  The theme is based on the colors of the University of Michigan's mascot, a wolverine.
+
+\end{colorthemeexample}
+
+\begin{colorthemeexample}{beaver}
+  The theme is based on the colors of MIT's mascot, a beaver.
+
+\end{colorthemeexample}
+
+\begin{colorthemeexample}{spruce}
+  The theme is based on the colors of Michigan State University.
+
+  \themeauthor Alan Munn.
+\end{colorthemeexample}
+
+\subsubsection{Inner Color Themes}
+
+Inner color themes only specify the colors of elements used in inner themes. Most noticably, they specify the colors used for blocks. They can be used together with other (color) themes. If they are used to change the inner colors installed by a presentation theme or another color theme, they should obviously be specified \emph{after} the other theme has been loaded. Inner color themes happen to have flower names.
+
+\begin{colorthemeexample}{lily}
+  This theme is mainly used to \emph{uninstall} any block colors setup by another theme, restoring the colors used in the |default| theme. In particular, using this theme will remove all background colors for blocks.
+\end{colorthemeexample}
+
+\begin{colorthemeexample}{orchid}
+  This theme installs white-on-dark block titles. The background of the title of a normal block is set to the foreground of the structure color, the foreground is set to white. The background of alerted blocks are set to red and of example blocks to green. The body of blocks get a nearly transparent background.
+\end{colorthemeexample}
+
+\begin{colorthemeexample}{rose}
+  This theme installs nearly transparent backgrounds for both block titles and block bodies. This theme is much less aggressive'' than the |orchid| theme. The background colors are derived from the foreground of the structure \beamer-color.
+\end{colorthemeexample}
+
+\subsubsection{Outer Color Themes}
+
+An outer color theme changes the palette colors, on which the colors used in the headline, footline, and sidebar are based by default. Outer color themes normally do not change the color of inner elements, except possibly for |titlelike|. They happen to be sea-animal names.
+
+\begin{colorthemeexample}{whale}
+  Installs a white-on-dark palette for the headline, footline, and sidebar. The backgrounds used there are set to shades between the structure \beamer-color and black. The foreground is set to white.
+
+  While this color theme can appear to be aggressive, you should note that a dark bar at the border of a frame will have a somewhat different appearance during a presentation than it has on paper: During a presentation the projection on the wall is usually surrounded by blackness. Thus, a dark bar will not create a contrast as opposed to the way it does on paper. Indeed, using this theme will cause the main part of the frame to be more at the focus of attention.
+
+  The counterpart to the theme with respect to blocks is the |orchid| theme. However, pairing it with the |rose| color theme is also interesting.
+\end{colorthemeexample}
+
+\begin{colorthemeexample}{seahorse}
+  Installs a near-transparent backgrounds for the headline, footline, and sidebar. Using this theme will cause navigational elements to be much less dominant'' than when using the |whale| theme (see the discussion on contrast there, though).
+
+  It goes well with the |rose| or the |lily| color theme. Pairing it with the |orchid| overemphasizes blocks (in Till's opinion).
+\end{colorthemeexample}
+
+\begin{colorthemeexample}{dolphin}
+  A color theme somewhere in the middle between the whale and the seahorse. It was graciously donated by Manuel Carro. Like the seahorse, it goes well with the |rose| and the |lily| color theme.
+\end{colorthemeexample}
+
+
+\subsection{Changing the Colors Used for Different Elements of a Presentation}
+
+This section explains how \beamer's color management works.
+
+\subsubsection{Overview of Beamer's Color Management}
+
+In \beamer's philosophy, every element of a presentation can have a different color. Unfortunately, it turned out that simply assigning a single color to every element of a presentation is not such a good idea. First of all, we sometimes want colors of elements to change during a presentation, like the color of the item indicators when they become alerted or inside an example block. Second, some elements naturally have two colors, namely a foreground and a background, but not always. Third, sometimes elements somehow should not have any special color but should simply run along'' with the color of their surrounding. Finally, giving a special color to every element makes it very hard to globally change colors (like changing all the different kind-of-blue things into kind-of-red things) and it makes later extensions even harder.
+
+For all these reasons, the color of an element in \beamer\ is a structured object, which we call a \emph{\beamer-color}. Every \beamer-color has two parts: a foreground and a background. Either of these may be empty,'' which means that whatever foreground or background was active before should remain active when the color is used.
+
+\beamer-colors can \emph{inherit} from other \beamer-colors and the default themes make extensive use of this feature. For example, there is a \beamer-color called |structure| and all sorts of elements inherit from this color. Thus, if someone changes |structure|, the color of all these elements automatically change accordingly. When a color inherits from another color, it can nevertheless still override only the foreground or the background.
+
+It is also possible to inherit'' from another \beamer-color in a more sophisticated way, which is more like \emph{using} the other \beamer-color in an indirect way. You can specify that, say, the background of the title should be a 90\% of the background of normal text and 10\% of the foreground of |structure|.
+
+Inheritance and using of other \beamer-colors is done dynamically. This means that if one of the parent \beamer-colors changes during the presentation, the derived colors automatically also change.
+
+The default color theme, which is always loaded, installs numerous \beamer-colors and inheritance relations between them. These colors are explained throughout this guide. The color used for, say, frametitles is discussed in the section on frametitles, and so on.
+
+\subsubsection{Using Beamer's Colors}
+
+A \beamer-color is not a normal color as defined by the |color| and |xcolor| packages and, accordingly, cannot be used directly as in commands like |\color| or |\colorlet|. Instead, in order to use a \beamer-color, you should first call the command |\usebeamercolor|, which is explained below. This command will setup two (normal) colors called |fg| (for foreground) and |bg| (for, well, guess what). You can then say |\color{fg}| to install the foreground color and |\color{bg}| to install the background color. You can also use the colors |fg| and |bg| in any context in which you normally use a color like, say, |red|. If a \beamer-color does not have a foreground or a background, the colors |fg| or |bg| (or both) remain unchanged.
+
+Inside templates, this command will typically have already been called for you with the option |[fg]|.
+
+\begin{command}{\usebeamercolor\opt{|*|}\oarg{fg or bg}\marg{beamer-color name}}
+  This command (possibly) changes the two colors |fg| and |bg| to the foreground and background color of the \meta{beamer-color name}. If the \beamer-color does not specify a foreground, |fg| is left unchanged; if does not specify a background, |bg| is left unchanged.
+
+  You will often wish to directly use the color |fg| or |bg| after using this command. For this common situation, the optional argument \meta{fg or bg} is useful, which may be either |fg| or |bg|. Giving this option will cause the foreground |fg| or the background |bg| to be immediately installed after they have been setup. Thus, the following command
+
+\begin{verbatim}
+\usebeamercolor[fg]{normal text}
+\end{verbatim}
+  is a shortcut for
+\begin{verbatim}
+\usebeamercolor{normal text}
+\color{fg}
+\end{verbatim}
+
+  If you use the starred version of this command, the \beamer-color |normal text| is used before the command is invoked. This ensures that, barring evil trickery, the colors |fg| and |bg| will be setup independently of whatever colors happened to be in use when the command is invoked.
+
+  This command has special side-effects. First, the (normal) color |parent.bg| is set to the value of |bg| prior to this call. Thus you can access the color that was in use prior to the call of this command via the color |parent.bg|.
+
+  Second, the special color \meta{beamer-color name}|.fg| is \emph{globally} set to the same value as |fg| and \meta{beamer-color name}|.bg| is globally set to the value of |bg|. This allows you to access the foreground or background of a certain \meta{beamer-color name} after another \beamer-color has been used. However, referring to these special global colors should be kept to the unavoidable minimum and should be done as locally as possible since a change of the \beamer-color will not reflect in a change of the colors \meta{beamer-color name}|.fg| and \meta{beamer-color name}|.bg| until the next invocation of |\usebeamercolor|. Also, if the \meta{beamer-color name} does not specify a foreground or a background color, then the values of the special colors are whatever happened to be the foreground or background at the time of the last invocation of |\usebeamercolor|.
+
+  So, try not to get into the habit of writing |\color{structure.fg}| all the time, at least not without a |\usebeamercolor{structure}| close by.
+
+  \example
+\begin{verbatim}
+  following box uses the fore- and background of frametitles:
+  {
+    \usebeamercolor[fg]{frametitle}
+    \colorbox{bg}{Frame Title}
+  }
+\end{verbatim}
+
+  \articlenote
+  This command has no effect in |article| mode.
+\end{command}
+
+
+\begin{command}{\ifbeamercolorempty\oarg{fg or bg}\marg{beamer-color name}\marg{if undefined}\marg{if defined}}
+  This command can be used to check whether the foreground or background of some \meta{beamer-color name} is non-empty. If the foreground or background of \meta{beamer-color name} is defined, \meta{if defined} will be executed, otherwise the \meta{if undefined} code.
+
+  \example
+\begin{verbatim}
+\ifbeamercolorempty[bg]{frametitle}
+{ % Transparent background''
+  \usebeamercolor[fg]{frametitle}
+  \insertframetitle
+}
+{ % Opaque background
+  \usebeamercolor[fg]{frametitle}
+  \colorbox{bg}{\insertframetitle}
+}
+\end{verbatim}
+\end{command}
+
+\subsubsection{Setting Beamer's Colors}
+
+To set or to change a \beamer-color, you can use the command |\setbeamercolor|.
+
+\begin{command}{\setbeamercolor\opt{|*|}\marg{beamer-color name}\marg{options}}
+  Sets or changes a \beamer-color. The \meta{beamer-color name} should be a reasonably simple text (do not try too much trickery and avoid punctuation symbols), but it may contain spaces. Thus, |normal text| is a valid \meta{beamer-color name} and so is |My Color Number 2|.
+
+  In the most simple case, you just specify a foreground by giving the |fg=| option and, possibly, also a background using the |bg=| option.
+
+  \example |\setbeamercolor{normal text}{fg=black,bg=mylightgrey}|
+
+  The effect of this command is accumulative, thus the following two commands
+
+\begin{verbatim}
+\setbeamercolor{section in toc}{fg=blue}
+\setbeamercolor{section in toc}{bg=white}
+\end{verbatim}
+  have the same effect as
+\begin{verbatim}
+\setbeamercolor{section in toc}{fg=blue,bg=white}
+\end{verbatim}
+
+  Naturally, a second call with the same kind of \meta{option} set to a different value overrides a previous call.
+
+  The starred version first resets everything, thereby switching off'' the accumulative effect. Use this starred version to completely reset the definition of some \beamer-color.
+
+  The following \meta{options} may be given:
+  \begin{itemize}
+  \item
+    \declare{|fg=|\meta{color}} sets the foreground color of \meta{beamer-color name} to the given (normal)   \meta{color}. The \meta{color} may also be a color expression like |red!50!black|, see the manual of the \textsc{xcolor} package. If \meta{color} is empty, the \meta{beamer-color name} has no special foreground'' and when the color is used, the foreground currently in force should not be changed.
+
+    Specifying a foreground this way will override any inherited foreground color.
+  \item
+    \declare{|bg=|\meta{color}} does the same as the |fg| option, but for the background.
+  \item
+    \declare{|parent=|\meta{parent beamer-color(s)}} specifies that \meta{beamer-color name} should inherit from the specified \meta{parent beamer-color(s)}. Any foreground and/or background color set by the parents will also be used when \meta{beamer-color name} is used. If multiple parents specify a foreground, the last one wins''; and likewise for the backgrounds.
+
+    \example
+\begin{verbatim}
+\setbeamercolor{father}{fg=red}
+\setbeamercolor{mother}{bg=green}
+\setbeamercolor{child}{parent={father,mother}}
+\begin{beamercolorbox}{child}
+  Terrible red on green text.
+\end{beamercolorbox}
+
+\setbeamercolor{father}{fg=blue}
+\begin{beamercolorbox}{child}
+  Now terrible blue on green text, since parent was changed.
+\end{beamercolorbox}
+\end{verbatim}
+
+    Note that a change of the foreground or background of a parent changes the corresponding foreground or background of the child (unless it is overruled).
+
+    A \beamer-color can not only have parents, but also grandparents and so on.
+  \item
+    \declare{|use=|\meta{another beamer-color}} is used to make sure that another \beamer-color is setup correctly before the foreground or background color specification are evaluated.
+
+    Suppose you wish the foreground of items to be a mixture of 50\% of the foreground of structural elements and 50\% of the normal foreground color. You could try
+
+\begin{verbatim}
+\setbeamercolor{item}{fg=structure.fg!50!normal text.fg}
+\end{verbatim}
+
+    However, this will not necessarily give the desired result: If the \beamer-color |structure| changes, the (normal) color |structure.fg| is not immediately updated. In order to ensure that the normal color |structure.fg| is correct, use the following:
+
+\begin{verbatim}
+\setbeamercolor{item}{use={structure,normal text},fg=structure.fg!50!normal text.fg}
+\end{verbatim}
+
+    This will guarantee that the colors |structure.fg| and |normal text.fg| are setup correctly when the foreground of |item| is computed.
+
+    To show the difference, consider the following example:
+
+\begin{verbatim}
+\setbeamercolor{grandfather}{fg=red}
+\setbeamercolor{grandmother}{bg=white}
+\setbeamercolor{father}{parent={grandfather,grandmother}}
+\setbeamercolor{mother}{fg=black}
+{
+  \usebeamercolor{father}\usebeamercolor{mother}
+  %% Defines father.fg and mother.fg globally
+}
+\setbeamercolor{my color A}{fg=father.fg!50!mother.fg}
+\setbeamercolor{my color B}{use={father,mother},fg=father.fg!50!mother.fg}
+
+{\usebeamercolor[fg]{my color A} dark red text}
+{\usebeamercolor[fg]{my color B} also dark red text}
+
+\setbeamercolor{grandfather}{fg=green}
+
+{\usebeamercolor[fg]{my color A} still dark red text}
+{\usebeamercolor[fg]{my color B} now dark green text}
+\end{verbatim}
+  \end{itemize}
+\end{command}
+
+
+\subsection{The Color of Mathematical Text}
+
+By default, mathematical text does not have any special color---it just inherits the surrounding'' color. Some people prefer mathematical text to have some special color. Though we do not recommend this (we believe mathematical text should \emph{not} stand out amid the normal text), \beamer\ makes it (reasonably) easy to change the color of mathematical text. Simply change the following colors:
+
+\begin{element}{math text}\no\yes\no
+  This color is the parent of |math text inlined| and |math text displayed|. It is empty by default. See those colors for details.
+\end{element}
+
+\begin{element}{math text inlined}\no\yes\no
+  \colorparents{math text}
+  If the foreground of this color is set, inlined mathematical text is typeset using this color. This is done via some |\everymath| hackery and may not work in all cases. If not, you'll have to try to find a way around the problem. The background is currently ignored.
+\end{element}
+
+\begin{element}{math text displayed}\no\yes\no
+  \colorparents{math text}
+  Like |math text inlined|, only for so-called displayed'' mathematical text. This is mathematical text between |$| and |$| or between |$$| and |$$| or inside environments like |equation| or |align|. The setup of this color is somewhat fragile, use at your own risk. The background is currently ignored.
+\end{element}
+
+\begin{element}{normal text in math text}\no\yes\no
+  If the foreground of this color is set, normal text inside mathematical text (which is introduced using the |\text| command) will be typeset using this color. The background is currently ignored.
+\end{element}
+
+
+\subsection{The Color Palettes}
+
+When one designs a color theme, one faces the following problem: Suppose we want the colors in the headline to gradually change from black to, say, blue. Whatever is at the very top of the headline should be black, what comes right below it should be dark blue, and at the bottom of the headline things should just be blue. Unfortunately, different outer themes will put different things at the top. One theme might put the author at the top, another theme might put the document title there. This makes it impossible to directly assign one of the three colors black'', dark blue,'' and blue'' to the different elements that are typically rendered in the headline. No matter how we assign them, things will look wrong for certain outer themes.
+
+To circumvent this problem, \beamer\ uses a layer of \emph{palette colors}. Color themes typically only change these palette colors. For example, a color theme might make the \beamer-color |palette primary| blue, make |palette secondary| a dark blue, and make |palette tertiary| black. Outer themes can now setup things such that whatever they show at the top of the headline inherits from |palette primary|, what comes below inherits from |palette secondary|, and whatever is at the bottom inherits from |palette tertiary|. This way, color themes can change the way even complicated outer themes look and they can do so consistently.
+
+Note that the user can still change the color of every element individually, simply by overriding the color(s) of the elements in the headline. In a sense, the palette colors are just a suggestion'' how things should be colored by an outer theme.
+
+In detail, the following palette colors are used by outer themes.
+
+\begin{element}{palette primary}\no\yes\no
+  Outer themes (should) base the color of navigational elements and, possibly, also of other elements, on the four palette colors. The primary'' palette should be used for the most important navigational elements, which are usually the ones that change most often and hence require the most attention by the audience. The secondary'' and tertiary'' are less important, the quaternary'' one is the least important.
+
+  By default, the palette colors do not have a background and the foreground ranges from |structure.fg| to |black|.
+
+  For the sidebar, there is an extra set of palette colors, see |palette sidebar primary|.
+\end{element}
+
+\begin{element}{palette secondary}\no\yes\no
+  See |palette primary|.
+\end{element}
+
+\begin{element}{palette tertiary}\no\yes\no
+  See |palette primary|.
+\end{element}
+
+\begin{element}{palette quaternary}\no\yes\no
+  See |palette primary|.
+\end{element}
+
+\begin{element}{palette sidebar primary}\no\yes\no
+  Similar to |palette primary|, only outer themes (should) base the colors of elements in the sidebar on the four sidebar palette colors.
+\end{element}
+
+\begin{element}{palette sidebar secondary}\no\yes\no
+  See |palette sidebar primary|.
+\end{element}
+
+\begin{element}{palette sidebar tertiary}\no\yes\no
+  See |palette sidebar primary|.
+\end{element}
+
+\begin{element}{palette sidebar quaternary}\no\yes\no
+  See |palette sidebar primary|.
+\end{element}
+
+
+\subsection{Miscellaneous Colors}
+
+In this section some basic'' colors are listed that do not belong'' to any special commands.
+
+\begin{element}{normal text}\no\yes\yes
+  The color is used for normal text. At the beginning of the document the foreground color is installed as |\normalcolor|. The background of this color is used by the default background canvas for the background of the presentation, see Section~\ref{section-canvas}. The background is also the default value of the normal color |bg|.
+
+  Since the color is the root'' of all other \beamer-colors, both a foreground and a background must be installed. In particular, to get a transparent background canvas, make the background of the \beamer-color |background canvas| empty, not the background of this color.
+
+  The \beamer-font currently is not used. In particular, redefining this font will not have any effect. This is likely to change in the future.
+\end{element}
+
+\begin{element}{example text}\no\yes\yes
+  The color/font is used when text is typeset inside an |example| block.
+\end{element}
+
+\begin{element}{titlelike}\no\yes\yes
+  This color/font is a more specialized form of the |structure| color/font. It is the base for all elements that are like titles.'' This includes the frame title and subtitle as well as the document title and subtitle.
+\end{element}
+
+\begin{element}{separation line}\no\yes\no
+  The foreground of this color is used for separating lines. If the foreground is empty, no separation line is drawn.
+\end{element}
+
+  \colorparents{separation line}
+  Special case for the uppermost separation line in a headline.
+\end{element}
+
+  \colorparents{separation line}
+  Special case for the middle separation line in a headline.
+\end{element}
+
+  \colorparents{separation line}
+  Special case for the lower separation line in a headline.
+\end{element}
+
+\begin{element}{upper separation line foot}\no\yes\no
+  \colorparents{separation line}
+  Special case for the uppermost separation line in a footline.
+\end{element}
+
+\begin{element}{middle separation line foot}\no\yes\no
+  \colorparents{separation line}
+  Special case for the middle separation line in a footline.
+\end{element}
+
+\begin{element}{lower separation line foot}\no\yes\no
+  \colorparents{separation line}
+  Special case for the lower separation line in a footline.
+\end{element}
+
+
+\subsection{Transparency Effects}
+\label{section-transparent}
+
+By default, \emph{covered} items are not shown during a presentation. Thus if you write |\uncover<2>{Text.}|, the text is not shown on any but the second slide. On the other slides, the text is not simply printed using the background color -- it is not shown at all. This effect is most useful if your background does not have a uniform color.
+
+Sometimes however, you might prefer that covered items are not completely covered. Rather, you would like them to be shown already in a very dim or shaded way. This allows your audience to get a feeling for what is yet to come, without getting distracted by it. Also, you might wish text that is covered once more'' still to be visible to some degree.
+
+Ideally, there would be an option to make covered text transparent.'' This would mean that when covered text is shown, it would instead be mixed with the background behind it. Unfortunately, |pgf| does not support real transparency yet. Instead, transparency is created by mixing the color of the object you want to show with the current background color (the color |bg|, which has hopefully been setup such that it is the average color of the background on which the object should be placed). To install this effect, you can use:
+
+\begin{verbatim}
+\setbeamercovered{transparent}
+\end{verbatim}
+
+This command allows you to specify in a quite general way how a covered item should be rendered. You can even specify different ways of rendering the item depending on how long it will take before this item is shown or for how long it has already been covered once more. The transparency effect will automatically apply to all colors, \emph{except} for the colors in images. For images there is a workaround, see the documentation of the \pgfname\ package.
+
+\begin{command}{\setbeamercovered\marg{options}}
+  This command offers several different options, the most important of which is |transparent|. All options are internally mapped to the two options |still covered| and |again covered|.
+
+  In detail, the following \meta{options} may be given:
+  \begin{itemize}
+  \item
+    \declare{|invisible|} is the default and causes covered text to completely disappear''.
+  \item
+    \declare{|transparent|}\opt{|=|\meta{opaqueness}} causes covered text to be typset in a transparent'' way. By default, this means that 85\% of the background color is mixed into all colors or that the \meta{opaqueness} of the text is 15\%. You can specify a different \meta{percentage}, where |0| means totally transparent'' and |100| means totally opaque.''
+
+    Unfortunately, this value is kind of specific'' to every projector. What looks good on your screen need not look good during a presentation.
+  \item
+    \declare{|dynamic|} Makes all covered text quite transparent, but in a dynamic way. The longer it will take till the text is uncovered, the stronger the transparency.
+  \item
+    \declare{|highly dynamic|} Has the same effect as |dynamic|, but the effect is stronger.
+  \item
+    \declare{|still covered=|\meta{not yet list}} specifies how to render covered items that have not yet been uncovered. The \meta{not yet list} should be a list of |\opaqueness| commands, see the description of that command, below.
+    \example
+\begin{verbatim}
+\setbeamercovered{%
+  still covered={\opaqueness<1>{15}\opaqueness<2>{10}\opaqueness<3>{5}\opaqueness<4->{2}},
+  again covered={\opaqueness<1->{15}}}
+\end{verbatim}
+
+  \item
+    \declare{|again covered=|\meta{once more list}} specifies how to render covered items that have once more been covered, that is, that had been shown before but are now covered again.
+  \end{itemize}
+\end{command}
+
+\begin{command}{\opaqueness\ssarg{overlay specification}\marg{percentage of opaqueness}}
+  The \meta{overlay specification} specifies on which slides covered text should have which \meta{percentage of opaqueness}. Unlike other overlay specifications, this \meta{overlay specification} is a relative'' overlay specification. For example, the specification 3'' here means things that will be uncovered three slides ahead,'' respectively things that have once more been covered for three slides.'' More precisely, if an item is uncovered for more than one slide and then covered once more, only the first moment of uncovering'' is used for the calculation of how long the item has been covered once more.
+
+  An opaqueness of 100 is fully opaque and 0 is fully transparent. Currently, since real transparency is not yet implemented, this command causes all colors to get a mixing of \meta{percentage of opaqueness} of the current |bg|. At some future point this command might result in real transparency.
+
+  The alternate \pgfname\ extension used inside an opaque area is \meta{percentage of opaqueness}|opaque|. In case of nested calls, only the innermost opaqueness specification is used.
+  \example
+\begin{verbatim}
+\setbeamercovered{still covered={\opaqueness<1->{15}},again covered={\opaqueness<1->{15}}}
+\pgfdeclareimage{book}{book}
+\pgfdeclareimage{book.!15opaque}{filenameforbooknearlytransparent}
+\end{verbatim}
+
+  Makes everything that is uncovered in two slides only 15 percent opaque.
+\end{command}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-color.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-compatibility.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-compatibility.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,235 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2012,2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\subsection{Compatibility with Other Packages and Classes}
+
+When using certain packages or classes together with the |beamer| class, extra options or precautions may be necessary.
+
+\begin{package}{{AlDraTex}}
+  Graphics created using AlDraTex must be treated like verbatim text. The reason is that DraTex fiddles with catcodes and spaces much like verbatim does. So, in order to insert a picture, either add the |fragile| option to the frame or use the |\defverbatim| command to create a box containing the picture.
+\end{package}
+
+\begin{package}{{alltt}}
+  Text in an |alltt| environment must be treated like verbatim text. So add the |fragile| option to frames containing this environment or use |\defverbatim|.
+\end{package}
+
+\begin{package}{{amsthm}}
+  This package is automatically loaded since \beamer\ uses it for typesetting theorems. If you do not wish it to be loaded, which can be necessary especially in |article| mode if the package is incompatible with the document class, you can use the class option |noamsthm| to suppress its loading. See Section~\ref{section-theorems} for more details.
+\end{package}
+
+\begin{package}{{babel}|[|\declare{|french|}|]|}
+  When using the |french| style, certain features that clash with the functionality of the \beamer\ class will be turned off. For example, enumerations are still produced the way the theme dictates, not the way the |french| style does.
+\end{package}
+
+\begin{package}{{babel}|[|\declare{|spanish|}|]|}
+  \beamernote
+  When using the |spanish| style, certain features that clash with the functionality of the \beamer\ class will be turned off. In particular, the special behavior of the pointed brackets |<| and |>| is deactivated.
+
+  \articlenote
+  To make the characters |<| and |>| active in |article| mode, pass the option |activeospeccharacters| to the package |beamerbasearticle|. This will lead to problems with overlay specifications.
+\end{package}
+
+\begin{package}{{color}}
+  \beamernote
+  The |color| package is automatically loaded by |beamer.cls|. This makes it impossible to pass options to |color| in the preamble of your document in the normal manner. To pass a \meta{list of options} to |color|, you can use the following class option:
+
+  \begin{classoption}{color={\normalfont\meta{list of options}}}
+  Causes the \meta{list of options} to be passed on to the |color| package. If the \meta{list of options} contains more than one option you must enclose it in curly brackets.
+  \end{classoption}
+
+  \articlenote
+  The |color| package is not loaded automatically if |beamerarticle| is loaded with the |noxcolor| option.
+\end{package}
+
+\begin{package}{{colortbl}}
+  \beamernote
+  With newer versions of |xcolor.sty|, you need to pass the option |table| to |xcolor.sty| if you wish to use |colortbl|. See the notes on |xcolor| below, on how to do this.
+\end{package}
+
+\begin{package}{{CJK}}
+  \beamernote
+  When using the |CJK| package for using Asian fonts, you must use the class option \declare{|CJK|}.
+\end{package}
+
+\begin{package}{{deluxetable}}
+  \beamernote
+  The caption generation facilities of |deluxetable| are deactivated. Instead, the caption template is used.
+\end{package}
+
+\begin{package}{{DraTex}}
+  See |AlDraTex|.
+\end{package}
+
+\begin{package}{{enumerate}}
+  \articlenote
+  This package is loaded automatically in the |presentation| modes, but not in the |article| mode. If you use its features, you have to load the package by hand'' in the |article| mode.
+\end{package}
+
+\begin{class}{{foils}}
+  If you wish to emulate the |foils| class using \beamer, please see Section~\ref{section-foiltex}.
+\end{class}
+
+\begin{package}{{fontenc}|[|\declare{|T1,EU1,EU2|}|]|}
+  Use the |T1| option \emph{only} with fonts that have outline fonts available in the T1 encoding like |times| or the |lmodern| fonts. In a standard installation standard Computer Modern fonts (the fonts Donald Knuth originally designed and which are used by default) are \emph{not} available in the T1 encoding. Using this option with them will result in very poor rendering of your presentation when viewed with \pdf\ viewer applications like Acrobat, |xpdf|, |evince| or |okular|. To use the Computer Modern fonts with the T1 encoding, use the package |lmodern|. See also Section~\ref{section-font-encoding}. This applies both to |latex|+|dvips| and |pdflatex|
+
+  Use the |EU1| option with |xelatex|, and |EU2| option with |lualatex|. Note that |xelatex| and |luatex| support OpenType fonts, and font encodings work very different compared to |pdflatex|. Again, see Section~\ref{section-font-encoding} for more information.
+\end{package}
+
+\begin{package}{{fourier}}
+  The package switches to a T1~encoding, but it does not redefine all fonts such that outline fonts (non-bitmapped fonts) are used by default. For example, the sans-serif text and the typewriter text are not replaced. To use outline fonts for these, write |\usepackage{lmodern}| \emph{before} including the |fourier| package.
+\end{package}
+
+\begin{package}{{HA-prosper}}
+  You cannot use this package with \beamer. However, you might try to use the package |beamerprosper| instead, see Section~\ref{section-prosper}.
+\end{package}
+
+\begin{package}{{hyperref}}
+  \beamernote
+  The |hyperref| package is automatically loaded by |beamer.cls| and certain options are set up. In order to pass additional options to |hyperref| or to override options, you can use the following class option:
+
+  \begin{classoption}{hyperref={\normalfont\meta{list of options}}}
+    Causes the \meta{list of options} to be passed on to the |hyperref| package.
+
+    \example |\documentclass[hyperref={bookmarks=false}]{beamer}|
+  \end{classoption}
+
+  Alternatively, you can also use the |\hypersetup| command.
+
+  \articlenote
+  In the |article| version, you must include |hyperref| manually if you want to use it. You can do so by passing option |hyperref| to |beamerarticle|. It is not included automatically.
+\end{package}
+
+\begin{package}{{inputenc}|[|\declare{|utf8,utf8x|}|]|}
+  \beamernote
+  When using Unicode, you may wish to use \emph{some} of the following class options:
+  \begin{classoption}{ucs}
+    Loads the package |ucs| and passes the correct Unicode options to |hyperref|. Also, it preloads the Unicode code pages zero and one.
+  \end{classoption}
+
+  \begin{classoption}{utf8x}
+    Same as the option |ucs|, but also sets the input encoding to |utf8x|. You could also use the option |ucs| and say |\usepackage[utf8x]{inputenc}| in the preamble. This also automatically loads |ucs| package in most \TeX\ systems.
+  \end{classoption}
+
+  If you use a Unicode character outside the first two code pages (which includes the Latin alphabet and the extended Latin alphabet) in a section or subsection heading, you have to use the command |\PreloadUnicodePage{|\meta{code page}|}| to give |ucs| a chance to preload these code pages. You will know that a character has not been preloaded, if you get a message like Please insert into preamble.'' The code page of a character is given by the unicode number of the character divided by 256.
+
+  \begin{classoption}{utf8}
+    This option sets the input encoding to |utf8|. It's designed to be used \emph{without} |ucs|. It's the same as saying |\usepackage[utf8]{inputenc}| in the preamble.
+  \end{classoption}
+
+  Note that \emph{none} of these options apply to |lualatex| and |xelatex|, since both support Unicode natively without any extra packages. Most of the time using these options actually harms output quality, so be careful about what you use. If you want to have a document that allows compiling with multiple drivers, take a look at |iftex|, |ifxetex| and |ifluatex| packages.
+
+  \articlenote
+  Passing option |utf8| to |beamerarticle| has the same effect as saying |\usepackage[utf8]{inputenc}| in the preamble.
+
+  Again, take care if you use |lualatex| or |xelatex|.
+\end{package}
+
+\begin{package}{{listings}}
+  \beamernote
+  Note that you must treat |lstlisting| environments exactly the same way as you would treat |verbatim| environments. When using |\defverbatim| that contains a colored |lstlisting|, use the |colored| option of |\defverbatim|.
+  \example
+\begin{verbatim}
+\usepackage{listings}
+
+\begin{document}
+\defverbatim[colored]\mycode{%
+  \begin{lstlisting}[frame=single, emph={cout}, emphstyle={\color{blue}}]
+    cout << "Hello world!";
+  \end{lstlisting}
+  }
+
+\begin{frame}
+  \mycode
+\end{frame}
+\end{document}
+\end{verbatim}
+\end{package}
+
+\begin{package}{{msc}}
+  \beamernote
+  Since this package uses |pstricks| internally, everything that applies to pstricks also applies to |msc|.
+\end{package}
+
+\begin{package}{{musixtex}}
+  When using MusiX\TeX\ to typeset musical scores, you have to have $\varepsilon$-\TeX extensions enabled. Most modern distributions enable that by default both in |pdflatex| and |latex|. However, if you have an older distribution, the document must be compiled with |pdfelatex| or |elatex| instead of |pdflatex| or |latex|.
+
+  Inside a |music| environment, the |\pause| is redefined to match MusiX\TeX's definition (a rest during one quarter of a whole). You can use the |\beamerpause| command to create overlays in this environment.
+\end{package}
+
+\begin{package}{{pdfpages}}
+  Commands like |\includepdf| only work \emph{outside} frames as they produce pages by themselves.'' You may also wish to say
+\begin{verbatim}
+\setbeamercolor{background canvas}{bg=}
+\end{verbatim}
+  when you use such a command since the background (even a white background) will otherwise be printed over the image you try to include.
+
+  \example
+\begin{verbatim}
+\begin{document}
+\begin{frame}
+  \titlepage
+\end{frame}
+
+{
+  \setbeamercolor{background canvas}{bg=}
+  \includepdf{somepdfimages.pdf}
+}
+
+\begin{frame}
+  A normal frame.
+\end{frame}
+\end{document}
+\end{verbatim}
+\end{package}
+
+\begin{package}{{\normalfont\meta{professional font package}}}
+  \beamernote
+  If you use a professional font package, \beamer's internal redefinition of how variables are typeset may interfere with the font package's superior way of typesetting them. In this case, you should use the class option |professionalfonts| to suppress any font substitution. See Section~\ref{section-substition} for details.
+\end{package}
+
+\begin{class}{{prosper}}
+  If you wish to (partly) emulate the |prosper| class using \beamer, please see Section~\ref{section-prosper}.
+\end{class}
+
+\begin{package}{{pstricks}}
+  You should add the option |xcolor=pst| to make |xcolor| aware of the fact that you are using |pstricks|.
+\end{package}
+
+\begin{class}{{seminar}}
+  If you wish to emulate the |seminar| class using \beamer, please see Section~\ref{section-seminar}.
+\end{class}
+
+\begin{package}{{texpower}}
+  You cannot use this package with \beamer. However, you might try to use the package |beamertexpower| instead, see Section~\ref{section-texpower}.
+\end{package}
+
+\begin{package}{{textpos}}
+  \beamernote
+  \beamer\ automatically installs a white background behind everything, unless you install a different background template. Because of this, you must use the |overlay| option when using |textpos|, so that it will place boxes \emph{in front of} everything. Alternatively, you can install an empty background template, but this may result in an incorrect display in certain situtations with older versions of the Acrobat Reader.
+\end{package}
+
+\begin{package}{{ucs}}
+  See |\usepackage[utf8,utf8x]{inputenc}|.
+\end{package}
+
+\begin{package}{{xcolor}}
+  \beamernote
+  The |xcolor| package is automatically loaded by |beamer.cls|. The same applies as to |color|.
+
+  \begin{classoption}{xcolor={\normalfont\meta{list of options}}}
+    Causes the \meta{list of options} to be passed on to the |xcolor| package.
+  \end{classoption}
+
+  When using \beamer\ together with the |pstricks| package, be sure to pass the |xcolor=pst| option to \beamer\ (and hence to |xcolor|).
+
+  \articlenote
+  The |color| package is not loaded automatically if |beamerarticle| is loaded with the |noxcolor| option.
+\end{package}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-compatibility.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-elements.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-elements.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,486 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2012,2014,2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\section{Inner Themes, Outer Themes, and Templates}
+\label{section-elements}
+
+This section discusses the inner and outer themes that are available in \beamer. These themes install certain \emph{templates} for the different elements of a presentation. The template mechanism is explained at the end of the section.
+
+Before we plunge into the details, let us agree on some terminology for this section. In \beamer, an \emph{element} is part of a presentation that is potentially typeset in some special way. Examples of elements are frame titles, the author's name, or the footnote sign. The appearance of every element is governed by a \emph{template} for this element. Appropriate templates are installed by inner and outer themes, where the \emph{inner} themes only install templates for elements that are typically inside the main text,'' while \emph{outer} themes install templates for elements around the main text.'' Thus, from the templates's point of view, there is no real difference between inner and outer themes.
+
+
+\subsection{Inner Themes}
+
+An inner theme installs templates that dictate how the following elements are typeset:
+\begin{itemize}
+\item Title and part pages.
+\item Itemize environments.
+\item Enumerate environments.
+\item Description environments.
+\item Block environments.
+\item Theorem and proof environments.
+\item Figures and tables.
+\item Footnotes.
+\item Bibliography entries.
+\end{itemize}
+
+In the following examples, the color themes |seahorse| and |rose| are used to show where and how background colors are honored. Furthermore, background colors have been specified for all elements that honor them in the default theme. In the default color theme, all of the large rectangular areas are transparent.
+
+\begin{innerthemeexample}{default}
+  The default element theme is quite sober. The only extravagance is the fact that a little triangle is used in |itemize| environments instead of the usual dot.
+
+  In some cases the theme will honor background color specifications for elements. For example, if you set the background color for block titles to green, block titles will have a green background. The background specifications are currently honored for the following elements:
+  \begin{itemize}
+  \item Title, author, institute, and date fields in the title page.
+  \item Block environments, both for the title and for the body.
+  \end{itemize}
+  This list may increase in the future.
+\end{innerthemeexample}
+
+\begin{innerthemeexample}{circles}
+\end{innerthemeexample}
+
+\begin{innerthemeexample}{rectangles}
+\end{innerthemeexample}
+
+\begin{innerthemeexample}[\oarg{options}]{rounded}
+  In this theme, |itemize| and |enumerate| items and table of contents entries start with small balls. If a background is specified for blocks, then the corners of the background rectangles will be rounded off. The following \meta{options} may be given:
+
+  \begin{itemize}
+  \end{itemize}
+\end{innerthemeexample}
+
+\begin{innerthemeexample}{inmargin}
+  The idea behind this theme is to have structuring'' information on the left and normal'' information on the right. To this end, blocks are redefined such that the block title is shown on the left and the block body is shown on the right.
+
+  The code used to place text in the margin is a bit fragile. You may often need to adjust the spacing by hand,'' so use at your own risk.
+
+  Itemize items are redefined such that they appear on the left. However, only the position is changed by changing some spacing parameters; the code used to draw the items is not changed otherwise. Because of this, you can load another inner theme first and then load this theme afterwards.
+
+  This theme is a dirty'' inner theme since it messes with things that an inner theme should not mess with. In particular, it changes the width of the left sidebar to a large value. However, you can still use it together with most outer themes.
+
+  Using columns inside this theme is problematic. Most of the time, the result will not be what you expect.
+\end{innerthemeexample}
+
+
+\subsection{Outer Themes}
+
+An outer theme dictates (roughly) the overall layout of frames. It specifies where any navigational elements should go (like a mini table of contents or navigational mini frames) and what they should look like. Typically, an outer theme specifies how the following elements are rendered:
+\begin{itemize}
+\item The sidebars.
+\item The logo.
+\item The frame title.
+\end{itemize}
+
+An outer theme will not specify how things like |itemize| environments should be rendered---that is the job of an inner theme.
+
+In the following examples the color theme |seahorse| is used. Since the default color theme leaves most backgrounds empty, most of the outer themes look too unstructured with the default color theme.
+
+\begin{outerthemeexample}{default}
+  The default layout theme is the most sober and minimalistic theme around. It will flush left the frame title and it will not install any head- or footlines. However, even this theme honors the background color specified for the frame title. If a color is specified, a bar occupying the whole page width is put behind the frame title. A background color of the frame subtitle is ignored.
+\end{outerthemeexample}
+
+\begin{outerthemeexample}{infolines}
+  This theme installs a headline showing the current section and the current subsection. It installs a footline showing the author's name, the institution, the presentation's title, the current date, and a frame count. This theme uses only little space.
+
+  The colors used in the headline and footline are drawn from |palette primary|, |palette secondary|, and |primary tertiary| (see Section~\ref{section-colors} for details on how to change these).
+\end{outerthemeexample}
+
+\begin{outerthemeexample}[\oarg{options}]{miniframes}
+  This theme installs a headline in which a horizontal navigational bar is shown. This bar contains one entry for each section of the presentation. Below each section entry, small circles are shown that represent the different frames in the section. The frames are arranged subsection-wise, that is, there is a line of frames for each subsection. If the class option |compress| is given, the frames will instead be arranged in a single row for each section. The navigation bars draws its color from |section in head/foot|.
+
+  Below the navigation bar, a line is put showing the title of the current subsection. The color is drawn from |subsection in head/foot|.
+
+  At the bottom, two lines are put that contain information such as the author's name, the institution, or the paper's title. What is shown exactly is influenced by the \meta{options} given. The colors are drawn from the appropriate \beamer-colors like |author in head/foot|.
+
+  At the top and bottom of both the head- and footline and between the navigation bar and the subsection name, separation lines are drawn \emph{if} the background color of |separation line| is set. This separation line will have a height of 3pt. You can get even more fine-grained control over the colors of the separation lines by setting appropriate colors like |lower separation line head|.
+
+  The following \meta{options} can be given:
+  \begin{itemize}
+  \item \declare{|footline=empty|} suppresses the footline (default).
+  \item \declare{|footline=authorinstitute|} shows the author's name and the institute in the footline.
+  \item \declare{|footline=authortitle|} shows the author's name and the title in the footline.
+  \item \declare{|footline=institutetitle|} shows the institute and the title in the footline.
+  \item \declare{|footline=authorinstitutetitle|} shows the author's name, the institute, and the title in the footline.
+  \item \declare{|subsection=|\meta{true or false}} shows or suppresses line showing the subsection in the headline. It is shown by default. If the document does not use subsections, this option should be set |false|.
+  \end{itemize}
+\end{outerthemeexample}
+
+\begin{outerthemeexample}[\oarg{options}]{smoothbars}
+  This theme behaves very much like the |miniframes| theme, at least with respect to the headline. The only differences are that smooth transitions are installed between the background colors of the navigation bar, the (optional) bar for the subsection name, and the background of the frame title. No footline is created. You can get the footlines of the |miniframes| theme by first loading that theme and then loading the |smoothbars| theme.
+
+  The following \meta{options} can be given:
+  \begin{itemize}
+  \item \declare{|subsection=|\meta{true or false}} shows or suppresses line showing the subsection in the headline. It is shown by default.
+  \end{itemize}
+\end{outerthemeexample}
+
+\begin{outerthemeexample}[\oarg{options}]{sidebar}
+  In this layout, a sidebar is shown that contains a small table of contents with the current section, subsection, or subsubsection highlighted. The frame title is vertically centered in a rectangular area at the top that always occupies the same amount of space in all frames. Finally, the logo is shown in the corner'' resulting from the sidebar and the frame title rectangle.
+
+  There are several ways of modifying the layout using the \meta{options}. If you set the width of the sidebar to 0pt, it is not shown, giving you a layout in which the frame title does not wobble'' since it always occupies the same amount of space on all slides. Conversely, if you set the height of the frame title rectangle to 0pt, the rectangular area is not used and the frame title is inserted normally (occupying as much space as needed on each slide).
+
+  The background color of the sidebar is taken from |sidebar|, the background color of the frame title from |frametitle|, and the background color of the logo corner from |logo|.
+
+  The colors of the entries in the table of contents are drawn from the \beamer-color |section in sidebar| and |section in sidebar current| as well as the corresponding \beamer-colors for subsections. If an entry does not fit on a single line it is automatically linebroken.''
+
+  The following \meta{options} may be given:
+  \begin{itemize}
+  \item
+    \declare{|height=|\meta{dimension}} specifies the height of the frame title rectangle. If it is set to 0pt, no frame title rectangle is created. Instead, the frame title is inserted normally into the frame. The default is 2.5 base line heights of the frame title font. Thus, there is about enough space for a two-line frame title plus a one-line subtitle.
+  \item
+    \declare{|hideothersubsections|} causes all subsections except those of the current section to be suppressed in the table of contents. This is useful if you have lots of subsections.
+  \item
+  \item
+    \declare{|left|} puts the sidebar on the left side. Note that in a left-to-right reading culture this is the side people look first. Note also that this table of contents is usually \emph{not} the most important part of the frame, so you do not necessarily want people to look at it first. Nevertheless, it is the default.
+  \item
+    \declare{|right|} puts the sidebar of the right side.
+  \item
+    \declare{|width=|\meta{dimension}} specifies the width of the sidebar. If it is set to 0pt, it is completely suppressed. The default is 2.5 base line heights of the frame title font.
+  \end{itemize}
+\end{outerthemeexample}
+
+\begin{outerthemeexample}{split}
+  This theme installs a headline in which, on the left, the sections of the talk are shown and, on the right, the subsections of the current section. If the class option |compress| has been given, the sections and subsections will be put in one line; normally there is one line per section or subsection.
+
+  The footline shows the author on the left and the talk's title on the right.
+
+  The colors are taken from |palette primary| and |palette quaternary|.
+\end{outerthemeexample}
+
+  This layout theme extends the |split| theme by putting a horizontal shading behind the frame title and adding a little shadow'' at the bottom of the headline.
+\end{outerthemeexample}
+
+\begin{outerthemeexample}[\oarg{options}]{tree}
+  In this layout, the headline contains three lines that show the title of the current talk, the current section in this talk, and the current subsection in the section. The colors are drawn from |title in head/foot|, |section in head/foot|, and |subsection in head/foot|.
+
+  In addition, separation lines of height 3pt are shown above and below the three lines \emph{if} the background of |separation line| is set. More fine-grained control of the colors of these lines can be gained by setting |upper separation line head| and |lower separation line head|.
+
+  The following \meta{options} may be given:
+  \begin{itemize}
+  \item
+    \declare{|hooks|} causes little hooks'' to be drawn in front of the section and subsection entries. These are supposed to increase the tree-like appearance.
+  \end{itemize}
+\end{outerthemeexample}
+
+\begin{outerthemeexample}{smoothtree}
+  This layout is similar to the |tree| layout. The main difference is that the background colors change smoothly.
+\end{outerthemeexample}
+
+
+\subsection{Changing the Templates Used for Different Elements of a Presentation}
+\label{section-templates}
+
+This section explains how \beamer's template management works.
+
+\subsubsection{Overview of Beamer's Template Management}
+
+If you only wish to modify the appearance of a single or few elements, you do not need to create a whole new inner or outer theme. Instead, you can modify the appropriate template.
+
+A template specifies how an element of a presentation is typeset. For example, the |frametitle| template dictates where the frame title is put, which font is used, and so on.
+
+As the name suggests, you specify a template by writing the exact \LaTeX\ code you would also use when typesetting a single frame title by hand. Only, instead of the actual title, you use the command |\insertframetitle|.
+
+\example
+Suppose we would like to have the frame title typeset in red, centered, and boldface. If we were to typeset a single frame title by hand, it might be done like this:
+
+\begin{verbatim}
+\begin{frame}
+  \begin{centering}
+    \color{red}
+    \textbf{The Title of This Frame.}
+    \par
+  \end{centering}
+
+  Blah, blah.
+\end{frame}
+\end{verbatim}
+
+In order to typeset the frame title in this way on all slides, in the simplest case we can change the frame title template as follows:
+
+\begin{verbatim}
+\setbeamertemplate{frametitle}
+{
+  \begin{centering}
+    \color{red}
+    \textbf{\insertframetitle}
+    \par
+  \end{centering}
+}
+\end{verbatim}
+We can then use the following code to get the desired effect:
+\begin{verbatim}
+\begin{frame}
+  \frametitle{The Title of This Frame.}
+
+  Blah, blah.
+\end{frame}
+\end{verbatim}
+
+When rendering the frame, \beamer\ will use the code of the frame title template to typeset the frame title and it will replace every occurrence of |\insertframetitle| by the current frame title.
+
+We can take this example a step further. It would be nicer if we did not have to hardwire'' the color of the frametitle, but if this color could be specified independently of the code for the template. This way, a color theme could change this color. Since this is a problem that is common to most templates, \beamer\ will automatically setup the \beamer-color |frametitle| when the template |frametitle| is used. Thus, we can remove the |\color{red}| command if we set the \beamer-color |frametitle| to red at some point.
+
+\begin{verbatim}
+\setbeamercolor{frametitle}{fg=red}
+\setbeamertemplate{frametitle}
+{
+  \begin{centering}
+    \textbf{\insertframetitle}
+    \par
+  \end{centering}
+}
+\end{verbatim}
+
+Next, we can also make the font themable.'' Just like the color, the \beamer-font |frametitle| is installed before the |frametitle| template is typeset. Thus, we should rewrite the code as follows:
+
+\begin{verbatim}
+\setbeamercolor{frametitle}{fg=red}
+\setbeamerfont{frametitle}{series=\bfseries}
+\setbeamertemplate{frametitle}
+{
+  \begin{centering}
+    \insertframetitle\par
+  \end{centering}
+}
+\end{verbatim}
+
+Users, themes, or whoever can now easily change the color or font of the frametitle without having to mess with the code used to typeset it.
+
+\articlenote
+In |article| mode, most of the template mechanism is switched off and has no effect. However, a few templates are also available. If this is the case, it is specially indicated.
+\smallskip
+
+Here are a few hints that might be helpful when you wish to set a template:
+\begin{itemize}
+\item
+  Usually, you might wish to copy code from an existing template. The code often takes care of some things that you may not yet have thought about. The default inner and outer themes might be useful starting points. Also, the file |beamerbaseauxtemplates.sty| contains interesting auxilliary'' templates.
+\item
+  When copying code from another template and when inserting this code in the preamble of your document (not in another style file), you may have to switch on'' the at-character (|@|). To do so, add the command |\makeatletter| before the |\setbeamertemplate| command and the command |\makeatother| afterward.
+\item
+  Most templates having to do with the frame components (headlines, sidebars, etc.)\ can only be changed in the preamble. Other templates can be changed during the document.
+\item
+  The height of the headline and footline templates is calculated automatically. This is done by typesetting the templates and then having a look'' at their heights. This recalculation is done right at the beginning of the document, \emph{after} all packages have been loaded and even \emph{after} these have executed their |\AtBeginDocument| initialization.
+\item
+  Getting the boxes right inside any template is often a bit of a hassle. You may wish to consult the \TeX\ book for the glorious details on Making Boxes.'' If your headline is simple, you might also try putting everything into a |pgfpicture| environment, which makes the placement easier.
+\end{itemize}
+
+\subsubsection{Using Beamer's Templates}
+
+As a user of the \beamer\ class you typically do not use'' or invoke'' templates yourself, directly. For example, the frame title template is automatically invoked by \beamer\ somewhere deep inside the frame typesetting process. The same is true of most other templates. However, if, for whatever reason, you wish to invoke a template yourself, you can use the following command.
+
+\begin{command}{\usebeamertemplate\opt{|***|}\marg{element name}}
+  If none of the stars is given, the text of the \meta{element name} is directly inserted at the current position. This text should previously have been specified using the |\setbeamertemplate| command. No text is inserted if this command has not been called before.
+  \example
+\begin{verbatim}
+\setbeamertemplate{my template}{correct}
+...
+\end{verbatim}
+
+  If you add one star, three things happen. First, the template is put inside a \TeX-group, thereby limiting most side effects of commands used inside the template. Second, inside this group the \beamer-color named \meta{element name} is used and the foreground color is selected. Third, the \beamer-font \meta{element name} is also used. This one-starred version is usually the best version to use.
+
+  If you add a second star, nearly the same happens as with only one star. However, in addition, the color is used with the command |\setbeamercolor*|. This causes the colors to be reset to the normal text color if no special foreground or background is specified by the \beamer-color \meta{element name}. Thus, in this twice-starred version, the color used for the template is guaranteed to be independent of the color that was currently in use when the template is used.
+
+  Finally, adding a third star will also cause a star to be added to the |\setbeamerfont*| command. This causes the font used for the template also to be reset to normal text, unless the \beamer-font \meta{element name} specifies things differently. This three-star version is the most protected'' version available.
+\end{command}
+
+\begin{command}{\ifbeamertemplateempty\marg{beamer template name}\marg{executed if empty}\marg{executed otherwise}}
+  This command checks whether a template is defined and set to a non-empty text. If the text is empty or the template is not defined at all, \meta{executed if empty} is executed. Otherwise, \meta{executed otherwise} is executed.
+\end{command}
+
+\begin{command}{\expandbeamertemplate\marg{beamer template name}}
+  This command does the same as |\usebeamertemplate|\marg{beamer template name}. The difference is that this command performs a direct expansion and does not scan for a star. This is important inside, for example, an |\edef|. If you don't know the difference between |\def| and |\edef|, you won't need this command.
+\end{command}
+
+\subsubsection{Setting Beamer's Templates}
+
+To set  a \beamer-template, you can use the following command:
+
+\begin{command}{\setbeamertemplate\marg{element name}\oarg{predefined option}\meta{args}}
+  In the simplest case, if no \meta{predefined option} is given, the \meta{args} must be a single argument and the text of the template \meta{element name} is setup to be this text. Upon later invocation of the template by the command |\usebeamertemplate| this text is used.
+
+  \example
+\begin{verbatim}
+...
+\end{verbatim}
+
+  If you specify a \meta{predefined option}, this command behaves slightly differently. In this case, someone has used the command |\defbeamertemplate| to predefine a template for you. By giving the name of this predefined template as the optional parameter \meta{predefined option}, you cause the template \meta{element name} to be set to this template.
+
+  \example
+  |\setbeamertemplate{bibliography item}[book]| causes the bibliography items to become little book icons. This command causes a subsequent call of |\usebeamertemplate{bibliography item}| to insert the predefined code for inserting a book.
+
+  Some predefined template options take parameters themselves. In such a case, the parameters are given as \meta{args}.
+
+  \example
+  The \meta{predefined option} |grid| for the template |background| takes an optional argument:
+\begin{verbatim}
+\setbeamertemplate{background}[grid][step=1cm]
+\end{verbatim}
+
+  In the example, the second argument in square brackets is the optional argument.
+
+  In the descriptions of elements, if there are possible \meta{predefined option}, the description shows how the \meta{predefined option} can be used together with its arguments, but the |\setbeamertemplate{xxxx}| is omitted. Thus, the above example would be documented in the description of the |background| element like this:
+  \begin{itemize}
+    \itemoption{grid}{\oarg{step options}} causes a light grid to be \dots
+  \end{itemize}
+\end{command}
+
+  This command adds the \meta{pre-text} before the text that is currently installed as the template \meta{element name} and the \meta{post-text} after it. This allows you a limited form of modification of existing templates.
+
+  \example
+  The following commands have the same effect:
+
+\begin{verbatim}
+\setbeamertemplate{my template}{Hello world!}
+
+\setbeamertemplate{my template}{world}
+\end{verbatim}
+
+  If a new template is installed, any additions will be deleted. On the other hand, you can repeatedly use this command to add multiple things.
+\end{command}
+
+\begin{command}{\defbeamertemplate\sarg{mode specification}\opt{|*|}\marg{element name}\marg{predefined option}\\ \oarg{argument number}\oarg{default optional argument}\marg{predefined text}\\ \opt{|[action]|\marg{action command}}}
+  This command installs a \emph{predefined option} for the template \meta{element name}. Once this command has been used, users can access the predefined template using the |\setbeamertemplate| command.
+
+  \example
+  |\defbeamertemplate{itemize item}{double arrow}{$\Rightarrow$}|
+
+  After the above command has been invoked, the following two commands will have the same effect:
+
+\begin{verbatim}
+\setbeamertemplate{itemize item}{$\Rightarrow$}
+\setbeamertemplate{itemize item}[double arrow]
+\end{verbatim}
+
+  Sometimes, a predefined template needs to get an argument when it is installed. Suppose, for example, we want to define a predefined template that draws a square as the itemize item and we want to make this size of this square configurable. In this case, we can specify the \meta{argument number} of the predefined option the same way one does for the |\newcommand| command:
+
+\begin{verbatim}
+\defbeamertemplate{itemize item}{square}[1]{\hrule width #1 height #1}
+
+%% The following have the same effect:
+\setbeamertemplate{itemize item}[square]{3pt}
+\setbeamertemplate{itemize item}{\hrule width 3pt height 3pt}
+\end{verbatim}
+  As for the |\newcommand| command, you can also specify a \meta{default optional argument}:
+\begin{verbatim}
+\defbeamertemplate{itemize item}{square}[1][1ex]{\hrule width #1 height #1}
+
+%% The following have the same effect:
+\setbeamertemplate{itemize item}[square][3pt]
+\setbeamertemplate{itemize item}{\hrule width 3pt height 3pt}
+
+%% So do the following:
+\setbeamertemplate{itemize item}[square]
+\setbeamertemplate{itemize item}{\hrule width 1ex height 1ex}
+\end{verbatim}
+
+  The starred version of the command installs the predefined template option, but then immediately calls |\setbeamertemplate| for this option. This is useful for the default templates. If there are any arguments necessary, these are set to |\relax|.
+
+  In certain cases, if a predefined template option is chosen, you do not only wish the template text to be installed, but certain extra actions'' must also be taken once. For example, a shading must be defined that should not be redefined every time the shading is used later on. To implement such actions,'' you can use the optional argument \meta{action} following the keyword |[action]|. Thus, after the normal use of the |\defbeamertemplate| you add the text |[action]| and then any commands that should be executed once when the \meta{predefined option} is selected by the |\setbeamertemplate| command.
+
+  \example
+\begin{verbatim}
+{
+}
+[action]
+{
+  {color(0cm)=(#1); color(\the\paperheight)=(#2)}
+}
+...
+
+%% \usebeamertemplate{background canvas} will yield
+%% \pgfuseshading{myshading}''.
+\end{verbatim}
+
+  \articlenote
+  Normally, this command has no effect in |article| mode. However, if a \meta{mode specification} is given, this command is applied for the specified modes. Thus, this command behaves like the |\\| command, which also gets the implicit mode specification |<presentation>| if no other specification is given.
+
+  \example
+  |\defbeamertemplate{my template}{default}{something}| has no effect in |article| mode.
+
+  \example
+  |\defbeamertemplate<article>{my template}{default}{something}| has no effect in |presentation| modes, but has an effect in |article| mode.
+
+  \example
+  |\defbeamertemplate<all>{my template}{default}{something}| applies to all modes.
+\end{command}
+
+It is often useful to have access to the same template option via different names. For this, you can use the following command to create aliases:
+\begin{command}{\defbeamertemplatealias\marg{element name}\marg{new predefined option name}\marg{existing predefined option name}}
+  Causes the two predefined options to have the same effect.
+\end{command}
+
+There is no inheritance relation among templates as there is for colors and fonts. This is due to the fact the templates for one element seldom make sense for another. However, sometimes certain elements behave similarly'' and one would like a |\setbeamertemplate| to apply to a whole set of templates via inheritance. For example, one might want that |\setbeamertemplate{items}[circle]| causes all items to use the |circle| option, though the effects for the |itemize item| as opposed to the |itemize subsubitem| as opposed to |enumerate item| must be slightly different.
+
+The \beamer-template mechanism implements a simple form of inheritance via \emph{parent templates}. In element descriptions, parent templates are indicated via a check mark in parentheses.
+
+\begin{command}{\defbeamertemplateparent\marg{parent template name}\oarg{predefined option name}\marg{child template list}\\ \oarg{argument number}\oarg{default optional argument}\marg{arguments for children}}
+  The effect of this command is that whenever someone calls |\setbeamertemplate{|\meta{parent template name}|}{|\meta{args}|}|, the command |\setbeamertemplate{|\meta{child template name}|}{|\meta{args}|}| is called for each \meta{child template name} in the \meta{child template list}.
+
+  The \meta{arguments for children} come into play if the |\setbeamertemplate| command is called with a predefined option name (not necessarily the same as the \meta{predefined option name}, we'll come to that). If |\setbeamertemplate| is called with some predefined option name, the children are called with the \meta{arguments for children} instead. Let's look at two examples:
+
+  \example
+  The following is the typical, simple usage:
+
+\begin{verbatim}
+\defbeamertemplateparent{itemize items}{itemize item,itemize subitem,itemize subsubitem}
+{}
+
+%% The following command has the same effect as the three commands below:
+\setbeamertemplate{itemize items}[circle]
+
+\setbeamertemplate{itemite item}[circle] % actually, the empty'' argument is added
+\setbeamertemplate{itemize subitem}[circle]
+\setbeamertemplate{itemize subsubitem}[circle]
+\end{verbatim}
+
+  \example
+  In the following case, an argument is passed to the children:
+
+\begin{verbatim}
+{[#1]}
+
+%% The following command has the same effect as the two commands below:
+
+
+
+%% Again:
+
+\end{verbatim}
+
+  In detail, the following happens: When |\setbeamertemplate| is encountered for a parent template, \beamer\ first checks whether a predefined option follows. If not, a single argument is read and |\setbeamertemplate| is called for all children for this template. If there is a predefined template option set, \beamer\ evaluates the \meta{argument for children}. It may contain parameters like |#1| or |#2|. These parameters are filled with the arguments that follow the call of |\setbeamertemplate| for the parent template. The number of arguments must be the number given as \meta{argument number}. An optional argument can also be specified in the usual way. Once the \meta{arguments for the children} have been computed, |\setbeamertemplate| is called for all children for the predefined template and with the computed arguments.
+
+  You may wonder what happens when certain predefined options take a certain number of arguments, but another predefined option takes a different number of arguments. In this case, the above-described mechanism cannot differentiate between the predefined options and it is unclear which or even how many arguments should be contained in \meta{arguments for children}. For this reason, you can give the optional argument \meta{predefined option name} when calling |\defbeamertemplateparent|. If this optional argument is specified, the parenthood of the template applies only to this particular \meta{predefined option name}. Thus, if someone calls |\setbeamertemplate| for this \meta{predefined option name}, the given \meta{argument for children} is used. For other predefined option names a possibly different definition is used. You can imaging that leaving out the optional \meta{predefined option name} means this \meta{argument for children} applies to all predefined option names that have not been specially defined differently.''
+\end{command}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-elements.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-emulation.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-emulation.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,721 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\section[How To Import Presentations Based on Other Packages and Classes]{How To Import Presentations Based on\\ Other Packages and Classes}
+
+The \beamer\ class comes with a number of emulation layers for classes or packages that do not support \beamer\ directly. For example, the package |beamerseminar| maps some (not all) commands of the \seminar\ class to appropriate \beamer\ commands. This way, individual slides or whole sets of slides that have been prepared for a presentation using \seminar\ can be used inside \beamer, provided they are reasonably simple.
+
+None of the emulation layers is a perfect substitute for the original (emulations seldom are) and it is not intended that they ever will be. If you want/need/prefer the features of another class, use that class for preparing your presentations. The intention of these layers is just to help speed up creating \beamer\ presentations that use parts of old presentations. You can simply copy these parts in verbatim, without having to worry about the subtle differences in syntax.
+
+A useful effect of using an emulation layer is that you get access to all the features of \beamer\ while using the syntax of another class. For example, you can use the |article| mode to create a nice article version of a \prosper\ talk.
+
+
+\subsection{Prosper, HA-Prosper and Powerdot}
+\label{section-prosper}
+
+The package |beamerprosper| maps the commands of the \prosper\ package, developed by Fr\'ed\'eric Goualard, to \beamer\ commands. Also, some commands of the \textsc{ha}-\prosper\ and \textsc{powerdot} packages, developed by Hendri Adriaens, are mapped to \beamer\ commands. \emph{These mappings cannot perfectly emulate all of Prosper!} Rather, these mappings are intended as an aid when porting parts of presentations created using \prosper\ to \beamer. \emph{No styles are implemented that mimick Prosper styles.} Rather, the normal \beamer\ themes must be used (although, one could implement \beamer\ themes that mimicks existing \prosper\ styles; we have not done that and do not intend to).
+
+The workflow for creating a \beamer\ presentation that uses \prosper\ code is the following:
+\begin{enumerate}
+\item
+  Use the document class |beamer|, not |prosper|. Most options passed to |prosper| do not apply to |beamer| and should be omitted.
+\item
+  Add a |\usepackage{beamerprosper}| to start the emulation.
+\item
+  If you add slides relying on \textsc{ha}-\prosper, you may wish to add the option |framesassubsections| to |beamerprosper|, though we do not recommend it (use the normal |\subsection| command instead; it gives you more fine-grained control).
+\item
+  If you also copy the title commands, it may be necessary to adjust the content of commands like |\title| or |\author|. Note that in \prosper\ the |\email| command is given outside the |\author| command, whereas in \beamer\ and also in \textsc{ha}-\prosper\ it is given inside.
+\item
+  When copying slides containing the command |\includegraphics|, you will almost surely have to adjust its usage. If you use pdf\LaTeX\ to typeset the presentation, than you cannot include PostScript files. You should convert them to |.pdf| or to |.png| and adjust any usage of |\includegraphics| accordingly.
+\item
+  When starting to change things, you can use all of \beamer's commands and even mix them with \prosper\ commands.
+\end{enumerate}
+
+An example can be found in the file |beamerexample-prosper.tex|.
+
+There are, unfortunately, quite a few places where you may run into problems:
+\begin{itemize}
+\item
+  In \beamer, the command |\PDForPS| will do exactly what the name suggests: insert the first argument when run by |pdflatex|, insert the second argument when run by |latex|. However, in \prosper, the code inserted for the \pdf\ case is actually PostScript code, which is only later converted to \pdf\ by some external program. You will need to adjust this PostScript code such that it works with |pdflatex| (which is not always possible).
+\item
+  If you used fine-grained spacing commands, like adding a little horizontal skip   here and a big negative vertical skip there, the typesetting of the text may be poor. It may be a good idea to just remove these spacing commands.
+\item
+  If you use |pstricks| commands, you will either have to stick to using |latex| and |dvips| or will have to work around them using, for example, |pgf|. Porting lots of |pstricks| code is bound to be difficult, if you wish to switch over to |pdflatex|, so be warned. You can read more about that in Section~\ref{section-graphics} that talks about graphics.
+\item
+  If the file cannot be compiled because some \prosper\ command is not implemented, you will have to delete this command and try to mimick its behavior using some \beamer\ command.
+\end{itemize}
+
+\begin{package}{{beamerprosper}}
+  Include this package in a |beamer| presentation to get access to \prosper\ commands. Use |beamer| as the document class, not |prosper|. Most of the options passed to the class |prosper| make no sense in |beamer|, so just delete them.
+
+  This package takes the following options:
+  \begin{itemize}
+  \item
+    \declare{|framesassubsections|} causes each frame to create its own subsection with the frame title as subsection name. This behavior mimicks \textsc{ha}-\textsc{prosper}'s behavior. In a long talk this will create way too many subsections.
+  \end{itemize}
+
+  \articlenote
+  The |framesassubsections| option has no effect in |article| mode.
+
+  \example
+\begin{verbatim}
+\documentclass[notes]{beamer}
+
+\usepackage[framesassubsections]{beamerprosper}
+
+\title{A Beamer Presentation Using (HA-)Prosper Commands}
+\subtitle{Subtitles Are Also Supported}
+\author{Till Tantau}
+\institution{The Institution is Mapped To Institute}
+
+\begin{document}
+
+\maketitle
+
+\tsectionandpart{Introduction}
+
+\overlays{2}{
+  \begin{itemstep}
+  \item
+    This is a beamer presentation.
+  \item
+    You can use the prosper and the HA-prosper syntax.
+  \item
+    This is done by mapping prosper and HA-prosper commands to beamer
+    commands.
+  \item
+    The emulation is by no means perfect.
+  \end{itemstep}
+\end{slide}
+}
+
+\section{Second Section}
+\subsection{A subsection}
+\begin{frame}
+  \frametitle{A frame created using the \texttt{frame} environment.}
+
+  \begin{itemize}[<+->]
+  \item You can still use the original beamer syntax.
+  \item The emulation is intended only to make recycling slides
+    easier, not to install a whole new syntax for beamer.
+  \end{itemize}
+\end{frame}
+
+\begin{notes}{Notes for these slides}
+My notes for these slides.
+\end{notes}
+\end{document}
+\end{verbatim}
+  You can run, for example, pdf\LaTeX\ on the file to get a \beamer\ presentation with overlays. Adding the |notes| option will also show the notes. Certain commands, like |\LeftFoot|, are ignored. You can change the theme using the usual commands. You can also use all normal \beamer\ commands and concepts, like overlay-specifications, in the file. You can also create an |article| version by using the class |article| and including the package |beamerarticle|.
+\end{package}
+
+In the following, the effects of \prosper\ commands in \beamer\ are listed.
+
+\begin{command}{\email\marg{text}}
+  Simply typesets its argument in typewriter text. Should hence be given \emph{inside} the |\author| command.
+\end{command}
+
+\begin{command}{\institution\marg{text}}
+  This command is mapped to \beamer's |\institute| command if given \emph{outside} the |\author| command, otherwise it typesets its argument in a smaller font.
+\end{command}
+
+\begin{command}{\Logo\opt{|(|\meta{x}|,|\meta{y}|)|}\marg{logo text}}
+  This is mapped to |\logo{|\meta{logo text}|}|. The coordinates are ignored.
+\end{command}
+
+\begin{environment}{{slide}\oarg{options}\marg{frame title}}
+  Inserts a frame with the |fragile=singleslide| option set. The \meta{frame title} will be enclosed in a |\frametitle| command.
+
+  The following \meta{options} may be given:
+  \begin{itemize}
+  \item
+    \declare{|trans=|\meta{prosper transition}} installs the specified \meta{prosper transition} as the transition effect when showing the slide.
+  \item
+    \declare{\meta{prosper transition}} has the same effect as |trans=|\meta{prosper transition}.
+  \item
+    \declare{|toc=|\meta{entry}} overrides the subsection table of contents entry created by this slide by \meta{entry}. Note that a subsection entry is created for a slide only if the |framesassubsections| options is specified.
+  \item
+    \declare{|template|=\meta{text}} is ignored.
+  \end{itemize}
+
+  \example
+  The following two texts have the same effect:
+
+\begin{verbatim}
+\begin{slide}[trans=Glitter,toc=short]{A Title}
+  Hi!
+\end{slide}
+\end{verbatim}
+  and
+\begin{verbatim}
+\subsection{short} % omitted, if framesassubsections is not specified
+\begin{frame}[fragile=singleslide]
+  \transglitter
+  \frametitle{A Title}
+  Hi!
+\end{frame}
+\end{verbatim}
+\end{environment}
+
+\begin{command}{\overlays\marg{number}\marg{slide environment}}
+  This will put the \meta{slide environment} into a frame that does not have the |fragile| option and which can hence contain overlayed text. The \meta{number} is ignored since the number of necessary overlays is computed automatically by \beamer.
+
+  \example
+  The following code fragments have the same effect:
+
+\begin{verbatim}
+\overlays{2}{
+\begin{slide}{A Title}
+  \begin{itemstep}
+  \item Hi!
+  \item Ho!
+  \end{itemstep}
+\end{slide}}
+\end{verbatim}
+  and
+\begin{verbatim}
+\subsection{A Title} % omitted, if framesassubsections is not specified
+\begin{frame}
+  \frametitle{A Title}
+  \begin{itemstep}
+  \item Hi!
+  \item Ho!
+  \end{itemstep}
+\end{frame}
+\end{verbatim}
+\end{command}
+
+\begin{command}{\fromSlide\marg{slide number}\marg{text}}
+  This is mapped to |\uncover<|\meta{slide number}|->{|\meta{text}|}|.
+\end{command}
+
+\begin{command}{\fromSlide|*|\marg{slide number}\marg{text}}
+  This is mapped to |\only<|\meta{slide number}|->{|\meta{text}|}|.
+\end{command}
+
+\begin{command}{\onlySlide\marg{slide number}\marg{text}}
+  This is mapped to |\uncover<|\meta{slide number}|>{|\meta{text}|}|.
+\end{command}
+
+\begin{command}{\onlySlide|*|\marg{slide number}\marg{text}}
+  This is mapped to |\only<|\meta{slide number}|>{|\meta{text}|}|.
+\end{command}
+
+\begin{command}{\untilSlide\marg{slide number}\marg{text}}
+  This is mapped to |\uncover<-|\meta{slide number}|>{|\meta{text}|}|.
+\end{command}
+
+\begin{command}{\untilSlide|*|\marg{slide number}\marg{text}}
+  This is mapped to |\only<-|\meta{slide number}|>{|\meta{text}|}|.
+\end{command}
+
+\begin{command}{\FromSlide\marg{slide number}}
+  This is mapped to |\onslide<|\meta{slide number}|->|.
+\end{command}
+
+\begin{command}{\OnlySlide\marg{slide number}}
+  This is mapped to |\onslide<|\meta{slide number}|>|.
+\end{command}
+
+\begin{command}{\UntilSlide\marg{slide number}}
+  This is mapped to |\onslide<-|\meta{slide number}|>|.
+\end{command}
+
+\begin{command}{\slideCaption\marg{text}}
+  This is mapped to |\date{|\meta{text}|}|.
+\end{command}
+
+\begin{command}{\fontTitle\marg{text}}
+  Simply inserts \meta{text}.
+\end{command}
+
+\begin{command}{\fontText\marg{text}}
+  Simply inserts \meta{text}.
+\end{command}
+
+\begin{command}{\PDFtransition\marg{prosper transition}}
+  Maps the \meta{prosper transition} to an appropriate |\transxxxx| command.
+\end{command}
+
+\begin{environment}{{Itemize}}
+  This is mapped to |itemize|.
+\end{environment}
+
+\begin{environment}{{itemstep}}
+  This is mapped to |itemize| with the option |[<+->]|.
+\end{environment}
+
+\begin{environment}{{enumstep}}
+  This is mapped to |enumerate| with the option |[<+->]|.
+\end{environment}
+
+\begin{command}{\hiddenitem}
+  This is mapped to |\addtocounter{beamerpauses}{1}|.
+\end{command}
+
+\begin{command}{\prosperpart\oarg{options}\marg{text}}
+  This command has the same effect as \prosper's |\part| command. \beamer's normal |\part| command retains its normal semantics. Thus, you might wish to replace all occurrences of |\part| by |\prosperpart|.
+\end{command}
+
+\begin{command}{\tsection\opt{|*|}\marg{section name}}
+  Creates a section named \meta{section name}. The star, if present, is ignored.
+\end{command}
+
+\begin{command}{\tsectionandpart\opt{|*|}\marg{part text}}
+  Mapped to a |\section| command followed by a |\prosperpart| command.
+
+  \articlenote
+  In |article| mode, no part page is added.
+\end{command}
+
+\begin{command}{\dualslide\oarg{x}\oarg{y}\oarg{z}\marg{options}\marg{left column}\marg{right column}}
+  This command is mapped to a |columns| environment. The \meta{left column} text is shown in the left column, the \meta{right column} text is shown in the right column. The options \meta{x}, \meta{y}, and \meta{z} are ignored. Also, all \meta{options} are ignored, except for \declare{|lcolwidth=|} and \declare{|rcolwidth=|}. These set the width of the left or right column, respectively.
+\end{command}
+
+\begin{command}{\PDForPS\marg{PostScript text}\marg{PDF text}}
+  Inserts either the \meta{PostScript text} or the \meta{PDF text}, depending on whether |latex| or |pdflatex| is used. When porting, the \meta{PDF text} will most likely be \emph{incorrect}, since in \prosper\ the \meta{PDF text} is actually PostScript text that is later transformed to \pdf\ by some external program.
+
+  If the \meta{PDF text} contains an |\includegraphics| command (which is its usual use), you should change the name of the graphic file that is included to a name ending |.pdf|, |.png|, or |.jpg|. Typically, you will have to convert your graphic to this format.
+\end{command}
+
+\begin{command}{\onlyInPDF\meta{PDF text}}
+  The \meta{PDF text} is only included if |pdflatex| is used. The same as for the command |\PDForPS| applies here.
+\end{command}
+
+\begin{command}{\onlyInPS\meta{PS text}}
+  The \meta{PS text} is only included if |latex| is used.
+\end{command}
+
+\begin{environment}{{notes}\marg{title}}
+  Mapped to |\note{\textbf{|\meta{title}|}|\meta{environment contents}|}| (more or less).
+\end{environment}
+
+The following commands are parsed by \beamer, but have no effect:
+\begin{itemize}\itemsep=0pt\parskip=0pt
+\item |\myitem|,
+\item |\FontTitle|,
+\item |\FontText|,
+\item |\ColorFoot|,
+\item |\DefaultTransition|,
+\item |\NoFrenchBabelItemize|,
+\item |\TitleSlideNav|,
+\item |\NormalSlideNav|,
+\item |\HAPsetup|,
+\item |\LeftFoot|, and
+\item |\RightFoot|.
+\end{itemize}
+
+
+\subsection{Seminar}
+\label{section-seminar}
+
+The package |beamerseminar| maps a subset of the commands of the \seminar\ package to \beamer. As for \prosper, the emulation cannot be perfect. For example, no portrait slides are supported, no automatic page breaking, the framing of slides is not emulated. Unfortunately, for all frames (|slide| environments) that contain overlays, you have to put the environment into a |frame| environment by hand'' and must remove all occurrences of |\newslide| inside the environment by closing the slide and opening a new one (and then putting these into |frame| environments).
+
+The workflow for the migration is the following:
+\begin{enumerate}
+\item
+  Use the document class |beamer|, not |seminar|. Most options passed to |seminar| do not apply to |beamer| and should be omitted.
+\item
+  If you copy parts of a presentation that is mixed with normal text, add the |ignorenonframetext| option and place \emph{every} |slide| environment inside a |frame| since \beamer\ will not recognize the |\begin{slide}| as the beginning of a frame.
+\item
+  Add a |\usepackage{beamerseminar}| to start the emulation. Add the option |accumulated| if you wish to create a presentation to be held with a video projector.
+\item
+  Possibly add commands to install themes and templates.
+\item
+  There should not be commands in the preamble having to do with page and slide styles. They do not apply to |beamer|.
+\item
+  If a |\newslide| command is used in a |slide| (or similarly |slide*|) environment that contains an overlay, you must replace it by a closing |\end{slide}| and an opening |\begin{slide}|.
+\item
+  Next, for each |slide| or |slide*| environment that contains an overlay, you must place a |frame| environment around it. You can remove the |slide| environment (and hence effectively replace it by |frame|), unless you use the |accumulated| option.
+\item
+  If you use |\section| or |\subsection| commands inside slides, you will have to move them \emph{outside} the frames. It may then be necessary to add a |\frametitle| command to the slide.
+\item
+  If you use pdf\LaTeX\ to typeset the presentation, you cannot include PostScript files. You should convert them to |.pdf| or to |.png| and adjust any usage of |\includegraphics| accordingly.
+\item
+  When starting to change things, you can use all of \beamer's commands and even mix them with \seminar\ commands.
+\end{enumerate}
+
+An example can be found in the file |beamerexample-seminar.tex|.
+
+There are, unfortunately, numerous places where you may run into problems:
+\begin{itemize}
+\item
+  The whole |note| management of |seminar| is so different from |beamer|'s, that you will have to edit notes by hand.'' In particular, commands like |\ifslidesonly| and |\ifslide| may not do exactly what you expect.
+\item
+  If you use |pstricks| commands, you will either have to stick to using |latex| and |dvips| or will have to work around them using, for example, |pgf|. Porting lots of |pstricks| code is bound to be difficult, if you wish to switch over to |pdflatex|, so be warned.
+\item
+  If the file cannot be compiled because some \seminar\ command is not implemented, you will have to delete this command and try to mimick its behavior using some \beamer\ command.
+\end{itemize}
+
+\begin{package}{{beamerseminar}}
+  Include this package in a |beamer| presentation to get access to \seminar\ commands. Use |beamer| as the document class, not |seminar|. Most of the options passed to the class |seminar| make no sense in |beamer|, so just delete them.
+
+  This package takes the following options:
+  \begin{itemize}
+  \item
+    \declare{|accumulated|} causes overlays to be accumulated. The original behavior of the \seminar\ package is that in each overlay only the really new'' part of the overlay is shown. This makes sense, if you really print out the overlays on transparencies and then really stack overlays on top of each other. For a presentation with a video projector, you rather want to present an accumulated'' version of the overlays. This is what this option does: When the new material of the $i$-th overlay is shown, the material of all previous overlays is also shown.
+  \end{itemize}
+
+  \example
+  The following example is an extract of |beamerexample-seminar.tex|:
+
+\begin{verbatim}
+\documentclass[ignorenonframetext]{beamer}
+\usepackage[accumulated]{beamerseminar}
+\usepackage{beamerthemeclassic}
+
+\title{A beamer presentation using seminar commands}
+\author{Till Tantau}
+
+
+\begin{document}
+
+\begin{frame}
+  \maketitle
+\end{frame}
+
+This is some text outside any frame. It will only be shown in the
+article version.
+
+\begin{frame}
+  \begin{slide}
+    \heading{This is a frame title.}
+
+    \begin{enumerate}
+      {\overlay1
+      \item Overlays are a little tricky in seminar.
+        {\overlay2
+        \item But it is possible to use them in beamer.
+        }
+      }
+    \end{enumerate}
+  \end{slide}
+\end{frame}
+\end{document}
+\end{verbatim}
+  You can use all normal \beamer\ commands and concepts, like overlay-specifications, in the file. You can also create an |article| version by using the class |article| and including the package |beamerarticle|.
+\end{package}
+
+In the following, the effects of \seminar\ commands in \beamer\ are listed.
+
+\begin{command}{\overlay\marg{number}}
+  Shows the material till the end of the current \TeX\ group only on overlay numbered $\hbox{\meta{number}}+1$ or, if the |accumulated| option is given, from that overlay on. Usages of this command may be nested (as in \seminar). If an |\overlay| command is given inside another, it temporarily overrules'' the outer one as demonstrated in the following example, where it is assumed that the |accumulated| option is given.
+
+  \example
+\begin{verbatim}
+\begin{frame}
+  \begin{slide}
+    This is shown from the first slide on.
+    {\overlay{2}
+      This is shown from the third slide on.
+      {\overlay{1}
+        This is shown from the second slide on.
+      }
+      This is shown once more from the third slide on.
+    }
+  \end{slide}
+\end{frame}
+\end{verbatim}
+\end{command}
+
+\begin{environment}{{slide}\opt{|*|}}
+  Mainly installs an |\overlay{0}| around the \meta{environment contents}. If the |accumulated| option is given, this has no effect, but otherwise it will cause the main text of the slide to be shown \emph{only} on the first slide. This is useful if you really wish to physically place slides on top of each other.
+
+  The starred version does the same as the nonstarred one.
+
+  If this command is not issued inside a |\frame|, it sets up a frame with the |fragile=singleframe| option set. Thus, this frame will contain only a single slide.
+
+  \example
+\begin{verbatim}
+\begin{slide}
+  Some text.
+\end{slide}
+
+\frame{
+\begin{slide}
+  Some text. And an {\overlay{1} overlay}.
+\end{slide}
+}
+\end{verbatim}
+\end{environment}
+
+\begin{command}{\red}
+  Mapped to |\color{red}|.
+\end{command}
+
+\begin{command}{\blue}
+  Mapped to |\color{blue}|.
+\end{command}
+
+\begin{command}{\green}
+  Mapped to |\color{green}|.
+\end{command}
+
+\begin{command}{\ifslide}
+  True in the |presentation| modes, false in the |article| mode.
+\end{command}
+
+\begin{command}{\ifslidesonly}
+  Same as |\ifslide|.
+\end{command}
+
+\begin{command}{\ifarticle}
+  False in the |presentation| modes, true in the |article| mode.
+\end{command}
+
+\begin{command}{\ifportrait}
+  Always false.
+\end{command}
+
+The following commands are parsed by \beamer, but have no effect:
+\begin{itemize}\itemsep=0pt\parskip=0pt
+\item |\ptsize|.
+\end{itemize}
+
+
+\subsection{Foil\TeX}
+\label{section-foiltex}
+
+The package |beamerfoils| maps a subset of the commands of the \foils\ package to \beamer. Since this package defines only few non-standard \TeX\ commands and since \beamer\ implements all the standard commands, the emulation layer is pretty simple.
+
+A copyright notice: The Foil\TeX\ package has a restricted license. For this reason, no example from the \foils\ package is included in the \beamer\ class. The emulation itself does not use the code of the \foils\ package (rather, it just maps \foils\ commands to \beamer\ commands). For this reason, our understanding is that the \emph{emulation} offered by the \beamer\ class is free'' and legally so. IBM has a copyright on the \foils\ class, not on the effect the commands of this class have. (At least, that's our understanding of things.)
+
+The workflow for the migration is the following:
+\begin{enumerate}
+\item
+  Use the document class |beamer|, not |foils|.
+\item
+  Add a |\usepackage{beamerfoils}| to start the emulation.
+\item
+  Possibly add commands to install themes and templates.
+\item
+  If the command |\foilhead| is used inside a |\frame| command or |frame| environment, it behaves like |\frametitle|. If it used outside a frame, it will start a new frame (with the |allowframebreaks| option, thus no overlays are allowed). This frame will persist till the next occurrence of |\foilhead| or of the new command |\endfoil|. Note that a |\frame| command will \emph{not} end a frame started using |\foilhead|.
+\item
+  If you rely on automatic frame creation based on |\foilhead|, you will need to insert an |\endfoil| before the end of the document to end the last frame.
+\item
+  If you use pdf\LaTeX\ to typeset the presentation, than you cannot include PostScript files. You should convert them to |.pdf| or to |.png| and adjust any usage of |\includegraphics| accordingly.
+\item
+  Sizes of objects are different in \beamer, since the scaling is done by the viewer, not by the class. Thus a framebox of size 6 inches will be way too big in a \beamer\ presentation. You will have to manually adjust explicit dimension occurring in a foil\TeX\ presentation.
+\end{enumerate}
+
+\begin{package}{{beamerfoils}}
+  Include this package in a |beamer| presentation to get access to \foils\ commands. Use |beamer| as the document class, not |foils|.
+
+  \example
+  In the following example, frames are automatically created. The |\endfoil| at the end is needed to close the last frame.
+
+\begin{verbatim}
+\documentclass{beamer}
+\usepackage{beamerfoils}
+
+\begin{document}
+
+\maketitle
+
+
+This is on the first frame.
+\pagebreak
+This is on the second frame, which is a continuation of the first.
+
+
+This is on the third frame.
+
+\endfoil
+\end{document}
+\end{verbatim}
+
+  \example
+  In this example, frames are manually inserted. No |\endfoil| is needed.
+
+\begin{verbatim}
+\documentclass{beamer}
+\usepackage{beamerfoils}
+
+\begin{document}
+
+\frame{\maketitle}
+
+\frame{
+This is on the first frame.
+}
+
+\frame{
+This is on the second frame.
+}
+\end{document}
+\end{verbatim}
+\end{package}
+
+In the following, the effects of \foils\ commands in \beamer\ are listed.
+
+\begin{command}{\MyLogo\marg{logo text}}
+  This is mapped to |\logo|, though the logo is internally stored, such that it can be switched on and off using |\LogoOn| and |\LogoOff|.
+\end{command}
+
+\begin{command}{\LogoOn}
+  Makes the logo visible.
+\end{command}
+
+\begin{command}{\LogoOff}
+  Makes the logo invisible.
+\end{command}
+
+  If used inside a |\frame| command or |frame| environment, this is mapped to |\frametitle{|\meta{frame title}|}|. If used outside any frames, a new frame is started with the option |allowframebreaks|. If a frame was previously started using this command, it will be closed before the next frame is started. The \meta{dimension} is ignored.
+\end{command}
+
+  This command has exactly the same effect as |\foilhead|.
+\end{command}
+
+\begin{command}{\endfoil}
+  This is a command that is \emph{not} available in \foils. In \beamer, it can be used to end a frame that has automatically been opened using |\foildhead|. This command must be given before the end of the document if the last frame was opened using |\foildhead|.
+\end{command}
+
+\begin{environment}{{boldequation}\opt{|*|}}
+  This is mapped to the |equation| or the |equation*| environment, with |\boldmath| switched on.
+\end{environment}
+
+\begin{command}{\FoilTeX}
+  Typesets the foil\TeX\ name as in the \foils\ package.
+\end{command}
+
+\begin{command}{\bm\marg{text}}
+  Implemented as in the \foils\ package.
+\end{command}
+
+\begin{command}{\bmstyle\marg{text}\marg{more text}}
+  Implemented as in the \foils\ package.
+\end{command}
+
+The following additional theorem-like environments are predefined:
+\begin{itemize}
+\item |Theorem*|,
+\item |Lemma*|,
+\item |Corollary*|,
+\item |Proposition*|, and
+\item |Definition*|.
+\end{itemize}
+For example, the first is defined using |\newtheorem*{Theorem*}{Theorem}|.
+
+The following commands are parsed by \beamer, but have no effect:
+\begin{itemize}
+\item |\leftfooter|,
+\item |\rightfooter|,
+\item |\Restriction|, and
+\item |\marginpar|.
+\end{itemize}
+
+
+\subsection{\TeX Power}
+\label{section-texpower}
+
+The package |beamertexpower| maps a subset of the commands of the \texpower\ package, due to Stephan Lehmke, to \beamer. This subset is currently rather small, so a lot of adaptions may be necessary. Note that \texpower\ is not a full class by itself, but a package that needs another class, like |seminar| or |prosper| to do the actual typesetting. It may thus be necessary to additionally load an emulation layer for these also. Indeed, it \emph{might} be possible to directly use \texpower\ inside \beamer, but we have not tried that. Perhaps this will be possible in the future.
+
+Currently, the package |beamertexpower| mostly just maps the |\stepwise| and related commands to appropriate \beamer\ commands. The |\pause| command need not be mapped since it is directly implemented by \beamer\ anyway.
+
+The workflow for the migration is the following:
+\begin{enumerate}
+\item
+  Replace the document class by |beamer|. If the document class is |seminar| or |prosper|, you can use the above emulation layers, that is, you can include the files |beamerseminar| or |beamerprosper| to emulate the class.
+
+  All notes on what to do for the emulation of \seminar\ or \prosper\ also apply here.
+\item
+\end{enumerate}
+
+\begin{package}{{beamertexpower}}
+  Include this package in a |beamer| presentation to get access to the \texpower\ commands having to do with the |\stepwise| command.
+\end{package}
+
+A note on the |\pause| command: Both \beamer\ and \texpower\ implement this command and they have the same semantics; so there is no need to map this command to anything different in |beamertexpower|. However, a difference is that |\pause| can be used almost anywhere in \beamer, whereas it may only be used in non-nested situations in \texpower. Since \beamer\ is only more flexible than \texpower\ here, this will not cause problems when porting.
+
+In the following, the effect of \texpower\ commands in \beamer\ are listed.
+
+\begin{command}{\stepwise\marg{text}}
+  As in \texpower, this initiates text in which commands like |\step| or |\switch| may be given. Text contained in a |\step| command will be enclosed in an |\only| command with the overlay specification |<+(1)->|. This means that the text of the first |\step| is inserted from the second slide onward, the text of the second |\step| is inserted from the third slide onward, and so on.
+\end{command}
+
+\begin{command}{\parstepwise\marg{text}}
+  Same as |\stepwise|, only |\uncover| is used instead of |\only| when mapping the |\step| command.
+\end{command}
+
+\begin{command}{\liststepwise\marg{text}}
+  Same as |\stepwise|, only an invisible horizontal line is inserted before the \meta{text}. This is presumably useful for solving some problems related to vertical spacing in \texpower.
+\end{command}
+
+\begin{command}{\step\marg{text}}
+  This is either mapped to |\only<+(1)->|\meta{text} or to |\uncover<+(1)->|\meta{text}, depending on whether this command is used inside a |\stepwise| environment or inside a |\parstepwise| environment.
+\end{command}
+
+\begin{command}{\steponce\marg{text}}
+  This is either mapped to |\only<+(1)>|\meta{text} or to |\uncover<+(1)>|\meta{text}, depending on whether this command is used inside a |\stepwise| environment or inside a |\parstepwise| environment.
+\end{command}
+
+\begin{command}{\switch\marg{alternate text}\marg{text}}
+  This is mapped to |\alt<+(1)->{|\meta{text}|}{|\meta{alternate text}|}|. Note that the arguments are swapped.
+\end{command}
+
+\begin{command}{\bstep\marg{text}}
+  This is always mapped to |\uncover<+(1)->|\meta{text}.
+\end{command}
+
+\begin{command}{\dstep}
+  This just advances the counter |beamerpauses| by one. It has no other effect.
+\end{command}
+
+\begin{command}{\vstep}
+  Same as |\dstep|.
+\end{command}
+
+\begin{command}{\restep\marg{text}}
+  Same as |\step|, but the \meta{text} is shown on the same slide as the previous |\step| command. This is implemented by first decreasing the counter |beamerpauses| by one before calling |\step|.
+\end{command}
+
+\begin{command}{\reswitch\marg{alternate text}\meta{text}}
+  Like |\restep|, only for the |\switch| command.
+\end{command}
+
+\begin{command}{\rebstep\meta{text}}
+  Like |\restep|, only for the |\bstep| command.
+\end{command}
+
+\begin{command}{\redstep}
+  This command has no effect.
+\end{command}
+
+\begin{command}{\revstep}
+  This command has no effect.
+\end{command}
+
+\begin{command}{\boxedsteps}
+  Temporarily (for the current \TeX\ group) changes the effect of |\step| to issue an |\uncover|, even if used inside a |\stepwise| environment.
+\end{command}
+
+\begin{command}{\nonboxedsteps}
+  Temporarily (for the current \TeX\ group) changes the effect of |\step| to issue an |\only|, even if used inside a |\parstepwise| environment.
+\end{command}
+
+\begin{command}{\code\marg{text}}
+  Typesets the argument using a boldface typewriter font.
+\end{command}
+
+\begin{command}{\codeswitch}
+  Switches to a boldface typewriter font.
+\end{command}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-emulation.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-fonts.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-fonts.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,251 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\section{Fonts}
+\label{section-fonts}
+
+The first subsection introduces the predefined font themes that come with \beamer\ and which make it easy to change the fonts used in a presentation. The next subsection describes further special commands for changing some basic attributes of the fonts used in a presentation. The last subsection explains how you can get a much more fine-grained control over the fonts used for every individual element of a presentation.
+
+
+\subsection{Font Themes}
+
+\beamer\ comes with a set of font themes. When you use such a theme, certain fonts are changed as described below. You can use several font themes in concert. For historical reasons, you cannot change all aspects of the fonts used using font themes---in some cases special commands and options are needed, which are described in the next subsection.
+
+The following font themes only change certain font attributes, they do not choose special font families (although that would also be possible and themes doing just that might be added in the future). Currently, to change the font family, you need to load special packages as explained in the next subsection.
+
+
+\begin{fontthemeexample}{default}
+  The default font theme installs a sans serif font for all text of the presentation. The default theme installs different font sizes for things like titles or head- and footlines, but does not use boldface or italics for highlighting.'' To change some or all text to a serif font, use the |serif| theme.
+
+  Note: The command |\mathrm| will always produce upright (not slanted), serif text and the command |\mathsf| will always produce upright, sans-serif text. The command |\mathbf| will produce upright, bold-face, sans-serif or serif text, depending on whether |mathsans| or |mathserif| is used.
+
+  To produce an upright, sans-serif or serif text, depending on whether |mathsans| or |mathserif| is used, you can use for instance the command |\operatorname| from the |amsmath| package. Using this command instead of |\mathrm| or |\mathsf| directly will automatically adjust upright mathematical text if you switch from sans-serif to serif or back.
+\end{fontthemeexample}
+
+\begin{fontthemeexample*}{professionalfonts}
+  This font theme does not really change any fonts. Rather, it \emph{suppresses} certain internal replacements performed by \beamer. If you use professional fonts'' (fonts that you buy and that come with a complete set of every symbol in all modes), you do not want \beamer\ to meddle with the fonts you use. \beamer\ normally replaces certain character glyphs in mathematical text by more appropriate versions. For example, \beamer\ will normally replace glyphs such that the italic characters from the main font are used for variables in mathematical text. If your professional font package takes care of this already, \beamer's meddling should be switched off. Note that \beamer's substitution is automatically turned off if one of the following packages is loaded: |arevmath|, |hvmath|, |kpfonts|, |lmodern|, |lucidabr|, |lucimatx|, |mathastext|, |mathpmnt|, |mathpple|, |mathtime|, |mtpro|, and |mtpro2|. If your favorite professional font package is not among these, use the |professionalfonts| option (and write us an email, so that the package can be added).
+\end{fontthemeexample*}
+
+\begin{fontthemeexample}[\oarg{options}]{serif}
+  This theme causes all text to be typeset using the default serif font (except if you specify certain \meta{options}). You might wish to consult Section~\ref{section-guidelines-serif} on whether you should use serif fonts.
+
+  The following \meta{options} may be given:
+  \begin{itemize}
+  \item
+    \declare{|stillsansserifmath|}
+    causes mathematical text still to be typeset using sans serif. This option only makes sense if you also use the |stillsansseriftext| option since sans serif math inside serif text looks silly.
+  \item
+    \declare{|stillsansserifsmall|}
+    will cause small'' text to be still typeset using sans serif. This refers to the text in the headline, footline, and sidebars. Using this options is often advisable since small text is often easier to read in sans serif.
+  \item
+    \declare{|stillsansseriflarge|}
+    will cause large'' text like the presentation title or the frame title to be still typeset using sans serif. Sans serif titles with serif text are a popular combination in typography.
+  \item
+    \declare{|stillsansseriftext|}
+    will cause normal text (none of the above three) to be still typeset using sans serif. If you use this option, you should most likely also use the first two. However, by not using |stillsansseriflarge|, you get a serif (possibly italic) title over a sans serif text. This can be an interesting visual effect. Naturally, interesting typographic effect'' can mean terrible typographic effect'' if you choose the wrong fonts combinations or sizes. You'll need some typographic experience to judge this correctly. If in doubt, try asking someone who should know.
+  \item
+    \declare{|onlymath|}
+    is a short-cut for selecting all of the above options except for the first. Thus, using this option causes only mathematical text to by typeset using a serif font. Recall that, by default, mathematical formulas are also typeset using sans-serif letters. In most cases, this is visually the most pleasing and easily readable way of typesetting mathematical formulas if the surrounding text is typeset using sans serif. However, in mathematical texts the font used to render, say, a variable is sometimes used to differentiate between different meanings of this variable. In such case, it may be necessary to typeset mathematical text using serif letters. Also, if you have a lot of mathematical text, the audience may be quicker to parse'' it if it is typeset the way people usually read mathematical text: in a serif font.
+  \end{itemize}
+\end{fontthemeexample}
+
+\begin{fontthemeexample}[\oarg{options}]{structurebold}
+  This font theme will cause titles and text in the headlines, footlines, and sidebars to be typeset in a bold font.
+
+  The following \meta{options} may be given:
+  \begin{itemize}
+  \item
+    \declare{|onlysmall|}
+    will cause only small'' text to be typeset in bold. More precisely, only the text in the headline, footline, and sidebars is changed to be typeset in bold. Large titles are not affected.
+  \item
+    \declare{|onlylarge|}
+    will cause only large'' text to be typeset in bold. These are the main title, frame titles, and section entries in the table of contents.
+  \end{itemize}
+
+  As pointed out in Section~\ref{section-sizes}, you should use this theme (possibly with the |onlysmall| option) if your font is not scaled down properly or for light-on-dark text.
+
+  The normal themes do not install this theme by default, while the old compatibility themes do. Since you can reload the theme once it has been loaded, you cannot use this theme with the old compatibility themes to set also titles to a bold font.
+\end{fontthemeexample}
+
+\begin{fontthemeexample}[\oarg{options}]{structureitalicserif}
+  This theme is similarly as the |structurebold| font theme, but where |structurebold| makes text bold, this theme typesets it in italics and in the standard serif font. The same \meta{options} as for the |structurebold| theme are supported. See Section~\ref{section-italics} for the pros and cons of using italics.
+\end{fontthemeexample}
+
+\begin{fontthemeexample}[\oarg{options}]{structuresmallcapsserif}
+  Again, this theme does exactly the same as the |structurebold| font theme, only this time text is set using small caps and a serif font. The same \meta{options} as for the |structurebold| theme are supported. See Section~\ref{section-smallcaps} for the pros and cons of using small caps.
+\end{fontthemeexample}
+
+
+\subsection{Font Changes Made Without Using Font Themes}
+
+While most font decisions can be made using font themes, for historical reasons some changes can only be made using class options or by loading special packages. These options are explained in the following. Possibly, these options will be replaced by themes in the future.
+
+\subsubsection{Choosing a Font Size for Normal Text}
+
+As pointed out in Section~\ref{section-sizes}, measuring the default font size in points is not really a good idea for presentations. Nevertheless, \beamer\ does just that, setting the default font size to 11pt as usual. This may seem ridiculously small, but the actual size of each frame size is by default just 128mm by 96mm and the viewer application enlarges the font. By specifying a default font size smaller than 11pt you can put more onto each slide, by specifying a larger font size you can fit on less.
+
+To specify the font size, you can use the following class options:
+
+\begin{classoption}{8pt}
+  This is way too small. Requires that the package |extsize| is installed.
+\end{classoption}
+
+\begin{classoption}{9pt}
+  This is also too small. Requires that the package |extsize| is installed.
+\end{classoption}
+
+\begin{classoption}{10pt}
+  If you really need to fit more onto each frame, use this option. Works without |extsize|.
+\end{classoption}
+
+\begin{classoption}{smaller}
+  Same as the |10pt| option. \end{classoption}
+
+\begin{classoption}{11pt}
+  The default font size. You need not specify this option.
+\end{classoption}
+
+\begin{classoption}{12pt}
+  Makes all fonts a little bigger, which makes the text more readable. The downside is that less fits onto each frame.
+\end{classoption}
+
+\begin{classoption}{bigger}
+  Same as the |12pt| option.
+\end{classoption}
+
+\begin{classoption}{14pt}
+  Makes all fonts somewhat bigger. Requires |extsize| to be installed.
+\end{classoption}
+
+\begin{classoption}{17pt}
+  This is about the default size of PowerPoint and OpenOffice.org Impress. Requires |extsize| to be installed.
+\end{classoption}
+
+\begin{classoption}{20pt}
+  This is really huge. Requires |extsize| to be installed.
+\end{classoption}
+
+\subsubsection{Choosing a Font Family}
+
+\label{section-substition}
+
+By default, \beamer\ uses the Computer Modern fonts. To change this, you can use one of the prepared packages of \LaTeX's font mechanism. For example, to change to Times/Helvetica, simply add
+\begin{verbatim}
+\usepackage{mathptmx}
+\usepackage{helvet}
+\end{verbatim}
+in your preamble. Note that if you do not use the |serif| font theme, Helvetica (not Times) will be selected as the text font.
+
+There may be many other fonts available on your installation. Typically, at least some of the following packages should be available: |arev|, |avant|, |bookman|, |chancery|, |charter|, |euler|, |helvet|, |lmodern|, |mathtime|, |mathptm|, |mathptmx|, |newcent|, |palatino|, |pifont|, |utopia|.
+
+\subsubsection{Choosing a Font Encodings}
+\label{section-font-encoding}
+
+The same font can come in different encodings, which are (very roughly spoken) the ways the characters of a text are mapped to glyphs (the actual shape of a particular character in a particular font at a particular size). In \TeX\ two encodings are often used with Latin characters: the T1~encoding and the OT1~encoding (old T1~encoding).
+
+Conceptually, the newer T1~encoding is preferable over the old OT1~encoding. For example, hyphenation of words containing umlauts (like the famous German word Fr\"aulein) will work only if you use the T1~encoding. Unfortunately, the EC fonts, that is, the T1-encoded Computer Modern fonts, are distributed on small installations just as MetaFont sources and only have bitmap renditions of each glyph. For this reason, using the T1-encoded EC fonts on such small installations will produce \pdf\ files that render poorly.
+
+\TeX\ Live (cross-platform; replaced older \texttt{teTeX} for \textsc{unix}\slash Linux) and MiK\TeX\ (for Windows platforms) can be installed with different levels of completeness. Concerning the Computer Modern fonts, the following packages can be installed: |cm-super| fonts, |lmodern| (Latin Modern) fonts, and |lgc| fonts, the latter containing the Latin, Greek, and Cyrillic alphabets. Concerning other fonts, the |txfonts| and |pxfonts| are two extended sets of the Times and the Palatino PostScript fonts, both packages containing extended sets of mathematical glyphs. Most other standard PostScript fonts are also available in T1~encoding.
+
+Among the packages that make available the Computer Modern fonts in the T1~encoding, the package |lmodern| may be suggested. If you use |lmodern|, several extra fonts become available (like a sans-serif boldface math) and extra symbols (like proper guillemots).
+
+To select the T1 encoding, use \verb|\usepackage[T1]{fontenc}|. Thus, if you have the LM~fonts installed, you could write
+\begin{verbatim}
+\usepackage[T1]{fontenc}
+\usepackage{lmodern}
+\end{verbatim}
+to get beautiful outline fonts and correct hyphenation. Note, however, that certain older versions of the LM~bundle did not include correct glyphs for ligatures like fi,'' which may cause trouble. Double check that all ligatures are displayed correctly and, if not, update your installation.
+
+Everything mentioned above applies to |pdflatex| and |latex|+|dvips|. Unlike those engines, |xelatex| and |lualatex| support OpenType fonts, and that means that you can use system fonts in your documents relatively easy. Details will eventually be documented in this manual. For now, you can take a look at the documentation for the |fontspec| package which supports both engines. Also, note that when you use |lualatex| or |xelatex| with EU2 or EU1 encoding, respectively, by default you get OpenType Latin Modern fonts.
+
+
+\subsection{Changing the Fonts Used for Different Elements of a Presentation}
+
+This section explains how \beamer's font management works.
+
+\subsubsection{Overview of Beamer's Font Management}
+
+\beamer's font mechanism is somewhat similar to \beamer's color mechanism, but not quite the same. As for colors, every \beamer\ element, like the frame titles, the document title, the footnotes, and so on has a certain \beamer-font. As for colors, on the one hand you can specify the font of each element individually; on the other hand fonts also use inheritance, thereby making it easy to globally change the fonts used for, say, titlelike things'' or for itemizelike things.''
+
+While a \beamer-color has a certain foreground and a certain background, either of which may be empty, a \beamer-font has a size, a shape, a series, and a family, each of which may be empty. The inheritance relation among \beamer-fonts is not necessarily the same as between \beamer-colors, though we have tried to match them whenever possible.
+
+Multiple inheritance plays a more important rule for fonts than it does for colors. A font might inherit the attributes of two different fonts. If one of them specifies that the font should be, say, boldface and the other specifies that the font should be, say, large, then the child font will be both large and bold.
+
+As for fonts, the description of the font used for an element is given after the description of the element.
+
+
+\subsubsection{Using Beamer's Fonts}
+
+To use a \beamer-font, you can use the command |\usebeamerfont|. Inside the templates for elements, this command will (typically) have already been called for you, so you will only seldomly have to use this command.
+
+\begin{command}{\usebeamerfont\opt{|*|}\marg{beamer-font name}}
+  This command changes the current font to the font specified by the \meta{beamer-font name}. The \meta{beamer-font name} can be a not-too-fancyful text and may contain spaces. Typical examples are |frametitle| or |section in toc| or |My Font 1|. \beamer-fonts can have (and should) have the same name as \beamer-templates and \beamer-colors.
+
+  \example |\usebeamerfont{frametitle}|
+  In the unstarred version of this command, the font is changed according to the attributes specified in the \meta{beamer-font name}, but unspecified attributes remain unchanged. For example, if the font specifies that the font should be bold,'' but specifies nothing else, and if the current font is large, then |\usebeamerfont| causes the current font to become large and bold.
+
+  In the starred version of this command, the font is first reset before the font's attributes are applied. Thus, in the above example of a \beamer-font having only the attribute boldface'' set, saying |\usebeamerfont*| will \emph{always} cause the current font to become a normal-size, normal-shape, bold, default-family font.
+\end{command}
+
+
+\subsubsection{Setting Beamer's Fonts}
+
+As for \beamer-colors, there exists a central command for setting and
+changing \beamer-fonts.
+
+\begin{command}{\setbeamerfont\opt{|*|}\marg{beamer-font name}\marg{attributes}}
+  This command sets or resets certain attributes of the \beamer-font \meta{beamer-font name}. In the unstarred version, this command just adds those attributes that have not been mentioned in a previous call and overwrites those that have been mentioned. Thus, the following two command blocks have the same effect:
+
+  \example
+\begin{verbatim}
+\setbeamerfont{frametitle}{size=\large}
+\setbeamerfont{frametitle}{series=\bfseries}
+
+\setbeamerfont{frametitle}{size=\large,series=\bfseries}
+\end{verbatim}
+
+  In the starred version, the font attributes are first completely reset, that is, set to be empty.
+
+  The following \meta{attributes} may be given:
+  \begin{itemize}
+  \item \declare{|size=|\meta{size command}} sets the size attribute of the \beamer\ font. The \meta{size command} should be a normal \LaTeX-command used for setting the font size or it should be empty. Useful commands include |\tiny|, |\scriptsize|, |\footnotesize|, |\small|, |\normalsize|, |\large|, |\Large|, |\huge|, and |\Huge|. \beamer\ also introduces the two font sizes |\Tiny| and |\TINY| for \emph{really} small text. But you should know \emph{exactly} what you are doing if you use them. You have been warned.
+
+    Note that there is a difference between specifying an empty command and specifying |\normalsize|: Making the size attribute empty'' means that the font size should not be changed when this font is used, while specifying |\normalsize| means that the size should be set to the normal size whenever this font is used.
+  \item \declare{|size*=|\marg{size in pt}\marg{baselineskip}} sets the size attribute of the font to the given \meta{size in pt} and the baseline skip to the given value. Note that, depending on what kind of font you use, not all font sizes may be available. Also, certain font sizes are much less desirable than other ones; the standard commands take care of choosing appropriate sizes for you. Do not use this option unless you have a good reason. This command has the same effect as |size={\fontsize|\marg{size in pt}\marg{baselineskip}|}|.
+  \item \declare{|shape=|\meta{shape command}} sets the shape attribute of the font. The command should be a command like |\itshape|, |\slshape|, |\scshape|, or |\upshape|.
+  \item \declare{|shape*=|\marg{shape attribute abbreviation}} sets the shape attribute of the font using the \LaTeX's abbreviations for attributes. This command has the same effect as |shape={\fontshape|\marg{shape attributes abbreviation}|}|.
+  \item \declare{|series=|\meta{series command}} sets the series'' attribute of the font. The command should be a command like |\bfseries|.
+  \item \declare{|series*=|\marg{series attribute abbreviation}} has the same effect as |series={\fontseries|\marg{series attributes abbreviation}|}|.
+  \item \declare{|family=|\meta{family command}} sets the font family attribute. The command should be a \LaTeX-font command like |\rmfamily| or |\sffamily|.
+  \item \declare{|family*=|\marg{family name}} sets the font family attribute to the given \meta{family name}. The command has the same effect as |family={\fontfamily|\marg{family name}|}|. The \meta{family name} is, normally, a somewhat cryptic abbreviation of a font family name that installed somewhere on the system. For example, the \meta{family name} for Times happens to be |ptm|. No one can remember these names, so it's perfectly normal if you have to look them up laboriously.
+  \item \declare{|parent=|\marg{parent list}} specifies a list of parent fonts. When the \beamer-font is used, the parents are used first. Thus, any font attributes set by one of the parents is inherited by the \beamer-font, except if this attribute is overwritten by the font.
+  \end{itemize}
+
+  \example
+\begin{verbatim}
+\setbeamerfont{parent A}{size=\large}
+\setbeamerfont{parent B}{series=\bfseries}
+\setbeamerfont{child}{parent={parent A, parent B},size=\small}
+
+\normalfont
+This text is in a normal font.
+\usebeamerfont{parent A}
+This text is large.
+\usebeamerfont{parent B}
+This text is large and bold.
+\usebeamerfont{parent B}
+This text is still large and bold.
+\usebeamerfont*{parent B}
+This text is only bold, but not large.
+\usebeamerfont{child}
+This text is small and bold.
+\end{verbatim}
+\end{command}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-fonts.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-frames.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-frames.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,1162 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2013,2015 by Vedran Mileti\'c, Joseph Wright
+% Copyright 2016 by Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\section{Creating Frames}
+\label{section-frames}
+
+
+\subsection{The Frame Environment}
+
+A presentation consists of a series of frames. Each frame consists of a series of slides. You create a frame using |frame| environment.\footnote{The command \texttt{\textbackslash frame} is supported for legacy documents.} All of the text that is not tagged by overlay specifications is shown on all slides of the frame. (Overlay specifications are explained in more detail in later sections. For the moment, let's just say that an overlay specification is a list of numbers or number ranges in pointed brackets that is put after certain commands as in |\uncover<1,2>{Text}|.) If a frame contains commands that have an overlay specification, the frame will contain multiple slides; otherwise it contains only one slide.
+
+\begin{environment}{{frame}\sarg{overlay specification}\opt{|[<|\meta{default overlay specification}|>]|}\oarg{options}\opt{\marg{title}\marg{subtitle}}}
+  The \meta{overlay specification} dictates which slides of a frame are to be shown. If left out, the number is calculated automatically. The \meta{environment contents} can be normal \LaTeX\ text, but may not contain |\verb| commands or |verbatim| environments or any environment that changes the character codes, unless the |fragile| option is given.
+
+  The optional \meta{title} is detected by an opening brace, that is, if the first thing in the frame is an opening brace then it is assumed that a frame title follows. Likewise, the optional \meta{subtitle} is detected the same way, that is, by an opening brace following the \meta{title}. The title and subtitle can also be given using the |\frametitle| and |\framesubtitle| commands.
+
+  The normal \LaTeX\ command |\frame| is available \emph{inside} frames with its usual meaning. Both outside and inside frames it is always available as {\color{red!75!black}|\framelatex|}.
+
+  \example
+\begin{verbatim}
+\begin{frame}{A title}
+  Some content.
+\end{frame}
+%% Same effect:
+\begin{frame}
+  \frametitle{A title}
+  Some content.
+\end{frame}
+\end{verbatim}
+
+  \example
+\begin{verbatim}
+\begin{frame}<beamer>{Outline}  % frame is only shown in beamer mode
+  \tabelofcontent[current]
+\end{frame}
+\end{verbatim}
+
+  Normally, the complete \meta{environment contents} is put on a slide. If the text does not fit on a slide, being too high, it will be squeezed as much as possible, a warning will be issued, and the text just extends unpleasantly over the bottom. You can use the option |allowframebreaks| to cause the \meta{frame text} to be split among several slides, though you cannot use overlays then. See the explanation of the |allowframebreaks| option for details.
+
+  The \meta{default overlay specification} is an optional argument that is detected'' according to the following rule: If the first optional argument in square brackets starts with a |<|, then this argument is a \meta{default overlay specification}, otherwise it is a normal \meta{options} argument. Thus |\begin{frame}[<+->][plain]| would be legal, but also |\begin{frame}[plain]|.
+
+  The effect of the \meta{default overlay specification} is the following: Every command or environment \emph{inside the frame} that accepts an action specification, see Section~\ref{section-action-specifications}, (this includes the |\item| command, the |actionenv| environment, |\action|, and all block environments) and that is not followed by an overlay specification gets the \meta{default overlay specification} as its specification. By providing an incremental specification like |<+->|, see Section~\ref{section-incremental}, this will essentially cause all blocks and all enumerations to be uncovered piece-wise (blocks internally employ action specifications).
+
+  \example
+  In this frame, the theorem is shown from the first slide on, the proof from the second slide on, with the first two itemize points shown one after the other; the last itemize point is shown together with the first one. In total, this frame will contain four slides.
+
+\begin{verbatim}
+\begin{frame}[<+->]
+  \begin{theorem}
+    $A = B$.
+  \end{theorem}
+  \begin{proof}
+    \begin{itemize}
+    \item Clearly, $A = C$.
+    \item As shown earlier,  $C = B$.
+    \item<3-> Thus $A = B$.
+    \end{itemize}
+  \end{proof}
+\end{frame}
+\end{verbatim}
+
+  The following \meta{options} may be given:
+  \begin{itemize}
+  \item
+    \declare{|allowdisplaybreaks|}\opt{|=|\meta{break desirability}} causes the AMS\TeX\ command |\allowdisplaybreaks|\penalty0|[|\meta{break desirability}|]| to be issued for the current frame. The \meta{break desirability} can be a value between 0 (meaning formulas may never be broken) and 4 (the default, meaning that formulas can be broken anywhere without any penalty). The option is just a convenience and makes sense only together with the |allowsframebreaks| option.
+  \item
+    \declare{|allowframebreaks|}\opt{|=|\meta{fraction}}. When this option is given, the frame will be automatically broken up into several frames if the text does not fit on a single slide. In detail, when this option is given, the following things happen:
+    \begin{enumerate}
+    \item
+      Overlays are not supported.
+    \item
+      Any notes for the frame created using the |\note| command will be inserted after the first page of the frame.
+    \item
+      Any footnotes for the frame will be inserted on the last page of the frame.
+    \item
+      If there is a frame title, each of the pages will have this frame title, with a special note added indicating which page of the frame that page is. By default, this special note is a Roman number. However, this can be changed using the following template.
+      \begin{element}{frametitle continuation}\yes\yes\yes
+        The text of this template is inserted at the end of every title of a frame with the |allowframebreaks| option set.
+        \begin{templateoptions}
+          \itemoption{default}{}
+          Installs a Roman number as the template. The number indicates the current page of the frame.
+
+          \itemoption{roman}{}
+          Alias for the default.
+
+          \itemoption{from second}{\oarg{text}}
+          Installs a template that inserts \meta{text} from the second page of a frame on. By default, the text inserted is |\insertcontinuationtext|,  which  in turn is |(cont.)| by default.
+        \end{templateoptions}
+        The following inserts are available:
+        \begin{templateinserts}
+          \iteminsert{\insertcontinuationcount}
+          inserts the current page of the frame as an arabic number.
+          \iteminsert{\insertcontinuationcountroman}
+          inserts the current page of the frame as an (uppercase) Roman number.
+          \iteminsert{\insertcontinuationtext}
+          just inserts the text |(cont.)| or, possibly, a translation thereof (like |(Forts.)| in German).
+        \end{templateinserts}
+      \end{element}
+    \end{enumerate}
+
+    If a frame needs to be broken into several pages, the material on all but the last page fills only 95\% of each page by default. Thus, there will be some space left at the top and/or bottom, depending on the vertical placement option for the frame. This yields a better visual result than a 100\% filling, which typically looks crowded. However, you can change this percentage using the optional argument \meta{fraction}, where 1 means 100\% and 0.5 means 50\%. This percentage includes the frame title. Thus, in order to split a frame roughly in half,'' you should give 0.6 as \meta{fraction}.
+
+    Most of the fine details of normal \TeX\ page breaking also apply to this option. For example, when you wish equations to be broken automatically, be sure to use the |\allowdisplaybreaks| command. You can insert |\break|, |\nobreak|, and |\penalty| commands to control where breaks should occur. The commands |\pagebreak| and |\nopagebreak| also work, including their options. Since you typically do not want page breaks for the frame to apply also to the |article| mode, you can add a mode specification like |<presentation>| to make these commands apply only to the presentation modes. The command \declare{|\string\framebreak|} is a shorthand for |\pagebreak<presentation>| and \declare{|\string\noframebreak|} is a shorthand for |\nopagebreak<presentation>|.
+
+    The use of this option is \emph{evil}. In a (good) presentation you prepare each slide carefully and think twice before putting something on a certain slide rather than on some different slide. Using the |allowframebreaks| option invites the creation of horrible, endless presentations that resemble more a paper projected on the wall'' than a presentation. Nevertheless, the option does have its uses. Most noticeably, it can be convenient for automatically splitting bibliographies or long equations.
+
+    \example
+\begin{verbatim}
+\begin{frame}[allowframebreaks]{References}
+  \begin{thebibliography}{XX}
+
+  \bibitem...
+  \bibitem...
+    ...
+  \bibitem...
+  \end{thebibliography}
+\end{frame}
+\end{verbatim}
+
+    \example
+\begin{verbatim}
+\begin{frame}[allowframebreaks,allowdisplaybreaks]{A Long Equation}
+  \begin{align}
+    \zeta(2) &= 1 + 1/4 + 1/9 + \cdots \\
+    &= ... \\
+    ...
+    &= \pi^2/6.
+  \end{align}
+\end{frame}
+\end{verbatim}
+
+  \item
+    \declare{|b|}, \declare{|c|}, \declare{|t|} will cause the frame to be vertically aligned at the bottom/center/top. This overrides the global placement policy, which is governed by the class options |t| and |c|.
+  \item
+    \declare{|fragile|\opt{|=singleslide|}} tells \beamer\ that the frame contents is fragile.'' This means that the frame contains text that is not interpreted as usual.'' For example, this applies to verbatim text, which is, obviously, interpreted somewhat differently from normal text.
+
+    If a frame contains fragile text, different internal mechanisms are used to typeset the frame to ensure that inside the frame the character codes can be reset. The price of switching to another internal mechanism is that either you cannot use overlays or an external file needs to be written and read back (which is not always desirable).
+
+    In detail, the following happens when this option is given for normal (pdf)\LaTeX: The contents of the frame is scanned and then written to a special file named \meta{jobname}|.vrb| or, if a label has been assigned to the frame, \meta{jobname}|.|\meta{current frame number}|.vrb|. Then, the frame is started anew and the content of this file is read back. Since, upon reading of a file, the character codes can be modified, this allows you to use both verbatim text and overlays.
+
+    To determine the end of the frame, the following rule is used: The first occurrence of a single line containing exactly |\end{|\meta{frame environment name}|}| ends the frame. The \meta{environment name} is normally |frame|, but it can be changed using the |environment| option. This special rule is needed since the frame contents is, after all, not interpreted when it is gathered.
+
+    You can also add the optional information |=singleslide|. This tells \beamer\ that the frame contains only a single slide. In this case, the frame contents is \emph{not} written to a special file, but interpreted directly, which is faster and cleaner.''
+  \item
+    \declare{|environment=|\meta{frame environment name}}. This option is useful only in conjunction with the |fragile| option (but it is not used for |fragile=singleslide|, only for the plain |fragile|). The \meta{frame environment name} is used to determine the end of the scanning when gathering the frame contents. Normally, the frame ends when a line reading |\end{frame}| is reached. However, if you use |\begin{frame}| inside another environment, you need to use this option:
+
+    \example
+\begin{verbatim}
+\newenvironment{slide}[1]
+  {\begin{frame}[fragile,environment=slide]
+      \frametitle{#1}}
+  {\end{frame}}
+
+\begin{slide}{My title}
+  Text.
+\end{slide}
+\end{verbatim}
+
+    If you did not specify the option |environment=slide| in the above example, \TeX\ would miss'' the end of the slide since it does not interpret text while gathering the frame contents.
+  \item
+    \declare{|label=|\meta{name}} causes the frame's contents to be stored under the name \meta{name} for later resumption using the command |\againframe|. Furthermore, on each slide of the frame a label with the name \meta{name}|<|\meta{slide number}|>| is created. On the \emph{first} slide, furthermore, a label with the name \meta{name} is created (so the labels \meta{name} and \meta{name}|<1>| point to the same slide). Note that labels in general, and these labels in particular, can be used as targets for hyperlinks.
+
+    You can use this option together with |fragile|.
+  \item
+    \declare{|plain|} causes the headlines, footlines, and sidebars to be suppressed. This is useful for creating single frames with different head- and footlines or for creating frames showing big pictures that completely fill the frame.
+
+    \example
+    A frame with a picture completely filling the frame:
+
+\begin{verbatim}
+\begin{frame}[plain]
+  \begin{centering}%
+    \pgfimage[height=\paperheight]{somebigimagefile}%
+    \par%
+  \end{centering}%
+\end{frame}
+\end{verbatim}
+
+    \example
+    A title page, in which the head- and footlines are replaced by two graphics.
+
+\begin{verbatim}
+\setbeamertemplate{title page}
+{
+  \pgfuseimage{toptitle}
+  \vskip0pt plus 1filll
+
+  \begin{centering}
+    {\usebeamerfont{title}\usebeamercolor[fg]{title}\inserttitle}
+
+    \insertdate
+  \end{centering}
+
+  \vskip0pt plus 1filll
+  \pgfuseimage{bottomtitle}
+}
+\begin{frame}[plain]
+  \titlepage
+\end{frame}
+\end{verbatim}
+
+  \item
+    \declare{|shrink|}\opt{|=|\meta{minimum shrink percentage}}. This option will cause the text of the frame to be shrunk if it is too large to fit on the frame. \beamer\ will first normally typeset the whole frame. Then it has a look at vertical size of the frame text (excluding the frame title). If this vertical size is larger than the text height minus the frame title height, \beamer\ computes a shrink factor and scales down the frame text by this factor such that the frame text then fills the frame completely. Using this option will automatically cause the |squeeze| option to be used, also.
+
+    Since the shrinking takes place only after everything has been typeset, shrunk frame text will not fill the frame completely horizontally. For this reason, you can specify a \meta{minimum shrink percentage} like |20|. If this percentage is specified, the frame will be shrunk \emph{at least} by this percentage. Since \beamer\ knows this, it can increase the horizontal width proportionally such that the shrunk text once more fills the entire frame. If, however, the percentage is not enough, the text will be shrunk as needed and you will be punished with a warning message.
+
+    The best way to use this option is to identify frames that are overly full, but in which all text absolutely has to be fit on a single frame. Then start specifying first |shrink=5|, then |shrink=10|, and so on, until no warning is issued any more (or just ignore the warning when things look satisfactory).
+
+    Using this option is \emph{very evil}. It will result in changes of the font size from slide to slide, which is a typographic nightmare. Its usage can \emph{always} be avoided by restructuring and simplifying frames, which will result in a better presentation.
+
+    \example
+\begin{verbatim}
+\begin{frame}[shrink=5]
+  Some evil endless slide that is 5\% too large.
+\end{frame}
+\end{verbatim}
+
+  \item
+    \declare{|squeeze|} causes all vertical spaces in the text to be squeezed together as much as possible. Currently, this just causes the vertical space in enumerations or itemizations to be reduced to zero.
+
+    Using this option is not good, but also not evil.
+  \end{itemize}
+
+  \articlenote
+  In |article| mode, the |frame| environment does not create any visual reference to the original frame (no frame is drawn). Rather, the frame text is inserted into the normal text. To change this, you can modify the templates |frame begin| and |frame end|, see below. To suppress a frame in |article| mode, you can, for example, specify |<presentation>| as overlay specification.
+
+  \begin{element}{frame begin}\yes\no\no
+    The text of this template is inserted at the beginning of each frame in |article| mode (and only there). You can use it, say, to start a |minipage| environment at the beginning of a frame or to insert a horizontal bar or whatever.
+  \end{element}
+
+  \begin{element}{frame end}\yes\no\no
+    The text of this template is inserted at the end of each frame in |article| mode.
+  \end{element}
+\end{environment}
+
+You \emph{can} use the |frame| environment inside other environments like this
+
+\begin{verbatim}
+\newenvironment{slide}{\begin{frame}}{\end{frame}}
+\end{verbatim}
+
+or like this
+
+\begin{verbatim}
+\newenvironment{myframe}[1]
+  {\begin{frame}[fragile,environment=myframe]\frametitle{#1}}
+  {\end{frame}}
+\end{verbatim}
+
+However, the actual mechanics are somewhat sensitive since the collecting'' of the frame contents is not easy, so do not attempt anything too fancy. As a rule, the beginning of the environment can be pretty arbitrary, but the ending must end with |\end{frame}| and should not contain any |\end{xxx}|. Anything really complex is likely to fail. If you need some |\end{xxx}| there, define a new command that contains this stuff as in the following example:
+
+\begin{verbatim}
+\newenvironment{itemizeframe}
+  {\begin{frame}\startitemizeframe}
+  {\stopitemizeframe\end{frame}}
+
+\newcommand\startitemizeframe{\begin{bfseries}\begin{itemize}}
+\newcommand\stopitemizeframe{\end{itemize}\end{bfseries}}
+
+\begin{itemizeframe}
+\item First item
+\end{itemizeframe}
+\end{verbatim}
+
+
+\subsection{Components of a Frame}
+
+Each frame consists of several components:
+\begin{enumerate}\itemsep=0pt\parskip=0pt
+\item a headline and a footline,
+\item a left and a right sidebar,
+\item a logo,
+\item a frame title,
+\item a background, and
+\item some frame contents.
+\end{enumerate}
+
+A frame need not have all of these components. Usually, the first three components are automatically setup by the theme you are using.
+
+
+The headline of a frame is the area at the top of the frame. If it is not empty, it should show some information that helps the audience orientate itself during your talk. Likewise, the footline is the area at the bottom of the frame.
+
+\beamer\ does not use the standard \LaTeX\ mechanisms for typesetting the headline and the footline. Instead, the special |headline| and |footline| templates are used to typeset them.
+
+The size of the headline and the footline is determined as follows: Their width is always the paper width. Their height is determined by tentatively typesetting the headline and the footline right after the |\begin{document}| command. The head of the headline and the footline at that point is frozen'' and will be used throughout the whole document, even if the headline and footline vary in height later on (which they should not).
+
+The appearance of the headline and footline is determined by the following templates:
+
+  This template is used to typeset the headline. The \beamer-color and -font |headline| are installed at the beginning. The background of the \beamer-color is not used by default, that is, no background rectangle is drawn behind the headline and footline (this may change in the future with the introduction of a headline and a footline canvas).
+
+  The width of the headline is the whole paper width. The height is determined automatically as described above. The headline is typeset in vertical mode with interline skip turned off and the paragraph skip set to zero.
+
+  Inside this template, the |\\| command is changed such that it inserts a comma instead.
+
+  \example
+\begin{verbatim}
+{%
+  \end{beamercolorbox}%
+}
+\end{verbatim}
+
+  \begin{templateoptions}
+    \itemoption{default}{}
+    The default is just an empty headline. To get the default headline of earlier versions of the \beamer\ class, use the |compatibility| theme.
+    \itemoption{infolines theme}{}
+    This option becomes available (and is used) if the |infolines| outer theme is loaded. The headline shows current section and subsection.
+    \itemoption{miniframes theme}{}
+    This option becomes available (and is used) if the |miniframes| outer theme is loaded. The headline shows the sections with small clickable mini frames below them.
+    \itemoption{sidebar theme}{}
+    This option becomes available (and is used) if the |sidebar| outer theme is loaded and if the head height (and option of the |sidebar| theme) is not zero. In this case, the headline is an empty bar of the background color |frametitle| with the logo to the left or right of this bar.
+    \itemoption{smoothtree theme}{}
+    This option becomes available (and is used) if the |smoothtree| outer theme is loaded. A smoothed'' navigation tree is shown in the headline.
+    \itemoption{smoothbars theme}{}
+    This option becomes available (and is used) if the |smoothbars| outer theme is loaded. A smoothed'' version of the |miniframes| headline is shown.
+    \itemoption{tree}{}
+    This option becomes available (and is used) if the |tree| outer theme is loaded. A navigational tree is shown in the headline.
+    \itemoption{split theme}{}
+    This option becomes available (and is used) if the |split| outer theme is loaded. The headline is split into a left part showing the sections and a right part showing the subsections.
+    \itemoption{text line}{\marg{text}}
+    The headline is typeset more or less as if it were a normal text line with the \meta{text} as contents. The left and right margin are setup such that they are the same as the margins of normal text. The \meta{text} is typeset inside an |\hbox|, while the headline is normally typeset in vertical mode.
+  \end{templateoptions}
+
+  Inside the template numerous inserts can be used:
+  \begin{itemize}
+    Inserts a horizontal navigation bar of the given \meta{width} into a template. The bar lists the sections and below them mini frames for each frame in that section.
+
+    \iteminsert{\insertpagenumber}
+    Inserts the current page number into a template.
+
+    \iteminsert{\insertsection}
+    Inserts the current section into a template.
+
+    Inserts a vertical navigation bar containing all sections, with the current section highlighted.
+
+    Inserts a horizontal navigation bar containing all sections, with the current section highlighted. The \meta{left insert} will be inserted to the left of the sections, the \marg{right insert} to the right. By inserting a triple fill (a |filll|) you can flush the bar to the left or right.
+    \example
+\begin{verbatim}
+\end{verbatim}
+
+    \iteminsert{\insertshortauthor}\oarg{options}
+    Inserts the short version of the author into a template. The text will be printed in one long line, line breaks introduced using the |\\| command are suppressed. The following \meta{options} may be given:
+    \begin{itemize}
+      \item
+      \declare{|width=|\meta{width}}
+      causes the text to be put into a multi-line minipage of the given size. Line breaks are still suppressed by default.
+      \item
+      \declare{|center|}
+      centers the text inside the minipage created using the |width| option, rather than having it left aligned.
+      \item
+      \declare{|respectlinebreaks|}
+      causes line breaks introduced by the |\\| command to be honored.
+    \end{itemize}
+
+    \example
+    |\insertauthor[width={3cm},center,respectlinebreaks]|
+
+    \iteminsert{\insertshortdate}\oarg{options}
+    Inserts the short version of the date into a template. The same options as for |\insertshortauthor| may be given.
+
+    \iteminsert{\insertshortinstitute}\oarg{options}
+    Inserts the short version of the institute into a template. The same options as for |\insertshortauthor| may be given.
+
+    \iteminsert{\insertshortpart}\oarg{options}
+    Inserts the short version of the part name into a template. The same options as for |\insertshortauthor| may be given.
+
+    \iteminsert{\insertshorttitle}\oarg{options}
+    Inserts the short version of the document title into a template. Same options as for |\insertshortauthor| may be given.
+
+    \iteminsert{\insertshortsubtitle}\oarg{options}
+    Inserts the short version of the document subtitle. Same options as for |\insertshortauthor| may be given.
+
+    \iteminsert{\insertsubsection}
+    Inserts the current subsection into a template.
+
+    \iteminsert{\insertsubsubsection}
+    Inserts the current subsection into a template.
+
+    Inserts a vertical navigation bar containing all subsections of the current section, with the current subsection highlighted.
+
+
+    Inserts a vertical navigation bar of the given \meta{width} into a template. The bar shows a little table of contents. The individual lines are typeset using the templates |section in head/foot| and |subsection in head/foot|.
+
+    Inserts the number of the current frame (not slide) into a template.
+
+    \iteminsert{\insertslidenumber}
+    Inserts the number of the current slide in frame into a template.
+
+    \iteminsert{\insertoverlaynumber}
+    Inserts the number of current overlay counter into a template. This is generally equal to |\insertslidenumber|, except when an overlay specification is used in a |frame| environment.
+
+    Inserts the total number of the frames (not slides) into a template. The number is only correct on the second run of \TeX\ on your document.
+
+    \iteminsert{\insertframestartpage}
+    Inserts the page number of the first page of the current frame.
+
+    \iteminsert{\insertframeendpage}
+    Inserts the page number of the last page of the current frame.
+
+    \iteminsert{\insertsubsectionstartpage}
+    Inserts the page number of the first page of the current subsection.
+
+    \iteminsert{\insertsubsectionendpage}
+    Inserts the page number of the last page of the current subsection.
+
+    \iteminsert{\insertsectionstartpage}
+    Inserts the page number of the first page of the current section.
+
+    \iteminsert{\insertsectionendpage}
+    Inserts the page number of the last page of the current section.
+
+    \iteminsert{\insertpartstartpage}
+    Inserts the page number of the first page of the current part.
+
+    \iteminsert{\insertpartendpage}
+    Inserts the page number of the last page of the current part.
+
+    \iteminsert{\insertpresentationstartpage}
+    Inserts the page number of the first page of the presentation.
+
+    \iteminsert{\insertpresentationendpage}
+    Inserts the page number of the last page of the presentation (excluding the appendix).
+
+    \iteminsert{\insertappendixstartpage}
+    Inserts the page number of the first page of the appendix. If there is no appendix, this number is the last page of the document.
+
+    \iteminsert{\insertappendixendpage}
+    Inserts the page number of the last page of the appendix. If there is no appendix, this number is the last page of the document.
+
+    \iteminsert{\insertdocumentstartpage}
+    Inserts 1.
+
+    \iteminsert{\insertdocumentendpage}
+    Inserts the page number of the last page of the document (including the appendix).
+  \end{itemize}
+\end{element}
+
+\begin{element}{footline}\yes\yes\yes
+  This template behaves exactly the same way as the headline. Note that, sometimes quite annoyingly, \beamer\ currently adds a space of 4pt between the bottom of the frame's text and the top of the footline.
+
+  \begin{templateoptions}
+    \itemoption{default}{}
+    The default is an empty footline. Note that the navigational symbols are \emph{not} part of the footline by default. Rather, they are part of an (invisible) right sidebar.
+    \itemoption{infolines theme}{}
+    This option becomes available (and is used) if the |infolines| outer theme is loaded. The footline shows things like the author's name and the title of the talk.
+    \itemoption{miniframes theme}{}
+    This option becomes available (and is used) if the |miniframes| outer theme is loaded. Depending on the exact options that are used when the |miniframes| theme is loaded, different things can be shown in the footline.
+    \itemoption{page number}{}
+    Shows the current page number in the footline.
+    \itemoption{frame number}{}
+    Shows the current frame number in the footline.
+    \itemoption{split}{}
+    This option becomes available (and is used) if the |split| outer theme is loaded. The footline (just like the headline) is split into a left part showing the author's name and a right part showing the talk's title.
+    \itemoption{text line}{\marg{text}}
+    The footline is typeset more or less as if it were a normal text line with the \meta{text} as contents. The left and right margin are setup such that they are the same as the margins of normal text. The \meta{text} is typeset inside an |\hbox|, while the headline is normally typeset in vertical mode. Using the |\strut| command somewhere in such a line might be a good idea.
+  \end{templateoptions}
+
+  The same inserts as for headlines can be used.
+
+    These \beamer-color and -font are used to typeset the page number or frame number in the footline.
+  \end{element}
+\end{element}
+
+\subsubsection{The Sidebars}
+
+Sidebars are vertical areas that stretch from the lower end of the headline to the top of the footline. There can be a sidebar at the left and another one at the right (or even both). Sidebars can show a table of contents, but they could also be added for purely aesthetic reasons.
+
+When you install a sidebar template, you must explicitly specify the horizontal size of the sidebar using the command |\setbeamersize| with the option |sidebar width left| or |sidebar width right|. The vertical size is determined automatically. Each sidebar has its own background canvas, which can be setup using the sidebar canvas templates.
+
+Adding a sidebar of a certain size, say 1\,cm, will make the main text 1\,cm narrower. The distance between the inner side of a side bar and the outer side of the text, as specified by the command |\setbeamersize| with the option |text margin left| and its counterpart for the right margin, is not changed when a sidebar is installed.
+
+Internally, the sidebars are typeset by showing them as part of the headline. The \beamer\ class keeps track of six dimensions, three for each side: the variables |\beamer at leftsidebar| and |\beamer at rightsidebar| store the (horizontal) sizes of the side bars, the variables |\beamer at leftmargin| and |\beamer at rightmargin| store the distance between sidebar and text, and the macros |\Gm at lmargin| and |\Gm at rmargin| store the distance from the edge of the paper to the edge of the text. Thus the sum |\beamer at leftsidebar| and |\beamer at leftmargin| is exactly |\Gm at lmargin|. Thus, if you wish to put some text right next to the left sidebar, you might write |\hskip-\beamer at leftmargin| to get there.
+
+\begin{element}{sidebar left}\yes\yes\yes
+  \colorfontparents{sidebar}
+  The template is used to typeset the left sidebar. As mentioned above, the size of the left sidebar is set using the command
+
+\begin{verbatim}
+\setbeamersize{sidebar width left=2cm}
+\end{verbatim}
+
+  \beamer\ will not clip sidebars automatically if they are too large.
+
+  When the sidebar is typeset, it is put inside a |\vbox|. You should currently setup things like the |\hsize| or the |\parskip| yourself.
+
+  \begin{templateoptions}
+    \itemoption{default}{}
+    installs an empty template.
+    \itemoption{sidebar theme}{}
+    This option is available if the outer theme |sidebar| is loaded with the |left| option. In this case, this options is selected automatically. It shows a mini table of contents in the sidebar.
+  \end{templateoptions}
+\end{element}
+
+\begin{element}{sidebar right}\yes\yes\yes
+  \colorfontparents{sidebar}
+  This template works the same way as the template for the left.
+
+  \begin{templateoptions}
+    \itemoption{default}{}
+    The default right sidebar has zero width. Nevertheless, it shows navigational symbols and, if installed, a logo at the bottom of the sidebar, protruding to the left into the text.
+    \itemoption{sidebar theme}{}
+    This option is available, if the outer theme |sidebar| is loaded with the |right| option. In this case, this option is selected automatically. It shows a mini table of contents in the sidebar. % FIXME: unsure
+  \end{templateoptions}
+\end{element}
+
+\begin{element}{sidebar canvas left}\yes\no\no
+  Like the overall background canvas, this canvas is drawn behind the actual text of the sidebar. This template should normally insert a rectangle of the size of the sidebar, though a too large height will not lead to an error or warning. When this template is called, the \beamer-color |sidebar left| will have been installed.
+
+  \begin{templateoptions}
+    \itemoption{default}{}
+    uses a large rectangle colored with |sidebar.bg| as the sidebar canvas. However, if the background of |sidebar| is empty, nothing is drawn and the canvas is transparent.''
+
+    installs a vertically shaded background. The following \meta{color options} may be given:
+    \begin{itemize}
+    \item
+      \declare{|top=|\meta{color}} specifies the color at the top of the sidebar. By default, 25\% of the foreground of the \beamer-color |palette primary| is used.
+    \item
+      \declare{|bottom=|\meta{color}} specifies the color at the bottom of the sidebar (more precisely, at a distance of the page height below the top of the sidebar). By default, the background of |normal text| at the moment of invocation of this command is used.
+    \item
+      \declare{|middle=|\meta{color}} specifies the color for the middle of the sidebar. Thus, if this option is given, the shading changes from the bottom color to this color and then to the top color.
+    \item
+      \declare{|midpoint=|\meta{factor}} specifies at which point of the page the middle color is used. A factor of |0| is the bottom of the page, a factor of |1| is the top. The default, which is |0.5|, is in the middle.
+    \end{itemize}
+    Note that you must give real'' \LaTeX\ colors here. This often makes it necessary to invoke the command |\usebeamercolor| before this command can be used.
+
+    Also note, that the width of the sidebar should be setup before this option is used.
+
+    \example
+    A stylish, but not very useful shading:
+
+\begin{verbatim}
+{\usebeamercolor{palette primary}}
+[top=palette primary.bg,middle=white,bottom=palette primary.bg]
+\end{verbatim}
+
+    installs a horizontally shaded background. The following \meta{color options} may be given:
+    \begin{itemize}
+      \item
+      \declare{|left=|\meta{color}} specifies the color at the left of the sidebar.
+      \item
+      \declare{|right=|\meta{color}} specifies the color at the right of the sidebar.
+      \item
+      \declare{|middle=|\meta{color}} specifies the color in the middle of the sidebar.
+      \item
+      \declare{|midpoint=|\meta{factor}} specifies at which point of the sidebar the middle color is used. A factor of |0| is the left of the sidebar, a factor of |1| is the right. The default, which is |0.5|, is in the middle.
+    \end{itemize}
+
+    \example
+    Adds two pillars''
+
+\begin{verbatim}
+\setbeamersize{sidebar width left=0.5cm,sidebar width right=0.5cm}
+
+{\usebeamercolor{sidebar}}
+
+[left=white,middle=sidebar.bg,right=white]
+[left=white,middle=sidebar.bg,right=white]
+\end{verbatim}
+  \end{templateoptions}
+\end{element}
+
+\begin{element}{sidebar canvas right}\yes\no\no
+  Works exactly as for the left side.
+\end{element}
+
+
+Many themes install a headline or a sidebar that shows a \emph{navigation bar}. Although these navigation bars take up quite a bit of space, they are often useful for two reasons:
+\begin{itemize}
+\item
+  They provide the audience with a visual feedback of how much of your talk you have covered and what is yet to come. Without such feedback, an audience will often puzzle whether something you are currently introducing will be explained in more detail later on or not.
+\item
+  You can click on all parts of the navigation bar. This will directly jump'' you to the part you have clicked on. This is particularly useful to skip certain parts of your talk and during a question session,'' when you wish to jump back to a particular frame someone has asked about.
+\end{itemize}
+
+Some navigation bars can be compressed'' using the following option:
+
+\begin{classoption}{compress}
+  Tries to make all navigation bars as small as possible. For example, all small frame representations in the navigation bars for a single section are shown alongside each other. Normally, the representations for different subsections are shown in different lines. Furthermore, section and subsection navigations are compressed into one line.
+\end{classoption}
+
+Some themes use the |\insertnavigation| to insert a navigation bar into the headline. Inside this bar, small icons are shown (called mini frames'') that represent the frames of a presentation. When you click on such an icon, the following happens:
+\begin{itemize}
+\item
+  If you click on (the icon of) any frame other than the current frame, the presentation will jump to the first slide of the frame you clicked on.
+\item
+  If you click on the current frame and you are not on the last slide of this frame, you will jump to the last slide of the frame.
+\item
+  If you click on the current frame and you are on the last slide, you will jump to the first slide of the frame.
+\end{itemize}
+
+By the above rules you can:
+\begin{itemize}
+\item
+  Jump to the beginning of a frame from somewhere else by clicking on it once.
+\item
+  Jump to the end of a frame from somewhere else by clicking on it twice.
+\item
+  Skip the rest of the current frame by clicking on it once.
+\end{itemize}
+
+We also tried making a jump to an already-visited frame jump automatically to the last slide of this frame. However, this turned out to be more confusing than helpful. With the current implementation a double-click always brings you to the end of a slide, regardless from where you come'' from.
+
+\begin{element}{mini frames}\semiyes\no\no
+  This parent template has the children |mini frame| and |mini frame in current subsection|.
+
+  \example
+  |\setbeamertemplate{mini frames}[box]|
+
+  \begin{templateoptions}
+    \itemoption{default}{}
+    shows small circles as mini frames.
+    \itemoption{box}{}
+    shows small rectangles as mini frames.
+    \itemoption{tick}{}
+    shows small vertical bars as mini frames.
+  \end{templateoptions}
+\end{element}
+
+\begin{element}{mini frame}\yes\yes\yes
+  The template is used to render the mini frame of the current frame in a navigation bar.
+
+  The width of the template is ignored. Instead, when multiple mini frames are shown, their position is calculated based on the \beamer-sizes |mini frame size| and |mini frame offset|. See the command |\setbeamersize| for a description of how to change them.
+\end{element}
+
+\begin{element}{mini frame in current subsection}\yes\no\no
+  This template is used to render the mini frame of frames in the current subsection that are not the current frame. The \beamer-color/-font |mini frame| installed prior to the usage of this template is invoked.
+\end{element}
+
+\begin{element}{mini frame in other subsection}\yes\no\no
+  This template is used to render mini frames of frames from subsections other than the current one.
+  \begin{templateoptions}
+    \itemoption{default}{\oarg{percentage}}
+    By default, this template shows |mini frame in current subsection|, except that the color is first changed to |fg!|\meta{percentage}|!bg|. The default \meta{percentage} is 50\%.
+
+    \example
+    To get an extremely shaded'' rendering of the frames outside the current subsection you can use the following:
+
+\begin{verbatim}
+\setbeamertemplate{mini frame in other subsection}[default][20]
+\end{verbatim}
+
+    \example
+    To render all mini frames other than the current one in the same way, use
+\begin{verbatim}
+\setbeamertemplate{mini frame in other subsection}[default][100]
+\end{verbatim}
+  \end{templateoptions}
+\end{element}
+
+Some themes show sections and/or subsections in the navigation bars. By clicking on a section or subsection in the navigation bar, you will jump to that section. Clicking on a section is particularly useful if the section starts with a |\tableofcontents[currentsection]|, since you can use it to jump to the different subsections.
+
+  This template is used to render a section entry if it occurs in the headline or the footline. The background of the \beamer-color is typically used as the background of the whole area'' where section entries are shown in the headline. You cannot usually use this template yourself since the insert |\insertsectionhead| is setup correctly only when a list of sections is being typeset in the headline.
+
+  The default template just inserts the section name. The following inserts are useful for this template:
+  \begin{itemize}
+    inserts the name of the section that is to be typeset in a navigation bar.
+
+    inserts the number of the section that is to be typeset in a navigation bar.
+
+    inserts the number of the part of the current section or subsection that is to be typeset in a navigation bar.
+  \end{itemize}
+\end{element}
+
+  This template is used instead of |section in head/foot| for typesetting sections that are currently shaded. Such shading is usually applied to all sections but the current one.
+
+  Note that this template does \emph{not} have its own color and font. When this template is called, the \beamer-font and color |section in head/foot| will have been setup. Then, at the start of the template, you will typically change the current color or start a |colormixin| environment.
+
+  \begin{templateoptions}
+    \itemoption{default}{\oarg{percentage}}
+    The default template changes the current color to |fg!|\meta{percentage}|!bg|. This causes the current color to become washed out'' or shaded.'' The default percentage is |50|.
+
+    \example
+    You can use the following command to make the shaded entries very light'':
+
+\begin{verbatim}
+\end{verbatim}
+  \end{templateoptions}
+\end{element}
+
+\begin{element}{section in sidebar}\yes\yes\yes
+  This template is used to render a section entry if it occurs in the sidebar, typically as part of a mini table of contents shown there. The background of the \beamer-color is used as background for the entry. Just like |section in head/foot|, you cannot usually use this template yourself and you should also use |\insertsectionhead| to insert the name of the section that is to be typeset.
+
+  For once, no default is installed for this template.
+
+  \begin{templateoptions}
+    \itemoption{sidebar theme}{}
+    This template, which is only available if the |sidebar| outer theme is loaded, inserts a bar with the \beamer-color's foreground and background that shows the section name. The width of the bar is the same as the width of the whole sidebar.
+  \end{templateoptions}
+
+  The same inserts as for |section in head/foot| can be used.
+\end{element}
+
+  This template is used instead of |section in sidebar| for typesetting sections that are currently shaded. Such shading is usually applied to all sections but the current one.
+
+  Differently from |section in head/foot shaded|, this template \emph{has} its own \beamer-color.
+
+  \begin{templateoptions}
+    \itemoption{sidebar theme}{}
+    Does the same as for the nonshaded version, except that a different \beamer-color is used.
+  \end{templateoptions}
+\end{element}
+
+  This template behaves exactly like |section in head/foot|, only for subsections.
+  \begin{itemize}
+
+  \end{itemize}
+\end{element}
+
+  This template behaves exactly like |section in head/foot shaded|, only for subsections.
+  \begin{templateoptions}
+    \itemoption{default}{\oarg{percentage}}
+    works like the corresponding option for sections.
+
+    \example
+\begin{verbatim}
+\end{verbatim}
+  \end{templateoptions}
+\end{element}
+
+\begin{element}{subsection in sidebar}\yes\yes\yes
+  This template behaves exactly like |section in sidebar|, only for subsections.
+\end{element}
+
+  This template behaves exactly like |section in sidebar shaded|, only for subsections.
+\end{element}
+
+  This template behaves exactly like |section in head/foot|, only for subsubsections. Currently, it is not used by the default themes.
+  \begin{itemize}
+
+  \end{itemize}
+\end{element}
+
+  This template behaves exactly like |section in head/foot shaded|, only for subsubsections.
+  \begin{templateoptions}
+    \itemoption{default}{\oarg{percentage}}
+    works like the corresponding option for sections.
+  \end{templateoptions}
+\end{element}
+
+\begin{element}{subsubsection in sidebar}\yes\yes\yes
+  This template behaves exactly like |section in sidebar|, only for subsubsections.
+\end{element}
+
+  This template behaves exactly like |section in sidebar shaded|, only for subsubsections.
+\end{element}
+
+By clicking on the document title in a navigation bar (not all themes show it), you will jump to the first slide of your presentation (usually the title page) \emph{except} if you are already at the first slide. On the first slide, clicking on the document title will jump to the end of the presentation, if there is one. Thus by \emph{double} clicking the document title in a navigation bar, you can jump to the end.
+
+
+Navigation symbols are small icons that are shown on every slide by default. The following symbols are shown:
+\begin{enumerate}
+\item
+  A slide icon, which is depicted as a single rectangle. To the left and right of this symbol, a left and right arrow are shown.
+\item
+  A frame icon, which is depicted as three slide icons stacked on top of each other''. This symbol is framed by arrows.
+\item
+  A subsection icon, which is depicted as a highlighted subsection entry in a table of contents. This symbol is framed by arrows.
+\item
+  A section icon, which is depicted as a highlighted section entry (together with all subsections) in a table of contents. This symbol is framed by arrows.
+\item
+\item
+  An appendix icon, which is depicted as a completely highlighted table of contents consisting of only one section. (This icon is only shown if there is an appendix.)
+\item
+  Back and forward icons, depicted as circular arrows.
+\item
+  A search'' or find'' icon, depicted as a detective's magnifying glass.
+\end{enumerate}
+
+Clicking on the left arrow next to an icon always jumps to (the last slide of) the previous slide, frame, subsection, or section. Clicking on the right arrow next to an icon always jumps to (the first slide of) the next slide, frame, subsection, or section.
+
+Clicking \emph{on} any of these icons has different effects:
+\begin{enumerate}
+\item
+  If supported by the viewer application, clicking on a slide icon pops up a window that allows you to enter a slide number to which you wish to jump.
+\item
+  Clicking on the left side of a frame icon will jump to the first slide of the frame, clicking on the right side will jump to the last slide of the frame (this can be useful for skipping overlays).
+\item
+  Clicking on the left side of a subsection icon will jump to the first slide of the subsection, clicking on the right side will jump to the last slide of the subsection.
+\item
+  Clicking on the left side of a section icon will jump to the first slide of the section, clicking on the right side will jump to the last slide of the section.
+\item
+  Clicking on the left side of the presentation icon will jump to the first slide, clicking on the right side will jump to the last slide of the presentation. However, this does \emph{not} include the appendix.
+\item
+  Clicking on the left side of the appendix icon will jump to the first slide of the appendix, clicking on the right side will jump to the last slide of the appendix.
+\item
+  If supported by the viewer application, clicking on the back and forward symbols jumps to the previously visited slides.
+\item
+  If supported by the viewer application, clicking on the search icon pops up a window that allows you to enter a search string. If found, the viewer application will jump to this string.
+\end{enumerate}
+
+You can reduce the number of icons that are shown or their layout by adjusting the |navigation symbols| template.
+
+  This template is invoked in three-star-mode'' by themes at the place where the navigation symbols should be shown. Three-star-mode'' means that the command |\usebeamertemplate***| is used.
+
+  Note that, although it may \emph{look} like the symbols are part of the footline, they are more often part of an invisible right sidebar.
+
+  \begin{templateoptions}
+    \itemoption{default}{}
+    Organizes the navigation symbols horizontally.
+    \itemoption{horizontal}{}
+    This is an alias for the default.
+    \itemoption{vertical}{}
+    Organizes the navigation symbols vertically.
+    \itemoption{only frame symbol}{}
+    Shows only the navigational symbol for navigating frames.
+  \end{templateoptions}
+
+  \example
+  The following command suppresses all navigation symbols:
+\begin{verbatim}
+\end{verbatim}
+
+  Inside this template, the following inserts are useful:
+  \begin{itemize}
+    Inserts the slide navigation symbols, that is, the slide symbols (a rectangle) together with arrows to the left and right that are hyperlinked.
+
+    Inserts the frame navigation symbol.
+
+    Inserts the subsection navigation symbol.
+
+    Inserts the section navigation symbol.
+
+    Inserts the presentation navigation symbol and (if necessary) the appendix navigation symbol.
+
+    Inserts a back, a find, and a forward navigation symbol.
+  \end{itemize}
+\end{element}
+
+\subsubsection{The Logo}
+
+To install a logo, use the following command:
+
+\begin{command}{\logo\marg{logo text}}
+  The \meta{logo text} is usually a command for including a graphic, but it can be any text. The position where the logo is inserted is determined by the current theme; you cannot (currently) specify this position directly.
+
+  \example
+\begin{verbatim}
+\pgfdeclareimage[height=0.5cm]{logo}{tu-logo}
+\logo{\pgfuseimage{logo}}
+\end{verbatim}
+
+  \example
+\begin{verbatim}
+\logo{\includegraphics[height=0.5cm]{logo.pdf}}
+\end{verbatim}
+
+  Currently, the effect of this command is just to setup the |logo| template. However, a more sophisticated effect might be implemented in the future.
+
+  \articlenote
+  This command has no effect.
+
+  \begin{element}{logo}\yes\yes\yes
+    This template is used to render the logo.
+  \end{element}
+
+  The following insert can be used to insert a logo somewhere:
+  \begin{itemize}
+    \iteminsert{\insertlogo}
+    inserts the logo at the current position. This command has the same effect as |\usebeamertemplate*{logo}|.
+  \end{itemize}
+\end{command}
+
+\subsubsection{The Frame Title}
+
+The frame title is shown prominently at the top of the frame and can be specified with the following command:
+
+\begin{command}{\frametitle\sarg{overlay specification}\oarg{short frame title}\marg{frame title text}}
+  You should end the \meta{frame title text} with a period, if the title is a proper sentence. Otherwise, there should not be a period. The \meta{short frame title} is normally not shown, but it's available via the |\insertshortframetitle| command. The \meta{overlay specification} is mostly useful for suppressing the frame title in |article| mode.
+
+  \example
+\begin{verbatim}
+\begin{frame}
+  \frametitle{A Frame Title is Important.}
+  \framesubtitle{Subtitles are not so important.}
+
+  Frame contents.
+\end{frame}
+\end{verbatim}
+
+  If you are using the |allowframebreaks| option with the current frame, a continuation text (like (cont.)'' or something similar, depending on the template |frametitle continuation|) is automatically added to the \meta{frame title text} at the end, separated with a space.
+
+  \beamernote
+  The frame title is not typeset immediately when the command |\frametitle| is encountered. Rather, the argument of the command is stored internally and the frame title is only typeset when the complete frame has been read. This gives you access to both the \meta{frame title text} and to the \meta{subframe title text} that is possibly introduced using the |\framesubtitle| command.
+
+  \articlenote
+  By default, this command creates a new paragraph in |article| mode, entitled \meta{frame title text}. Using the \meta{overlay specification} makes it easy to suppress a frame title once in a while. If you generally wish to suppress \emph{all} frame titles in |article| mode, say |\setbeamertemplate<article>{frametitle}{}|.
+
+  \begin{element}{frametitle}\yes\yes\yes
+    \colorfontparents{titlelike}
+
+    When the frame title and subtitle are to be typeset, this template is invoked with the \beamer-color and -font |frametitle| set. This template is \emph{not} invoked when the commands |\frametitle| or |\framesubtitle| are called. Rather, it is invoked when the whole frame has been completely read. Till then, the frame title and frame subtitle text are stored in a special place. This way, when the template is invoked, both inserts are setup correctly. The resulting \TeX-box is then magically put back to the top of the frame.
+
+    \begin{templateoptions}
+      \itemoption{default}{\oarg{alignment}}
+      The frame is typeset using the \beamer-color |frametitle| and the \beamer-font |frametitle|. The subtitle is put below using the color and font |framesubtitle|. If the color |frametitle| has a background, a background bar stretching the whole frame width is put behind the title. A background color of the subtitle is ignored. The \meta{alignment} is passed on to the |beamercolorbox| environment. In particular, useful options are |left|, |center|, and |right|. As a special case, the |right| option causes the left border of the frame title to be somewhat larger than normal so that the frame title is more in the middle of the frame.
+
+      This option is available if the outer theme |shadow| is loaded. It draws the frame title on top of a horizontal shading between the background colors of |frametitle| and |frametitle right|. A subtitle is, if present, also put on this bar. Below the bar, a shadow'' is drawn.
+
+      \itemoption{sidebar theme}{}
+      This option is available if the outer theme |sidebar| is loaded and if the headline height is not set to 0pt (which can be done using an option of the |sidebar| theme). With this option, the frame title is put inside a rectangular area that is part of the headline (some negative space'' is used to raise the frame title into this area). The background of the color |frametitle| is not used, this is the job of the headline template in this case.
+
+      \itemoption{smoothbars theme}{}
+      This option is available if the outer theme |smoothbars| is loaded. It typesets the frame title on a colored bar with the background color of |frametitle|. The top and bottom of the bar smoothly blend over to backgrounds above and below.
+
+      \itemoption{smoothtree theme}{}
+      Like |smoothbars theme|, only for the |smoothtree| theme.
+    \end{templateoptions}
+
+    The following commands are useful for this template:
+    \begin{templateinserts}
+      \iteminsert{\insertframetitle} yields the frame title.
+      \iteminsert{\insertframesubtitle} yields the frame subtitle.
+    \end{templateinserts}
+  \end{element}
+\end{command}
+
+
+\begin{command}{\framesubtitle\sarg{overlay specification}\marg{frame subtitle text}}
+  If present, a subtitle will be shown in a smaller font below the main title. Like the |\frametitle| command, this command can be given anywhere in the frame, since the frame title is actually typeset only when everything else has already been typeset.
+
+  \example
+\begin{verbatim}
+\begin{frame}
+  \frametitle<presentation>{Frame Title Should Be in Uppercase.}
+  \framesubtitle{Subtitles can be in lowercase if they are full sentences.}
+
+  Frame contents.
+\end{frame}
+\end{verbatim}
+
+  \articlenote
+  By default, the subtitle is not shown in any way in |article| mode.
+
+  \begin{element}{framesubtitle}\no\yes\yes
+    \colorfontparents{frametitle}
+    This element provides a color and a font for the subtitle, but no template. It is the job of the |frametitle| template to also typeset the subtitle.
+  \end{element}
+\end{command}
+
+Be default, all material for a slide is vertically centered. You can change this using the following class options:
+
+\begin{classoption}{t}
+  Place text of slides at the (vertical) top of the slides. This corresponds to a vertical flush.'' You can override this for individual frames using the |c| or |b| option.
+\end{classoption}
+
+\begin{classoption}{c}
+  Place text of slides at the (vertical) center of the slides. This is the default. You can override this for individual frames using the |t| or |b| option.
+\end{classoption}
+
+\subsubsection{The Background}
+\label{section-canvas}
+\label{section-background}
+
+Each frame has a \emph{background}, which---as the name suggests---is behind everything.'' The background is a surprisingly complex object: in \beamer, it consists of a \emph{background canvas} and the \emph{main background}.
+
+The background canvas can be imagined as a large area on which everything (the main background and everything else) is painted on. By default, this canvas is a big rectangle filling the whole frame whose color is the background of the \beamer-color |background canvas|. Since this color inherits from |normal text|, by changing the background color of the normal text, you can change this color of the canvas.
+
+\example
+The following command changes the background color to a light red.
+\begin{verbatim}
+\setbeamercolor{normal text}{bg=red!20}
+\end{verbatim}
+
+The canvas need not be monochrome. Instead, you can install a shading or even make it transparent. Making it transparent is a good idea if you wish to include your slides in some other document.
+
+\example
+The following command makes the background canvas transparent:
+\begin{verbatim}
+\setbeamercolor{background canvas}{bg=}
+\end{verbatim}
+
+\begin{element}{background canvas}\yes\yes\yes
+  \colorparents{normal text}
+  The template is inserted behind everything.'' The template should typically be some \TeX\ commands that produce a rectangle of height |\paperheight| and width |\paperwidth|.
+
+  \begin{templateoptions}
+    \itemoption{default}{}
+    installs a large rectangle with the background color. If the background is empty, the canvas is transparent.'' Since |background canvas| inherits from |normal text|, you can change the background of the \beamer-color |normal text| to change the color of the default canvas. However, to make the canvas transparent, only set the background of the canvas empty; leave the background of normal text white.
+
+    installs a vertically shaded background. \emph{Use with care: Background shadings are often distracting!} The following \meta{color options} may be given:
+    \begin{itemize}
+      \item
+      \declare{|top=|\meta{color}} specifies the color at the top of the page. By default, 25\% of the foreground of the \beamer-color |palette primary| is used.
+      \item
+      \declare{|bottom=|\meta{color}} specifies the color at the bottom of the page. By default, the background of |normal text| at the moment of invocation of this command is used.
+      \item
+      \declare{|middle=|\meta{color}} specifies the color for the middle of the page. Thus, if this option is given, the shading changes from the bottom color to this color and then to the top color.
+      \item
+      \declare{|midpoint=|\meta{factor}} specifies at which point of the page the middle color is used. A factor of |0| is the bottom of the page, a factor of |1| is the top. The default, which is |0.5| is in the middle.
+    \end{itemize}
+  \end{templateoptions}
+\end{element}
+
+The main background is drawn on top of the background canvas. It can be used to add, say, a grid to every frame or a big background picture or whatever. If you plan to use a PNG image as a background image, use one with an alpha channel to avoid potential problems with transparency in some PDF viewers.
+
+\begin{element}{background}\yes\yes\yes
+  \colorparents{background canvas}
+  The template is inserted behind everything, but on top of the background canvas.'' Use it for pictures or grids or anything that does not necessarily fill the whole background. When this template is typeset, the \beamer-color and -font |background| will be setup.
+
+  \begin{templateoptions}
+    \itemoption{default}{} is empty.
+
+    \itemoption{grid}{\oarg{grid options}}
+    places a grid on the background. The following \meta{grid options} may be given:
+    \begin{itemize}
+      \item
+      \declare{|step=|\meta{dimension}} specifies the distance between grid lines. The default is 0.5cm.
+      \item
+      \declare{|color=|\meta{color}} specifies the color of the grid lines. The default is 10\% foreground.
+    \end{itemize}
+  \end{templateoptions}
+\end{element}
+
+
+\subsection{Frame and Margin Sizes}
+
+The size of a frame is actually the paper size'' of a \beamer\ presentation, and it is variable. By default, it amounts to 128mm by 96mm. The aspect ratio of this size is 4:3, which is exactly what most beamers offer these days. It is the job of the presentation program (like |acroread|, |xpdf|, |okular| or |evince|) to display the slides at full screen size. The main advantage of using a small paper size'' is that you can use all your normal fonts at their natural sizes. In particular, inserting a graphic with 11pt labels will result in reasonably sized labels during the presentation.
+
+To change paper size'' and aspect ratio, you can use the following class options:
+
+\begin{classoption}{aspectratio=1610}
+  Sets aspect ratio to 16:10, and frame size to 160mm by 100mm.
+\end{classoption}
+
+\begin{classoption}{aspectratio=169}
+  Sets aspect ratio to 16:9, and frame size to 160mm by 90mm.
+\end{classoption}
+
+\begin{classoption}{aspectratio=149}
+  Sets aspect ratio to 14:9, and frame size to 140mm by 90mm.
+\end{classoption}
+
+\begin{classoption}{aspectratio=141}
+  Sets aspect ratio to 1.41:1, and frame size to 148.5mm by 105mm.
+\end{classoption}
+
+\begin{classoption}{aspectratio=54}
+  Sets aspect ratio to 5:4, and frame size to 125mm by 100mm.
+\end{classoption}
+
+\begin{classoption}{aspectratio=43}
+  The default aspect ratio and frame size. You need not specify this option.
+\end{classoption}
+
+\begin{classoption}{aspectratio=32}
+  Sets aspect ratio to 3:2, and frame size to 135mm by 90mm.
+\end{classoption}
+
+Aside from using these options, you should refrain from changing the paper size.'' However, you \emph{can} change the size of the left and right margins, which default to 1cm. To change them, you should use the following command:
+
+\begin{command}{\setbeamersize\marg{options}}
+  The following \meta{options} can be given:
+  \begin{itemize}
+  \item
+    \declare{|text margin left=|\meta{\TeX\ dimension}} sets a new left margin. This excludes the left sidebar. Thus, it is the distance between the right edge of the left sidebar and the left edge of the text.
+  \item
+    \declare{|text margin right=|\meta{\TeX\ dimension}} sets a new right margin.
+  \item
+    \declare{|sidebar width left=|\meta{\TeX\ dimension}} sets the size of the left sidebar. Currently, this command should be given \emph{before} a shading is installed for the sidebar canvas.
+  \item
+    \declare{|sidebar width right=|\meta{\TeX\ dimension}} sets the size of the right sidebar.
+  \item
+    \declare{|description width=|\meta{\TeX\ dimension}} sets the default width of description labels, see Section~\ref{section-descriptions}.
+  \item
+    \declare{|description width of=|\meta{text}} sets the default width of description labels to the width of the \meta{text}, see Section~\ref{section-descriptions}.
+  \item
+    \declare{|mini frame size=|\meta{\TeX\ dimension}} sets the size of mini frames in a navigation bar. When two mini frame icons are shown alongside each other, their left end points are \meta{\TeX\ dimension} far apart.
+  \item
+    \declare{|mini frame offset=|\meta{\TeX\ dimension}} set an additional vertical offset that is added to the mini frame size when arranging mini frames vertically.
+  \end{itemize}
+
+  \articlenote
+  This command has no effect in |article| mode.
+\end{command}
+
+
+\subsection{Restricting the Slides of a Frame}
+\label{section-restriction}
+
+The number of slides in a frame is automatically calculated. If the largest number mentioned in any overlay specification inside the frame is 4, four slides are introduced (despite the fact that a specification like |<4->| might suggest that more than four slides would be possible).
+
+You can also specify the number of slides in the frame by hand.'' To do so, you pass an overlay specification to the |\frame| command. The frame will contain only the slides specified in this argument. Consider the following example.
+
+\begin{verbatim}
+\begin{frame}<1-2,4->
+  This is slide number \only<1>{1}\only<2>{2}\only<3>{3}%
+  \only<4>{4}\only<5>{5}.
+\end{frame}
+\end{verbatim}
+
+This command will create a frame containing four slides. The first will contain the text This is slide number~1,'' the second This is slide number~2,'' the third This is slide number~4,'' and the fourth This is slide number~5.''
+
+A useful specification is just |<0>|, which causes the frame to have no slides at all. For example, |\begin{frame}<handout:0>| causes the frame to be suppressed in the handout version, but to be shown normally in all other versions. Another useful specification is |<beamer>|, which causes the frame to be shown normally in |beamer| mode, but to be suppressed in all other versions.

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-frames.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-globalstructure.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-globalstructure.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,689 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2012,2013,2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\section{Structuring a Presentation: The Static Global Structure}
+
+This section lists the commands that are used for structuring a presentation globally'' using commands like |\section| or |\part|. These commands are used to create a \emph{static} structure, meaning that the resulting presentation is normally presented one slide after the other in the order the slides occur. Section~\ref{section-nonlinear} explains which commands can be used to create the \emph{interactive} structure. For the interactive structure, you must interact with the presentation program, typically by clicking on hyperlinks, to advance the presentation.
+
+
+You can use the |\titlepage| command to insert a title page into a frame. By default, it will arrange the following elements on the title page: the document title, the authors' names, their affiliation, a title graphic, and a date.
+
+\begin{command}{\titlepage}
+  Inserts the text of a title page into the current frame.
+  \example
+  |\frame{\titlepage}|
+  \example
+  |\frame[plain]{\titlepage}| for a titlepage that fills the whole frame.
+
+  \begin{element}{title page}\yes\yes\yes
+    This template is invoked when the |\titlepage| command is used.
+
+    \begin{templateoptions}
+      \itemoption{default}{\oarg{alignment}}
+      The title page is typeset showing the title, followed by the author, his or her affiliation, the date, and a titlegraphic. If any of these are missing, they are not shown. Except for the titlegraphic, if the \beamer-color |title|, |author|, |institute|, or |date| is defined, respectively, it is used as textcolor for these entries. If a background color is defined for them, a colored bar in the corresponding color is drawn behind them, spanning the text width. The corresponding \beamer-fonts are used for these entries.
+
+      The \meta{alignment} option is passed on the |beamercolorbox| and can be used, for example, to flush the title page to the left by specifying |left| here.
+    \end{templateoptions}
+
+    The following commands are useful for this template:
+    \begin{templateinserts}
+      \iteminsert{\insertauthor} inserts a version of the author's name that is useful for the title page.
+      \iteminsert{\insertdate} inserts the date.
+      \iteminsert{\insertinstitute} inserts the institute.
+      \iteminsert{\inserttitle} inserts a version of the document title that is useful for the title page.
+      \iteminsert{\insertsubtitle} inserts a version of the document title that is useful for the title page.
+      \iteminsert{\inserttitlegraphic} inserts the title graphic into a template.
+    \end{templateinserts}
+  \end{element}
+\end{command}
+
+For compatibility with other classes, in |article| mode the following command is also provided:
+
+\begin{command}{\maketitle}
+  \beamernote
+  If used inside a frame, it has the same effect as |\titlepage|. If used outside a frame, it has the same effect as |\frame{\titlepage}|; in other words, a frame is added if necessary.
+\end{command}
+
+Before you invoke the title page command, you must specify all elements you wish to be shown. This is done using the following commands:
+
+\begin{command}{\title\oarg{short title}\marg{title}}
+  The \meta{short title} is used in headlines and footlines. Inside the \meta{title} line breaks can be inserted using the double-backslash command.
+  \example
+\begin{verbatim}
+\title{The Beamer Class}
+\title[Short Version]{A Very Long Title\\Over Several Lines}
+\end{verbatim}
+
+  \articlenote
+  The short form is ignored in |article| mode.
+\end{command}
+
+\begin{command}{\subtitle\oarg{short subtitle}\marg{subtitle}}
+  The \meta{short subtitle} is not used by default, but is available via the insert |\insertshortsubtitle|. The subtitle is shown below the title in a smaller font.
+  \example
+\begin{verbatim}
+\title{The Beamer Class}
+\subtitle{An easily paced introduction with many examples.}
+\end{verbatim}
+
+  \articlenote
+  This command causes the subtitle to be appended to the title with a linebreak and a |\normalsize| command issued before it. This may or may not be what you would like to happen.
+\end{command}
+
+\begin{command}{\author\oarg{short author names}\marg{author names}}
+  The names should be separated using the command |\and|. In case authors have different affiliations, they should be suffixed by the command |\inst| with different parameters.
+  \example
+  |\author[Hemaspaandra et al.]{L. Hemaspaandra\inst{1} \and T. Tantau\inst{2}}|
+
+  \articlenote
+  The short form is ignored in |article| mode.
+\end{command}
+
+\begin{command}{\institute\oarg{short institute}\marg{institute}}
+  If more than one institute is given, they should be separated using the command |\and| and they should be prefixed by the command |\inst| with different parameters.
+  \example
+\begin{verbatim}
+\institute[Universities of Rijeka and Berlin]{
+  \inst{1}Department of Informatics\\
+  University of Rijeka
+  \and
+  \inst{2}Fakult\"at f\"ur Elektrotechnik und Informatik\\
+  Technical University of Berlin}
+\end{verbatim}
+
+  \articlenote
+  The short form is ignored in |article| mode. The long form is also ignored, except if the document class (like |llncs|) defines it.
+\end{command}
+
+\begin{command}{\date\oarg{short date}\marg{date}}
+  \example|\date{\today}| or |\date[STACS 2003]{STACS Conference, 2003}|.
+
+  \articlenote
+  The short form is ignored in |article| mode.
+\end{command}
+
+\begin{command}{\titlegraphic\marg{text}}
+  The \meta{text} is shown as title graphic. Typically, a picture environment is used as \meta{text}.
+  \example
+  |\titlegraphic{\pgfuseimage{titlegraphic}}|
+
+  \articlenote
+  The command is ignored in |article| mode.
+\end{command}
+
+\begin{command}{\subject\marg{text}}
+  Enters the \meta{text} as the subject text in the \pdf\ document info. It currently has no other effect.
+\end{command}
+
+\begin{command}{\keywords\marg{text}}
+  Enters the \meta{text} as keywords in the \pdf\ document info. It currently has no other effect.
+\end{command}
+
+
+By default, the |\title| and |\author| commands will also insert their arguments into a resulting \pdf-file in the document information fields. This may cause problems if you use complicated things like boxes as arguments to these commands. In this case, you might wish to switch off the automatic generation of these entries using the following class option:
+
+\begin{classoption}{usepdftitle=false}
+  Suppresses the automatic generation of title and author entries in the \pdf\ document information.
+\end{classoption}
+
+
+
+You can structure your text using the commands |\section| and |\subsection|. Unlike standard \LaTeX, these commands will not create a heading at the position where you use them. Rather, they will add an entry to the table of contents and also to the navigation bars.
+
+In order to create a line break in the table of contents (usually not a good idea), you can use the command |\breakhere|. Note that the standard command |\\| is modified so that it's no longer robust (see Section 9.3; using |\protect\\| or |\newline| will also be fine).
+
+\begin{command}{\section\sarg{mode specification}\oarg{short section name}\marg{section name}}
+  Starts a section. No heading is created. By default the \meta{section name} is shown in the table of contents and in the navigation bars; if \meta{short section name} is specified, it will be used in the navigation bars instead; if \meta{short section name} is explicitly empty, it will not appear in the navigation bars. If a \meta{mode specification} is given, the command only has an effect for the specified modes.
+
+  \example
+  |\section[Summary]{Summary of Main Results}|
+
+  \articlenote
+  The \meta{mode specification} allows you to provide an alternate section command in |article| mode. This is necessary for example if the \meta{short section name} is unsuitable for the table of contents:
+
+  \example
+\begin{verbatim}
+\section<presentation>[Results]{Results on the Main Problem}
+\section<article>{Results on the Main Problem}
+\end{verbatim}
+
+  \begin{element}{section in toc}\yes\yes\yes
+    This template is used when a section entry is to be typeset. For the permissible \meta{options} see the parent template |table of contents|.
+
+    The following commands are useful for this template:
+    \begin{templateinserts}
+      \iteminsert{\inserttocsection}
+
+      \iteminsert{\inserttocsectionnumber}
+    \end{templateinserts}
+  \end{element}
+
+    This template is used instead of the previous one if the section should be shown in a shaded way, because it is not the current section. For the permissible \meta{options} see the parent template |table of contents|.
+  \end{element}
+\end{command}
+
+\begin{command}{\section\sarg{mode specification}\declare{|*|}\marg{section name}}
+  \example
+  |\section*{Outline}|
+  \example
+  |\section<beamer>*{Outline}|
+\end{command}
+
+\begin{command}{\subsection\sarg{mode specification}\oarg{short subsection name}\marg{subsection name}}
+  This command works the same way as the |\section| command.
+  \example
+  |\subsection[Applications]{Applications to the Reduction of Pollution}|
+
+  \begin{element}{subsection in toc}\yes\yes\yes
+    Like |section in toc|, only for subsection.
+
+    In addition to the inserts for the |section in toc| template, the following commands are available for this template:
+    \begin{templateinserts}
+      \iteminsert{\inserttocsubsection}
+
+      \iteminsert{\inserttocsubsectionnumber}
+    \end{templateinserts}
+  \end{element}
+
+    Like |section in toc shaded|, only for subsections.
+  \end{element}
+\end{command}
+
+\begin{command}{\subsection\sarg{mode specification}\declare{|*|}\marg{subsection name}}
+  Starts a subsection without an entry in the table of contents. No heading is created, but the \meta{subsection name} is shown in the navigation bar, \emph{except} if \meta{subsection name} is empty. In this case, neither a table of contents entry nor a navigation bar entry is created, \emph{but} any frames in this empty'' subsection are shown in the navigation bar.
+
+  \example
+\begin{verbatim}
+\section{Summary}
+
+  \frame{This frame is not shown in the navigation bar}
+
+  \subsection*{}
+
+  \frame{This frame is shown in the navigation bar, but no subsection
+    entry is shown.}
+
+  \subsection*{A subsection}
+
+  \frame{Normal frame, shown in navigation bar. The subsection name is
+\end{verbatim}
+\end{command}
+
+\begin{command}{\subsubsection\sarg{mode specification}\oarg{short subsubsection name}\marg{subsubsection name}}
+  This command works the like |\subsection|. However, subsubsections are supported less well than subsections. For example, in the table of contents subsubsections are always shown with the same shading/hiding parameters as the subsection.
+
+  We \emph{strongly} discourage the use of subsubsections in presentations. If you do not use them, you will give a better presentation.
+
+  \example
+  |\subsubsection[Applications]{Applications to the Reduction of Pollution}|
+
+  \begin{element}{subsubsection in toc}\yes\yes\yes
+    Like |subsection in toc|, only for subsection.
+
+    In addition to the inserts for the |subsection in toc| template, the following commands are available for this template:
+    \begin{templateinserts}
+      \iteminsert{\inserttocsubsubsection}
+
+      \iteminsert{\inserttocsubsubsectionnumber}
+    \end{templateinserts}
+  \end{element}
+
+    Like |subsection in toc shaded|, only for subsubsections.
+  \end{element}
+\end{command}
+
+\begin{command}{\subsubsection\sarg{mode specification}\declare{|*|}\marg{subsubsection name}}
+  Starts a subsubsection without an entry in the table of contents. No heading is created, but the \meta{subsubsection name} is shown in a possible sidebar.
+\end{command}
+
+Often, you may want a certain type of frame to be shown directly after a section or subsection starts. For example, you may wish every subsection to start with a frame showing the table of contents with the current subsection highlighted. To facilitate this, you can use the following commands.
+
+\begin{command}{\AtBeginSection\oarg{special star text}\marg{text}}
+  The given text will be inserted at the beginning of every section. If the \meta{special star text} parameter is specified, this text will be used for starred sections instead. Different calls of this command will not add up'' the given texts (like the |\AtBeginDocument| command does), but will overwrite any previous text.
+
+  \example
+\begin{verbatim}
+\AtBeginSection[] % Do nothing for \section*
+{
+  \begin{frame}<beamer>
+    \frametitle{Outline}
+    \tableofcontents[currentsection]
+  \end{frame}
+}
+\end{verbatim}
+
+  \articlenote
+  This command has no effect in |article| mode.
+
+\end{command}
+
+\begin{command}{\AtBeginSubsection\oarg{special star text}\marg{text}}
+  The given text will be inserted at the beginning of every subsection. If the \meta{special star text} parameter is specified, this text will be used for starred subsections instead. Different calls of this command will not add up'' the given texts.
+
+  \example
+\begin{verbatim}
+\AtBeginSubsection[] % Do nothing for \subsection*
+{
+  \begin{frame}<beamer>
+    \frametitle{Outline}
+    \tableofcontents[currentsection,currentsubsection]
+  \end{frame}
+}
+\end{verbatim}
+\end{command}
+
+\begin{command}{\AtBeginSubsubsection\oarg{special star text}\marg{text}}
+  Like |\AtBeginSubsection|, only for subsubsections.
+\end{command}
+
+\beamer\ also provides |\sectionpage| and |\subsectionpage| commands, which are used to fill a frame with section or subsection number and title in a stylish way. They are very similar to |\partpage| command described below.
+
+  \example
+\begin{verbatim}
+\section{A section}
+
+  \frame{\sectionpage}
+
+  \frame{Some text.}
+\end{verbatim}
+
+
+If you give a long talk (like a lecture), you may wish to break up your talk into several parts. Each such part acts like a little talk of its own'' with its own table of contents, its own navigation bars, and so on. Inside one part, the sections and subsections of the other parts are not shown at all.
+
+To create a new part, use the |\part| command. All sections and subsections following this command will be local'' to that part. Like the |\section| and |\subsection| command, the |\part| command does not cause any frame or special text to be produced. However, it is often advisable for the start of a new part to use the command |\partpage| to insert some text into a frame that advertises'' the beginning of a new part.
+
+\begin{command}{\part\sarg{mode specification}\oarg{short part name}\marg{part name}}
+  Starts a part. The \meta{part name} will be shown when the |\partpage| command is used. The \meta{short part name} is not shown anywhere by default, but it is accessible via the command |\insertshortpart|.
+  \example
+\begin{verbatim}
+\begin{document}
+  \frame{\titlepage}
+
+  \section*{Outlines}
+  \subsection{Part I: Review of Previous Lecture}
+  \frame{
+    \frametitle{Outline of Part I}
+    \tableofcontents[part=1]}
+  \subsection{Part II: Today's Lecture}
+  \frame{
+    \frametitle{Outline of Part II}
+    \tableofcontents[part=2]}
+
+  \part{Review of Previous Lecture}
+  \frame{\partpage}
+  \section[Previous Lecture]{Summary of the Previous Lecture}
+  \subsection{Topics}
+  \frame{...}
+  \subsection{Learning Objectives}
+  \frame{...}
+
+  \part{Today's Lecture}
+  \frame{\partpage}
+  \section{Topic A}
+  \frame{\tableofcontents[currentsection]}
+  \subsection{Foo}
+  \frame{...}
+  \section{Topic B}
+  \frame{\tableofcontents[currentsection]}
+  \subsection{bar}
+  \frame{...}
+\end{document}
+\end{verbatim}
+\end{command}
+
+\begin{command}{\partpage}
+  Works like |\titlepage|, only that the current part, not the current presentation is advertised.''
+  \example
+  |\frame{\partpage}|
+
+  \begin{element}{part page}\yes\yes\yes
+    This template is invoked when the |\partpage| command is used.
+
+    \begin{templateoptions}
+      \itemoption{default}{\oarg{alignment}}
+      The part page is typeset showing the current part number and, below, the current part title. The \beamer-color and -font |part page| are used, including the background color of |part page|. As for the |title page| template, the \meta{alignment} option is passed on the |beamercolorbox|.
+    \end{templateoptions}
+
+    The following commands are useful for this template:
+    \begin{templateinserts}
+      \iteminsert{\insertpart}
+      inserts the current part name.
+      \iteminsert{\insertpartnumber}
+      inserts the current part number as an Arabic number into a template.
+      \iteminsert{\insertromanpartnumber}
+      inserts the current part number as a Roman number into a template.
+    \end{templateinserts}
+  \end{element}
+\end{command}
+
+\begin{command}{\AtBeginPart\marg{text}}
+  The given text will be inserted at the beginning of every part.
+
+  \example
+\begin{verbatim}
+\AtBeginPart{\frame{\partpage}}
+\end{verbatim}
+\end{command}
+
+
+\subsection{Splitting a Course Into Lectures}
+
+When using \beamer\ with the |article| mode, you may wish to have the lecture notes of a whole course reside in one file. In this case, only a few frames are actually part of any particular lecture.
+
+The |\lecture| command makes it easy to select only a certain set of frames from a file to be presented. This command takes (among other things) a label name. If you say |\includeonlylecture| with this label name, then only the frames following the corresponding |\lecture| command are shown. The frames following other |\lecture| commands are suppressed.
+
+By default, the |\lecture| command has no other effect. It does not create any frames or introduce entries in the table of contents. However, you can use |\AtBeginLecture| to have \beamer\ insert, say, a title page at the beginning of (each) lecture.
+
+\begin{command}{\lecture\oarg{short lecture name}\marg{lecture name}\marg{lecture label}}
+  Starts a lecture. The \meta{lecture name} will be available via the |\insertlecture| command. The \meta{short lecture name} is available via the |\insertshortlecture| command.
+
+  \example
+\begin{verbatim}
+\begin{document}
+\lecture{Vector Spaces}{week 1}
+
+\section{Introduction}
+...
+\section{Summary}
+
+\lecture{Scalar Products}{week 2}
+
+\section{Introduction}
+...
+\section{Summary}
+
+\end{document}
+\end{verbatim}
+
+  \articlenote
+  This command has no effect in |article| mode.
+\end{command}
+
+\begin{command}{\includeonlylecture\meta{lecture label}}
+  Causes all |\frame|, |frame|, |\section|, |\subsection|, and |\part| commands following a |\lecture| command to be suppressed, except if the lecture's label matches the \meta{lecture label}. Frames before any |\lecture| commands are always included. This command should be given in the preamble.
+
+  \example
+  |\includeonlylecture{week 1}|
+
+  \articlenote
+  This command has no effect in |article| mode.
+\end{command}
+
+\begin{command}{\AtBeginLecture\marg{text}}
+  The given text will be inserted at the beginning of every
+  lecture.
+
+  \example
+\begin{verbatim}
+\AtBeginLecture{\frame{\Large Today's Lecture: \insertlecture}}
+\end{verbatim}
+
+  \articlenote
+  This command has no effect in |article| mode.
+\end{command}
+
+
+
+You can create a table of contents using the command |\tableofcontents|. Unlike the normal \LaTeX\ table of contents command, this command takes an optional parameter in square brackets that can be used to create certain special effects.
+
+\begin{command}{\tableofcontents\oarg{comma-separated option list}}
+
+  \example
+\begin{verbatim}
+\section*{Outline}
+\frame{\tableofcontents}
+
+\section{Introduction}
+\frame{\tableofcontents[currentsection]}
+\subsection{Why?}
+\frame{...}
+\frame{...}
+\subsection{Where?}
+\frame{...}
+
+\section{Results}
+\frame{\tableofcontents[currentsection]}
+\subsection{Because}
+\frame{...}
+\subsection{Here}
+\frame{...}
+\end{verbatim}
+
+  The following options can be given:
+  \begin{itemize}
+  \item
+    \declare{|currentsection|} causes all sections but the current to be shown in a semi-transparent way. Also, all subsections but those in the current section are shown in the semi-transparent way. This command is a shorthand for specifying the following options:
+
+\begin{verbatim}
+\end{verbatim}
+  \item
+    \declare{|currentsubsection|} causes all subsections but the current subsection in the current section to be shown in a semi-transparent way. This command is a shorthand for specifying the option |subsectionstyle=show/shaded|.
+  \item
+    \declare{|firstsection=|\meta{section number}} specifies which section should be numbered as section~1.''  This is useful if you have a first section (like an overview section) that should not receive a number. Section numbers are not shown by default. To show them, you must install a different table of contents templates.
+  \item
+    \declare{|hideallsubsections|} causes all subsections to be hidden. This command is a shorthand for specifying the option |subsectionstyle=hide|.
+  \item
+    \declare{|hideothersubsections|} causes the subsections of sections other than the current one to be hidden. This command is a shorthand for specifying the option |subsectionstyle=show/show/hide|.
+  \item
+    \declare{|part=|\meta{part number}} causes the table of contents of part \meta{part number} to be shown, instead of the table of contents of the current part (which is the default). This option can be combined with the other options, although combining it with the |current| option obviously makes no sense.
+  \item
+    \declare{|pausesections|} causes a |\pause| command to be issued before each section. This is useful if you wish to show the table of contents in an incremental way.
+  \item
+    \declare{|pausesubsections|} causes a |\pause| command to be issued before each subsection.
+  \item
+    \declare{|sections=|\marg{overlay specification}} causes only the sections mentioned in the \meta{overlay specification} to be shown. For example, \verb/sections={<2-4| handout:0>}/ causes only the second, third, and fourth section to be shown in the normal version, nothing to be shown in the handout version, and everything to be shown in all other versions. For convenience, if you omit the pointed brackets, the specification is assumed to apply to all versions. Thus |sections={2-4}| causes sections two, three, and four to be shown in all versions.
+  \item
+    \declare{|sectionstyle=|\meta{style for current section}|/|\meta{style for other sections}} specifies how sections should be displayed. Allowed \meta{styles} are |show|, |shaded|, and |hide|. The first will show the section title normally, the second will show it in a semi-transparent way, and the third will completely suppress it. You can also omit the second style, in which case the first is used for all sections (this is not really useful).
+  \item
+    \declare{|subsectionstyle=|\meta{style for current subsection}|/|\meta{style for other subsections in current section}|/|\\\meta{style for subsections in other sections}} specifies how subsections should be displayed. The same styles as for the |sectionstyle| option may be given. You can omit the last style, in which case the second also applies to the last, and you can omit the last two, in which case the first applies to all.
+    \example
+    \example
+    |subsectionstyle=hide| causes all subsections to be hidden.
+    \example
+    |subsectionstyle=show/shaded| causes all subsections but the current subsection in the current section to be shown in a semi-transparent way.
+    \example
+    |subsectionstyle=show/show/hide| causes all subsections outside the current section to be suppressed.
+    \example
+    |subsectionstyle=show/shaded/hide| causes all subsections outside the current section to be suppressed and only the current subsection in the current section to be highlighted.
+  \item
+    \declare{|subsubsectionstyle=|\meta{style for current subsubsection}|/|\meta{style for other subsubsections in current subsection}|/|\\\meta{style for subsubsections in other subsections in current section}|/|\meta{style for subsubsections in other subsections in other sections}} specifies how subsubsections should be displayed. The same styles as for the |sectionstyle| option may be given. You can omit the last style, in which case the second also applies to the last, and you can omit the last two, in which case the first applies to all.
+    This option operates in an analogous manner to |subsectionstyle|.
+  \end{itemize}
+
+  The last examples are useful if you do not wish to show too many details when presenting the talk outline.
+
+  \articlenote
+  The options are ignored in |article| mode.
+
+  \begin{element}{section/subsection in toc}\semiyes\no\no
+    This is a parent template, whose children are |section in toc| and |subsection in toc|. This means that if you use the |\setbeamertemplate| command on this template, the command is instead called for both of these children (with the same arguments).
+
+    \begin{templateoptions}
+      \itemoption{default}{}
+      In the default setting, the sections and subsections are typeset using the fonts and colors |section in toc| and |subsection in toc|, though the background colors are ignored. The subsections are indented.
+      \itemoption{sections numbered}{}
+      Similar to the default setting, but the section numbers are also shown. The subsections are not numbered.
+      \itemoption{subsections numbered}{}
+      This time, the subsections are numbered, but not the sections. Nevertheless, since the subsections are fully numbered'' as in 1.2'' or 3.2,'' if every section has at least one subsection, the section numbered will not really be missed.
+      \itemoption{circle}{}
+      Draws little circles before the sections. Inside the circles the section number is shown. The \beamer-font and color |section number projected| is used for typesetting the circles, that is, the circle gets the background color and the text inside the circle the foreground color.
+      \itemoption{square}{}
+      Similar to the |circle| option, except that small squares are used instead of circles. Small, unnumbered squares are shown in front of the subsections.
+      \itemoption{ball}{}
+      Like |square|, the only difference being the balls are used instead of squares.
+      \itemoption{ball unnumbered}{}
+      Similar to |ball|, except that no numbering is used. This option makes the table of contents look more like an |itemize|.
+    \end{templateoptions}
+
+    If none of the above options suits you, you have to change the templates |section in toc| and |subsection in toc| directly.
+  \end{element}
+
+    A parent template with children |section in toc shaded| and |subsection in toc shaded|. They are used to render section and subsection entries when they are currently shaded; like all non-current subsections in |\tableofcontents[currentsubsection]|.
+
+    \begin{templateoptions}
+      \itemoption{default}{\oarg{opaqueness}}
+      In the default setting, the templates |section in toc shaded| and |subsection in toc shaded| just show whatever the nonshaded versions of these templates show, but only \meta{opaqueness}\% opaque. The default is 20\%.
+
+      \example
+      |\setbeamertemplate{section in toc shaded}[default][50]| makes dimmed entries 50\% transparent.
+    \end{templateoptions}
+  \end{element}
+\end{command}
+
+
+
+You can use the bibliography environment and the |\cite| commands of \LaTeX\ in a \beamer\ presentation. You will typically have to typeset your bibliography items partly by hand.'' Nevertheless, you \emph{can} use |bibtex| to create a first approximation'' of the bibliography. Copy the content of the file |main.bbl| into your presentation. If you are not familiar with |bibtex|, you may wish to consult its documentation. It is a  powerful tool for creating high-quality citations.
+
+Using |bibtex| or your editor, place your bibliographic references in the environment |thebibliography|. This (standard \LaTeX) environment takes one parameter, which should be the longest |\bibitem| label in the following list of bibliographic entries.
+
+\begin{environment}{{thebibliography}\marg{longest label text}}
+  Inserts a bibliography into the current frame. The \meta{longest label text} is used to determine the indentation of the list. However, several predefined options for the typesetting of the bibliography ignore this parameter since they replace the references by a symbol.
+
+  Inside the environment, use a (standard \LaTeX) |\bibitem| command for each reference item. Inside each item, use a (standard \LaTeX) |\newblock| command to separate the authors' names, the title, the book/journal reference, and any notes. Each of these commands may introduce a new line or color or other formatting, as specified by the template for bibliographies.
+
+  The environment must be placed inside a frame. If the bibliography does not fit on one frame, you should split it (create a new frame and a second |thebibliography| environment) or use the |allowframebreaks| option. Even better, you should reconsider whether it is a good idea to present so many references.
+
+  \example
+\begin{verbatim}
+\begin{frame}
+
+  \begin{thebibliography}{Dijkstra, 1982}
+  \bibitem[Salomaa, 1973]{Salomaa1973}
+    A.~Salomaa.
+    \newblock {\em Formal Languages}.
+
+  \bibitem[Dijkstra, 1982]{Dijkstra1982}
+    E.~Dijkstra.
+    \newblock Smoothsort, an alternative for sorting in situ.
+    \newblock {\em Science of Computer Programming}, 1(3):223--233, 1982.
+  \end{thebibliography}
+\end{frame}
+\end{verbatim}
+
+  Four templates govern the appearance of the author, title, journal, and note text. These author templates are inserted before the first block of the entry (the first block is all text before the first occurrence of a |\newblock| command). The title template is inserted before the second block (the text between the first and second occurrence of |\newblock|). Likewise for the journal and note templates.
+
+  The templates are inserted \emph{before} the blocks and you do not have access to the blocks themselves via insert commands. The corresponding \beamer-color and -font are also installed before the blocks.
+
+  \begin{element}{bibliography entry author}\yes\yes\yes
+    This template is inserted before the author of a bibliography entry. The color and font are also installed. Note that the effect of this template will persist until the end of the bibliography item or until one of the following templates undo the effect.
+
+    By default, this template does nothing. The default color is the structure color.
+  \end{element}
+
+  \begin{element}{bibliography entry title}\yes\yes\yes
+    This template is inserted before the title of a bibliography entry (more precisely, it is inserted after the first occurrence of the |\newblock| command). By default, this template starts a new paragraph, causing a line break. The default color is the normal text color.
+  \end{element}
+
+  \begin{element}{bibliography entry location}\yes\yes\yes
+    This template is inserted before the journal of a bibliography entry (the second |\newblock|). By default, this template starts a new paragraph. The default color is a slightly transparent version of the structure color.
+  \end{element}
+
+  \begin{element}{bibliography entry note}\yes\yes\yes
+    This template is inserted before any note text at the end of a bibliography entry (it is inserted before the third |\newblock|). By default, this template starts a new paragraph. The default color is the same as for the journal.
+  \end{element}
+\end{environment}
+
+\begin{command}{\bibitem\sarg{overlay specification}\oarg{citation text}\marg{label name}}
+  The \meta{citation text} is inserted into the text when the item is cited using |\cite{|\meta{label name}|}| in the main presentation text. For a \beamer\ presentation, this should usually be as long as possible.
+
+  Use |\newblock| commands to separate the authors's names, the title, the book/journal reference, and any notes. If the \meta{overlay specification} is present, the entry will only be shown on the specified slides.
+
+  \example
+\begin{verbatim}
+\bibitem[Dijkstra, 1982]{Dijkstra1982}
+  E.~Dijkstra.
+  \newblock Smoothsort, an alternative for sorting in situ.
+  \newblock {\em Science of Computer Programming}, 1(3):223--233, 1982.
+\end{verbatim}
+
+  \begin{element}{bibliography item}\yes\yes\yes
+    \colorfontparents{item}
+    This template is used to render the bibliography item. Unlike normal \LaTeX, the default template for the bibliography does not repeat the citation text (like [Dijkstra, 1982]'') before each item in the bibliography. Instead, a cute, small article symbol is drawn. The rationale is that the audience will not be able to remember any abbreviated citation texts till the end of the
+    talk.
+    \begin{templateoptions}
+      \itemoption{default}{}
+      Draws a cute little article icon as the reference. Use this for journal articles, parts of books (like conference proceedings), or technical reports.
+
+      \itemoption{article}{}
+      Alias for the default.
+
+      \itemoption{book}{}
+      Draws a cute little book icon as the reference. Use this for, well, books.
+
+      \itemoption{online}{}
+      Draws a cute little globe icon as the reference. Use this for websites and the like.
+
+
+      \itemoption{triangle}{}
+      Draws a triangle as the reference. This is more in keeping with the standard itemize items.
+
+      \itemoption{text}{}
+      Uses the reference text (like [Dijkstra, 1982]'') as the reference text. Be sure you know what you are doing if you use this.
+    \end{templateoptions}
+    The following insert is useful for the template:
+    \begin{itemize}
+      \iteminsert{\insertbiblabel}
+      inserts the current citation label.
+    \end{itemize}
+  \end{element}
+\end{command}
+
+
+
+You can add an appendix to your talk by using the |\appendix| command. You should put frames and perhaps whole subsections into the appendix that you do not intend to show during your presentation, but which might be useful to answer a question. The |\appendix| command essentially just starts a new part named |\appendixname|. However, it also sets up certain hyperlinks. Like other parts, the appendix is kept separate from your actual talk.
+
+\begin{command}{\appendix\sarg{mode specification}}
+  Starts the appendix in the specified modes. All frames, all |\subsection| commands, and all |\section| commands used after this command will not be shown as part of the normal navigation bars.
+  \example
+\begin{verbatim}
+\begin{document}
+\frame{\titlepage}
+\section*{Outline}
+\frame{\tableofcontents}
+\section{Main Text}
+\frame{Some text}
+\section*{Summary}
+\frame{Summary text}
+
+\appendix
+\section{\appendixname}
+\frame{\tableofcontents}
+\frame{Details}
+\frame{Text omitted in main talk.}
+\frame{More details}
+\end{document}
+\end{verbatim}
+\end{command}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-globalstructure.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-graphics.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-graphics.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,108 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2013,2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\section{Graphics}
+\label{section-graphics}
+
+In the following, the advantages and disadvantages of different possible ways of creating graphics for \beamer\ presentations are discussed. Much of the information presented in the following is not really special to \beamer, but applies to any other document class as well.
+
+
+\subsection{Including External Graphic Files Versus Inlines Graphics}
+
+There are two principal ways of creating \TeX-documents that include graphics: Either the graphic resides in an external file that is \emph{included} or the graphic is \emph{inlined}, which means that \TeX-file contains a bunch of commands like draw a red line from here to there.'' In the following, the advantages and disadvantages of these two approaches are discussed.
+
+You can use an external program, like |xfig|, GIMP or Inkscape, to create a graphic. These programs have an option to \emph{export} graphic files in a format that can then be inserted into the presentation.
+
+\begin{itemize}
+\item
+  You can use a powerful program to create a high-quality graphic.
+\end{itemize}
+
+\begin{itemize}
+\item
+  You  have to worry about many files. Typically there are at least two for each presentation, namely the program's graphic data file and the exported graphic file in a format that can be read by \TeX.
+\item
+  Changing the graphic using the program does not automatically change the graphic in the presentation. Rather, you must reexport the graphic and rerun \LaTeX.
+\item
+  It may be difficult to get the line width, fonts, and font sizes right.
+\item
+  Creating formulas as part of graphics is often difficult or impossible.
+\end{itemize}
+
+You can use all the standard \LaTeX\ commands for inserting graphics, like |\includegraphics|. Also, the |pgf| package offers commands for including graphics. Either will work fine in most situations, so choose whichever you like. Like |\pgfdeclareimage|, |\includegraphics| also includes an image only once in a |.pdf| file, even if it used several times (as a matter of fact, the |graphics| package is even a bit smarter about this than |pgf|). However, currently only |pgf| offers the ability to include images that are partly transparent.
+
+At the end of this section you will find notes on how to include specific graphic formats like |.eps| or |.jpg|.
+
+The commands |\includegraphics|, |\pgfuseimage|, and |\pgfimage| are overlay-specification-aware in \beamer. If the overlay specification does not apply, the command has no effect. This is useful for creating a simple animation where each picture of the animation resides in a different file:
+
+\begin{verbatim}
+\begin{frame}
+  \includegraphics<1>[height=2cm]{step1.pdf}%
+  \includegraphics<2>[height=2cm]{step2.pdf}%
+  \includegraphics<3>[height=2cm]{step3.pdf}%
+\end{frame}
+\end{verbatim}
+A different way of creating graphics is to insert graphic drawing commands directly into your \LaTeX\ file. There are numerous packages that help you do this. They have various degrees of sophistication. Inlining graphics suffers from none of the disadvantages mentioned above for including external graphic files, but the main disadvantage is that it is often hard to use these packages. In some sense, you program'' your graphics, which requires a bit of practice.
+
+When choosing a graphic package, there are a few things to keep in
+mind:
+\begin{itemize}
+\item
+  Many packages produce poor quality graphics. This is especially true of the standard |picture| environment of \LaTeX.
+\item
+  Powerful packages that produce high-quality graphics often do not work together with |pdflatex|, |lualatex| or |xelatex|.
+\item
+  The most powerful and easiest-to-use package around, namely |pstricks|, does not work together with |pdflatex|, |lualatex| or |xelatex| and this is a fundamental problem. Due to the fundamental differences between \pdf\ and PostScript, it is not possible to write a |pdflatex| back-end for |pstricks|.'' (Situation with |lualatex| and |xelatex| is very similar.) Regardless, \textsc{pst-pdf}, \textsc{xetex-pstricks} and \textsc{pdftricks} package can help here and simplify things from user's perspective.
+\end{itemize}
+
+There are three possible solutions to the above problem, each with it's own advantages and disadvantages.
+\begin{itemize}
+\item
+  Use the \textsc{pgf} package. It produces high-quality graphics and works together with |pdflatex|, |lualatex|, |xelatex| and also with normal |latex|. It is not as powerful as |pstricks| (as pointed out above, this is because of rather fundamental reasons) and not as easy to use, but it should be sufficient in most cases.
+\item
+  Use \textsc{luamplib} package and |lualatex|. It provides you with an environment using which you can type MetaPost code directly in your document.
+\item
+  Use |pstricks| and stick to |latex| and |dvips| or use some of the workarounds mentioned above.
+\end{itemize}
+
+
+\subsection{Including Graphic Files Ending \texttt{.eps} or \texttt{.ps}}
+
+External graphic files ending with the extension |.eps| (Encapsulated PostScript) or |.ps| (PostScript) can be included if you use |latex| and |dvips|, but \emph{not} when using |pdflatex|. This is true both for the normal |graphics| package and for |pgf|. When using |pgf|, do \emph{not} add the extension |.eps|. When using |graphics|, do add the extension.
+
+If you have a |.eps| graphic and wish to use |pdflatex|, you can use the program |ps2pdf| to convert the graphic to a |.pdf| file. Some modern distributions enable |write18| which allows |pdflatex| to do that automatically. Note, however, that it is often a better idea to directly generate a |.pdf| if the program that produced the |.eps| supports this.
+
+
+\subsection{Including Graphic Files Ending \texttt{.pdf}, \texttt{.jpg}, \texttt{.jpeg} or \texttt{.png}}
+
+The four formats |.pdf|, |.jpg|, |.jpeg|, and |.png| can only be included by |pdflatex|. As before, do not add these extension when using |pgf|, but do add them when using |graphics|. If your graphic file has any of these formats and you wish/must use |latex| and |dvips|, you  have to convert your graphic to |.eps| first.
+
+
+\subsection{Including Graphic Files Ending \texttt{.mps}}
+
+A graphic file ending |.mps| (MetaPost PostScript) is a special kind of Encapsulated PostScript file. Files in this format are produced by the MetaPost program. As you know, \TeX\ is a program that converts simple plain text into beautifully typeset documents. The MetaPost program is similar, only it converts simple plain text into beautiful graphics.
+
+The MetaPost program converts a plain text file ending |.mp| into an |.mps| file (although for some unfathomable reason the extension is not added). The |.mp| file must contain text written in the MetaFont programming language. Since |.mps| files are actually also |.eps| files, you can use the normal |\includegraphics| command to include them.
+
+However, as a special bonus, you can \emph{also} include such a file when using |pdflatex|. Normally, |pdflatex| cannot handle |.eps| files, but the |.mps| files produced by MetaPost have such a simple and special structure that this is possible. The |graphics| package implements some filters to convert such PostScript output to \pdf\ on-the-fly. For this to work, the file should end |.mps| instead of |.eps|. The following command can be used to make the |graphics| package just \emph{assume} the extension |.mps| for any file it knows nothing about (like files ending with |.1|, which is what MetaPost loves to produce):
+\begin{verbatim}
+\DeclareGraphicsRule{*}{mps}{*}{}
+\end{verbatim}
+This special feature currently only works with the |graphics| package, not with |pgf|.
+
+
+\subsection{Including Graphic Files Ending \texttt{.mmp}}
+
+The format |.mmp| (Multi-MetaPost) is actually not a format that can be included directly in a \TeX-file. Rather, like a |.mp| file, it first has to be converted using the MetaPost program. The crucial difference between |.mp| and |.mmp| is that in the latter multiple graphics can reside in a single |.mmp| file (actually, multiple graphics can also reside in a |.mp| file, but by convention such a file is called |.mmp|). When running MetaPost on a |.mmp| file, it will create not a single encapsulated PostScript file, but several, ending |.0|, |.1|, |.2|, and so on. The idea is that |.0| might contain a main graphic and the following pictures contain overlay material that should be incrementally added to this graphic.
+
+To include the series of resulting files, you can use the command |\multiinclude| from the |mpmulti| or from the |xmpmulti| package. How this program works is explained in Section~\ref{section-mpmulti}.

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-graphics.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-guidelines.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-guidelines.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,422 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2012,2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\section{Guidelines for Creating Presentations}
+\label{section-guidelines}
+
+In this section we sketch the guidelines that we try to stick to when we create presentations. These guidelines either arise out of experience, out of common sense, or out of recommendations by other people or books. These rules are certainly not intended as commandments that, if not followed, will result in catastrophe. The central rule of typography also applies to creating presentations: \emph{Every rule can be broken, but no rule may be ignored.}
+
+
+\subsection{Structuring a Presentation}
+\label{section-structure-guidelines}
+
+\subsubsection{Know the Time Constraints}
+
+When you start to create a presentation, the very first thing you should worry about is the amount of time you have for your presentation. Depending on the occasion, this can be anything between 2 minutes and two hours.
+\begin{itemize}
+\item
+  A simple rule for the number of frames is that you should have at most one frame per minute.
+\item
+  In most situations, you will have less time for your presentation that you would like.
+\item
+  \emph{Do not try to squeeze more into a presentation than time allows for.} No matter how important some detail seems to you, it is better to leave it out, but get the main message across, than getting neither the main message nor the detail across.
+\end{itemize}
+
+In many situations, a quick appraisal of how much time you have will show that you won't be able to mention certain details. Knowing this can save you hours of work on preparing slides that you would have to remove later anyway.
+
+\subsubsection{Global Structure}
+
+To create the global structure'' of a presentation, with the time constraints in mind, proceed as follows:
+\begin{itemize}
+\item
+  Make a mental inventory of the things you can reasonably talk about within the time available.
+\item
+  Categorize the inventory into sections and subsections.
+\item
+  For very long talks (like a 90 minute lecture), you might also divide your talk into independent parts (like a review of the previous lecture part'' and a main part'') using the |\part| command. Note that each  part has its own table of contents.
+\item
+  Do not feel afraid to change the structure later on as you work on the talk.
+\end{itemize}
+
+\paragraph{Parts, Section, and Subsections.}
+
+\begin{itemize}
+\item
+  Do not use more than four sections and not less than two per part.
+\end{itemize}
+
+Even four sections are usually too much, unless they follow a very easy pattern. Five and more sections are simply too hard to remember for the audience. After all, when you present the table of contents, the audience will not yet really be able to grasp the importance and relevance of the different sections and will most likely have forgotten them by the time you reach them.
+\begin{itemize}
+\item
+  Ideally, a table of contents should be understandable by itself. In particular, it should be comprehensible \emph{before} someone has heard your talk.
+\item
+  Keep section and subsection titles self-explaining.
+\item
+  Both the sections and the subsections should follow a logical pattern.
+\item
+  Begin with an explanation of what your talk is all about. (Do not assume that everyone knows this. The \emph{Ignorant Audience Law} states: Someone important in the audience always knows less than you think everyone should know, even if you take the Ignorant Audience Law into account.)
+\item
+  Then explain what you or someone else has found out concerning the subject matter.
+\item
+  Always conclude your talk with a summary that repeats the main message of the talk in a short and simple way. People pay most attention at the beginning and at the end of talks. The summary is your second chance'' to get across a message.
+\item
+  You can also add an appendix part using the |\appendix| command. Put everything into this part that you do not actually intend to talk about, but that might come in handy when questions are asked.
+\item
+  Do not use subsubsections, they are evil.
+\end{itemize}
+
+\paragraph{Giving an Abstract}
+
+In papers, the abstract gives a short summary of the whole paper in about 100 words. This summary is intend to help readers appraise whether they should read the whole paper or not.
+\begin{itemize}
+\item
+  Since your audience is unlikely to flee after the first slide, in a presentation you usually do not need to present an abstract.
+\item
+  However, if you can give a nice, succinct statement of your talk, you might wish to include an abstract.
+\item
+  If you include an abstract, be sure that it is \emph{not} some long text but just a very short message.
+\item
+  \emph{Never, ever} reuse a paper abstract for a presentation, \emph{except} if the abstract is We show $\operatorname{P} = \operatorname{NP}$'' or We show $\operatorname{P} \neq \operatorname{NP}$''
+\item
+  If your abstract is one of the above two, double-check whether your proof is correct.
+\end{itemize}
+
+\paragraph{Numbered Theorems and Definitions.}
+
+A common way of globally structuring (math) articles and books is to use consecutively numbered definitions and theorems. Unfortunately, for presentations the situation is a bit more complicated and we would like to discourage using numbered theorems in presentations. The audience has no chance of remembering these numbers. \emph{Never} say things like now, by Theorem~2.5 that I showed you earlier, we have \dots'' It would be much better to refer to, say, Kummer's Theorem instead of Theorem~2.5. If Theorem~2.5 is some obscure theorem that does not have its own name (unlike Kummer's Theorem or Main Theorem or Second Main Theorem or Key Lemma), then the audience will have forgotten about it anyway by the time you refer to it again.
+
+In our opinion, the only situation in which numbered theorems make sense in a presentation is in a lecture, in which the students can read lecture notes in parallel to the lecture where the theorems are numbered in exactly the same way.
+
+If you do number theorems and definitions, number everything consecutively. Thus if there are one theorem, one lemma, and one definition, you would have Theorem~1, Lemma~2, and Definition~3. Some people prefer all three to be numbered~1. We would \emph{strongly} like to discourage this. The problem is that this makes it virtually impossible to find anything since Theorem~2 might come after Definition~10 or the other way round. Papers and, worse, books that have a Theorem~1 and a Definition~1 are a pain.
+\begin{itemize}
+\item
+  Do not inflict pain on other people.
+\end{itemize}
+
+\paragraph{Bibliographies.}
+
+You may also wish to present a bibliography at the end of your talk, so that people can see what kind of further reading'' is possible. When adding a bibliography to a presentation, keep the following in mind:
+\begin{itemize}
+\item
+  It is a bad idea to present a long bibliography in a presentation. Present only very few references. (Naturally, this applies only to the talk itself, not to a possible handout.)
+\item
+  If you present more references than fit on a single slide you can be almost sure that none of them will be remembered.
+\item
+  Present references only if they are intended as further reading.'' Do not present a list of all things you used like in a paper.
+\item
+  You should not present a long list of all your other great papers \emph{except} if you are giving an application talk.
+\item
+  Using the |\cite| commands can be confusing since the audience has little chance of remembering the citations. If you cite the references, always cite them with full author name and year like [Tantau, 2003]'' instead of something like [2,4]'' or [Tan01,NT02]''.
+\item
+  If you want to be modest, you can abbreviate your name when citing yourself as in [Nickelsen and T., 2003]'' or [Nickelsen and T, 2003]''. However, this can be confusing for the audience since it is often not immediately clear who exactly T.'' might be. We recommend using the full name.
+\end{itemize}
+
+\subsubsection{Frame Structure}
+\label{section-frame-guidelines}
+\label{section-guidelines-local}
+
+Just like your whole presentation, each frame should also be structured. A frame that is solely filled with some long text is very hard to follow. It is your job to structure the contents of each frame such that, ideally, the audience immediately sees which information is important, which information is just a detail, how the presented information is related, and so on.
+
+\paragraph{The Frame Title}
+
+\begin{itemize}
+\item
+  Put a title on each frame. The title explains the contents of the frame to people who did not follow all details on the slide.
+\item
+  The title should really \emph{explain} things, not just give a cryptic summary that cannot be understood unless one has understood the whole slide. For example, a title like The Poset'' will have everyone puzzled what this slide might be about. Titles like Review of the Definition of Partially Ordered Sets (Posets)'' or A Partial Ordering on the Columns of the Genotype Matrix'' are \emph{much} more informative.
+\item
+  Ideally, titles on consecutive frames should tell a story'' all by themselves.
+\item
+  In English, you should \emph{either} \emph{always} capitalize all words in a frame title except for words like a'' or the'' (as in a title), \emph{or} you \emph{always} use the normal lowercase letters. Do \emph{not} mix this; stick to one rule. The same is true for block titles. For example, do not use titles like A short Review of Turing machines.'' Either use A Short Review of Turing Machines.'' or A short review of Turing machines.'' (Turing is still spelled with a capital letter since it is a name).
+\item
+  In English, the title of the whole document should be capitalized, regardless of whether you capitalize anything else.
+\item
+  In German and other languages that have lots of capitalized words, always use the correct upper-/lowercase letters. Never capitalize anything in addition to what is usually capitalized.
+\end{itemize}
+
+\paragraph{How Much Can I Put On a Frame?}
+
+\begin{itemize}
+\item
+  A frame with too little on it is better than a frame with too much on it. A usual frame should have between 20 and 40 words. The maximum should be at about 80 words.
+\item
+  Do not assume that everyone in the audience is an expert on the subject matter. Even if the people listening to you should be experts, they may last have heard about things you consider obvious several years ago. You should always have the time for a quick reminder of what exactly a semantical complexity class'' or an $\omega$-complete partial ordering'' is.
+\item
+  Never put anything on a slide that you are not going to explain during the talk, not even to impress anyone with how complicated your subject matter really is. However, you may explain things that are not on a slide.
+\item
+  Keep it simple. Typically, your audience will see a slide for less than 50 seconds. They will not have the time to puzzle through long sentences or complicated formulas.
+\item
+  Lance Fortnow, a professor of computer science, claims: PowerPoint users give better talks. His reason: Since PowerPoint is so bad at typesetting math, they use less math, making their talks easier to understand.
+
+  There is some truth in this in our opinion. The great math-typesetting capabilities of \TeX\ can easily lure you into using many more formulas than is necessary and healthy. For example, instead of writing {\catcode |=12Since $\left|\{x \in \{0,1\}^* \mid x \sqsubseteq y\}\right| < \infty$}, we have\dots''\ use Since $y$ has only finitely many prefixes, we have\dots''
+
+  You will be surprised how much mathematical text can be reformulated in plain English or can just be omitted. Naturally, if some mathematical argument is what you are actually talking about, as in a math lecture, make use of \TeX's typesetting capabilities to your heart's content.
+\end{itemize}
+
+\paragraph{Structuring a Frame}
+
+\begin{itemize}
+\item
+  Use block environments like |block|, |theorem|, |proof|, |example|, and so on.
+\item
+  Prefer enumerations and itemize environments over plain text.
+\item
+  Use |description| when you define several things.
+\item
+  Do not use more than two levels of subitemizing.'' \beamer\ supports three levels, but you should not use that third level. Mostly, you should not even use the second one. Use good graphics instead.
+\item
+  Do not create endless |itemize| or |enumerate| lists.
+\item
+  Do not uncover lists piecewise.
+\item
+  Emphasis is an important part of creating structure. Use |\alert| to highlight important things. This can be a single word or a whole sentence. However, do not overuse highlighting since this will negate the effect.
+\item
+  Use columns.
+\item
+  \emph{Never} use footnotes. They needlessly disrupt the flow of reading. Either what is said in the footnote is important and should be put in the normal text; or it is not important and should be omitted (\emph{especially} in a presentation).
+\item
+  Use |quote| or |quotation| to typeset quoted text.
+\item
+  Do not use the option |allowframebreaks| except for long bibliographies.
+\item
+  Do not use long bibliographies.
+\end{itemize}
+
+\paragraph{Writing the Text}
+
+\begin{itemize}
+\item
+  Use short sentences.
+\item
+  Prefer phrases over complete sentences. For example, instead of The figure on the left shows a Turing machine, the figure on the right shows a finite automaton.''\ try Left: A Turing machine. Right: A finite automaton.'' Even better, turn this into an itemize or a description.
+\item
+  Punctuate correctly: no punctuation after phrases, complete punctuation in and after complete sentences.
+\item
+  \emph{Never} use a smaller font size to fit more on a frame.'' \emph{Never ever} use the \emph{evil} option |shrink|.
+\item
+  Do not hyphenate words. If absolutely necessary, hyphenate words by hand,'' using the command~|\-|.
+\item
+  Break lines by hand'' using the command~|\\|. Do not rely on automatic line breaking. Break where there is a logical pause. For example, good breaks in the tape alphabet is larger than the input alphabet'' are before is'' and before the second the.'' Bad breaks are before either alphabet'' and before larger.''
+\item
+  Text and numbers in figures should have the \emph{same} size as normal text. Illegible numbers on axes usually ruin a chart and its message.
+\end{itemize}
+
+\subsubsection{Interactive Elements}
+
+Ideally, during a presentation you would like to present your slides in a perfectly linear fashion, presumably by pressing the page-down-key once for each slide. However, there are different reasons why you might have to deviate from this linear order:
+\begin{itemize}
+\item
+  Your presentation may contain different levels of detail'' that may or may not be skipped or expanded, depending on the audience's reaction.
+\item
+  You are asked questions and wish to show supplementary slides.
+\item
+  You present a complicated picture and you have to zoom out'' different parts to explain details.
+\item
+\end{itemize}
+
+You cannot really prepare against the last kind of questions. In this case, you can use the navigation bars and symbols to find the slide you are interested in, see \ref{section-navigation-bars}.
+
+Concerning the first three kinds of deviations, there are several things you can do to prepare planned detours'' or planned short cuts''.
+\begin{itemize}
+\item
+  You can add skip buttons.'' When such a button is pressed, you jump over a well-defined part of your talk. Skip button have two advantages over just pressing the forward key is rapid succession: first, you immediately end up at the correct position and, second, the button's label can give the audience a visual feedback of what exactly will be skipped. For example, when you press a skip button labeled Skip proof'' nobody will start puzzling over what he or she has missed.
+\item
+  You can add an appendix to your talk. The appendix is kept perfectly separated'' from the main talk. Only once you enter'' the appendix part (presumably by hyperjumping into it), does the appendix structure become visible. You can put all frames that you do not intend to show during the normal course of your talk, but which you would like to have handy in case someone asks, into this appendix.
+\item
+  You can add goto buttons'' and return buttons'' to create detours. Pressing a goto button will jump to a certain part of the presentation where extra details can be shown. In this part, there is a return button present on each slide that will jump back to the place where the goto button was pressed.
+\item
+  In \beamer, you can use the |\againframe| command to continue'' frames that you previously started somewhere, but where certain details have been suppressed. You can use the |\againframe| command at a much later point, for example only in the appendix to show additional slides there.
+\item
+  In \beamer, you can use the |\framezoom| command to create links to zoomed out parts of a complicated slide.
+\end{itemize}
+
+\subsection{Using Graphics}
+
+Graphics often convey concepts or ideas much more efficiently than text: A picture can say more than a thousand words. (Although, sometimes a word can say more than a thousand pictures.)
+\begin{itemize}
+\item
+  Put (at least) one graphic on each slide, whenever possible. Visualizations help an audience enormously.
+\item
+  Usually, place graphics to the left of the text. (Use the |columns| environment.) In a left-to-right reading culture, we look at the left first.
+\item
+  Graphics should have the same typographic parameters as the text: Use the same fonts (at the same size) in graphics as in the main text. A small dot in a graphic should have exactly the same size as a small dot in a text. The line width should be the same as the stroke width used in creating the glyphs of the font. For example, an 11pt non-bold Computer Modern font has a stroke width of 0.4pt.
+\item
+  While bitmap graphics, like photos, can be much more colorful than the rest of the text, vector graphics should follow the same color logic'' as the main text (like black~= normal lines, red~= highlighted parts, green~= examples, blue~= structure).
+\item
+  Like text, you should explain everything that is shown on a graphic. Unexplained details make the audience puzzle whether this was something important that they have missed. Be careful when importing graphics from a paper or some other source. They usually have much more detail than you will be able to explain and should be radically simplified.
+\item
+  Sometimes the complexity of a graphic is intentional and you are willing to spend much time explaining the graphic in great detail. In this case, you will often run into the problem that fine details of the graphic are hard to discern for the audience. In this case you should use a command like |\framezoom| to create anticipated zoomings of interesting parts of the graphic, see Section~\ref{section-zooming}.
+\end{itemize}
+
+
+\subsection{Using Animations and Transitions}
+
+\begin{itemize}
+\item
+  Use animations to explain the dynamics of systems, algorithms, etc.
+\item
+  Do \emph{not} use animations just to attract the attention of your audience. This often distracts attention away from the main topic of the slide. No matter how cute a rotating, flying theorem seems to look and no matter how badly you feel your audience needs some action to keep it happy, most people in the audience will typically feel you are making fun of them.
+\item
+  Do \emph{not} use distracting special effects like dissolving'' slides unless you have a very good reason for using them. If you use them, use them sparsely. They \emph{can} be useful in some situations: For example, you might show a young boy on a slide and might wish to dissolve this slide into a slide showing a grown man instead. In this case, the dissolving  gives the audience visual feedback that the young boy slowly becomes'' the man.
+\end{itemize}
+
+
+\subsection{Choosing Appropriate Themes}
+
+\beamer\ comes with a number of different themes. When choosing a theme, keep the following in mind:
+\begin{itemize}
+\item
+  Different themes are appropriate for different occasions. Do not become too attached to a favorite theme; choose a theme according to occasion.
+\item
+  A longer talk is more likely to require navigational hints than a short one. When you give a 90 minute lecture to students, you should choose a theme that always shows a sidebar with the current topic highlighted so that everyone always knows exactly what's the current status'' of your talk is; when you give a ten-minute introductory speech, a table of contents is likely to just seem silly.
+\item
+  A theme showing the author's name and affiliation is appropriate in situations where the audience is likely not to know you (like during a conference). If everyone knows you, having your name on each slide is just vanity.
+\item
+  First choose a presentation theme that has a layout that is appropriate for your talk.
+\item
+  Next you might wish to change the colors by installing a different color theme. This can drastically change the appearance of your presentation. A colorful'' theme like |Berkeley| will look much less flashy if you use the color themes |seahorse| and |lily|.
+\item
+  You might also wish to change the fonts by installing a different font theme.
+\end{itemize}
+
+
+\subsection{Choosing Appropriate Colors}
+
+\begin{itemize}
+\item
+  Use colors sparsely. The prepared themes are already quite colorful (blue~= structure, red~= alert, green~= example). If you add more colors for things like code, math text, etc., you should have a \emph{very} good reason.
+\item
+  Be careful when using bright colors on white background, \emph{especially} when using green. What looks good on your monitor may look bad during a presentation due to the different ways monitors, beamers, and printers reproduce colors. Add lots of black to pure colors when you use them on bright backgrounds.
+\item
+  Maximize contrast. Normal text should be black on white or at least something very dark on something very bright. \emph{Never} do things like light green text on not-so-light green background.''
+\item
+  Background shadings decrease the legibility without increasing the information content. Do not add a background shading just because it somehow looks nicer.''
+\item
+  Inverse video (bright text on dark background) can be a problem during presentations in bright environments since only a small percentage of the presentation area is light up by the beamer. Inverse video is harder to reproduce on printouts and on transparencies.
+\end{itemize}
+
+
+\subsection{Choosing Appropriate Fonts and Font Attributes}
+
+Text and fonts literally surround us constantly. Try to think of the last time when there was no text around you within ten meters. Likely, this has never happened in your life! (Whenever you wear clothing, even a swim suit, there is a lot of text right next to your body.) The history of fonts is nearly as long as the history of civilization itself. There are tens of thousands of fonts available these days, some of which are the product of hundreds of years of optimization.
+
+Choosing the right fonts for a presentation is by no means trivial and wrong choices will either just look bad'' or, worse, make the audience have trouble reading your slides. This user's guide cannot replace a good book on typography, but in the present section you'll find several hints that should help you setup fonts for a \beamer\ presentation that look good. A font has numerous attributes like weight, family, or size. All of these have an impact on the usability of the font in presentations. In the following, these attributes are described and advantages and disadvantages of the different choices are sketched.
+
+\subsubsection{Font Size}
+\label{section-sizes}
+
+Perhaps the most obvious attribute of a font is its size. Fonts are traditionally measured in points.'' How much a point is depends on whom you ask. \TeX\ thinks a point is the 72.27th part of an inch, which is 2.54 cm. On the other hand, PostScript and Adobe think a point is the 72th part of an inch (\TeX\ calls this a big point). There are differences between American and European points. Once it is settled how much a point is, claiming that a text is in 11pt'' means that the height'' of the letters in the font are 11pt. However, this height'' stems from the time when letters where still cast in lead and refers to the vertical size of the lead letters. It thus does not need to have any correlation with the actual height of, say, the letter x or even the letter M. The letter x of an 11pt Times from Adobe will have a height that is different from the height of the letter x of an 11pt Times from UTC and the letter x of an 11pt Helvetica from Adobe will have yet another height.
+
+Summing up, the font size has little to do with the actual size of letters. Rather, these days it is a convention that 10pt or 11pt is the size a font should be printed for normal reading.'' Fonts are designed so that they can optimally be read at these sizes.
+
+In a presentation the classical font sizes obviously lose their meaning. Nobody could read a projected text if it were actually 11pt. Instead, the projected letters need to be several centimetres high. Thus, it does not really make sense to specify font sizes'' for presentations in the usual way. Instead, you should try to think of the number of lines that will fit on a slide if you were to fill the whole slide with line-by-line text (you are never going to do that in practice, though). Depending on how far your audience is removed from the projection and on how large the projection is, between 10 and 20 lines should fit on each slide. The less lines, the more readable your text will be.
+
+In \beamer, the default sizes of the fonts are chosen in a way that makes it difficult to fit too much'' onto a slide. Also, it will ensure that your slides are readable even under bad conditions like a large room and only a small projection area. However, you may wish to enlarge or shrink the fonts a bit if you know this to be more appropriate in your presentation environment.
+
+Once the size of the normal text is settled, all other sizes are usually defined relative to that size. For this reason, \LaTeX\ has commands like |\large| or |\small|. The actual size these commands select depends on the size of normal text.
+
+In a presentation, you will want to use a very small font for text in headlines, footlines, or sidebars since the text shown there is not vital and is read at the audience's leisure. Naturally, the text should still be large enough that it actually \emph{can} be read without binoculars. However, in a normal presentation environment the audience will still be able to read even |\tiny| text when necessary.
+
+However, using small fonts can be tricky. Many PostScript fonts are just scaled down when used at small sizes. When a font is used at less than its normal size, the characters should actually be stroked using a slightly thicker pen'' than the one resulting from just scaling things. For this reason, high quality multiple master fonts or the Computer Modern fonts use different fonts for small characters and for normal characters. However, when you use a normal Helvetica or Times font, the characters are just scaled down. A similar problem arises when you use a light font on a dark background. Even when printed on paper in high resolution, light-on-dark text tends to be overflooded'' by the dark background. When light-on-dark text is rendered in a presentation this effect can be much worse, making the text almost impossible to read.
+
+You can counter both negative effects by using a bold version for small text.
+
+In the other direction, you can use larger text for titles. However, using a larger font does not always have the desired effect. Just because a frame title is printed in large letters does not mean that it is read first. Indeed, have a look at the cover of your favorite magazine. Most likely, the magazine's name is the typeset in the largest font, but your attention will nevertheless first go to the topics advertised on the cover. Likewise, in the table of contents you are likely to first focus on the entries, not on the words Table of Contents.'' Most likely, you would not spot a spelling mistake there (a friend of mine actually managed to misspell \emph{his own name} on the cover of his master's thesis and nobody noticed until a year later). In essence, large text at the top of a page signals unimportant since I know what to expect.'' So, instead of using a very large frame title, also consider using a normal size frame title that is typeset in bold or in italics.
+
+\subsubsection{Font Families}
+\label{section-guidelines-serif}
+
+The other central property of any font is its family. Examples of font families are Times or Helvetica or Futura. As the name suggests, a lot of different fonts can belong to the same family. For example, Times comes in different sizes, there is a bold version of Times, an italics version, and so on. To confuse matters, font families like Times are often just called the font Times.''
+
+There are two large classes of font families: serif fonts and sans-serif fonts. A sans-serif font is a font in which the letters do not have serifs (from French \emph{sans}, which means without''). Serifs are the little hooks at the ending of the strokes that make up a letter. The font you are currently reading is a serif font. \textsf{By comparison, this text is in a sans-serif font.} Sans-serif fonts are (generally considered to be) easier to read when used in a presentation. In low resolution rendering, serifs decrease the legibility of a font. However, on projectors with very high resolution serif text is just as readable as sans-serif text. A presentation typeset in a serif font creates a more conservative impression, which might be exactly what you wish to create.
+
+Most likely, you'll have a lot of different font families preinstalled on your system. The default font used by \TeX\ (and \beamer) is the Computer Modern font. It  is the original font family designed by Donald Knuth himself for the \TeX\ program. It is a mature font that comes with just about everything you could wish for: extensive mathematical alphabets, outline PostScript versions, real small caps, real oldstyle numbers, specially designed small and large letters, and so on.
+
+However, there are reasons for using font families other than Computer Modern:
+\begin{itemize}
+\item
+  The Computer Modern fonts are a bit boring if you have seen them too often. Using another font (but not Times!) can give a fresh look.
+\item
+  Other fonts, especially Times and Helvetica, are sometime rendered better since they seem to have better internal hinting.
+\item
+  The sans-serif version of Computer Modern is not nearly as well-designed as the serif version. Indeed, the sans-serif version is, in essence, the serif version with different design parameters, not an independent design.
+\item
+  Computer modern needs much more space than more economic fonts like Times (this explains why Times is so popular with people who need to squeeze their great paper into just twelve pages). To be fair, Times was specifically designed to be economic (the newspaper company publishing The Times needed robust, but space-economic font).
+\end{itemize}
+
+A small selection of alternatives to Computer Modern:
+\begin{itemize}
+\item
+  Latin Modern is a Computer Modern derivate that provides more characters, so it's not considered a real alternative. It's recommended over Computer Modern, though.
+\item
+  Helvetica is an often used alternative. However, Helvetica also tends to look boring (since we see it everywhere) and it has a very large x-height (the height of the letter~x in comparison to a letter like~M). A large x-height is usually considered good for languages (like English) that use uppercase letters seldom and not-so-good for languages (like German) that use uppercase letters a lot. (We have never been quite convinced by the argument for this, though.) Be warned: the x-height of Helvetica is so different from the x-height of Times that mixing the two in a single line looks strange. The packages for loading Times and Helvetica provide options for fixing this, though.
+\item
+  Futura is, in our opinion, a beautiful font that is very well-suited for presentations. Its thick letters make it robust against scaling, inversion, and low contrast. Unfortunately, while it is most likely installed on your system somewhere in some form, getting \TeX\ to work with it is a complicated process. However, it has been made a lot simpler with modern typesetting engines such as |luatex| and |xetex|.
+\item
+  Times is a possible alternative to Computer Modern. Its main disadvantage is that it is a serif font, which requires a high-resolution projector. Naturally, it also used very often, so we all know it very well.
+\item
+  DejaVu, a derivate of Bitstream Vera is also a very good and free alternative. TrueType version that comes with OpenOffice.org is complicated to get to work with \TeX, but |arev| \LaTeX\ package provides an easy way to use Type 1 version named Bera. It has both sans-serif and serif versions; |arev| provides both.
+\end{itemize}
+
+Families that you should \emph{not} use for normal text include:
+\begin{itemize}
+\item
+  All monospaced fonts (like Courier).
+\item
+  Script fonts (which look like handwriting). Their stroke width is way too small for a presentation.
+\item
+  More delicate serif fonts like Stempel and possibly even Garamond (though Garamond is really a beautiful font for books).
+\item
+  Gothic fonts. Only a small fraction of your audience will be able to read them fluently.
+\end{itemize}
+
+There is one popular font that is a bit special: Microsoft's Comic Sans. On the one hand, there is a website lobbying for banning the use of this font. Indeed, the main trouble with the font is that it is not particularly well-readable and that math typeset partly using this font looks terrible. On the other hand, this font \emph{does} create the impression of a slide written by hand,'' which gives the presentation a natural look. Think twice before using this font, but do not let yourself be intimidated.
+
+One of the most important rules of typography is that you should use as little fonts as possible in a text. In particular, typographic wisdom dictates that you should not use more than two different families on one page. However, when typesetting mathematical text, it is often necessary and useful to use different font families. For example, it used to be common practice to use Gothic letters to denote vectors. Also, program texts are often typeset in monospace fonts. If your audience is used to a certain font family for a certain type of text, use that family, regardless of what typographic wisdom says.
+
+A common practice in typography is to use a sans-serif fonts for titles and serif fonts for normal text (check your favorite magazine). You can \emph{also} use two different sans-serif fonts or two different serif fonts, but you then have to make sure that the fonts look sufficiently different.'' If they look only slightly different, the page will look somehow strange,'' but the audience will not be able to tell why. For example, do not mix Arial and Helvetica (they are almost identical) or Computer Modern and Baskerville (they are quite similar). A combination of Gills Sans and Helvetica is dangerous but perhaps possible. A combination like Futura and Optima is certainly OK, at least with respect to the fonts being very different.
+
+\subsubsection{Font Shapes: Italics and Small Capitals}
+\label{section-italics}
+\label{section-smallcaps}
+
+\LaTeX\ introduces the concept of the \emph{shape} of a font. The only really important ones are italic and small caps. An \emph{italic} font is a font in which the text is slightly slanted to the right \emph{like this}. Things to know about italics:
+\begin{itemize}
+\item
+  Italics are commonly used in novels to express emphasis. However, especially with sans-serif fonts, italics are typically not strong enough'' and the emphasis gets lost in a presentation. Using a different color or bold text seems better suited for presentations to create emphasis.
+\item
+  If you look closely, you will notice that italic text is not only slanted but that different letters are actually used (compare a and \emph{a}, for example). However, this is only true for serif text, not for sans-serif text. Text that is only slanted without using different characters is called slanted'' instead of italic.'' Sometimes, the word oblique'' is also used for slanted, but it sometimes also used for italics, so it is perhaps best to avoid it. Using slanted serif text is very much frowned upon by typographers and is considered cheap computer typography.'' However, people who use slanted text in their books include Donald Knuth.
+
+  In a presentation, if you go to the trouble of using a serif font for some part of it, you should also use italics, not slanted text.
+\item
+  The different characters used for serif italics have changed much less from the original handwritten letters they are based on than normal serif text. For this reason, serif italics creates the impression of handwritten text, which may be desirable to give a presentation a more personal touch'' (although you can't get very personal using Times italics, which everyone has seen a thousand times). However, it is harder to read than normal text, so do not use it for text more than a line long.
+\end{itemize}
+
+The second font shape supported by \TeX\ are small capital letters. Using them can create a conservative, even formal impression, but some words of caution:
+\begin{itemize}
+\item
+  Small capitals are different from all-uppercase text. A small caps text leaves normal uppercase letters unchanged and uses smaller versions of the uppercase letters for normal typesetting lowercase letters. Thus the word German'' is typeset as \textsc{German} using small caps, but as \uppercase{German} using all uppercase letters.
+\item
+  Small caps either come as faked'' small caps or as real'' small caps. Faked small caps are created by just scaling down normal uppercase letters. This leads to letters the look too thin. Real small caps are specially designed smaller versions of the uppercase letters that have the same stroke width as normal text.
+\item
+  Computer Modern fonts and expert version of PostScript fonts come with real small caps (though the small caps of Computer Modern are one point size too large for some unfathomable reason---but your audience is going to pardon this since it will not be noticed anyway). Simple'' PostScript fonts like out-of-the-box Helvetica or Times only come with faked small caps.
+\item
+  Text typeset in small caps is harder to read than normal text. The reason is that we read by seeing the shape'' of words. For example, the word shape'' is mainly recognized by seeing one normal letter, one ascending letter, a normal letter, one descending letter, and a normal letter. One has much more trouble spotting a misspelling like shepe''  than spape''. Small caps destroy the shape of words since \textsc{shape}, \textsc{shepe} and \textsc{spape} all have the same shape, thus making it much harder to tell them apart. Your audience will read small caps more slowly than normal text. This is, by the way, why legal disclaimers are often written in uppercase letters: not to make them appear more important to you, but to make them much harder to actually read.
+\end{itemize}
+
+\subsubsection{Font Weight}
+
+The weight'' of a font refers to the thickness of the letters. Usually, fonts come as regular or as bold fonts. There often also exist semibold, ultrabold (or black), thin, or ultrathin (or hair) versions.
+
+In typography, using a bold font to create emphasis, especially within normal text, is frowned upon (bold words in the middle of a normal text are referred to as dirt''). For presentations this rule of not using bold text does not really apply. On a presentation slide there is usually very little text and there are numerous elements that try to attract the viewer's attention. Using the traditional italics to create emphasis will often be overlooked. So, using bold text, seems a good alternative in a presentation. However, an even better alternative is using a bright color like red to attract attention.
+
+As pointed out earlier, you should use bold text for small text unless you use an especially robust font like Futura or DejaVu.

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-guidelines.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-installation.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-installation.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,133 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2010,2013,2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\section{Installation}
+\label{section-installation}
+
+There are different ways of installing the \beamer\ class, depending on your installation and needs. When installing the class, you may have to install some other packages as well as described below. Before installing, you may wish to review the licenses under which the class is distributed, see Section~\ref{section-license}.
+
+Fortunately, most likely your system will already have \beamer\ preinstalled, so you can skip this section.
+
+
+\subsection{Versions and Dependencies}
+
+This documentation is part of version \beamerugversion\ of the \beamer\ class. \beamer\ needs a reasonably recent version of several standard packages to run and also the following versions of two special packages (later versions should work, but not necessarily):
+\begin{itemize}
+\item
+  |pgf.sty| version \beamerugpgfversion,
+\item
+  |xcolor.sty| version \beamerugxcolorversion.
+\end{itemize}
+
+If you use |pdflatex|, which is optional, you need
+\begin{itemize}
+\item
+  |pdflatex| version 0.14 or higher. Earlier versions do not work.
+\end{itemize}
+
+
+\subsection{Installation of Pre-bundled Packages}
+
+We do not create or manage pre-bundled packages of \beamer, but, fortunately, other nice people do. We cannot give detailed instructions on how to install these packages, since we do not manage them, but we \emph{can} tell you were to find them and we can tell you what these nice people told us on how to install them. If you have a problem with installing, you might wish to have a look at the following first.
+
+
+\subsubsection{\TeX\ Live and Mac\TeX}
+
+In \TeX\ Live, use the |tlmgr| tool to install the packages called |beamer|, |pgf|, and |xcolor|. If you have a fairly recent version of \TeX\ Live, and you have done full installation, \beamer\ is included.
+
+
+\subsubsection{MiK\TeX\ and pro\TeX t}
+
+For MiK\TeX\ and pro\TeX t, use the update wizard or package manager to install the (latest versions of the) packages called |beamer|, |pgf|, and |xcolor|.
+
+
+\subsubsection{Debian and Ubuntu}
+
+The command |aptitude install latex-beamer|'' should do the trick. If necessary, the packages |pgf| and |latex-xcolor| will be automatically installed. Sit back and relax. In detail, the following packages are installed:
+\begin{verbatim}
+http://packages.debian.org/latex-beamer
+http://packages.debian.org/pgf
+http://packages.debian.org/latex-xcolor
+\end{verbatim}
+
+Debian 5.0 lenny'' includes \TeX\ Live 2007, and version 6.0 squeeze'' will include \TeX\ Live 2009. This also allows you to manually install newer versions of \beamer\ (into your local directory, see below) without having to update any other \LaTeX\ packages.
+
+Ubuntu 8.04, 9.04 and 9.10 include \TeX\ Live 2007, and version 10.04 includes \TeX\ Live 2009.
+
+
+\subsubsection{Fedora}
+
+Fedora 9, 10, 11, 12 and 13 include \TeX\ Live 2007, which includes \beamer. It can be installed by running the command |yum install texlive-texmf-latex|''. As with Debian, this allows you to manually install newer versions of \beamer\ into your local directory (explained below).
+
+Jindrich Novy provides \TeX\ Live 2010 |rpm| packages for Fedora 12 and 13, at
+\begin{verbatim}
+http://fedoraproject.org/wiki/Features/TeXLive
+\end{verbatim}
+Fedora 14 will contain \TeX\ Live 2010 once it's released.
+
+
+\subsection{Installation in a texmf Tree}
+
+If, for whatever reason, you do not wish to use a prebundled package, the right'' way to install \beamer\ is to put it in a so-called |texmf| tree. In the following, we explain how to do this.
+
+Obtain the latest source version (ending |.tar.gz| or |.zip|) of the \beamer\ package from
+\begin{verbatim}
+https://github.com/josephwright/beamer
+\end{verbatim}
+(most likely, you have already done this). Next, you also need the \textsc{pgf} package and the \textsc{xcolor} packages, which you need to install separately (see their installation instructions).
+
+The package contains a bunch of files; |beamer.cls| is one of these files and happens to be the most important one. You now need to put these files in an appropriate |texmf| tree.
+
+When you ask \TeX\ to use a certain class or package, it usually looks for the necessary files in so-called |texmf| trees. These trees are simply huge directories that contain these files. By default, \TeX\ looks for files in three different |texmf| trees:
+\begin{itemize}
+\item
+  The root |texmf| tree, which is usually located at |/usr/share/texmf/|, |/usr/local/texlive/texmf/|, |c:\texmf\|, or\\ |c:\texlive\texmf\|.
+\item
+  The local  |texmf| tree, which is usually located at |/usr/local/share/texmf/|, |/usr/local/texlive/texmf-local/| |c:\localtexmf\|, or\\ |c:\texlive\texmf-local\|.
+\item
+  Your personal |texmf| tree, which is usually located in your home directory at |~/texmf/| or |~/Library/texmf/|.
+\end{itemize}
+
+You should install the packages either in the local tree or in your personal tree, depending on whether you have write access to the local tree. Installation in the root tree can cause problems, since an update of the whole \TeX\ installation will replace this whole tree.
+
+Inside whatever |texmf| directory you have chosen, create the sub-sub-sub-directory
+\begin{verbatim}
+texmf/tex/latex/beamer
+\end{verbatim}
+and place all files of the package in this directory.
+
+Finally, you need to rebuild \TeX's filename database. This is done by running the command |texhash| or |mktexlsr| (they are the same). In MiK\TeX\ package manager and \TeX\ Live |tlmgr|, there is a menu option to do this.
+
+\vskip1em
+For a more detailed explanation of the standard installation process of packages, you might wish to consult \href{http://www.ctan.org/installationadvice/}{|http://www.ctan.org/installationadvice/|}. However, note that the \beamer\ package does not come with a |.ins| file (simply skip that part).
+
+
+\subsection{Updating the Installation}
+
+To update your installation from a previous version, simply replace everything in the directory
+\begin{verbatim}
+texmf/tex/latex/beamer
+\end{verbatim}
+with the files of the new version. The easiest way to do this is to first delete the old version and then to proceed as described above.
+
+Note that if you have two versions installed, one in |texmf| and other in |texmf-local| directory, \TeX\ distribution will prefer one in |texmf-local| directory. This generally allows you to update packages manually without administrator privileges.
+
+
+\subsection{Testing the Installation}
+
+To test your installation, copy the file |generic-ornate-15min-45min.en.tex| from the directory
+\begin{verbatim}
+beamer/solutions/generic-talks
+\end{verbatim}
+to some place where you usually create presentations. Then run the command |pdflatex| several times on the file and check whether the resulting \pdf\ file looks correct. If so, you are all set.
+
+
+\input{beamerug-compatibility}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-installation.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-interaction.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-interaction.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,332 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2013,2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\section{Structuring a Presentation: The Interactive Global Structure}
+\label{section-nonlinear}
+
+
+To create anticipated nonlinear jumps in your talk structure, you can add hyperlinks to your presentation. A hyperlink is a text (usually rendered as a button) that, when you click on it, jumps the presentation to some other slide. Creating such a button is a three-step process:
+\begin{enumerate}
+\item
+  You specify a target using the command |\hypertarget| or (easier) the command |\label|. In some cases, see below, this step may be skipped.
+\item
+  You render the button using |\beamerbutton| or a similar command. This will \emph{render} the button, but clicking it will not yet have any effect.
+\item
+\end{enumerate}
+
+\begin{command}{\hypertarget\sarg{overlay specification}\marg{target name}\marg{text}}
+  If the \meta{overlay specification} is present, the \meta{text} is the target for hyper jumps to \meta{target name} only on the specified slide. On all other slides, the text is shown normally. Note that you \emph{must} add an overlay specification to the |\hypertarget| command whenever you use it on frames that have multiple slides (otherwise |pdflatex| rightfully complains that you have defined the same target on different slides).
+
+  \example
+\begin{verbatim}
+\begin{frame}
+  \begin{itemize}
+  \item<1-> First item.
+  \item<2-> Second item.
+  \item<3-> Third item.
+  \end{itemize}
+
+  \hypertarget<2>{jumptosecond}{}
+\end{frame}
+\end{verbatim}
+
+  \articlenote
+  You must say |\usepackage[hyperref]{beamerarticle}| or |\usepackage{hyperref}| in your preamble to use this command in |article| mode.
+\end{command}
+
+The |\label| command creates a hypertarget as a side-effect and the |label=|\meta{name} option of the |\frame| command creates a label named \meta{name}|<|\meta{slide number}|>| for each slide of the frame as a side-effect. Thus the above example could be written more easily as:
+\begin{verbatim}
+\begin{frame}[label=threeitems]
+  \begin{itemize}
+  \item<1-> First item.
+  \item<2-> Second item.
+  \item<3-> Third item.
+  \end{itemize}
+
+\end{frame}
+\end{verbatim}
+
+The following commands can be used to specify in an abstract way what a button will be used for.
+
+\begin{command}{\beamerbutton\marg{button text}}
+  Draws a button with the given \meta{button text}.
+
+  \example
+
+  \articlenote
+  This command (and the following) just insert their argument in |article| mode.
+
+  \begin{element}{button}\yes\yes\yes
+    When the |\beamerbutton| command is called, this template is used to render the button. Inside the template you can use the command |\insertbuttontext| to insert the argument that was passed to |\beamerbutton|.
+    \begin{templateoptions}
+      \itemoption{default}{}
+      Typesets the button with rounded corners. The fore- and background of the \beamer-color |button| are used and also the \beamer-font |button|. The border of the button gets the foreground of the \beamer-color |button border|.
+    \end{templateoptions}
+    The following inserts are useful for this element:
+    \begin{itemize}
+      \iteminsert{\insertbuttontext} inserts the text of the current button. Inside Goto-Buttons'' (see below) this text is prefixed by the insert |\insertgotosymbol| and similarly for skip and return buttons.
+
+      \iteminsert{\insertgotosymbol} This text is inserted at the beginning of goto buttons. Redefine this command to change the symbol.
+      \example
+      |\renewcommand{\insertgotosymbol}{\somearrowcommand}|
+
+      \iteminsert{\insertskipsymbol} This text is inserted at the beginning of skip buttons.
+
+      \iteminsert{\insertreturnsymbol} This text is inserted at the beginning of return buttons.
+    \end{itemize}
+  \end{element}
+
+  \begin{element}{button border}\no\yes\no
+    The foreground of this color is used to render the border of buttons.
+  \end{element}
+\end{command}
+
+\begin{command}{\beamergotobutton\marg{button text}}
+  Draws a button with the given \meta{button text}. Before the text, a small symbol (usually a right-pointing arrow) is inserted that indicates that pressing this button will jump to another area'' of the presentation.
+
+  \example
+\end{command}
+
+\begin{command}{\beamerskipbutton\marg{button text}}
+  The symbol drawn for this button is usually a double right arrow. Use this button if pressing it will skip over a well-defined part of your talk.
+
+  \example
+\begin{verbatim}
+\frame{
+  \begin{theorem}
+    ...
+  \end{theorem}
+
+  \begin{overprint}
+  \onslide<1>
+  \onslide<2>
+    \begin{proof}
+      ...
+    \end{proof}
+  \end{overprint}
+}
+\end{verbatim}
+\end{command}
+
+\begin{command}{\beamerreturnbutton\marg{button text}}
+  The symbol drawn for this button is usually a left-pointing arrow. Use this button if pressing it will return from a detour.
+
+  \example
+\begin{verbatim}
+\frame<1>[label=mytheorem]
+{
+  \begin{theorem}
+    ...
+  \end{theorem}
+
+  \begin{overprint}
+  \onslide<1>
+  \onslide<2>
+    \begin{proof}
+      ...
+    \end{proof}
+  \end{overprint}
+}
+\appendix
+\againframe<2>{mytheorem}
+\end{verbatim}
+\end{command}
+
+To make a button clickable'' you must place it in a command like |\hyperlink|. The command |\hyperlink| is a standard command of the |hyperref| package. The \beamer\ class defines a whole bunch of other hyperlink commands that you can also use.
+
+  Only one \meta{overlay specification} may be given. The \meta{link text} is typeset in the usual way. If you click anywhere on this text, you will jump to the slide on which the |\hypertarget| command was used with the parameter \meta{target name}. If an \meta{overlay specification} is present, the hyperlink (including the \meta{link text}) is completely suppressed on the non-specified slides.
+\end{command}
+
+The following commands have a predefined target; otherwise they behave exactly like |\hyperlink|. In particular, they all also accept an overlay specification and they also accept it at the end, rather than at the beginning.
+
+  Clicking the text jumps one slide back.
+\end{command}
+
+  Clicking the text jumps one slide forward.
+\end{command}
+
+  Clicking the text jumps to the first slide of the current frame.
+\end{command}
+
+  Clicking the text jumps to the last slide of the current frame.
+\end{command}
+
+  Clicking the text jumps to the first slide of the next frame.
+\end{command}
+
+  Clicking the text jumps to the last slide of the previous frame.
+\end{command}
+
+The previous four command exist also with |frame|'' replaced by |subsection|'' everywhere, and also again with  |frame|'' replaced by |section|''.
+
+  Clicking the text jumps to the first slide of the presentation.
+\end{command}
+
+  Clicking the text jumps to the last slide of the presentation. This \emph{excludes} the appendix.
+\end{command}
+
+  Clicking the text jumps to the first slide of the appendix. If there is no appendix, this will jump to the last slide of the document.
+\end{command}
+
+  Clicking the text jumps to the last slide of the appendix.
+\end{command}
+
+  Clicking the text jumps to the first slide of the presentation.
+\end{command}
+
+  Clicking the text jumps to the last slide of the presentation or, if an appendix is present, to the last slide of the appendix.
+\end{command}
+
+
+\subsection{Repeating a Frame at a Later Point}
+
+Sometimes you may wish some slides of a frame to be shown in your main talk, but wish some supplementary'' slides of the frame to be shown only in the appendix. In this case, the |\againframe| command is useful.
+
+\begin{command}{\againframe\sarg{overlay specification}\opt{|[<|\meta{default overlay specification}|>]|}\oarg{options}\marg{name}}
+  \beamernote
+  Resumes a frame that was previously created using |\frame| with the option |label=|\meta{name}. You must have used this option, just placing a label inside a frame by hand'' is not enough. You can use this command to continue'' a frame that has been interrupted by another frame. The effect of this command is to call the |\frame| command with the given \meta{overlay specification}, \meta{default overlay specification} (if present), and \meta{options} (if present) and with the original frame's contents.
+
+  \example
+\begin{verbatim}
+\frame<1-2>[label=myframe]
+{
+  \begin{itemize}
+  \item<alert at 1> First subject.
+  \item<alert at 2> Second subject.
+  \item<alert at 3> Third subject.
+  \end{itemize}
+}
+
+\frame
+{
+  Some stuff explaining more on the second matter.
+}
+
+\againframe<3>{myframe}
+\end{verbatim}
+
+  The effect of the above code is to create four slides. In the first two, the items 1 and~2 are highlighted. The third slide contains the text Some stuff explaining more on the second matter.'' The fourth slide is identical to the first two slides, except that the third point is now highlighted.
+
+  \example
+\begin{verbatim}
+\frame<1>[label=Cantor]
+{
+  \frametitle{Main Theorem}
+
+  \begin{Theorem}
+    $\alpha < 2^\alpha$ for all ordinals~$\alpha$.
+  \end{Theorem}
+
+  \begin{overprint}
+  \onslide<1>
+
+  \onslide<2->
+    % this is only shown in the appendix, where this frame is resumed.
+    \begin{proof}
+      As shown by Cantor, ...
+    \end{proof}
+
+  \end{overprint}
+}
+
+...
+\appendix
+
+\againframe<2>{Cantor}
+\end{verbatim}
+
+  In this example, the proof details are deferred to a slide in the appendix. Hyperlinks are setup, so that one can jump to the proof and go back.
+
+  \articlenote
+  This command is ignored in |article| mode.
+
+\end{command}
+
+
+\label{section-zooming}
+
+Anticipated zooming is necessary when you have a very complicated graphic that you are not willing to simplify since, indeed, all the complex details merit an explanation. In this case, use the command |\framezoom|. It allows you to specify that clicking on a certain area of a frame should zoom out this area. You can then explain the details. Clicking on the zoomed out picture will take you back to the original one.
+
+\begin{command}{\framezoom\ssarg{button overlay specification}\ssarg{zoomed overlay specification}\oarg{options}\\|(|\meta{upper left x}|,|\meta{upper left y}|)(|\meta{zoom area width}|,|\meta{zoom area depth}|)|}
+  This command should be given somewhere at the beginning of a frame. When given, two different things will happen, depending on whether the \meta{button overlay specification} applies to the current slide of the frame or whether the \meta{zoomed overlay specification} applies. These overlay specifications should not overlap.
+
+  If the \meta{button overlay specification} applies, a clickable area is created inside the frame. The size of this area is given by \meta{zoom area width} and \meta{zoom area depth}, which are two normal \TeX\ dimensions (like |1cm| or |20pt|). The upper left corner of this area is given by \meta{upper left x} and \meta{upper left y}, which are also \TeX\ dimensions. They are measures \emph{relative to the place where the first normal text of a frame would go}. Thus, the location |(0pt,0pt)| is at the beginning of the normal text (which excludes the headline and also the frame title).
+
+  By default, the button is clickable, but it will not be indicated in any special way. You can draw a border around the button by using the following \meta{option}:
+  \begin{itemize}
+  \item
+    \declare{|border|}\opt{|=|\meta{width in pixels}} will draw a border around the specified button area. The default width is 1 pixel. The color of this  button is the |linkbordercolor| of |hyperref|. \beamer\ sets this color to a 50\% gray by default. To change this, you can use the command |\hypersetup{linkbordercolor={|\meta{red}| |\meta{green}| |\meta{blue}|}}|, where \meta{red}, \meta{green}, and \meta{blue} are values between 0 and 1.
+  \end{itemize}
+
+  When you press the button created in this way, the viewer application will hyperjump to the first of the frames specified by the \meta{zoomed overlay specification}. For the slides to which this overlay specification applies, the following happens:
+
+  The exact same area as the one specified before is zoomed out'' to fill the whole normal text area of the frame. Everything else, including the sidebars, the headlines and footlines, and even the frame title retain their normal size. The zooming is performed in such a way that the whole specified area is completely shown. The aspect ratio is kept correct and the zoomed area will possibly show more than just the specified area if the aspect ratio of this area and the aspect ratio of the available text area do not agree.
+
+  Behind the whole text area (which contains the zoomed area) a big invisible Back'' button is put. Thus clicking anywhere on the text area will jump back to the original (unzoomed) picture.
+
+  You can specify several zoom areas for a single frame. In this case, you should specify different \meta{zoomed overlay specification}, but you can specify the same \meta{button overlay specification}. You cannot nest zoomings in the sense that you cannot have a zoom button on a slide that is in some \meta{zoomed overlay specification}. However, you can have overlapping and even nested \meta{button overlay specification}. When clicking on an area that belongs to several buttons, the one given last will win'' (it should hence be the smallest one).
+
+  If you do not wish to have the frame title shown on a zoomed slide, you can add an overlay specification to the |\frametitle| command that simply suppresses the title for the slide. Also, by using the |plain| option, you can have the zoomed slide fill the whole page.
+
+  \example
+  A simple case
+\begin{verbatim}
+\begin{frame}
+  \frametitle{A Complicated Picture}
+
+  \framezoom<1><2>(0cm,0cm)(2cm,1.5cm)
+  \framezoom<1><3>(1cm,3cm)(2cm,1.5cm)
+  \framezoom<1><4>(3cm,2cm)(3cm,2cm)
+
+  \pgfimage[height=8cm]{complicatedimagefilename}
+\end{frame}
+\end{verbatim}
+
+  \example
+  A more complicate case in which the zoomed parts completely fill the frames.
+\begin{verbatim}
+\begin{frame}<1>[label=zooms]
+  \frametitle<1>{A Complicated Picture}
+
+  \framezoom<1><2>[border](0cm,0cm)(2cm,1.5cm)
+  \framezoom<1><3>[border](1cm,3cm)(2cm,1.5cm)
+  \framezoom<1><4>[border](3cm,2cm)(3cm,2cm)
+
+  \pgfimage[height=8cm]{complicatedimagefilename}
+\end{frame}
+\againframe<2->[plain]{zooms}
+\end{verbatim}
+\end{command}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-interaction.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-introduction.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-introduction.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,168 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2012,2013,2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\section{Introduction}
+
+\beamer\ is a \LaTeX\ class for creating presentations that are held using a projector, but it can also be used to create transparency slides. Preparing presentations with \beamer\ is different from preparing them with \textsc{wysiwyg} programs like OpenOffice.org Impress, Apple Keynote, KOffice KPresenter or Microsoft PowerPoint. A \beamer\ presentation is created like any other \LaTeX\ document: It has a preamble and a body, the body contains |\section|s and |\subsection|s, the different slides (called \emph{frames} in \beamer) are put in environments, they are structured using |itemize| and |enumerate| environments, and so on. The obvious disadvantage of this approach is that you have to know \LaTeX\ in order to use \beamer. The advantage is that if you know \LaTeX, you can use your knowledge of \LaTeX\ also when creating a presentation, not only when writing papers.
+
+
+\subsection{Main Features}
+
+The list of features supported by \beamer\ is quite long (unfortunately, so is presumably the list of bugs supported by \beamer). The most important features, in our opinion, are:
+\begin{itemize}
+\item
+  You can use \beamer\ with |pdflatex|, |latex|+|dvips|, |lualatex| and |xelatex|. |latex|+|dvipdfm| isn't supported (but we accept patches!).
+\item
+  The standard commands of \LaTeX\ still work. A |\tableofcontents| will still create a table of contents, |\section| is still used to create structure, and |itemize| still creates a list.
+\item
+  You can easily create overlays and dynamic effects.
+\item
+  Themes allow you to change the appearance of your presentation to suit your purposes.
+\item
+  The themes are designed to be usable in practice, they are not just for show. You will not find such nonsense as a green body text on a picture of a green meadow.
+\item
+  The layout, the colors, and the fonts used in a presentation can easily be changed globally, but you still also have control over the most minute detail.
+\item
+  A special style file allows you to use the \LaTeX-source of a presentation directly in other \LaTeX\ classes like |article| or |book|. This makes it easy to create presentations out of lecture notes or lecture notes out of presentations.
+\item
+  The final output is typically a \textsc{pdf}-file. Viewer applications for this format exist for virtually every platform. When bringing your presentation to a conference on a memory stick, you do not have to worry about which version of the presentation program might be installed there. Also, your presentation is going to look exactly the way it looked on your computer.
+\end{itemize}
+
+
+\subsection{History}
+
+Till Tantau created \beamer\ mainly in his spare time. Many other people have helped by sending him emails containing suggestions for improvement or corrections or patches or whole new themes (by now, this amounts to over a thousand emails concerning \beamer). Indeed, most of the development was only initiated by feature requests and bug reports. Without this feedback, \beamer\ would still be what it was originally intended to be: a small private collection of macros that make using the |seminar| class easier. Till created the first version of \beamer\ for his PhD defense presentation in February 2003. A month later, he put the package on \textsc{ctan} at the request of some colleagues. After that, things somehow got out of hand.
+
+After being unmaintained since 2007, in April 2010 Till handed over the maintenance to Joseph Wright and Vedran Mileti\'c, who are still maintaining it: improving code, fixing bugs, adding new features and helping users.
+
+
+\subsection{Acknowledgments}
+
+Till Tantau: \emph{Where to begin? \beamer's development depends not only on me, but on the feedback I get from other people. Many features have been implemented because someone requested them and I thought that these features would be nice to have and reasonably easy to implement. Other people have given valuable feedback on themes, on the user's guide, on features of the class, on the internals of the implementation, on special \LaTeX\ features, and on life in general. A small selection of these people includes (in no particular order and I have surely forgotten to name lots of people who really, really deserve being in this list): Carsten (for everything), Birgit (for being the first person to use \beamer\ besides me), Tux (for his silent criticism), Rolf Niepraschk (for showing me how to program \LaTeX\ correctly), Claudio Beccari (for writing part of the documentation  on font encodings), Thomas Baumann (for the emacs stuff), Stefan M\"uller (for not loosing hope), Uwe Kern (for \textsc{xcolor}),
+Hendri Adriaens (for \textsc{ha-prosper}), Ohura Makoto (for spotting typos). People who have contributed to the themes include Paul Gomme, Manuel Carro, and Marlon R\'egis Schmitz.''}
+
+Joseph Wright: \emph{Thanks to Till Tantau for the huge development effort in creating \beamer. Sincere thanks to Vedran Mileti\'c for taking the lead in continuing development.''}
+
+Vedran Mileti\'c: \emph{First, I would like to thank Karl Berry and Sanda Buja\v ci\'c for encouragement, without which I wouldn't ever be anything but a \LaTeX\ user. I would also like to thank Ana Me\v strovi\'c, my colleague, who was excited by the prospect of using \beamer\ for preparing class material; Ivona Frankovi\'c and Marina Rajnovi\'c, my students at Department of Informatics, who were the first to hear about \LaTeX, \beamer\ and how it can help in preparing class material. I would like to thank Heiko Oberdiek (for \textsc{hyperref}), Johannes Braams (for \textsc{babel}) and Philipp Lehman (for \textsc{biblatex}). Above all, I owe a lot to Till Tantau for developing \beamer\ in the first place and to Joseph Wright for developing \textsc{siunitx} and for helping me develop \beamer\ further.''}
+
+
+\subsection{How to Read this User's Guide}
+
+You should start with the first part. If you have not yet installed the package, please read Section~\ref{section-installation} first. If you are new to \beamer, you should next read the tutorial in Section~\ref{section-tutorial}. When you sit down to create your first real presentation using \beamer, read Section~\ref{section-workflow} where the technical details of a possible workflow are discussed. If you are still new to creating presentations in general, you might find Section~\ref{section-guidelines} helpful, where many guidelines are given on what to do and what not to do. Finally, you should browse through Section~\ref{section-solutions}, where you will find ready-to-use solution templates for creating talks, possibly even in the language you intend to use.
+
+The second part of this user's guide goes into the details of all the commands defined in \beamer, but it also addresses  other technical issues having to do with creating presentations (like how to include graphics or animations).
+
+The third part explains how you can change the appearance of your presentation easily either using themes or by specifying colors or fonts for specific elements of a presentation (like, say, the font used for the numbers in an enumeration).
+
+The fourth part talks about handouts and lecture notes, so called support material''. You will frequently have create some kind of support material to give to your audience during the talk or after it, and this part will explain how to do it using the same source that you created your presentation from.
+
+The last part contains howtos,'' which are explanations of how to get certain things done using \beamer.
+
+\medskip
+\noindent
+This user's guide contains descriptions of all public'' commands, environments, and concepts defined by the \beamer-class. The following examples show how things are documented. As a general rule, red text is \emph{defined}, green text is \emph{optional}, blue text indicates special mode considerations.
+
+\begingroup
+\noindexing
+\begin{command}{\somebeamercommand\oarg{optional arguments}\marg{first argument}\marg{second argument}}
+  Here you will find the explanation of what the command |\somebeamercommand| does. The green argument(s) is optional. The command of this example takes two parameters.
+
+  \example
+  |\somebeamercommand[opt]{my arg}{xxx}|
+\end{command}
+
+\begin{environment}{{somebeamerenvironment}\oarg{optional arguments}\marg{first argument}}
+  Here you will find the explanation of the effect of the environment |somebeamerenvironment|. As with commands, the green arguments are optional.
+
+  \example
+\begin{verbatim}
+\begin{somebeamerenvironment}{Argument}
+  Some text.
+\end{somebeamerenvironment}
+\end{verbatim}
+\end{environment}
+
+\begin{element}{some beamer element}\yes\yes\yes
+  Here you will find an explanation of the template, color, and/or font |some beamer element|. A \beamer-element'' is a concept that is explained in more detail in Section~\ref{section-elements}. Roughly speaking, an \emph{element} is a part of a presentation that is potentially typeset in some special way. Examples of elements are frame titles, the author's name, or the footnote sign. For most elements there exists a \emph{template}, see Section~\ref{section-elements} once more, and also a \beamer-color and a \beamer-font.
+
+  For each element, it is indicated whether a template, a \beamer-color, and/or a \beamer-font of the name |some beamer element| exist. Typically, all three exist and are employed together when the element needs to be typeset, that is, when the template is inserted the \beamer-color and -font are installed first. However, sometimes templates do not have a color or font associated with them (like parent templates). Also, there exist \beamer-colors and -fonts that do not have an underlying template.
+
+  Using and changing templates is explained in Section~\ref{section-templates}. Here is the essence: To change a template, you can say
+\begin{verbatim}
+\setbeamertemplate{some beamer element}{your definition for this template}
+\end{verbatim}
+
+  Unfortunately, it is not quite trivial to come up with a good definition for some templates. Fortunately, there are often \emph{predefined options} for a template. These are indicated like this:
+  \begin{itemize}
+    \itemoption{square}{}
+    causes a small square to be used to render the template.
+    causes circles of the given radius to be used to render the template.
+  \end{itemize}
+
+  You can install such a predefined option like this:
+\begin{verbatim}
+\setbeamertemplate{some beamer element}[square]
+%% Now squares are used
+
+\setbeamertemplate{some beamer element}[circle]{3pt}
+%% Now a circle is used
+\end{verbatim}
+
+  \beamer-colors are explained in Section~\ref{section-colors}. Here is the essence: To change the foreground of the color to, say, red, use
+\begin{verbatim}
+\setbeamercolor{some beamer element}{fg=red}
+\end{verbatim}
+
+  To change the background to, say, black, use:
+\begin{verbatim}
+\setbeamercolor{some beamer element}{bg=black}
+\end{verbatim}
+
+  You can also change them together using |fg=red,bg=black|. The background will not always be honoured,'' since it is difficult to show a colored background correctly and an extra effort must be made by the templates (while the foreground color is usually used automatically).
+
+  \beamer-fonts are explained in Section~\ref{section-fonts}. Here is the essence: To change the size of the font to, say, large, use:
+\begin{verbatim}
+\setbeamerfont{some beamer element}{size=\large}
+\end{verbatim}
+
+  In addition to the size, you can use things like |series=\bfseries| to set the series, |shape=\itshape| to change the shape, |family=\sffamily| to change the family, and you can use them in conjunction. Add a star to the command to first reset'' the font.
+\end{element}
+
+\beamernote
+As next to this paragraph, you will sometimes find the word \textsc{presentation} in blue next to some paragraph. This means that the paragraph applies only when you normally typeset your presentation using \LaTeX\ or pdf\LaTeX.''
+
+\articlenote
+Opposed to this, a paragraph with \textsc{article} next to it describes some behavior that is special for the |article| mode. This special mode is used to create lecture notes out of a presentation (the two can coexist in one file).
+
+\endgroup
+
+
+\subsection{Getting Help}
+
+When you need help with \beamer, please do the following:
+\begin{enumerate}
+\item
+  Read the user guide, at least the part that has to do with your problem.
+\item
+  If that does not solve the problem, try searching \href{http://tex.stackexchange.com}{TeX-sx (\texttt{tex.stackexchange.com})}.
+  Perhaps someone has already reported a similar problem and someone has found a solution.
+\item
+  If you find no answers there, or if you are sure you have found a bug in
+  \beamer{}, please report it \emph{via} \href{https://github.com/josephwright/beamer/issues}{\texttt{github.com/josephwright/beamer/issues}}.
+\item
+  Before you file a bug report, especially a bug report concerning the installation, make sure that this is really a bug. In particular, have a look at the |.log| file that results when you \TeX\ your files. This |.log| file should show that all the right files are loaded from the right directories. Nearly all installation problems can be resolved by looking at the |.log| file.
+
+  If you can, before reporting the bug, retest using latest version of \beamer\ with latest version of \TeX\ Live. This can help isolate bugs from other packages that might affect \beamer.
+\item
+  \emph{As a last resort} you can try emailing authors. We do not mind getting emails, we simply get way too many of them. Because of this, we cannot guarantee that your emails will be answered timely or even at all. Reporting
+an issue is usually a better approach as they don't get lost.
+\end{enumerate}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-introduction.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-license.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,345 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+
+
+\begin{enumerate}
+\item
+  The \emph{code} of the package is dual-license. This means that you can decide which license you wish to use when using the \beamer\ package. The two options are:
+  \begin{enumerate}
+  \item
+    You can use the \textsc{gnu} General Public License, Version 2 or any later version published by the Free Software Foundation.
+  \item
+    You can use the \LaTeX\ Project Public License, version 1.3c or (at your option) any later version.
+  \end{enumerate}
+\item
+  The \emph{documentation} of the package is also dual-license. Again, you can choose between two options:
+  \begin{enumerate}
+  \item
+    You can use the \textsc{gnu} Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation.
+  \item
+    You can use the \LaTeX\ Project Public License, version 1.3c or (at your option) any later version.
+  \end{enumerate}
+\end{enumerate}
+
+The documentation of the package'' refers to all files in the subdirectory |doc| of the \beamer\ package. A detailed listing can be found in the file |doc/licenses/manifest-documentation.txt|. All files in other directories are part of the code of the package.'' A detailed listing can be found in the file |doc/licenses/manifest-code.txt|.
+
+In the rest of this section, the licenses are presented. The following text is copyrighted, see the plain text versions of these licenses in the directory |doc/licenses| for details.
+
+
+\subsection{The GNU General Public License, Version 2}
+
+\subsubsection{Preamble}
+
+The licenses for most software are designed to take away your freedom to share and change it. By contrast, the \textsc{gnu} General Public License is intended to guarantee your freedom to share and change free software---to make sure the software is free for all its users. This General Public License applies to most of the Free Software Foundation's software and to any other program whose authors commit to using it. (Some other Free Software Foundation software is covered by the \textsc{gnu} Library General Public License instead.) You can apply it to your programs, too.
+
+When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for this service if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs; and that you know you can do these things.
+
+To protect your rights, we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it.
+
+For example, if you distribute copies of such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights.
+
+We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software.
+
+Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations.
+
+Finally, any free program is threatened constantly by software patents. We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses, in effect making the program proprietary. To prevent this, we have made it clear that any patent must be licensed for everyone's free use or not licensed at all.
+
+The precise terms and conditions for copying, distribution and modification follow.
+
+\subsubsection{Terms and Conditions For Copying, Distribution and Modification}
+
+\begin{enumerate}
+\item
+  This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The Program'', below, refers to any such program or work, and a work based on the Program'' means either the Program or any derivative work under copyright law: that is to say, a work containing the Program or a portion of it, either verbatim or with modifications and/or translated into another language. (Hereinafter, translation is included without limitation in the term modification''.) Each licensee is addressed as you''.
+
+  Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running the Program is not restricted, and the output from the Program is covered only if its contents constitute a work based on the Program (independent of having been made by running the Program). Whether that is true depends on what the Program does.
+\item
+  You may copy and distribute verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of this License along with the Program.
+
+  You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee.
+\item
+  You may modify your copy or copies of the Program or any portion of it, thus forming a work based on the Program, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions:
+  \begin{enumerate}
+  \item
+    You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change.
+  \item
+    You must cause any work that you distribute or publish, that in whole or in part contains or is derived from the Program or any part thereof, to be licensed as a whole at no charge to all third parties under the terms of this License.
+  \item
+    If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the most ordinary way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this License. (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.)
+  \end{enumerate}
+
+  These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Program, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it.
+
+  Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Program.
+
+  In addition, mere aggregation of another work not based on the Program with the Program (or with a work based on the Program) on a volume of a storage or distribution medium does not bring the other work under the scope of this License.
+\item
+  You may copy and distribute the Program (or a work based on it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following:
+  \begin{enumerate}
+  \item
+    Accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or,
+  \item
+    Accompany it with a written offer, valid for at least three years, to give any third party, for a charge no more than your cost of physically performing source distribution, a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange; or,
+  \item
+    Accompany it with the information you received as to the offer to distribute corresponding source code. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer, in accord with Subsubsection b above.)
+  \end{enumerate}
+
+  The source code for a work means the preferred form of the work for making modifications to it. For an executable work, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the executable. However, as a special exception, the source code distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable.
+
+  If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code.
+\item
+  You may not copy, modify, sublicense, or distribute the Program except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense or distribute the Program is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance.
+\item
+  You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Program or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Program (or any work based on the Program), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Program or works based on it.
+\item
+  Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties to this License.
+\item
+  If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Program at all. For example, if a patent license would not permit royalty-free redistribution of the Program by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program.
+
+  If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances.
+
+  It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice.
+
+  This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License.
+\item
+  If the distribution and/or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License.
+\item
+  The Free Software Foundation may publish revised and/or new versions of the General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the Program specifies a version number of this License which applies to it and any later version'', you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of this License, you may choose any version ever published by the Free Software Foundation.
+\item
+  If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally.
+\end{enumerate}
+
+\subsubsection{No Warranty}
+
+\begin{enumerate}
+\item
+  Because the program is licensed free of charge, there is no warranty for the program, to the extent permitted by applicable law. Except when otherwise stated in writing the copyright holders and/or other parties provide the program as is'' without warranty of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The entire risk as to the quality and performance of the program is with you. Should the program prove defective, you assume the cost of all necessary servicing, repair or correction.
+\item
+  In no event unless required by applicable law or agreed to in writing will any copyright holder, or any other party who may modify and/or redistribute the program as permitted above, be liable to you for damages, including any general, special, incidental or consequential damages arising out of the use or inability to use the program (including but not limited to loss of data or data being rendered inaccurate or losses sustained by you or third parties or a failure of the program to operate with any other programs), even if such holder or other party has been advised of the possibility of such damages.
+\end{enumerate}
+
+
+\subsection{The GNU Free Documentation License, Version 1.3, 3 November 2008}
+\label{label_fdl}
+
+
+  \begin{quote}
+    \textbf{Copyright \copyright 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc.}
+
+    \url{http://fsf.org/}
+
+    Everyone is allowed to distribute verbatim copies of this license document, but modification of it is not allowed.
+  \end{quote}
+
+\subsubsection{Preamble}
+
+The purpose of this License is to make a manual, textbook, or other functional and useful document free'' in the sense of freedom: to assure everyone the effective freedom to copy and redistribute it, with or without modifying it, either commercially or noncommercially. Secondarily, this License preserves for the author and publisher a way to get credit for their work, while not being considered responsible for modifications made by others.
+
+This License is a kind of copyleft'', which means that derivative works of the document must themselves be free in the same sense. It complements the GNU General Public License, which is a copyleft license designed for free software.
+
+We have designed this License in order to use it for manuals for free software, because free software needs free documentation: a free program should come with manuals providing the same freedoms that the software does. But this License is not limited to software manuals; it can be used for any textual work, regardless of subject matter or whether it is published as a printed book. We recommend this License principally for works whose purpose is instruction or reference.
+
+\subsubsection{Applicability and definitions}
+
+This License applies to any manual or other work, in any medium, that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License. Such a notice grants a world-wide, royalty-free license, unlimited in duration, to use that work under the conditions stated herein. The \textbf{Document''}, below, refers to any such manual or work. Any member of the public is a licensee, and is addressed as \textbf{you''}. You accept the license if you copy, modify or distribute the work in a way requiring permission under copyright law.
+
+A \textbf{Modified Version''} of the Document means any work containing the Document or a portion of it, either copied verbatim, or with modifications and/or translated into another language.
+
+A \textbf{Secondary Section''} is a named appendix or a front-matter section of the Document that deals exclusively with the relationship of the publishers or authors of the Document to the Document's overall subject (or to related matters) and contains nothing that could fall directly within that overall subject. (Thus, if the Document is in part a textbook of mathematics, a Secondary Section may not explain any mathematics.)  The relationship could be a matter of historical connection with the subject or with related matters, or of legal, commercial, philosophical, ethical or political position regarding them.
+
+The \textbf{Invariant Sections''} are certain Secondary Sections whose titles are designated, as being those of Invariant Sections, in the notice that says that the Document is released under this License. If a section does not fit the above definition of Secondary then it is not allowed to be designated as Invariant. The Document may contain zero Invariant Sections. If the Document does not identify any Invariant Sections then there are none.
+
+The \textbf{Cover Texts''} are certain short passages of text that are listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says that the Document is released under this License. A Front-Cover Text may be at most 5 words, and a Back-Cover Text may be at most 25 words.
+
+A \textbf{Transparent''} copy of the Document means a machine-readable copy, represented in a format whose specification is available to the general public, that is suitable for revising the document straightforwardly with generic text editors or (for images composed of pixels) generic paint programs or (for drawings) some widely available drawing editor, and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters. A copy made in an otherwise Transparent file format whose markup, or absence of markup, has been arranged to thwart or discourage subsequent modification by readers is not Transparent. An image format is not Transparent if used for any substantial amount of text. A copy that is not Transparent'' is called \textbf{Opaque''}.
+
+Examples of suitable formats for Transparent copies include plain ASCII without markup, Texinfo input format, LaTeX input format, SGML or XML using a publicly available DTD, and standard-conforming simple HTML, PostScript or PDF designed for human modification. Examples of transparent image formats include PNG, XCF and JPG. Opaque formats include proprietary formats that can be read and edited only by proprietary word processors, SGML or XML for which the DTD and/or processing tools are not generally available, and the machine-generated HTML, PostScript or PDF produced by some word processors for output purposes only.
+
+The \textbf{Title Page''} means, for a printed book, the title page itself, plus such following pages as are needed to hold, legibly, the material this License requires to appear in the title page. For works in formats which do not have any title page as such, Title Page'' means the text near the most prominent appearance of the work's title, preceding the beginning of the body of the text.
+
+The \textbf{publisher''} means any person or entity that distributes copies of the Document to the public.
+
+A section \textbf{Entitled XYZ''} means a named subunit of the Document whose title either is precisely XYZ or contains XYZ in parentheses following text that translates XYZ in another language. (Here XYZ stands for a specific section name mentioned below, such as \textbf{Acknowledgements''}, \textbf{Dedications''}, \textbf{Endorsements''}, or \textbf{History''}.) To \textbf{Preserve the Title''} of such a section when you modify the Document means that it remains a section Entitled XYZ'' according to this definition.
+
+The Document may include Warranty Disclaimers next to the notice which states that this License applies to the Document. These Warranty Disclaimers are considered to be included by reference in this License, but only as regards disclaiming warranties: any other implication that these Warranty Disclaimers may have is void and has no effect on the meaning of this License.
+
+\subsubsection{Verbatim Copying}
+
+You may copy and distribute the Document in any medium, either commercially or noncommercially, provided that this License, the copyright notices, and the license notice saying this License applies to the Document are reproduced in all copies, and that you add no other conditions whatsoever to those of this License. You may not use technical measures to obstruct or control the reading or further copying of the copies you make or distribute. However, you may accept compensation in exchange for copies. If you distribute a large enough number of copies you must also follow the conditions in section 3.
+
+You may also lend copies, under the same conditions stated above, and you may publicly display copies.
+
+\subsubsection{Copying in Quantity}
+
+If you publish printed copies (or copies in media that commonly have printed covers) of the Document, numbering more than 100, and the Document's license notice requires Cover Texts, you must enclose the copies in covers that carry, clearly and legibly, all these Cover Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the back cover. Both covers must also clearly and legibly identify you as the publisher of these copies. The front cover must present the full title with all words of the title equally prominent and visible. You may add other material on the covers in addition. Copying with changes limited to the covers, as long as they preserve the title of the Document and satisfy these conditions, can be treated as verbatim copying in other respects.
+
+If the required texts for either cover are too voluminous to fit legibly, you should put the first ones listed (as many as fit reasonably) on the actual cover, and continue the rest onto adjacent pages.
+
+If you publish or distribute Opaque copies of the Document numbering more than 100, you must either include a machine-readable Transparent copy along with each Opaque copy, or state in or with each Opaque copy a computer-network location from which the general network-using public has access to download using public-standard network protocols a complete Transparent copy of the Document, free of added material. If you use the latter option, you must take reasonably prudent steps, when you begin distribution of Opaque copies in quantity, to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy (directly or through your agents or retailers) of that edition to the public.
+
+It is requested, but not required, that you contact the authors of the Document well before redistributing any large number of copies, to give them a chance to provide you with an updated version of the Document.
+
+\subsubsection{Modifications}
+
+You may copy and distribute a Modified Version of the Document under the conditions of sections 2 and 3 above, provided that you release the Modified Version under precisely this License, with the Modified Version filling the role of the Document, thus licensing distribution and modification of the Modified Version to whoever possesses a copy of it. In addition, you must do these things in the Modified Version:
+
+\begin{itemize}
+\item[A.]
+  Use in the Title Page (and on the covers, if any) a title distinct from that of the Document, and from those of previous versions (which should, if there were any, be listed in the History section of the Document). You may use the same title as a previous version if the original publisher of that version gives permission.
+
+\item[B.]
+  List on the Title Page, as authors, one or more persons or entities responsible for authorship of the modifications in the Modified Version, together with at least five of the principal authors of the Document (all of its principal authors, if it has fewer than five), unless they release you from this requirement.
+
+\item[C.]
+  State on the Title page the name of the publisher of the Modified Version, as the publisher.
+
+\item[D.]
+  Preserve all the copyright notices of the Document.
+
+\item[E.]
+
+\item[F.]
+  Include, immediately after the copyright notices, a license notice giving the public permission to use the Modified Version under the terms of this License, in the form shown in the Addendum below.
+
+\item[G.]
+  Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given in the Document's license notice.
+
+\item[H.]
+  Include an unaltered copy of this License.
+
+\item[I.]
+  Preserve the section Entitled History'', Preserve its Title, and add to it an item stating at least the title, year, new authors, and publisher of the Modified Version as given on the Title Page. If there is no section Entitled History'' in the Document, create one stating the title, year, authors, and publisher of the Document as given on its Title Page, then add an item describing the Modified Version as stated in the previous sentence.
+
+\item[J.]
+  Preserve the network location, if any, given in the Document for public access to a Transparent copy of the Document, and likewise the network locations given in the Document for previous versions it was based on. These may be placed in the History'' section. You may omit a network location for a work that was published at least four years before the Document itself, or if the original publisher of the version it refers to gives permission.
+
+\item[K.]
+  For any section Entitled Acknowledgements'' or Dedications'', Preserve the Title of the section, and preserve in the section all the substance and tone of each of the contributor acknowledgements and/or dedications given therein.
+
+\item[L.]
+  Preserve all the Invariant Sections of the Document, unaltered in their text and in their titles. Section numbers or the equivalent are not considered part of the section titles.
+
+\item[M.]
+  Delete any section Entitled Endorsements''. Such a section may not be included in the Modified Version.
+
+\item[N.]
+  Do not retitle any existing section to be Entitled Endorsements'' or to conflict in title with any Invariant Section.
+
+\item[O.]
+  Preserve any Warranty Disclaimers.
+\end{itemize}
+
+If the Modified Version includes new front-matter sections or appendices that qualify as Secondary Sections and contain no material copied from the Document, you may at your option designate some or all of these sections as invariant. To do this, add their titles to the list of Invariant Sections in the Modified Version's license notice. These titles must be distinct from any other section titles.
+
+You may add a section Entitled Endorsements'', provided it contains nothing but endorsements of your Modified Version by various parties--for example, statements of peer review or that the text has been approved by an organization as the authoritative definition of a standard.
+
+You may add a passage of up to five words as a Front-Cover Text, and a passage of up to 25 words as a Back-Cover Text, to the end of the list of Cover Texts in the Modified Version. Only one passage of Front-Cover Text and one of Back-Cover Text may be added by (or through arrangements made by) any one entity. If the Document already includes a cover text for the same cover, previously added by you or by arrangement made by the same entity you are acting on behalf of, you may not add another; but you may replace the old one, on explicit permission from the previous publisher that added the old one.
+
+The author(s) and publisher(s) of the Document do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any Modified Version.
+
+\subsubsection{Combining Documents}
+
+You may combine the Document with other documents released under this License, under the terms defined in section 4 above for modified versions, provided that you include in the combination all of the Invariant Sections of all of the original documents, unmodified, and list them all as Invariant Sections of your combined work in its license notice, and that you preserve all their Warranty Disclaimers.
+
+The combined work need only contain one copy of this License, and multiple identical Invariant Sections may be replaced with a single copy. If there are multiple Invariant Sections with the same name but different contents, make the title of each such section unique by adding at the end of it, in parentheses, the name of the original author or publisher of that section if known, or else a unique number. Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work.
+
+In the combination, you must combine any sections Entitled History'' in the various original documents, forming one section Entitled History''; likewise combine any sections Entitled Acknowledgements'', and any sections Entitled Dedications''. You must delete all sections Entitled Endorsements''.
+
+\subsubsection{Collection of Documents}
+
+You may make a collection consisting of the Document and other documents released under this License, and replace the individual copies of this License in the various documents with a single copy that is included in the collection, provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects.
+
+You may extract a single document from such a collection, and distribute it individually under this License, provided you insert a copy of this License into the extracted document, and follow this License in all other respects regarding verbatim copying of that document.
+
+\subsubsection{Aggregating with Independent Works}
+
+A compilation of the Document or its derivatives with other separate and independent documents or works, in or on a volume of a storage or distribution medium, is called an aggregate'' if the copyright resulting from the compilation is not used to limit the legal rights of the compilation's users beyond what the individual works permit. When the Document is included in an aggregate, this License does not apply to the other works in the aggregate which are not themselves derivative works of the Document.
+
+If the Cover Text requirement of section 3 is applicable to these copies of the Document, then if the Document is less than one half of the entire aggregate, the Document's Cover Texts may be placed on covers that bracket the Document within the aggregate, or the electronic equivalent of covers if the Document is in electronic form. Otherwise they must appear on printed covers that bracket the whole aggregate.
+
+\subsubsection{Translation}
+
+Translation is considered a kind of modification, so you may distribute translations of the Document under the terms of section 4. Replacing Invariant Sections with translations requires special permission from their copyright holders, but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections. You may include a translation of this License, and all the license notices in the Document, and any Warranty Disclaimers, provided that you also include the original English version of this License and the original versions of those notices and disclaimers. In case of a disagreement between the translation and the original version of this License or a notice or disclaimer, the original version will prevail.
+
+If a section in the Document is Entitled Acknowledgements'', Dedications'', or History'', the requirement (section 4) to Preserve its Title (section 1) will typically require changing the actual title.
+
+\subsubsection{Termination}
+
+You may not copy, modify, sublicense, or distribute the Document except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense, or distribute it is void, and will automatically terminate your rights under this License.
+
+However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally
+terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation.
+
+Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice.
+
+Termination of your rights under this section does not terminate the licenses of parties who have received copise or rights from you under this License. If your rights have been terminated and not permanently reinstated, receipt of a copy of some or all of the same material does not give you any rights to use it.
+
+
+The Free Software Foundation may publish new, revised versions of the GNU Free Documentation License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. See http://www.gnu.org/copyleft/.
+
+Each version of the License is given a distinguishing version number. If the Document specifies that a particular numbered version of this License or any later version'' applies to it, you have the option of following the terms and conditions either of that specified version or of any later version that has been published (not as a draft) by the Free Software Foundation. If the Document does not specify a version number of this License, you may choose any version ever published (not as a draft) by the Free Software Foundation. If the Document specifies that a proxy can decide which future versions of this
+License can be used, that proxy’s public statement of acceptance of a version permanently authorizes you to choose that version for the Document.
+
+\subsubsection{Relicensing}
+
+Massive Multiauthor Collaboration Site'' (or MMC Site'') means any World Wide Web server that publishes copyrightable works and also provides prominent facilities for anybody to edit those works. A public wiki that anybody can edit is an example of such a server. A Massive Multiauthor Collaboration'' (or MMC'') contained in the site means any set of copyrightable works thus published on the MMC site.
+
+CC-BY-SA'' means the Creative Commons Attribution-Share Alike 3.0 license published by Creative Commons Corporation, a not-for-profit corporation with a principal place of business in San Francisco, California, as well as future copyleft versions of that license published by that same organization.
+
+Incorporate'' means to publish or republish a Document, in whole or in part, as part of another Document.
+
+An MMC is eligible for relicensing'' if it is licensed under this License, and if all works that were first published under this License somewhere other than this MMC, and subsequently incorporated in whole or in part into the MMC, (1) had no cover texts or invariant sections, and (2) were thus incorporated prior to November 1, 2008.
+
+The operator of an MMC Site may republish an MMC contained in the site under CC-BY-SA on the same site at any time before August 1, 2009, provided the MMC is eligible for relicensing.
+
+
+To use this License in a document you have written, include a copy of the License in the document and put the following copyright and license notices just after the title page:
+
+\bigskip
+\begin{quote}
+
+  Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled GNU Free Documentation License''.
+\end{quote}
+\bigskip
+
+If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, replace the with \dots\ Texts.'' line with this:
+
+\bigskip
+\begin{quote}
+  with the Invariant Sections being \textsc{list their titles}, with the Front-Cover Texts being \textsc{list}, and with the Back-Cover Texts being \textsc{list}.
+\end{quote}
+\bigskip
+
+If you have Invariant Sections without Cover Texts, or some other combination of the three, merge those two alternatives to suit the situation.
+
+If your document contains nontrivial examples of program code, we recommend releasing these examples in parallel under your choice of free software license, such as the GNU General Public License, to permit their use in free software.
+
+
+\providecommand{\LPPLsection}{\subsection}
+\providecommand{\LPPLsubsection}{\subsubsection}
+\providecommand{\LPPLsubsubsection}{\subsubsection}
+\providecommand{\LPPLparagraph}{\paragraph}
+
+
+\input{lppl}

___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-localstructure.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-localstructure.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,1154 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2012--2015 by Vedran Mileti\'c, Joseph Wright
+% Copyright 2016 by Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\section{Structuring a Presentation: The Local Structure}
+
+\LaTeX\ provides different commands for structuring text locally,'' for example, via the |itemize| environment. These environments are also available in the \beamer\ class, although their appearance has been slightly changed. Furthermore, the \beamer\ class also defines some new commands and environments, see below, that may help you to structure your text.
+
+
+\subsection{Itemizations, Enumerations, and Descriptions}
+\label{section-enumerate}
+
+There are three predefined environments for creating lists, namely |enumerate|, |itemize|, and |description|. The first two can be nested to depth three, but nesting them to this depth creates totally unreadable slides.
+
+The |\item| command is overlay specification-aware. If an overlay specification is provided, the item will only be shown on the specified slides, see the following example. If the |\item| command is to take an optional argument and an overlay specification, the overlay specification can either come first as in |\item<1>[Cat]| or come last as in |\item[Cat]<1>|.
+\begin{verbatim}
+\begin{frame}
+  There are three important points:
+  \begin{enumerate}
+  \item<1-> A first one,
+  \item<2-> a second one with a bunch of subpoints,
+    \begin{itemize}
+    \item first subpoint. (Only shown from second slide on!).
+    \item<3-> second subpoint added on third slide.
+    \item<4-> third subpoint added on fourth slide.
+    \end{itemize}
+  \item<5-> and a third one.
+  \end{enumerate}
+\end{frame}
+\end{verbatim}
+
+\begin{environment}{{itemize}\opt{|[<|\meta{default overlay specification}|>]|}}
+  Used to display a list of items that do not have a special ordering. Inside the environment, use an |\item| command for each topic.
+
+  If the optional parameter \meta{default overlay specification} is given, in every occurrence of an |\item| command that does not have an overlay specification attached to it, the \meta{default overlay specification} is used. By setting this specification to be an incremental overlay specification, see Section~\ref{section-incremental}, you can implement, for example, a step-wise uncovering of the items. The \meta{default overlay specification} is inherited by subenvironments. Naturally, in a subenvironment you can reset it locally by setting it to |<1->|.
+  \example
+\begin{verbatim}
+\begin{itemize}
+\item This is important.
+\item This is also important.
+\end{itemize}
+\end{verbatim}
+
+  \example
+\begin{verbatim}
+\begin{itemize}[<+->]
+\item This is shown from the first slide on.
+\item This is shown from the second slide on.
+\item This is shown from the third slide on.
+\item<1-> This is shown from the first slide on.
+\item This is shown from the fourth slide on.
+\end{itemize}
+\end{verbatim}
+
+  \example
+\begin{verbatim}
+\item This is shown from the first slide on and alerted on the first slide.
+\item This is shown from the second slide on and alerted on the second slide.
+\item This is shown from the third slide on and alerted on the third slide.
+\end{itemize}
+\end{verbatim}
+
+  \example
+\begin{verbatim}
+\end{verbatim}
+
+  The appearance of an |itemize| list is governed by several templates. The first template concerns the way the little marker introducing each item is typeset:
+  \begin{element}{itemize items}\semiyes\no\no
+    This template is a parent template, whose children are |itemize item|, |itemize subitem|, and |itemize subsubitem|. This means that if you use the |\setbeamertemplate| command on this template, the command is instead called for all of these children (with the same arguments).
+
+    \begin{templateoptions}
+      \itemoption{default}{}
+      The default item marker is a small triangle colored with the foreground of the \beamer-color |itemize item| (or, for subitems, |itemize subitem| etc.). Note that these colors will automatically change under certain circumstances such as inside an example block or inside an |alertenv| environment.
+      \itemoption{triangle}{}
+      Alias for the default.
+      \itemoption{circle}{}
+      Uses little circles (or dots) as item markers.
+      \itemoption{square}{}
+      Uses little squares as item markers.
+      \itemoption{ball}{}
+      Uses little balls as item markers.
+    \end{templateoptions}
+  \end{element}
+
+  \begin{element}{itemize item}\yes\yes\yes
+    \colorfontparents{item}
+    This template (with |item| instead of |items|) governs how the marker in front of a first-level item is typeset. First-level'' refers to the level of nesting. See the |itemize items| template for the \meta{options} that may be given.
+
+    When the template is inserted, the \beamer-font and -color |itemize item| is installed. Typically, the font is ignored by the template as some special symbol is drawn anyway, by the font may be important if an optional argument is given to the |\item| command as in |\item[First]|.
+
+    The font and color inherit from the |item| font and color, which are explained at the end of this section.
+  \end{element}
+
+  \begin{element}{itemize subitem}\yes\yes\yes
+    \colorfontparents{subitem}
+    Like |itemize item|, only for second-level items. An item of an itemize inside an enumerate counts as a second-level item.
+  \end{element}
+
+  \begin{element}{itemize subsubitem}\yes\yes\yes
+    \colorfontparents{subsubitem}
+    Like |itemize item|, only for third-level items.
+  \end{element}
+\end{environment}
+
+\begin{environment}{{enumerate}\opt{|[<|\meta{default overlay specification}|>]|}\oarg{mini template}}
+  Used to display a list of items that are ordered. Inside the environment, use an |\item| command for each topic. By default, before each item increasing Arabic numbers followed by a dot are printed (as in 1.'' and 2.''). This can be changed by specifying a different template, see below.
+
+  The first optional argument \meta{default overlay specification} has exactly the same effect as for the |itemize| environment. It is detected'' by the opening |<|-sign in the \meta{default overlay specification}. Thus, if there is only one optional argument and if this argument does not start with |<|, then it is considered to be a \meta{mini template}.
+
+  The syntax of the \meta{mini template} is the same as the syntax of mini templates in the |enumerate| package (you do not need to include the |enumerate| package, this is done automatically). Roughly spoken, the text of the \meta{mini template} is printed before each item, but any occurrence of a |1| in the mini template is replaced by the current item number, an occurrence of the letter |A| is replaced by the $i$-th letter of the alphabet (in uppercase) for the $i$-th item, and the letters |a|, |i|, and |I| are replaced by the corresponding lowercase letters, lowercase Roman letters, and uppercase Roman letters, respectively. So the mini template |(i)| would yield the items (i), (ii), (iii), (iv), and so on. The mini template |A.)| would yield the items A.), B.), C.), D.) and so on. For more details on the possible mini templates, see the documentation of the |enumerate| package. Note that there is also a template that governs the appearance of the mini template.
+
+  \example
+\begin{verbatim}
+\begin{enumerate}
+\item This is important.
+\item This is also important.
+\end{enumerate}
+
+\begin{enumerate}[(i)]
+\item First Roman point.
+\item Second Roman point.
+\end{enumerate}
+
+\begin{enumerate}[<+->][(i)]
+\item First Roman point.
+\item Second Roman point, uncovered on second slide.
+\end{enumerate}
+\end{verbatim}
+
+  \articlenote
+  To use the \meta{mini template}, you have to include the package |enumerate|.
+
+  \begin{element}{enumerate items}\semiyes\no\no
+    Similar to |itemize items|, this template is a parent template, whose children are |enumerate item|, |enumerate subitem|, |enumerate subsubitem|, and |enumerate mini template|. These templates govern how the text (the number) of an enumeration is typeset.
+
+    \begin{templateoptions}
+      \itemoption{default}{}
+      The default enumeration marker uses the scheme 1., 2., 3.\ for the first level, 1.1, 1.2, 1.3 for the second level and 1.1.1, 1.1.2, 1.1.3 for the third level.
+      \itemoption{circle}{}
+      Places the numbers inside little circles. The colors are taken from |item projected| or |subitem projected| or |subsubitem projected|.
+      \itemoption{square}{}
+      Places the numbers on little squares.
+      \itemoption{ball}{}
+      Projects'' the numbers onto little balls.
+    \end{templateoptions}
+  \end{element}
+
+  \begin{element}{enumerate item}\yes\yes\yes
+    This template governs how the number in front of a first-level item is typeset. The level here refers to the level of enumeration nesting only. Thus an enumerate inside an itemize is a first-level enumerate (but it uses the second-level |itemize/enumerate body|).
+
+    When the template is inserted, the \beamer-font and -color |enumerate item| are installed.
+
+    The following command is useful for this template:
+    \begin{templateinserts}
+      \iteminsert{\insertenumlabel}
+      inserts the current number of the top-level enumeration (as an Arabic number). This insert is also available in the next two templates.
+    \end{templateinserts}
+  \end{element}
+
+  \begin{element}{enumerate subitem}\yes\yes\yes
+    Like |enumerate item|, only for second-level items.
+
+    \begin{templateinserts}
+      \iteminsert{\insertsubenumlabel}
+      inserts the current number of the second-level enumeration (as an Arabic number).
+    \end{templateinserts}
+
+    \example
+\begin{verbatim}
+\setbeamertemplate{enumerate subitem}{\insertenumlabel-\insertsubenumlabel}
+\end{verbatim}
+  \end{element}
+
+  \begin{element}{enumerate subsubitem}\yes\yes\yes
+    Like |enumerate item|, only for third-level items.
+
+    \begin{templateinserts}
+      \iteminsert{\insertsubsubenumlabel}
+      inserts the current number of the second-level enumeration (as an Arabic number).
+    \end{templateinserts}
+  \end{element}
+
+  \begin{element}{enumerate mini template}\yes\yes\yes
+    This template is used to typeset the number that arises from a mini template.
+
+    \begin{templateinserts}
+      \iteminsert{\insertenumlabel}
+      inserts the current number rendered by this mini template. For example, if the \meta{mini template} is |(i)| and this command is used in the fourth item, |\insertenumlabel| would yield |(iv)|.
+    \end{templateinserts}
+  \end{element}
+\end{environment}
+
+The following templates govern how the \emph{body} of an |itemize| or an |enumerate| is typeset.
+\begin{element}{itemize/enumerate body begin}\yes\no\no
+  This template is inserted at the beginning of a first-level |itemize| or |enumerate| environment. Furthermore, before this template is inserted, the \beamer-font and -color |itemize/enumerate body| is used.
+\end{element}
+\begin{element}{itemize/enumerate body end}\yes\no\no
+  This template is inserted at the end of a first-level |itemize| or |enumerate| environment.
+\end{element}
+There exist corresponding templates like |itemize/enumerate subbody begin| for second- and third-level itemize or enumerates.
+
+\begin{element}{items}\semiyes\no\no
+  This template is a parent template of |itemize items| and |enumerate items|.
+  \example
+  |\setbeamertemplate{items}[circle]| will cause all items in |itemize| or |enumerate| environments to become circles (of the appropriate size, color, and font).
+\end{element}
+
+\label{section-descriptions}
+
+\begin{environment}{{description}\opt{|[<|\meta{default overlay specification}|>]|}\oarg{long text}}
+  Like |itemize|, but used to display a list that explains or defines labels. The width of \meta{long text} is used to set the indentation. Normally, you choose the widest label in the description and copy it here. If you do not give this argument, the default width is used, which can be changed using |\setbeamersize| with the argument |description width=|\meta{width}.
+
+  As for |enumerate|, the \meta{default overlay specification} is detected by an opening~|<|. The effect is the same as for |enumerate| and |itemize|.
+  \example
+\begin{verbatim}
+\begin{description}
+\item[Lion] King of the savanna.
+\item[Tiger] King of the jungle.
+\end{description}
+
+\begin{description}[longest label]
+\item<1->[short] Some text.
+\item<2->[longest label] Some text.
+\item<3->[long label] Some text.
+\end{description}
+\end{verbatim}
+
+  \example
+  The following has the same effect as the previous example:
+\begin{verbatim}
+\begin{description}[<+->][longest label]
+\item[short] Some text.
+\item[longest label] Some text.
+\item[long label] Some text.
+\end{description}
+\end{verbatim}
+
+  \begin{element}{description item}\yes\yes\yes
+    This template is used to typeset the description items. When this template is called, the \beamer-font and -color |description item| are installed.
+
+    \begin{templateoptions}
+      \itemoption{default}{}
+      By default, the description item text is just inserted without any modification.
+    \end{templateoptions}
+
+    The main insert that is useful inside this template is:
+    \begin{templateinserts}
+      \iteminsert{\insertdescriptionitem} inserts the text of the current description item.
+    \end{templateinserts}
+  \end{element}
+
+  \begin{element}{description body begin}\yes\no\no
+    This template is inserted at the beginning of a |description| environment. Furthermore, before this template is inserted, the \beamer-font and -color |description body| is used.
+  \end{element}
+
+  \begin{element}{description body end}\yes\no\no
+    This template is inserted at the end of a |description| environment.
+  \end{element}
+\end{environment}
+
+In order to simplify changing the color or font of items, the different kinds of items inherit from or just use the following general'' \beamer-color and fonts:
+
+\begin{element}{item}\no\yes\yes
+  \colorparents{local structure}
+  \fontparents{structure}
+
+  This color/font serves as a parent for the individual items of |itemize| and |enumerate| environments, but also for items in the table of contents. Since its color parent is the |local structure|, a change of that color causes the color of items to change accordingly.
+\end{element}
+
+\begin{element}{item projected}\no\yes\yes
+  \colorfontparents{item}
+
+  This is a special version'' of the |item| color and font that should be used by templates that render items with text (as in an enumeration) and which project'' this text onto something like a ball or a square or whatever. While the normal |item| color typically has a transparent background, the |item projected| typically has a colored background and, say, a white foreground.
+\end{element}
+
+\begin{element}{subitem}\no\yes\yes
+  \colorfontparents{item}
+  Same as |item| for subitems, that is, for items on the second level of indentation.
+\end{element}
+
+\begin{element}{subitem projected}\no\yes\yes
+  \colorfontparents{item projected}
+  Same as |item projected| for subitems, that is, for items on the second level of indentation.
+\end{element}
+
+\begin{element}{subsubitem}\no\yes\yes
+  \colorfontparents{subitem}
+  Same as |subitem| for subsubitems, that is, for items on the third level of indentation.
+\end{element}
+
+\begin{element}{subsubitem projected}\no\yes\yes
+  \colorfontparents{subitem projected}
+  Same as |subitem projected| for subsubitems, that is, for items on the third level of indentation.
+\end{element}
+
+
+\subsection{Highlighting}
+
+The \beamer\ class predefines commands and environments for highlighting text. Using these commands makes it easy to change the appearance of a document by changing the theme.
+
+\begin{command}{\structure\sarg{overlay specification}\marg{text}}
+  The given text is marked as part of the structure, that is, it is supposed to help the audience see the structure of your presentation. If the \meta{overlay specification} is present, the command only has an effect on the specified slides.
+  \example
+
+  Internally, this command just puts the \emph{text} inside a |structureenv| environment.
+
+  \articlenote
+  Structure text is typeset as bold text. This can be changed by modifying the templates.
+
+  \begin{element}{structure}\no\yes\yes
+    This color/font is used when structured text is typeset, but it is also widely used as a base for many other colors including the headings of blocks, item buttons, and titles. In most color themes, the colors for navigational elements in the headline or the footline are derived from the foreground color of |structure|. By changing the structure color you can easily change the basic color'' of your presentation, other than the color of normal text. See also the related color |local structure| and the related font |tiny structure|.
+
+    Inside the |\structure| command, the background of the color is ignored, but this is not necessarily true for elements that inherit their color from |structure|. There is no template |structure|, use |structure begin| and |structure end| instead.
+  \end{element}
+
+  \begin{element}{local structure}\no\yes\no
+    This color should be used to typeset structural elements that change their color according to the local environment.'' For example, an item button'' in an |itemize| environment changes its color according to circumstances. If it is used inside an example block, it should have the |example text| color; if it is currently alerted'' it should have the |alerted text| color. This color is setup by certain environments to have the color that should be used to typset things like item buttons. Since the color used for items, |item|, inherits from this color by default, items automatically change their color according to the current situation.
+
+    If you write your own environment in which the item buttons and similar structural elements should have a different color, you should change the color |local structure| inside these environments.
+  \end{element}
+
+  \begin{element}{tiny structure}\no\no\yes
+    This special font is used for tiny'' structural text. Basically, this font should be used whenever a structural element uses a tiny font. The idea is that the tiny versions of the |structure| font often are not suitable. For example, it is often necessary to use a boldface version for them. Also, one might wish to have serif smallcaps structural text, but still retain normal sans-serif tiny structural text.
+  \end{element}
+\end{command}
+
+\begin{environment}{{structureenv}\sarg{overlay specification}}
+  Environment version of the |\structure| command.
+
+  \begin{element}{structure begin}\yes\no\no
+    This text is inserted at the beginning of a |structureenv| environment.
+
+    \begin{templateoptions}
+      \itemoption{default}{}
+
+      \articlenote
+      The text is typeset in boldface.
+    \end{templateoptions}
+  \end{element}
+
+  \begin{element}{structure end}\yes\no\no
+    This text is inserted at the end of a |structureenv| environment.
+  \end{element}
+\end{environment}
+
+
+  The given text is highlighted, typically by coloring the text red. If the \meta{overlay specification} is present, the command only has an effect on the specified slides.
+  \example
+
+  Internally, this command just puts the \emph{highlighted text} inside an |alertenv|.
+
+  \articlenote
+  Alerted text is typeset as emphasized text. This can be changed by modifying the templates, see below.
+
+    This color/font is used when alerted text is typeset. The background is currently ignored. There is no template |alerted text|, rather there are templates |alerted text begin| and |alerted text end| that are inserted before and after alerted text.
+  \end{element}
+\end{command}
+
+  Environment version of the |\alert| command.
+
+    This text is inserted at the beginning of a an |alertenv| environment.
+
+    \begin{templateoptions}
+      \itemoption{default}{}
+
+      \beamernote
+      This changes the color |local structure| to |alerted text|. This causes things like buttons or items to be colored in the same color as the alerted text, which is often visually pleasing. See also the |\structure| command.
+
+      \articlenote
+      The text is emphasized.
+    \end{templateoptions}
+  \end{element}
+
+    This text is inserted at the end of an |alertenv| environment.
+  \end{element}
+\end{environment}
+
+
+\subsection{Block Environments}
+\label{predefined}
+
+The \beamer\ class predefines an environment for typesetting a block'' of text that has a heading. The appearance of blocks can easily be changed using the following template:
+
+\begin{element}{blocks}\semiyes\no\no
+  Changing this parent template changes the templates of normal blocks, alerted blocks, and example blocks.
+
+  \example
+  |\setbeamertemplate{blocks}[default]|
+  \example
+
+  \begin{templateoptions}
+    \itemoption{default}{}
+    The default setting typesets the block title on its own line. If a background is specified either for the |block title| or for the |block body|, this background color is used as background of the title or body, respectively. For alerted and example blocks, the corresponding \beamer-colors and -fonts are used, instead.
+    Makes the blocks rounded.'' This means that the corners of the backgrounds of the blocks are rounded off.'' If the |shadow=true| option is given, a shadow'' is drawn behind the block.
+  \end{templateoptions}
+\end{element}
+
+
+\begin{environment}{{block}\sarg{action specification}\marg{block title}\sarg{action specification}}
+  Only one \meta{action specification} may be given. Inserts a block, like a definition or a theorem, with the title \meta{block title}. If the \meta{action specification} is present, the given actions are taken on the specified slides, see Section~\ref{section-action-specifications}. In the example, the definition is shown only from slide 3 onward.
+  \example
+\begin{verbatim}
+  \begin{block}<3->{Definition}
+    A \alert{set} consists of elements.
+  \end{block}
+\end{verbatim}
+
+  \articlenote
+  The block name is typeset in bold.
+
+  \begin{element}{block begin}\yes\no\no
+    This template is inserted at the beginning of a block before the \meta{environment contents}. Inside this template, the block title can be accessed via the following insert:
+    \begin{itemize}
+      \iteminsert{\insertblocktitle}
+      Inserts the \meta{block title} into the template.
+    \end{itemize}
+
+    When the template starts, no special color or font is installed (for somewhat complicated reasons). Thus, this template should install the correct colors and fonts for the title and the body itself.
+  \end{element}
+
+  \begin{element}{block end}\yes\no\no
+    This template is inserted at the end of a block.
+  \end{element}
+
+  \begin{element}{block title}\no\yes\yes
+    This \beamer-color/-font should be used to typeset the title of the block. Since neither the color nor the font are setup automatically, the template |block begin| must do so itself.
+
+    The default block template and also the |rounded| version honor the background of this color.
+  \end{element}
+
+  \begin{element}{block body}\no\yes\yes
+    This \beamer-color/-font should be used to typeset the body of the block, that is, the \meta{environment contents}. As for |block title|, the color and font must be setup by the template |block begin|.
+  \end{element}
+\end{environment}
+
+title}\sarg{action specification}}
+  Inserts a block whose title is highlighting. Behaves like the |block| environment otherwise.
+  \example
+\begin{verbatim}
+    $1=2$.
+\end{verbatim}
+
+  \articlenote
+  The block name is typeset in bold and is emphasized.
+
+    Same applies as for normal blocks.
+  \end{element}
+
+    Same applies as for normal blocks.
+  \end{element}
+
+    Same applies as for normal blocks.
+  \end{element}
+
+    Same applies as for normal blocks.
+  \end{element}
+\end{environment}
+
+\begin{environment}{{exampleblock}\sarg{action specification}\marg{block title}\sarg{overlay specification}}
+  Inserts a block that is supposed to be an example. Behaves like the |block| environment otherwise.
+
+  \example
+  In the following example, the block is completely suppressed on the first slide (it does not even occupy any space).
+\begin{verbatim}
+  \begin{exampleblock}{Example}<only at 2->
+    The set $\{1,2,3,5\}$ has four elements.
+  \end{exampleblock}
+\end{verbatim}
+
+  \articlenote
+  The block name is typeset in italics.
+
+  \begin{element}{block example begin}\yes\no\no
+    Same applies as for normal blocks.
+  \end{element}
+
+  \begin{element}{block example end}\yes\no\no
+    Same applies as for normal blocks.
+  \end{element}
+
+  \begin{element}{block title example}\no\yes\yes
+    Same applies as for normal blocks.
+  \end{element}
+
+  \begin{element}{block body example}\no\yes\yes
+    Same applies as for normal blocks.
+  \end{element}
+\end{environment}
+
+
+\subsection{Theorem Environments}
+\label{section-theorems}
+
+The \beamer\ class predefines several environments, like |theorem| or |definition| or |proof|, that you can use to typeset things like, well, theorems, definitions, or proofs. The complete list is the following:  |theorem|, |corollary|, |definition|, |definitions|, |fact|, |example|, and |examples|. The following German block environments are also predefined: |Problem|, |Loesung|, |Definition|, |Satz|, |Beweis|, |Folgerung|, |Lemma|, |Fakt|, |Beispiel|, and |Beispiele|.
+
+Here is a typical example on how to use them:
+\begin{verbatim}
+\begin{frame}
+  \frametitle{A Theorem on Infinite Sets}
+
+  \begin{theorem}<1->
+    There exists an infinite set.
+  \end{theorem}
+
+  \begin{proof}<2->
+    This follows from the axiom of infinity.
+  \end{proof}
+
+  \begin{example}<3->[Natural Numbers]
+    The set of natural numbers is infinite.
+  \end{example}
+\end{frame}
+\end{verbatim}
+
+In the following, only the English versions are discussed. The German ones behave analogously.
+
+  Inserts a theorem. Only one \meta{action specification} may be given. If present, the \meta{additional text} is shown behind the word Theorem'' in rounded brackets (although this can be changed by the template).
+
+  The appearance of the theorem is governed by the templates |theorem begin| and |theorem end|, see their description later on for details on how to change these. Every theorem is put into a |block| environment, thus the templates for blocks also apply.
+
+  The theorem style (a concept from |amsthm|) used for this environment is |plain|. In this style, the body of a theorem should be typeset in italics. The head of the theorem should be typeset in a bold font, but this is usually overruled by the templates.
+
+  If the option |envcountsect| is given either as class option in one of the |presentation| modes or as an option to the package |beamerarticle| in |article| mode, then the numbering of the theorems is local to each section with the section number prefixing the theorem number; otherwise they are numbered consecutively throughout the presentation or article. We recommend using this option in |article| mode.
+
+  By default, no theorem numbers are shown in the |presentation| modes.
+
+  \example
+\begin{verbatim}
+\begin{theorem}[Kummer, 1992]
+  If $\#^_A^n$ is $n$-enumerable, then $A$ is recursive.
+\end{theorem}
+
+\begin{theorem}<2->[Tantau, 2002]
+  If $\#_A^2$ is $2$-fa-enumerable, then $A$ is regular.
+\end{theorem}
+\end{verbatim}
+
+\end{environment}
+
+The environments \declare{|corollary|}, \declare{|fact|}, and \declare{|lemma|} behave exactly the same way.
+
+\begin{classoption}{envcountsect}
+  Causes theorems, definitions, and so on to be numbered locally to each section. Thus, the first theorem of the second section would be Theorem~2.1 (assuming that there are no definitions, lemmas, or corollaries earlier in the section).
+\end{classoption}
+
+  Behaves like the |theorem| environment, except that the theorem style |definition| is used. In this style, the body of a theorem is typeset in an upright font.
+\end{environment}
+
+The environment \declare{|definitions|} behaves exactly the same way.
+
+  Behaves like the |theorem| environment, except that the theorem style |example| is used. A side-effect of using this theorem style is that the \meta{environment contents} is put in an |exampleblock| instead of a |block|.
+\end{environment}
+
+The environment \declare{|examples|} behaves exactly the same way.
+
+\beamernote
+The default template for typesetting theorems suppresses the theorem number, even if this number is available'' for typesetting (which it is by default in all predefined environments; but if you define your own environment using |\newtheorem*| no number will be available).
+
+\articlenote
+In |article| mode, theorems are automatically numbered. By specifying the class option |envcountsect|, theorems will be numbered locally to each section, which is usually a good idea, except for very short articles.
+
+\begin{environment}{{proof}\sarg{action specification}\oarg{proof name}\sarg{action specification}}
+  Typesets a proof. If the optional \meta{proof name} is given, it completely replaces the word Proof.'' This is different from normal theorems, where the optional argument is shown in brackets.
+
+  At the end of the theorem, a |\qed| symbol is shown, except if you say |\qedhere| earlier in the proof (this is exactly as in |amsthm|). The default |\qed| symbol is an open circle. To completely suppress the symbol, write |\def\qedsymbol{}| in your preamble. To get a closed square, say
+\begin{verbatim}
+\setbeamertemplate{qed symbol}{\vrule width1.5ex height1.5ex depth0pt}
+\end{verbatim}
+
+  If you use |babel| and a different language, the text Proof'' is replaced by whatever is appropriate in the selected language.
+
+  \example
+\begin{verbatim}
+\begin{proof}<2->[Sketch of proof]
+  Suppose ...
+\end{proof}
+\end{verbatim}
+
+  \begin{element}{qed symbol}\yes\yes\yes
+    The symbol is shown at the end of every proof.
+  \end{element}
+\end{environment}
+
+You can define new environments using the following command:
+
+\begin{command}{\newtheorem\opt{|*|}\marg{environment name}\oarg{numbered same as}\marg{head text}\oarg{number within}}
+  This command is used exactly the same way as in the |amsthm| package (as a matter of fact, it is the command from that package), see its documentation. The only difference is that environments declared using this command are overlay specification-aware in \beamer\ and that, when typeset, are typeset according to \beamer's templates.
+
+  \articlenote
+  Environments declared using this command are also overlay specification-aware in |article| mode.
+
+  \example
+  |\newtheorem{observation}[theorem]{Observation}|
+\end{command}
+
+You can also use |amsthm|'s command |\newtheoremstyle| to define new theorem styles. Note that the default template for theorems will ignore any head font setting, but will honor the body font setting.
+
+If you wish to define the environments like |theorem| differently (for example, have it numbered within each subsection), you can use the following class option to disable the definition of the predefined environments:
+
+\begin{classoption}{notheorems}
+  Switches off the definition of default blocks like |theorem|, but still loads |amsthm| and makes theorems overlay specification-aware.
+\end{classoption}
+
+The option is also available as a package option for |beamerarticle| and has the same effect.
+
+\articlenote
+In the |article| version, the package |amsthm| sometimes clashes with the document class. In this case you can use the following option, which is once more available as a class option for \beamer\ and as a package option for |beamerarticle|, to switch off the loading of |amsthm| altogether.
+
+\begin{classoption}{noamsthm}
+  Does not load |amsthm| and also not |amsmath|. Environments like |theorem| or |proof| will not be available.
+\end{classoption}
+
+\begin{classoption}{noamssymb}
+  Does not load |amssymb|. This option is mainly intended for users who are loading specialist font packages. Note that |\blacktriangleright| needs to be defined if |itemize| environments are in use.
+\end{classoption}
+
+
+\begin{element}{theorems}\semiyes\no\no
+  This template is a parent of |theorem begin| and |theorem end|, see the first for a detailed discussion of how the theorem templates are set.
+
+  \example
+  |\setbeamertemplate{theorems}[numbered]|
+
+  \begin{templateoptions}
+    \itemoption{default}{}
+    By default, theorems are typeset as follows: The font specification for the body is honored, the font specification for the head is ignored. No theorem number is printed.
+    \itemoption{normal font}{}
+    Like the default, except all font specifications for the body are ignored. Thus, the fonts are used that are normally used for blocks.
+    \itemoption{numbered}{}
+    This option is like the default, except that the theorem number is printed for environments that are numbered.
+    \itemoption{ams style}{}
+    This causes theorems to be put in a |block| or |exampleblock|, but to be otherwise typeset as is normally done in |amsthm|. Thus the head font and body font depend on the setting for the theorem to be typeset and theorems are numbered.
+  \end{templateoptions}
+\end{element}
+
+
+\begin{element}{theorem begin}\yes\no\no
+  Whenever an environment declared using the command |\newtheorem| is to be typeset, this template is inserted at the beginning and the template |theorem end| at the end. If there is an overlay specification when an environment like |theorem| is used, this overlay specification will directly follow the \meta{block beginning template} upon invocation. This is even true if there was an optional argument to the |theorem| environment. This optional argument is available via the insert |\inserttheoremaddition|.
+
+  Numerous inserts are available in this template, see below.
+
+  Before the template starts, the font is set to the body font prescribed by the environment to be typeset.
+
+  \example
+  The following typesets theorems like |amsthm|:
+\begin{verbatim}
+\setbeamertemplate{theorem begin}
+{%
+  \begin{\inserttheoremblockenv}
+  {%
+    \inserttheoremname
+    \inserttheoremnumber
+    \inserttheorempunctuation
+  }%
+}
+\setbeamertemplate{theorem end}{\end{\inserttheoremblockenv}}
+\end{verbatim}
+
+  \example
+  In the following example, all font suggestions'' for the environment are suppressed or ignored; and the theorem number is suppressed.
+\begin{verbatim}
+\setbeamertemplate{theorem begin}
+{%
+  \normalfont% ignore body font
+  \begin{\inserttheoremblockenv}
+  {%
+    \inserttheoremname
+  }%
+}
+\setbeamertemplate{theorem end}{\end{\inserttheoremblockenv}}
+\end{verbatim}
+
+  The following inserts are available inside this template:
+  \begin{itemize}
+    \iteminsert{\inserttheoremblockenv}
+    This will normally expand to |block|, but if a theorem that has theorem style |example| is typeset, it will expand to |exampleblock|. Thus you can use this insert to decide which environment should be used when typesetting the theorem.
+
+    This will expand to a font changing command that switches to the font to be used in the head of the theorem. By not inserting it, you can ignore the head font.
+
+    \iteminsert{\inserttheoremname}
+    This will expand to the name of the environment to be typeset (like Theorem'' or Corollary'').
+
+    \iteminsert{\inserttheoremnumber}
+    This will expand to the number of the current theorem preceeded by a space or to nothing, if the current theorem does not have a number.
+
+    This will expand to the optional argument given to the environment or will be empty, if there was no optional argument.
+
+    \iteminsert{\inserttheorempunctuation}
+    This will expand to the punctuation character for the current environment. This is usually a period.
+  \end{itemize}
+\end{element}
+
+\begin{element}{theorem end}\yes\no\no
+  Inserted at the end of a theorem.
+\end{element}
+
+
+\subsection{Framed and Boxed Text}
+
+In order to draw a frame (a rectangle) around some text, you can use \LaTeX s standard command |\fbox| and also |\frame| (inside a \beamer\ frame, the |\frame| command changes its meaning to the normal \LaTeX\ |\frame| command). More frame types are offered by the package |fancybox|, which defines the following commands: |\shadowbox|, |\doublebox|, |\ovalbox|, and |\Ovalbox|. Please consult the \LaTeX\ Companion for details on how to use these commands.
+
+The \beamer\ class also defines two environments for creating colored boxes.
+
+\begin{environment}{{beamercolorbox}\oarg{options}\marg{beamer color}}
+  This environment can be used to conveniently typeset some text using some \beamer-color. Basically, the following two command blocks do the same:
+\begin{verbatim}
+\begin{beamercolorbox}{beamer color}
+  Text
+\end{beamercolorbox}
+
+{
+  \usebeamercolor{beamer color}
+  \colorbox{bg}{
+    \color{fg}
+    Text
+  }
+}
+\end{verbatim}
+
+  In other words, the environment installs the \meta{beamer color} and uses the background for the background of the box and the foreground for the text inside the box. However, in reality, numerous \meta{options} can be given to specify in much greater detail how the box is rendered.
+
+  If the background color of \meta{beamer color} is empty, no background is drawn behind the text, that is, the background is transparent.''
+
+  This command is used extensively by the default inner and outer themes for typesetting the headlines and footlines. It is not really intended to be used in normal frames (for example, it is not available inside |article| mode). You should prefer using structuring elements like blocks or theorems that automatically insert colored boxes as needed.
+
+  \example
+  The following example could be used to typeset a headline with two lines, the first showing the document title, the second showing the author's name:
+\begin{verbatim}
+  \insertshorttitle
+\end{beamercolorbox}%
+  \insertshortauthor
+\end{beamercolorbox}
+\end{verbatim}
+
+  \example
+  Typesetting a postit:
+\begin{verbatim}
+\setbeamercolor{postit}{fg=black,bg=yellow}
+\begin{beamercolorbox}[sep=1em,wd=5cm]{postit}
+  Place me somewhere!
+\end{beamercolorbox}
+\end{verbatim}
+
+  The following \meta{options} can be given:
+  \begin{itemize}
+  \item
+    \declare{|wd=|\marg{width}} sets the width of the box. This command has two effects: First, \TeX's |\hsize| is set to \meta{width}. Second, after the box has been typeset, its width is set to \meta{width} (no matter what it actually turned out to be). Since setting the |\hsize| does not automatically change some of \LaTeX's linewidth dimensions, you should consider using a minipage inside this environment if you fool around with the width.
+
+    If the width is larger than the normal text width, as specified by the value of |\textwidth|, the width of the resulting box is reset to the width |\textwidth|, but intelligent negative skips are inserted at the left and right end of the box. The net effect of this is that you can use a width larger than the text width for a box and can insert the resulting box directly into normal text without getting annoying warnings and having the box positioned sensibly.
+  \item
+    \declare{|dp=|\marg{depth}} sets the depth of the box, overriding the real depth of the box. The box is first typeset normally, then the depth is changed afterwards. This option is useful for creating boxes that have guaranteed size.
+
+    If the option is not given, the box has its natural'' depth, which results from the typesetting. For example, a box containing only the letter a'' will have a different depth from a box containing only the letter g.''
+  \item
+    \declare{|ht=|\meta{height}} sets the height of the box, overriding the real height. Note that the height'' does not include the depth (see, for example, the \TeX-book for details). If you want a one-line box that always has the same size, setting the height to 2.25ex and the depth to 1ex is usually a good option.
+  \item
+    \declare{|left|} causes the text inside the box to be typeset left-aligned and with a (radically) ragged right border. This is the default. To get a better ragged right border, use the |rightskip| option. Note that this will override any |leftskip| or |rightskip| setting.
+  \item
+    \declare{|right|} causes the text to be right-aligned with a (radically) ragged left border. Note that this will override any |leftskip| or |rightskip| setting.
+  \item
+    \declare{|center|} centers the text inside the box. Note that this will override any |leftskip| or |rightskip| setting.
+  \item
+    \declare{|leftskip=|\meta{left skip}} installs the \meta{left skip} inside the box as the left skip. \TeX's left skip is a glue that is inserted at the left end of every line. See the \TeX-book for details. Note that this will override any |left|, |center| or |right| setting.
+  \item
+    \declare{|rightskip=|\meta{right skip}} install the \meta{right skip}. To get a good ragged right border, try, say, |\rightskip=0pt plus 4em|. Note that this will override any |left|, |center| or |right| setting.
+  \item
+    \declare{|sep=|\meta{dimension}} sets the size of extra space around the text. This space is added inside the box,'' which means that if you specify a |sep| of 1cm and insert the box normally into the vertical list, then the left border of the box will be aligned with the left border of the slide text, while the left border of the text inside the box will be 1cm to the right of this left border. Likewise, the text inside the box will stop 1cm before the right border of the normal text.
+  \item
+    \declare{|colsep=|\meta{dimension}} sets the extra color separation space'' around the text. This space behaves the same way as the space added by |sep|, only this space is only inserted if the box has a colored background, that is, if the background of the \meta{beamer color} is not empty. This command can be used together with |sep|, the effects accumulate.
+  \item
+    \declare{|colsep*=|\meta{dimension}} sets an extra color separation space around the text that is \emph{horizontally outside the box}. This means that if the box has a background, this background will protrude by \meta{dimension} to the left and right of the text, but this protruding background will not be taken into consideration by \TeX\ for typesetting purposes.
+
+    A typical example usage of this option arises when you insert a box with a colored background in the middle of normal text. In this case, if the background color is set, you would like a background to be drawn behind the text \emph{and} you would like a certain extra space around this text (the background should not stop immediately at the borders of the text, this looks silly) \emph{and} you would like the normal text always to be at the same horizontal position, independently of whether a background is present or not. In this case, using |colsep*=4pt| is a good option.
+  \item
+    \declare{|shadow|}\opt{|=|\meta{true or false}} draws a shadow behind the box. Currently, this option only has an effect if used together with the |rounded| option, but that may change.
+  \item
+    \declare{|rounded|}\opt{|=|\meta{true or false}} causes the borders of the box to be rounded off if there is a background installed. This command internally calls |beamerboxesrounded|. In this case, |colsep*| option will have no effect.
+  \item
+    \declare{|ignorebg|} causes the background color of the \meta{beamer color} to be ignored, that is, to be treated as if it were set to transparent'' or empty.''
+  \item
+    \declare{|vmode|} causes \TeX\ to be in vertical mode when the box starts. Normally, \TeX\ will be in horizontal mode at the start of the box (a |\leavevmode| is inserted automatically at the beginning of the box unless this option is given). Only \TeX perts need this option, so, if you use it, you will probably know what you are doing anyway.
+  \end{itemize}
+\end{environment}
+
+  The text inside the environment is framed by a rectangular area with rounded corners. For the large rectangular area, the \beamer-color specified with the |lower| option  is used. Its background is used for the background, its foreground for the foreground. If the \meta{head} is not empty, \meta{head} is drawn in the upper part of the box using the \beamer-color specified with the |upper| option for the fore- and background. The following options can be given:
+  \begin{itemize}
+  \item
+    \declare{|lower=|\meta{beamer color}} sets the \beamer-color to be used for the lower (main) part of the box. Its background is used for the background, its foreground for the foreground of the main part of the box. If either is empty, the current background or foreground is used. The box will never be transparent.
+  \item
+    \declare{|upper=|\meta{beamer color}} sets the \beamer-color used for the upper (head) part of the box. It is only used if the \meta{head} is not empty.
+  \item
+    \declare{|width=|\meta{dimension}} causes the width of the text inside the box to be the specified \meta{dimension}. By default, the |\textwidth| is used. Note that the box will protrude 4pt to the left and right.
+  \item
+    \declare{|shadow=|\meta{true or false}}. If set to |true|, a shadow will be drawn.
+  \end{itemize}
+  If no \meta{head} is given, the head part is completely suppressed.
+  \example
+\begin{verbatim}
+  $A = B$.
+\end{beamerboxesrounded}
+\end{verbatim}
+
+  \articlenote
+  This environment is not available in |article| mode.
+\end{environment}
+
+
+\subsection{Figures and Tables}
+
+You can use the standard \LaTeX\ environments |figure| and |table| much the same way you would normally use them. However, any placement specification will be ignored. Figures and tables are immediately inserted where the environments start. If there are too many of them to fit on the frame, you must manually split them among additional frames or use the |allowframebreaks| option.
+
+\example
+\begin{verbatim}
+\begin{frame}
+  \begin{figure}
+    \pgfuseimage{myfigure}
+    \caption{This caption is placed below the figure.}
+  \end{figure}
+
+  \begin{figure}
+    \caption{This caption is placed above the figure.}
+    \pgfuseimage{myotherfigure}
+  \end{figure}
+\end{frame}
+\end{verbatim}
+
+\begin{element}{caption}\yes\yes\yes
+  This template is used to render the caption.
+  \begin{templateoptions}
+    \itemoption{default}{}
+    typesets the caption name (a word like Figure'' or Abbildung'' or Table,'' depending on whether a table or figure is typeset and depending on the currently installed language) before the caption text. No number is printed, since these make little sense in a normal presentation.
+    \itemoption{numbered}{}
+    adds the figure or table number to the caption. Use this option only if your audience has a printed handout or printed lecture notes that follow the same numbering.
+    \itemoption{caption name own line}{}
+    As the name suggests, this options puts the caption name (like Figure'') on its own line.
+  \end{templateoptions}
+
+  Inside the template, you can use the following inserts:
+  \begin{itemize}
+    \iteminsert{\insertcaption}
+    Inserts the text of the current caption.
+
+    \iteminsert{\insertcaptionname}
+    Inserts the name of the current caption. This word is either Table'' or Figure'' or, if the |babel| package is used, some translation thereof.
+
+    \iteminsert{\insertcaptionnumber}
+    Inserts the number of the current figure or table.
+  \end{itemize}
+\end{element}
+
+\begin{element}{caption name}\no\yes\yes
+  These \beamer-color and -font are used to typeset the caption name (a word like Figure''). The |caption| template must directly use'' them, they are not installed automatically by the |\insertcaptionname| command.
+\end{element}
+
+\begin{element}{caption label separator}\yes\no\no
+  This template is inserted between caption name and caption text.
+  \begin{templateoptions}
+    \itemoption{default}{}
+    Typesets the colon followed by the space.
+    \itemoption{none}{}
+    Typesets no separator.
+    \itemoption{colon}{}
+    Alias for the default.
+    \itemoption{period}{}
+    Typesets the period followed by the space.
+    \itemoption{space}{}
+    Typesets the space.
+    Typesets the |\quad| followed by the space.
+    \itemoption{endash}{}
+    Typesets the en-dash surrounded by spaces (| -- |).
+  \end{templateoptions}
+\end{element}
+
+
+\subsection{Splitting a Frame into Multiple Columns}
+
+The \beamer\ class offers several commands and environments for splitting (perhaps only part of) a frame into multiple columns. These commands have nothing to do with \LaTeX's commands for creating columns. Columns are especially useful for placing a graphic next to a description/explanation.
+
+The main environment for creating columns is called |columns|. Inside this environment, you can either place several |column| environments, each of which creates a new column, or use the |\column| command to create new columns.
+
+\begin{environment}{{columns}\oarg{options}}
+  A multi-column area. Inside the environment you should place only |column| environments or |\column| commands (see below). The following \meta{options} may be given:
+  \begin{itemize}
+  \item
+    \declare{|b|} will cause the bottom lines of the columns to be vertically aligned.
+  \item
+    \declare{|c|} will cause the columns to be centered vertically relative to each other. Default, unless the global option |t| is used.
+  \item
+    \declare{|onlytextwidth|} is the same as |totalwidth=\textwidth|.
+  \item
+    \declare{|t|} will cause the first lines of the columns to be aligned. Default if global option |t| is used.
+  \item
+    \declare{|T|} is similar to the |t| option, but |T| aligns the tops of the first lines while |t| aligns the so-called baselines of the first lines. If strange things seem to happen in conjunction with the |t| option (for example if a graphic suddenly drops down'' with the |t| option instead of going up,''), try using this option instead.
+  \item
+    \declare{|totalwidth=|\meta{width}} will cause the columns to occupy not the whole page width, but only \meta{width}, all told.
+     Note that this means that any margins are ignored.
+  \end{itemize}
+
+  \example
+\begin{verbatim}
+\begin{columns}[t]
+  \begin{column}{5cm}
+    Two\\lines.
+  \end{column}
+  \begin{column}{5cm}
+    One line (but aligned).
+  \end{column}
+\end{columns}
+\end{verbatim}
+
+  \example
+\begin{verbatim}
+\begin{columns}[t]
+  \column{5cm}
+    Two\\lines.
+
+  \column[T]{5cm}
+    \includegraphics[height=3cm]{mygraphic.jpg}
+\end{columns}
+\end{verbatim}
+
+  \articlenote
+  This environment is ignored in |article| mode.
+
+\end{environment}
+
+To create a column, you can either use the |column| environment or the |\column| command.
+
+\begin{environment}{{column}\oarg{placement}\marg{column width}}
+  Creates a single column of width \meta{column width}. The vertical placement of the enclosing |columns| environment can be overruled by specifying a specific \meta{placement} (|t| and |T| for the two top modes, |c| for centered, and |b| for bottom).
+
+  \example
+  The following code has the same effect as the above examples:
+\begin{verbatim}
+\begin{columns}
+  \begin{column}[t]{5cm}
+    Two\\lines.
+  \end{column}
+  \begin{column}[t]{5cm}
+    One line (but aligned).
+  \end{column}
+\end{columns}
+\end{verbatim}
+
+  \articlenote
+  This command is ignored in |article| mode.
+
+\end{environment}
+
+\begin{command}{{\column}\oarg{placement}\marg{column width}}
+  Starts a single column. The parameters and options are the same as for the |column| environment. The column automatically ends with the next occurrence of |\column| or of a |column| environment or of the end of the current |columns| environment.
+
+  \example
+\begin{verbatim}
+\begin{columns}
+  \column[t]{5cm}
+    Two\\lines.
+  \column[t]{5cm}
+    One line (but aligned).
+\end{columns}
+\end{verbatim}
+
+  \articlenote
+  This command is ignored in |article| mode.
+
+\end{command}
+
+
+\subsection{Positioning Text and Graphics Absolutely}
+
+Normally, \beamer\ uses \TeX's normal typesetting mechanism to position text and graphics on the page. In certain situation you may instead wish a certain text or graphic to appear at a page position that is specified \emph{absolutely}. This means that the position is specified relative to the upper left corner of the slide.
+
+The package |textpos| provides several commands for positioning text absolutely and it works together with \beamer. When using this package, you will typically have to specify the options |overlay| and perhaps |absolute|. For details on how to use the package, please see its documentation.
+
+
+\subsection{Verbatim and Fragile Text}
+
+If you wish to use a |{verbatim}| environment in a frame, you have to add the option |[fragile]| to the |{frame}| environment. The |\end{frame}| must be alone on a single line (except for any leading whitespace). Using this option will cause the frame contents to be written to an external file and then read back. See the description of the |{frame}| environment for more details.
+
+You must also use the |[fragile]| option for frames that include any fragile'' text, which is any text that is not interpreted the way text is usually interpreted by \TeX.'' For example, if you use a package that (locally) redefined the meaning of, say, the character |&|, you must use this option.
+
+Inside |{verbatim}| environments you obviously cannot use commands like |\alert<2>| to highlight part of code since the text is written in, well, verbatim. There are several good packages like |alltt| or |listings| that allow you to circumvent this problem. For simple cases, the following environment can be used, which is defined by \beamer:
+
+\begin{environment}{{semiverbatim}}
+  The text inside this environment is typeset like verbatim text. However, the characters |\|, |{|, and |}| retain their meaning. Thus, you can say things like
+\begin{verbatim}
+\alert<1->{std::cout << "AT&T likes 100% performance";}
+\end{verbatim}
+
+  To typeset the three characters |\|, |{|, and |}| you can use the commands |\\| (which is redefined inside this environment---you do not need it anyway), |\{|, and |\}|. Thus in order to get typeset |\alert<1>{X}|'' you can write |\\alert<1>\{X\}|.
+\end{environment}
+
+
+\subsection{Abstract}
+
+The |{abstract}| environment is overlay specificiation-aware in \beamer:
+
+\begin{environment}{{abstract}\sarg{action specification}}
+  You can use this environment to typeset an abstract.
+
+  \begin{element}{abstract}\no\yes\yes
+    These \beamer-color and -font are used to typeset the abstract. If a background color is set, this background color is used as background for the whole abstract by default.
+  \end{element}
+
+  \begin{element}{abstract title}\yes\yes\yes
+    \colorparents{titlelike}
+    This template is used for the title. By default, this inserts the word |\abstractname|, centered. The background color is ignored.
+  \end{element}
+
+  \begin{element}{abstract begin}\yes\no\no
+    This template is inserted at the very beginning of the abstract, before the abstract title and the \meta{environment contents} is inserted.
+  \end{element}
+
+  \begin{element}{abstract end}\yes\no\no
+    This template is inserted at the end of the abstract, after the \meta{environment contents}.
+  \end{element}
+\end{environment}
+
+
+\subsection{Verse, Quotations, Quotes}
+
+\LaTeX\ defines three environments for typesetting quotations and verses: |verse|, |quotation|, and |quote|. These environments are also available in the \beamer\ class, where they are overlay specification-aware. If an overlay specification is given, the verse or quotation is shown only on the specified slides and is covered otherwise. The difference between a |quotation| and a |quote| is that the first has paragraph indentation, whereas the second hasn't.
+
+You can change the font and color used for these by changing the \beamer-colors and -fonts listed below. Unlike the standard \LaTeX\ environments, the default font theme typesets a verse in an italic serif font, quotations and quotes are typeset using an italic font (whether serif or sans-serif depends on the standard document font).
+
+\begin{environment}{{verse}\sarg{action specification}}
+  You can use this environment to typeset a verse.
+
+  \begin{element}{verse}\no\yes\yes
+    These \beamer-color and -font are used to typeset the verse. If a background color is set, this background color is used as background for the whole abstract. The default font is italic serif.
+  \end{element}
+
+  \begin{element}{verse begin}\yes\no\no
+    This template is inserted at the beginning of the verse.
+  \end{element}
+
+  \begin{element}{verse end}\yes\no\no
+    This template is inserted at the end of the verse.
+  \end{element}
+\end{environment}
+
+\begin{environment}{{quotation}\sarg{action specification}}
+  Use this environment to typeset multi-paragraph quotations. Think again, before presenting multi-paragraph quotations.
+
+  \begin{element}{quotation}\no\yes\yes
+    These \beamer-color and -font are used to typeset the quotation.
+  \end{element}
+
+  \begin{element}{quotation begin}\yes\no\no
+    This template is inserted at the beginning of the quotation.
+  \end{element}
+
+  \begin{element}{quotation end}\yes\no\no
+    This template is inserted at the end of the quotation.
+  \end{element}
+\end{environment}
+
+\begin{environment}{{quote}\sarg{action specification}}
+  Use this environment to typeset a single-paragraph quotation.
+
+  \begin{element}{quote}\no\yes\yes
+    These \beamer-color and -font are used to typeset the quote.
+  \end{element}
+
+  \begin{element}{quote begin}\yes\no\no
+    This template is inserted at the beginning of the quote.
+  \end{element}
+
+  \begin{element}{quote end}\yes\no\no
+    This template is inserted at the end of the quote.
+  \end{element}
+\end{environment}
+
+
+\subsection{Footnotes}
+
+First a word of warning: Using footnotes is usually not a good idea. They disrupt the flow of reading.
+
+You can use the usual |\footnote| command. It has been augmented to take an additional option, for placing footnotes at the frame bottom instead of at the bottom of the current minipage.
+
+\begin{command}{\footnote\sarg{overlay specification}\oarg{options}\marg{text}}
+  Inserts a footnote into the current frame. Footnotes will always be shown at the bottom of the current frame; they will never be moved'' to other frames. As usual, one can give a number as \meta{options}, which will cause the footnote to use that number. The \beamer\ class adds one additional option:
+  \begin{itemize}
+  \item
+    \declare{|frame|} causes the footnote to be shown at the bottom of the frame. This is normally the default behavior anyway, but in minipages and certain blocks it makes a difference. In a minipage, the footnote is usually shown as part of the minipage rather than as part of the frame.
+  \end{itemize}
+
+  If an \meta{overlay specification} is given, this causes the footnote \meta{text} to be shown only on the specified slides. The footnote symbol in the text is shown on all slides.
+
+  \example
+  |\footnote{On a fast machine.}|
+  \example
+  |\footnote[frame,2]{Not proved.}|
+  \example
+  |\footnote<.->{Der Spiegel, 4/04, S.~90.}|
+
+  \articlenote
+  In |article| mode, footnotes are typeset as usual. The |frame| option has no effect, which means in a minipage the footnote is shown as part of it.
+
+  \begin{element}{footnote}\yes\yes\yes
+    This template will be used to render the footnote. Inside this template, the following two inserts can be used:
+    \begin{itemize}
+      \iteminsert{\insertfootnotetext}
+      Inserts the current footnote text.
+      \iteminsert{\insertfootnotemark}
+      Inserts the current footnote mark (like a raised number). This mark is computed automatically.
+    \end{itemize}
+  \end{element}
+
+  \begin{element}{footnote mark}\no\yes\yes
+    This \beamer-color/-font is used when rendering the footnote mark, both in the text and at the beginning of the footnote itself.
+  \end{element}
+\end{command}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-localstructure.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-macros.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-macros.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,341 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2013,2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\def\beamer{\textsc{beamer}}
+\def\pdf{\textsc{pdf}}
+\def\pgfname{\textsc{pgf}}
+\def\translatorname{\textsc{translator}}
+\def\pstricks{\textsc{pstricks}}
+\def\prosper{\textsc{prosper}}
+\def\seminar{\textsc{seminar}}
+\def\texpower{\textsc{texpower}}
+\def\foils{\textsc{foils}}
+
+{
+  \makeatletter
+  \global\let\myempty=\@empty
+  \global\let\mygobble=\@gobble
+  \makeatother
+  \gdef\getridofats#1@#2\relax{%
+    \def\getridtest{#2}%
+    \ifx\getridtest\myempty%
+      \expandafter\def\expandafter\strippedat\expandafter{\strippedat#1}
+    \else%
+      \expandafter\def\expandafter\strippedat\expandafter{\strippedat#1\protect\printanat}
+      \getridofats#2\relax%
+    \fi%
+  }
+  \gdef\removeats#1{%
+    \let\strippedat\myempty%
+    \edef\strippedtext{\stripcommand#1}%
+    \expandafter\getridofats\strippedtext @\relax%
+  }
+  \makeatletter
+  \gdef\stripcommand#1{\expandafter\@gobble\string#1}
+}
+\providecommand\href[2]{\texttt{#1}}
+
+\def\printanat{\char\@}
+
+\def\declare#1{{\color{red!75!black}#1}}
+%\def\declare{\afterassignment\translatormanualdeclare\let\next=}
+%\def\translatormanualdeclare{\ifx\next\bgroup\bgroup\color{red!75!black}\else{\color{red!75!black}\next}\fi}
+
+\def\command#1{\list{}{\leftmargin=2em\itemindent-\leftmargin\def\makelabel##1{\hss##1}}%
+\item\extractcommand#1@\par\topsep=0pt}
+\def\endcommand{\endlist}
+\def\extractcommand#1#2@{\strut\declare{\texttt{\string#1}}#2%
+  \index{\stripcommand#1@\protect\myprintocmmand{\stripcommand#1}}}
+
+%\let\textoken=\command
+%\let\endtextoken=\endcommand
+
+\def\myprintocmmand#1{\texttt{\char\\#1}}
+
+\def\example{\par\smallskip\noindent\textit{Example: }}
+\def\themeauthor{\par\smallskip\noindent\textit{Theme author: }}
+
+\def\environment#1{\list{}{\leftmargin=2em\itemindent-\leftmargin\def\makelabel##1{\hss##1}}%
+\extractenvironement#1@\par\topsep=0pt}
+\def\endenvironment{\endlist}
+\def\extractenvironement#1#2@{%
+\item{{\ttfamily\char\\begin\char\{\declare{#1}\char\}}#2}%
+  {\itemsep=0pt\parskip=0pt\item{\meta{environment contents}}%
+  \item{\ttfamily\char\\end\char\{\declare{#1}\char\}}}%
+  \index{#1@\protect\texttt{#1} environment}%
+  \index{Environments!#1@\protect\texttt{#1}}}
+
+\def\classoption#1{\list{}{\leftmargin=2em\itemindent-\leftmargin\def\makelabel##1{\hss##1}}%
+\item{{\ttfamily\char\\documentclass[\declare{#1}]\char\{beamer\char\}}}
+  \index{#1@\protect\texttt{#1} class option}%
+  \index{Class options for \textsc{beamer}!#1@\protect\texttt{#1}}%
+  \par\topsep=0pt}
+\def\endclassoption{\endlist}
+
+
+\newcommand\beameroption[2]{\list{}{\leftmargin=2em\itemindent-\leftmargin\def\makelabel##1{\hss##1}}%
+\item{{\ttfamily\char\\setbeameroption\char\{\declare{#1}{\normalfont\opt{#2}}\char\}}}
+  \index{#1@\protect\texttt{#1} beamer option}%
+  \index{Beamer options!#1@\protect\texttt{#1}}%
+  \par\topsep=0pt}
+\def\endbeameroption{\endlist}
+
+
+\def\smallpackage{\vbox\bgroup\package}
+\def\endsmallpackage{\egroup\endpackage}
+
+\def\package#1{\list{}{\leftmargin=2em\itemindent-\leftmargin\def\makelabel##1{\hss##1}}%
+\extracttheme#1 at usepackage@package at Packages@\par\topsep=0pt}
+\def\endpackage{\endlist}
+%\def\extracttheme#1#2@{%
+%\item{{{\ttfamily\char\\usepackage}#2{\ttfamily\char\{\declare{#1}\char\}}}}}
+
+\def\theme#1#2#3#4{\list{}{\leftmargin=2em\itemindent-\leftmargin\def\makelabel##1{\hss##1}}%
+\extracttheme#2@#1@#3@#4@\par\topsep=0pt}
+\def\endtheme{\endlist}
+\def\extracttheme#1#2@#3@#4@#5@{%
+\item{{{\ttfamily\char\\#3}#2{\ttfamily\char\{\declare{#1}\char\}}}}%
+  \index{#1@\protect\texttt{#1} #4}%
+  \index{#5!#1@\protect\texttt{#1}}
+}
+
+\def\class#1{\list{}{\leftmargin=2em\itemindent-\leftmargin\def\makelabel##1{\hss##1}}%
+\extractclass#1@\par\topsep=0pt}
+\def\endclass{\endlist}
+\def\extractclass#1#2@{%
+\item{{{\ttfamily\char\\documentclass}#2{\ttfamily\char\{\declare{#1}\char\}}}}%
+  \index{#1@\protect\texttt{#1} class}%
+  \index{Classes!#1@\protect\texttt{#1}}}
+
+\def\typesetsol#1{\texttt{\def\_{\char\_}#1}}
+
+\def\solution#1{\list{}{\leftmargin=2em\itemindent-\leftmargin\def\makelabel##1{\hss##1}}%
+\item \textbf{Solution Template }\declare{\typesetsol{#1}}\par\topsep=0pt%
+  \index{#1@\protect\typesetsol{#1} solution}%
+  \index{Solutions!#1@\protect\typesetsol{#1}}}
+\def\endsolution{\endlist}
+
+\def\template#1{\list{}{\leftmargin=2em\itemindent-\leftmargin\def\makelabel##1{\hss##1}}%
+\item {\ttfamily\char\\setbeamertemplate\char\{\declare{#1}\char\}}\oarg{options}\opt{\meta{args}}\par\topsep=0pt}
+\def\endtemplate{\endlist}
+\newenvironment{template*}[1]{\list{}{\leftmargin=2em\itemindent-\leftmargin\def\makelabel##1{\hss##1}}%
+\item \leavevmode\llap{\color{blue}\vtop
+    to0pt{\llap{\textsc{appear-\!}}\vskip-3pt\llap{\textsc{ance}}\vss}\ \ }{\ttfamily\char\\setbeamertemplate\char\{\declare{#1}\char\}}\oarg{options}\opt{\meta{args}}\par\topsep=0pt}
+{\endlist}
+
+\newenvironment{element}[4]{\list{}{\leftmargin=2em\itemindent-\leftmargin\def\makelabel##1{\hss##1}}%
+\item \textbf{\ifx#2\semiyes Parent Beamer-Template\else%
+    Beamer\applier#2{-Template}\applier#3{\applier#2{/}-Color}\applier#4{\ifx#2\yes/\else\ifx#3\yes/\fi\fi
+      -Font}\fi}
+    {\ttfamily{\declare{#1}}}\par\topsep=0pt%
+  \edef\parameters{%
+    \ifx#2\semiyes parent template\else%
+    \applier#2{template}\applier#3{\applier#2{/}color}\applier#4{\ifx#2\yes/\else\ifx#3\yes/\fi\fi font}\fi}
+  \index{#1@\protect\texttt{#1} \parameters}%
+  \applier#2{\index{Beamer templates!#1@\protect\texttt{#1}}}%
+  \applier#3{\index{Beamer colors!#1@\protect\texttt{#1}}}%
+  \applier#4{\index{Beamer fonts!#1@\protect\texttt{#1}}}%
+}
+{\endlist}
+
+\def\applier#1#2{\ifx#1\yes#2\fi}
+
+\def\templateoptions{\par
+  The following template options are predefined:
+  \begin{itemize}}
+\def\endtemplateoptions{\end{itemize}}
+
+\def\itemoption#1#2{\item {\texttt{[\declare{#1}]}}#2}
+
+%\def\itemoption#1{\item \declare{\texttt{#1}}%
+%  \indexoption{#1}%
+%}
+
+%\def\indexoption#1{%
+%  \index{#1@\protect\texttt{#1} option}%
+%  \index{Options!#1@\protect\texttt{#1}}%
+%}
+
+\def\yes{\hbox to .6cm{\ding{51}\hfil}}
+\def\semiyes{\hbox to .6cm{(\ding{51})\hfil}}
+\def\no{\hbox to .6cm{\ding{55}\hfil}}
+
+\def\choosecol#1{}%\ifx#1\yes\color{green!50!black}\else\color{red!50!black}\fi}
+
+\def\templatefontcolor#1#2#3#4{%
+  \item\declare{\texttt{#1}}\hfill%
+  {\choosecol#2Template #2} {\choosecol#3Color #3} {\choosecol#4Font #4}\par}
+
+\def\fontparents#1{Font parents: \texttt{#1}\par}
+\def\colorparents#1{Color parents: \texttt{#1}\par}
+\def\colorfontparents#1{Color/font parents: \texttt{#1}\par}
+
+\def\templateinserts{\begin{itemize}}
+\def\endtemplateinserts{\end{itemize}}
+
+\def\iteminsert#1{\item {\texttt{\declare{\string#1}}}%
+  \index{Inserts!\stripcommand#1@\protect\myprintocmmand{\stripcommand#1}}}
+
+\newcommand\opt[1]{{\color{black!50!green}#1}}
+\renewcommand\oarg[1]{\opt{{\ttfamily[}\meta{#1}{\ttfamily]}}}
+\newcommand\ooarg[1]{{\ttfamily[}\meta{#1}{\ttfamily]}}
+\newcommand\sarg[1]{\opt{{\ttfamily\char\<}\meta{#1}{\ttfamily\char\>}}}
+\newcommand\ssarg[1]{{\ttfamily\char\<}\meta{#1}{\ttfamily\char\>}}
+
+%\def\opt{\afterassignment\translatormanualopt\let\next=}
+\def\translatormanualopt{\ifx\next\bgroup\bgroup\color{black!50!green}\else{\color{black!50!green}\next}\fi}
+
+\newcommand{\beamernote}{\par\smallskip\noindent\llap{\color{blue}\vtop to0pt{\llap{\textsc{presen-\!}}\vskip-3pt\llap{\textsc{tation}}\vss}\ \ }}
+\newcommand{\articlenote}{\par\smallskip\noindent\llap{\color{blue}\textsc{article}\ \ }}
+\newcommand{\appearancenote}{\par\smallskip\noindent\appearancenotetext}
+
+\def\appearancenotetext{\llap{\color{blue}\vtop
+    to0pt{\llap{\textsc{appear-\!}}\vskip-3pt\llap{\textsc{ance}}\vss}\ \ }}
+
+\newcommand{\templatenote}{\par\smallskip\noindent\llap{\color{blue}\textsc{template}\ \ }}
+\newcommand{\colornote}{\par\smallskip\noindent\llap{\color{blue}\textsc{color}\ \ }}
+\newcommand{\fontnote}{\par\smallskip\noindent\llap{\color{blue}\textsc{font}\ \ }}
+
+\newcommand{\genericthemeexample}[2][]{%
+  \smallskip\par\noindent
+  \smallskip\par}
+\newenvironment{themeexample}[2][]
+{\begin{theme}{usetheme}{{#2}#1}{presentation theme}{Presentation themes}
+    \example\genericthemeexample{theme#2}
+  }
+{\end{theme}}
+\newenvironment{innerthemeexample}[2][]
+{\begin{theme}{useinnertheme}{{#2}#1}{inner theme}{Inner themes}
+    \example\genericthemeexample{innertheme#2}
+  }
+{\end{theme}}
+\newenvironment{outerthemeexample}[2][]
+{\begin{theme}{useoutertheme}{{#2}#1}{outer theme}{Outer themes}
+    \example\genericthemeexample{outertheme#2}
+  }
+{\end{theme}}
+\newenvironment{colorthemeexample}[2][]
+{\begin{theme}{usecolortheme}{{#2}#1}{color theme}{Color themes}
+    \example\genericthemeexample{colortheme#2}
+  }
+{\end{theme}}
+\newenvironment{fontthemeexample}[2][]
+{\begin{theme}{usefonttheme}{{#2}#1}{font theme}{Font themes}
+    \example\genericthemeexample{fonttheme#2}
+  }
+{\end{theme}}
+\newenvironment{fontthemeexample*}[2][]
+{\begin{theme}{usefonttheme}{{#2}#1}{font theme}{Font themes}}
+{\end{theme}}
+
+\def\partname{Part}
+
+\colorlet{examplefill}{yellow!80!black}
+\definecolor{graphicbackground}{rgb}{0.96,0.96,0.8}
+\definecolor{codebackground}{rgb}{0.8,0.8,1}
+
+\newenvironment{translatormanualentry}{\list{}{\leftmargin=2em\itemindent-\leftmargin\def\makelabel##1{\hss##1}}}{\endlist}
+\newcommand\translatormanualbody{\parskip3pt}
+
+
+%\newenvironment{command}[1]{
+%  \begin{translatormanualentry}
+%    \extractcommand#1\@@
+%    \translatormanualbody
+%}
+%{
+%  \end{translatormanualentry}
+%}
+
+%\def\extractcommand#1#2\@@{%
+%  \removeats{#1}%
+%  \index{\strippedat @\protect\myprintocmmand{\strippedat}}}
+
+
+\renewenvironment{environment}[1]{
+  \begin{translatormanualentry}
+    \extractenvironement#1\@@
+    \translatormanualbody
+}
+{
+  \end{translatormanualentry}
+}
+
+\def\extractenvironement#1#2\@@{%
+  \translatormanualentryheadline{{\ttfamily\char\\begin\char\{\declare{#1}\char\}}#2}%
+  \translatormanualentryheadline{{\ttfamily\char\\end\char\{\declare{#1}\char\}}}%
+  \index{#1@\protect\texttt{#1} environment}%
+  \index{Environments!#1@\protect\texttt{#1}}}
+
+
+
+%\newenvironment{package}[1]{
+%  \begin{translatormanualentry}
+%    \translatormanualentryheadline{{\ttfamily\char\\usepackage\opt{[\meta{options}]}\char\{\declare{#1}\char\}}}
+%    \index{#1@\protect\texttt{#1} package}%
+%    \index{Packages and files!#1@\protect\texttt{#1}}%
+%    \translatormanualbody
+%}
+%{
+%  \end{translatormanualentry}
+%}
+
+
+
+\newenvironment{filedescription}[1]{
+  \begin{translatormanualentry}
+    \index{#1@\protect\texttt{#1} file}%
+    \index{Packages and files!#1@\protect\texttt{#1}}%
+    \translatormanualbody
+}
+{
+  \end{translatormanualentry}
+}
+
+
+\newenvironment{packageoption}[1]{
+  \begin{translatormanualentry}
+    \translatormanualentryheadline{{\ttfamily\char\\usepackage[\declare{#1}]\char\{translator\char\}}}
+    \index{#1@\protect\texttt{#1} package option}%
+    \index{Package options for \textsc{translator}!#1@\protect\texttt{#1}}%
+    \translatormanualbody
+}
+{
+  \end{translatormanualentry}
+}
+
+\makeatletter
+  This index only contains automatically generated entries, sorry. A good
+  index should also contain carefully selected keywords.
+  \bigskip
+}
+\c at IndexColumns=2
+  \def\theindex{\@restonecoltrue
+    \columnseprule \z@  \columnsep 35\p@
+    \twocolumn[\index at prologue]%
+       \parindent -30pt
+       \columnsep 15pt
+       \parskip 0pt plus 1pt
+       \leftskip 30pt
+       \rightskip 0pt plus 2cm
+       \small
+       \def\@idxitem{\par}%
+    \let\item\@idxitem \ignorespaces}
+  \def\endtheindex{\onecolumn}
+\def\noindexing{\let\index=\@gobble}
+
+\makeatother

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-macros.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-nonpresentation.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-nonpresentation.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,392 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2012,2014,2015 by Vedran Mileti\'c, Joseph Wright
+% Copyright 2016 by Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\section{Creating Handouts and Lecture Notes}
+\label{section-modes}
+
+During a presentation it is very much desirable that the audience has a \emph{handout} or even \emph{lecture notes} available to it. A handout allows everyone in the audience to individually go back to things he or she has not understood.
+
+Always provide handouts \emph{as early as possible}, preferably weeks before the talk. Do \emph{not} retain the handout till the end of the talk.
+
+The \beamer\ package offers two different ways of creating special versions of your talk; they are discussed in the following. The first, easy, way is to create a handout version by adding the |handout| option, which will cause the document to be typeset in |handout| mode. It will look like'' a presentation, but it can be printed more easily (the overlays are flattened''). The second, more complicated and more powerful way is to create an independent article'' version of your presentation. This version coexists in your main file.
+
+
+\subsection{Creating Handouts Using the Handout Mode}
+\label{handout}
+
+The easiest way of creating a handout for your audience (though not the most desirable one) is to use the |handout| option. This option works exactly like the |trans| option.
+
+\begin{classoption}{handout}
+  Create a version that uses the |handout| overlay specifications.
+
+  You might wish to choose a different color and/or presentation theme for the handout.
+\end{classoption}
+
+When printing a handout created this way, you will typically wish to print at least two and possibly four slides on each page. The easiest way of doing so is presumably to use |pgfpages| as follows:
+
+\begin{verbatim}
+\usepackage{pgfpages}
+\pgfpagesuselayout{2 on 1}[a4paper,border shrink=5mm]
+\end{verbatim}
+
+Instead of |2 on 1| you can use |4 on 1| (but then you have to add |landscape| to the list of options) and you can use, say, |letterpaper| instead of |a4paper|.
+
+
+\subsection{Creating Handouts Using the Article Mode}
+\label{section-article}
+
+In the following, the article version'' of your presentation refers to a normal \TeX\ text typeset using, for example, the document class |article| or perhaps |llncs| or a similar document class. This version of the presentation will typically follow different typesetting rules and may even have a different structure. Nevertheless, you may wish to have this version coexist with your presentation in one file and you may wish to share some part of it (like a figure or a formula) with your presentation.
+
+In general, the article version of a talk is better suited as a handout than a handout created using the simple |handout| mode since it is more economic and can include more in-depth information.
+
+\subsubsection{Starting the Article Mode}
+
+The article mode of a presentation is created by specifying |article| or |book| or some other class as the document class instead of |beamer| and by then loading the package |beamerarticle|.
+
+The package |beamerarticle| defines virtually all of \beamer's commands in a way that is sensible for the |article| mode. Also, overlay specifications can be given to commands like |\textbf| or |\item| once |beamerarticle| has been loaded. Note that, except for |\item|, these overlay specifications also work: by writing |\section<presentation>{Name}| you will suppress this section command in the article version. For the exact effects overlay specifications have in |article| mode, please see the descriptions of the commands to which you wish to apply them.
+
+\begin{package}{{beamerarticle}\opt{|[|\meta{options}|]|}}
+  Makes most \beamer\ commands available for another document class.
+
+  The following \meta{options} may be given:
+  \begin{itemize}
+  \item
+    \declare{|activeospeccharacters|} will leave the character code of the pointed brackets as specified by other packages. Normally, \beamer\ will turn off the special behavior of the two characters |<| and |>|. Using this option, you can reinstall the original behavior at the price of possible problems when using overlay specifications in the |article| mode.
+  \item
+    \declare{|noamssymb|} will suppress the automatic loading of the |amssymb| package. Normally, \beamer\ will load this package since many themes use AMS symbols. This option allows you to opt-out from this behavior in article mode, thus preventing clashes with some classes and font packages that conflict with |amssymb|. Note that, if you use this option, you will have to care for yourself that |amssymb| or an alternative package is loaded if you use respective symbols.
+  \item
+    \declare{|noamsthm|} will suppress the loading of the |amsthm| package. No theorems will be defined.
+  \item
+    \declare{|nokeywords|} will suppress the creation of a |\keywords| command.
+  \item
+    \declare{|notheorems|} will suppress the definition of standard environments like |theorem|, but |amsthm| is still loaded and the |\newtheorem| command still makes the defined environments overlay-specification-aware. Using this option allows you to define the standard environments in whatever way you like while retaining the power of the extensions to |amsthm|.
+  \item
+    \declare{|envcountsect|} causes theorem, definitions and the like to be numbered with each section. Thus instead of Theorem~1 you get Theorem~1.1. We recommend using this option.
+  \item
+    \declare{|noxcolor|} will suppress the loading of the |xcolor| package. No colors will be defined.
+  \end{itemize}
+
+  \example
+\begin{verbatim}
+\documentclass{article}
+\usepackage{beamerarticle}
+\begin{document}
+\begin{frame}
+  \frametitle{A frame title}
+  \begin{itemize}
+\item<1-> You can use overlay specifications.
+\item<2-> This is useful.
+  \end{itemize}
+\end{frame}
+\end{document}
+\end{verbatim}
+\end{package}
+
+There is one remaining problem: While the |article| version can easily \TeX\ the whole file, even in the presence of commands like |\frame<2>|, we do not want the special article text to be inserted into our original \beamer\ presentation. That means, we would like all text \emph{between} frames to be suppressed. More precisely, we want all text except for commands like |\section| and so on to be suppressed. This behavior can be enforced by specifying the option |ignorenonframetext| in the presentation version. The option will insert a |\mode*| at the beginning of your presentation.
+
+The following example shows a simple usage of the |article| mode:
+
+\begin{verbatim}
+\documentclass[a4paper]{article}
+\usepackage{beamerarticle}
+%%\documentclass[ignorenonframetext,red]{beamer}
+
+\mode<article>{\usepackage{fullpage}}
+\mode<presentation>{\usetheme{Berlin}}
+
+%% everyone:
+\usepackage[english]{babel}
+\usepackage{pgf}
+
+\pgfdeclareimage[height=1cm]{myimage}{filename}
+
+\begin{document}
+
+\section{Introduction}
+
+This is the introduction text. This text is not shown in the
+presentation, but will be part of the article.
+
+\begin{frame}
+  \begin{figure}
+    % In the article, this is a floating figure,
+    % In the presentation, this figure is shown in the first frame
+    \pgfuseimage{myimage}
+  \end{figure}
+\end{frame}
+
+This text is once more not shown in the presentation.
+
+\section{Main Part}
+
+While this text is not shown in the presentation, the section command
+also applies to the presentation.
+
+We can add a subsection that is only part of the article like this:
+
+\subsection<article>{Article-Only Section}
+
+With some more text.
+
+\begin{frame}
+  This text is part both of the article and of the presentation.
+  \begin{itemize}
+\item This stuff is also shown in both version.
+\item This too.
+  \only<article>{\item This particular item is only part
+      of the article version.}
+\item<presentation:only at 0> This text is also only part of the article.
+  \end{itemize}
+\end{frame}
+\end{document}
+\end{verbatim}
+
+There is one command whose behavior is a bit special in |article| mode: The line break command |\\|. Inside frames, this command has no effect in |article| mode, except if an overlay specification is present. Then it has the normal effect dictated by the specification. The reason for this behavior is that you will typically inserts lots of |\\| commands in a presentation in order to get control over all line breaks. These line breaks are mostly superfluous in |article| mode. If you really want a line break to apply in all versions, say |\\<all>|. Note that the command |\\| is often redefined by certain environments, so it may not always be overlay-specification-aware. In such a case you have to write something like |\only<presentation>{\\}|.
+
+\subsubsection{Workflow}
+\label{section-article-version-workflow}
+
+The following workflow steps are optional, but they can simplify the creation of the article version.
+
+\begin{itemize}
+\item
+  In the main file |main.tex|, delete the first line, which sets the document class.
+\item
+  Create a file named, say, |main.beamer.tex| with the following content:
+
+\begin{verbatim}
+\documentclass[ignorenonframetext]{beamer}
+\input{main.tex}
+\end{verbatim}
+
+\item
+  Create an extra file named, say, |main.article.tex| with the following content:
+
+\begin{verbatim}
+\documentclass{article}
+\usepackage{beamerarticle}
+\setjobnamebeamerversion{main.beamer}
+\input{main.tex}
+\end{verbatim}
+
+\item
+  You can now run |pdflatex| or |latex| on the two files |main.beamer.tex| and |main.article.tex|.
+\end{itemize}
+
+The command |\setjobnamebeamerversion| tells the article version where to find the presentation version. This is necessary if you wish to include slides from the presentation version in an article as figures.
+
+\begin{command}{\setjobnamebeamerversion\marg{filename without extension}}
+  Tells the \beamer\ class where to find the presentation version of the current file.
+\end{command}
+
+\subsubsection{Including Slides from the Presentation Version in the Article Version}
+
+If you use the package |beamerarticle|, the |\frame| command becomes available in |article| mode. By adjusting the frame template, you can mimic'' the appearance of frames typeset by \beamer\ in your articles. However, sometimes you may wish to insert the real thing'' into the |article| version, that is, a precise screenshot'' of a slide from the presentation. The commands introduced in the following help you do exactly this.
+
+In order to include a slide from your presentation in your article version, you must do two things: First, you must place a normal \LaTeX\ label on the slide using the |\label| command. Since this command is overlay-specification-aware, you can also select specific slides of a frame. Also, by adding the option |label=|\meta{name} to a frame, a label \meta{name}|<|\meta{slide number}|>| is automatically added to each slide of the frame.
+
+Once you have labeled a slide, you can use the following command in your article version to insert the slide into it:
+
+\begin{command}{\includeslide\oarg{options}\marg{label name}}
+  This command calls |\pgfimage| with the given \meta{options} for the file specified by
+  \begin{quote}
+    |\setjobnamebeamerversion|\meta{filename}
+  \end{quote}
+  Furthermore, the option |page=|\meta{page of label name} is passed to |\pgfimage|, where the \meta{page of label name} is read internally from the file \meta{filename}|.snm|.
+  \example
+
+\begin{verbatim}
+\article
+  \begin{figure}
+    \begin{center}
+      \includeslide[height=5cm]{slide1}
+    \end{center}
+    \caption{The first slide (height 5cm). Note the partly covered second item.}
+  \end{figure}
+  \begin{figure}
+    \begin{center}
+      \includeslide{slide2}
+    \end{center}
+    \caption{The second slide (original size). Now the second item is also shown.}
+  \end{figure}
+\end{verbatim}
+\end{command}
+
+The exact effect of passing the option |page=|\meta{page of label name} to the command |\pgfimage| is explained in the documentation of |pgf|. In essence, the following happens:
+\begin{itemize}
+\item
+  For old versions of |pdflatex| and for any version of |latex| together with |dvips|, the |pgf| package will look for a file named
+  \begin{quote}
+    \meta{filename}|.page|\meta{page of label name}|.|\meta{extension}
+  \end{quote}
+  For each page of your |.pdf| or |.ps| file that is to be included in this way, you must create such a file by hand. For example, if the PostScript file of your presentation version is named |main.beamer.ps| and you wish to include the slides with page numbers 2 and~3, you must create (single page) files |main.beamer.page2.ps| and |main.beamer.page3.ps| by hand'' (or using some script). If these files cannot be found, |pgf| will complain.
+\item
+  For new versions of |pdflatex|, |pdflatex| also looks for the files according to the above naming scheme. However, if it fails to find them (because you have not produced them), it uses a special mechanism to directly extract the desired page from the presentation file |main.beamer.pdf|.
+\end{itemize}
+
+
+\subsection{Details on Modes}
+\label{section-mode-details}
+
+This subsection describes how modes work exactly and how you can use the |\mode| command to control what part of your text belongs to which mode.
+
+When \beamer\ typesets your text, it is always in one of the following five modes:
+\begin{itemize}
+\item
+  \declare{|beamer|} is the default mode.
+\item
+  \declare{|second|} is the mode used when a slide for an optional second screen is being typeset.
+\item
+  \declare{|handout|} is the mode for creating handouts.
+\item
+  \declare{|trans|} is the mode for creating transparencies.
+\item
+  \declare{|article|} is the mode when control has been transferred to another class, like |article.cls|. Note that the mode is also |article| if control is transferred to, say, |book.cls|.
+\end{itemize}
+
+In addition to these modes, \beamer\ recognizes the following names for modes sets:
+
+\begin{itemize}
+\item
+  \declare{|all|} refers to all modes.
+\item
+  \declare{|presentation|} refers to the first four modes, that is, to all modes except for the |article| mode.
+\end{itemize}
+
+Depending on the current mode, you may wish to have certain text inserted only in that mode. For example, you might wish a certain frame or a certain table to be left out of your article version. In some situations, you can use the |\only| command for this purpose. However, the command |\mode|, which is described in the following, is much more powerful than |\only|.
+
+The command actually comes in three flavors,'' which only slightly differ in syntax. The first, and simplest, is the version that takes one argument. It behaves essentially the same way as |\only|.
+
+\begin{command}{\mode\sarg{mode specification}\marg{text}}
+  Causes the \meta{text} to be inserted only for the specified modes. Recall that a \meta{mode specification} is just an overlay specification in which no slides are mentioned.
+
+  The \meta{text} should not do anything fancy that involves mode switches or including other files. In particular, you should not put an |\include| command inside \meta{text}. Use the argument-free form below, instead.
+
+  \example
+\begin{verbatim}
+\mode<article>{Extra detail mentioned only in the article version.}
+
+\mode
+<beamer| trans>
+{\frame{\tableofcontents[currentsection]}}
+\end{verbatim}
+\end{command}
+
+The second flavor of the |\mode| command takes no argument. No argument'' means that it is not followed by an opening brace, but any other symbol.
+
+\begin{command}{\mode\sarg{mode specification}}
+  In the specified mode, this command actually has no effect. The interesting part is the effect in the non-specified modes: In these modes, the command causes \TeX\ to enter a kind of gobbling'' state. It will now ignore all following lines until the next line that has a sole occurrence of one of the following commands: |\mode|, |\mode*|, |\begin{document}|, |\end{document}|. Even a comment on this line will make \TeX\ skip it. Note that the line with the special commands that make \TeX\ stop gobbling may not directly follow the line where the gobbling is started. Rather, there must either be one non-empty line before the special command or at least two empty lines.
+
+  When \TeX\ encounters a single |\mode| command, it will execute this command. If the command is |\mode| command of the first flavor, \TeX\ will resume its gobbling'' state after having inserted (or not inserted) the argument of the |\mode| command. If the |\mode| command is of the second flavor, it takes over.
+
+  Using this second flavor of |\mode| is less convenient than the first, but there are different reasons why you might need to use it:
+  \begin{itemize}
+  \item
+    The line-wise gobbling is much faster than the gobble of the third flavor, explained below.
+  \item
+    The first flavor reads its argument completely. This means, it cannot contain any verbatim text that contains unbalanced braces.
+  \item
+    The first flavor cannot cope with arguments that contain |\include|.
+  \item
+    If the text mainly belongs to one mode with only small amounts of text from another mode inserted, this second flavor is nice to use.
+  \end{itemize}
+
+  \emph{Note:} When searching line-wise for a |\mode| command to shake it out of its gobbling state, \TeX\ will not recognize a |\mode| command if a mode specification follows on the same line. Thus, such a specification must be given on the next line.
+
+  \emph{Note:} When a \TeX\ file ends, \TeX\ must not be in the gobbling state. Switch this state off using |\mode| on one line and |<all>| on the next.
+
+  \example
+\begin{verbatim}
+\mode<article>
+
+This text is typeset only in |article| mode.
+\verb!verbatim text is ok {!
+
+\mode
+<presentation>
+{ % this text is inserted only in presentation mode
+\frame{\tableofcontents[currentsection]}}
+
+Here we are back to article mode stuff. This text
+is not inserted in presentation mode
+
+\mode
+<presentation>
+
+This text is only inserted in presentation mode.
+\end{verbatim}
+\end{command}
+
+The last flavor of the mode command behaves quite differently.
+
+\begin{command}{\mode\declare{|*|}}
+  The effect of this mode is to ignore all text outside frames in the |presentation| modes. In |article| mode it has no effect.
+
+  This mode should only be entered outside of frames. Once entered, if the current mode is a |presentation| mode, \TeX\ will enter a gobbling state similar to the gobbling state of the second flavor'' of the |\mode| command. The difference is that the text is now read token-wise, not line-wise. The text is gobbled token by token until one of the following tokens is found: |\mode|, |\frame|, |\againframe|, |\part|, |\section|, |\subsection|, |\appendix|, |\note|, |\begin{frame}|, and |\end{document}| (the last two are not really tokens, but they are recognized anyway).
+
+  Once one of these commands is encountered, the gobbling stops and the command is executed. However, all of these commands restore the mode that was in effect when they started. Thus, once the command is finished, \TeX\ returns to its gobbling.
+
+  Normally, |\mode*| is exactly what you want \TeX\ to do outside of frames: ignore everything except for the above-mentioned commands outside frames in |presentation| mode. However, there are  cases in which you have to use the second flavor of the |\mode| command instead: If you have verbatim text that contains one of the commands, if you have very long text outside frames, or if you wish some text outside a frame (like a definition) to be executed also in |presentation| mode.
+
+  The class option |ignorenonframetext| will switch on |\mode*| at the beginning of the document.
+
+  \example
+\begin{verbatim}
+\begin{document}
+\mode*
+
+This text is not shown in the presentation.
+
+\begin{frame}
+  This text is shown both in article and presentation mode.
+\end{frame}
+
+this text is not shown in the presentation again.
+
+\section{This command also has effect in presentation mode}
+
+Back to article stuff again.
+
+\frame<presentation>
+{ this frame is shown only in the presentation. }
+\end{document}
+\end{verbatim}
+
+  \example The following example shows how you can include other files in a main file. The contents of a |main.tex|:
+
+\begin{verbatim}
+\documentclass[ignorenonframetext]{beamer}
+\begin{document}
+This is star mode stuff.
+
+Let's include files:
+\mode<all>
+\include{a}
+\include{b}
+\mode*
+
+Back to star mode
+\end{document}
+\end{verbatim}
+
+  And |a.tex| (and likewise |b.tex|):
+
+\begin{verbatim}
+\mode*
+\section{First section}
+Extra text in article version.
+\begin{frame}
+  Some text.
+\end{frame}
+\mode<all>
+\end{verbatim}
+\end{command}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-nonpresentation.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-notes.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-notes.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,214 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2012,2013,2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+
+A \emph{note} is text that is intended as a reminder to yourself of what you should say or should keep in mind when presenting a slide. Notes are usually printed out on paper, but with two-screen support they can also be shown on your laptop screen while the main presentation is shown on the projector.
+
+
+\subsection{Specifying Note Contents}
+
+To add a note to a slide or a frame, use the |\note| command. This command can be used both inside and outside frames, but it has quite different behaviors then: Inside frames, |\note| commands accumulate and append a single note page after the current slide; outside frames each |\note| directly inserts a single note page with the given parameter as contents. Using the |\note| command inside frames is usually preferably over using them outside, since only commands issued inside frames profit from the class option |onlyslideswithnotes|, see below.
+
+Inside a frame, the effect of |\note|\meta{text} is the following: When you use it somewhere inside the frame on a specific slide, a note page is created after the slide, containing the \meta{text}. Since you can add an overlay specification to the |\note| command, you can specify after which slide the note should be shown. If you use multiple |\note| commands on one slide, they accumulate'' and are all shown on the same note.
+
+To make the accumulation of notes more convenient, you can use the |\note| command with the option |[item]|. The notes added with this option are accumulated in an |enumerate| list that follows any text inserted using |\note|.
+
+The following example will produce one note page that follows the second slide and has two entries.
+\begin{verbatim}
+\begin{frame}
+  \begin{itemize}
+  \item<1-> Eggs
+  \item<2-> Plants
+    \note[item]<2>{Make it short.}
+  \item<3-> Animals
+  \end{itemize}
+\end{frame}
+\end{verbatim}
+
+Outside frames, the command |\note| creates a single note page. It is independent'' of any usage of the |\note| commands inside the previous frame. If you say |\note| inside a frame and |\note| right after it, \emph{two} note pages are created.
+
+In the following, the syntax and effects of the |\note| command \emph{inside} frames are described:
+
+\begin{command}{\note\sarg{overlay specification}\oarg{options}\marg{note text}}
+  Effects \emph{inside} frames:
+
+  This command appends the \meta{note text} to the note that follows the current slide. Multiple uses of this command on a slide accumulate. If you do not specify an \meta{overlay specification}, the note will be added to \emph{all} slides of the current frame. This is often not what you want, so adding a specification like |<1>| is usually a good idea.
+
+  The following \meta{options} may be given:
+  \begin{itemize}
+  \item
+    \declare{|item|} causes the note to be put as an item in a list that is shown at the end of the note page.
+  \end{itemize}
+
+
+  \articlenote
+  Notes are ignored in |article| mode.
+
+\end{command}
+
+Next, the syntax and effects of the |\note| command \emph{outside} frames are described:
+
+\begin{command}{\note\oarg{options}\marg{note text}}
+  Outside frames, this command creates a note page. This command is \emph{not} affected by the option |notes=onlyframeswithnotes|, see below.
+
+  The following \meta{options} may be given:
+  \begin{itemize}
+  \item
+    \declare{|itemize|} will enclose the whole note page in an |itemize| environment. This is just a convenience.
+  \item
+    \declare{|enumerate|} will enclose the whole note page in an |enumerate| environment.
+  \end{itemize}
+
+  \example
+\begin{verbatim}
+\frame{some text}
+\note{Talk no more than 1 minute.}
+
+\note[enumerate]
+{
+\item Stress this first.
+\item Then this.
+}
+\end{verbatim}
+
+  \articlenote
+  Notes are ignored in |article| mode.
+\end{command}
+
+The following element dictates how the note pages are rendered:
+
+\begin{element}{note page}\yes\yes\yes
+  This template is used to typeset a note page.  The template should contain a mentioning of the insert |\insertnote|, which will contain the note text. To squeeze more onto note pages you might consider changing the size of the \beamer-font |note page| to something small. The default is |\small|.
+  \begin{templateoptions}
+    \itemoption{default}{}
+    The default template shows the last slide in the upper right corner and some hints'' that should help you match a note page to the slide that is currently shown.
+    \itemoption{compress}{}
+    The option produces an output that is similar to the default, only more fits onto each note page at the price of legibility.
+    \itemoption{plain}{}
+    Just inserts the note text, no fancy hints.
+  \end{templateoptions}
+  The following two inserts are useful for note pages:
+  \begin{itemize}
+    \iteminsert{\insertnote}
+    Inserts the text of the current note into the template.
+    \iteminsert{\insertslideintonotes}\marg{magnification}
+    Inserts a mini picture'' of the last slide into the current note. The slide will be scaled by the given magnification.
+
+    \example
+    |\insertslideintonotes{0.25}|
+
+    This will give a mini slide whose width and height are one fourth of the usual size.
+  \end{itemize}
+\end{element}
+
+
+\subsection{Specifying Contents for Multiple Notes}
+
+Sometimes you wish some text to be shown on every note or at least on every note in a long series of notes. To achieve this effect, you can use the following two commands:
+
+\begin{command}{\AtBeginNote\marg{text}}
+  The \meta{text} will be inserted at the beginning of every note in the scope of the command. To stop the effect, either use |\AtBeginNote{}| or enclose the area in a \TeX\ group.
+
+  It is advisable to add a |\par| command or an empty line at the end of the \meta{text} since otherwise any note text will directly follow the \meta{text} without a line break.
+
+  \example
+\begin{verbatim}
+\section{My Section}
+
+\AtBeginNote{Finish this section by 14:35.\par}
+\begin{frame}
+  ...
+  \note{some note}
+\end{frame}
+\begin{frame}
+  ...
+  \note{some other note}
+\end{frame}
+\AtBeginNote{}
+\end{verbatim}
+\end{command}
+
+\begin{command}{\AtEndNote\marg{text}}
+  This command behaves the same way as |\AtBeginNote|, except that the text is inserted at the end (bottom). You may wish to add a |\par| at the beginning of \meta{text}.
+\end{command}
+
+
+\subsection{Specifying Which Notes and Frames Are Shown}
+
+Since you normally do not wish the notes to be part of your presentation, you must explicitly say so in the preamble if notes should be included in your presentation. You can use the following \beamer\ options for this:
+
+\begin{beameroption}{hide notes}{}
+  Notes are not shown. This is the default in a presentation.
+\end{beameroption}
+
+\begin{beameroption}{show notes}{}
+  Include notes in the output file. Normal slides are also included and the note pages are interleaved with them.
+\end{beameroption}
+
+\begin{beameroption}{show notes on second screen}{|=|\meta{location}}
+  \label{command-notesonsecondscreen}
+  When this option is given, a two screen version of your talk is created, see Section~\ref{section-twoscreens} for further details. The second screen, which is displayed on the right by default, shows your notes. By   specifying a different \meta{location}, you can also place the second screen on the |left|, |bottom|, or |top|.
+
+  \example
+\begin{verbatim}
+\documentclass{beamer}
+\usepackage{pgfpages}
+\setbeameroption{show notes on second screen}
+\begin{document}
+\begin{frame}
+  A frame.
+  \note{This is shown on the right.}
+\end{frame}
+\end{document}
+\end{verbatim}
+
+  In detail, the following happens: The presentation is typeset normally and shown on the main screen or, to be precise, on |pgfpages|'s logical page number zero. The second screen (logical screen number one) is initialized to be empty.
+
+  Whenever a note page is to be typeset, either because a frame contained |\note| commands or because the frame was followed by a |\note| command, the note page is normally typeset. Then the note page is put on the second screen. Then the whole page is shipped out. (The exact details are bit more complex, but that is what happens, basically.)
+
+  An important effect of this behavior is that a note page \emph{following} a frame is shown next to this frame. Normally, this is exactly what you want and expect. However, if there are multiple note pages for a single slide only the last one is shown, currently. This may change in the future, so do not rely on this effect.
+
+  \example
+\begin{verbatim}
+\begin{frame}
+  First frame.
+\end{frame}
+\note{This note is not shown at all (currently).}
+\note{This note is shown together with the first frame.}
+
+\begin{frame}
+  Second frame.
+  \note{This note is shown together with the second frame.}
+\end{frame}
+
+\begin{frame}
+  No note text is shown for this frame.
+\end{frame}
+\end{verbatim}
+
+  If you really need multiple note pages for a single slide, you will have to use something more complicated like this:
+\begin{verbatim}
+\begin{frame}<1-3>
+  First frame.
+  \note<1>{First page of notes for this frame.}
+  \note<2>{Second page of notes for this frame.}
+  \note<3>{Third page of notes for this frame.}
+\end{frame}
+\end{verbatim}
+\end{beameroption}
+
+
+\begin{beameroption}{show only notes}{}
+  Include only the notes in the output file and suppresses all frames. This options is useful for printing them. If you specify this command, the |.aux| and |.toc| files are \emph{not} updated. So, if you add a section and re\TeX\ your presentation, this will not be reflected in the navigation bars (which you do not see anyway since only notes are output).
+\end{beameroption}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-notes.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-overlays.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-overlays.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,776 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2011--2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\section{Creating Overlays}
+\label{section-overlay}
+
+
+\subsection{The Pause Commands}
+
+The |pause| command offers an easy, but not very flexible way of creating frames that are uncovered piecewise. If you say |\pause| somewhere in a frame, only the text on the frame up to the |\pause| command is shown on the first slide. On the second slide, everything is shown up to the second |\pause|, and so forth. You can also use |\pause| inside environments; its effect will last after the environment. However, taking this to extremes and using |\pause| deeply within a nested environment may not have the desired result.
+
+A much more fine-grained control over what is shown on each slide can be attained using overlay specifications, see the next sections. However, for many simple cases the |\pause| command is sufficient.
+
+The effect of |\pause| lasts till the next |\pause|, |\onslide|, or the end of the frame.
+\begin{verbatim}
+\begin{frame}
+  \begin{itemize}
+  \item
+    Shown from first slide on.
+  \pause
+  \item
+    Shown from second slide on.
+    \begin{itemize}
+    \item
+      Shown from second slide on.
+    \pause
+    \item
+      Shown from third slide on.
+    \end{itemize}
+  \item
+    Shown from third slide on.
+  \pause
+  \item
+    Shown from fourth slide on.
+  \end{itemize}
+
+  Shown from fourth slide on.
+
+  \begin{itemize}
+  \onslide
+  \item
+    Shown from first slide on.
+  \pause
+  \item
+    Shown from fifth slide on.
+  \end{itemize}
+\end{frame}
+\end{verbatim}
+
+\begin{command}{\pause\oarg{number}}
+  This command causes the text following it to be shown only from the next slide on, or, if the optional \meta{number} is given, from the slide with the number \meta{number}. If the optional \meta{number} is given, the counter |beamerpauses| is set to this number. This command uses the |\onslide| command, internally. This command does \emph{not} work inside |amsmath| environments like |align|, since these do really wicked things.
+
+  \example
+\begin{verbatim}
+\begin{frame}
+  \begin{itemize}
+  \item
+    A
+  \pause
+  \item
+    B
+  \pause
+  \item
+    C
+  \end{itemize}
+\end{frame}
+\end{verbatim}
+
+  \articlenote
+  This command is ignored.
+
+\end{command}
+
+To unpause'' some text, that is, to temporarily suspend pausing, use the command |\onslide|, see below.
+
+
+\subsection{The General Concept of Overlay Specifications}
+\label{section-concept-overlays}
+
+The approach taken by most presentation classes to overlays is somewhat similar to the above |\pause| command. These commands get a certain slide number as input and affect the text on the slide following this command in a certain way. For example, \textsc{prosper}'s |\FromSlide{2}| command causes all text following this command to be shown only from the second slide on.
+
+The \beamer\ class uses a different approach (though the abovementioned command is also available: |\onslide<2->| will have the same effect as |\FromSlide{2}|, except that |\onslide| transcends environments; likewise, |\pause| is internally mapped to a command with an appropriate overlay specification). The idea is to add \emph{overlay specifications} to certain commands. These specifications are always given in pointed brackets and follow the command as soon as possible,'' though in certain cases \beamer\ also allows overlay specification to be given a little later. In the simplest case, the specification contains just a number. A command with an overlay specification following it will only have effect'' on the slide(s) mentioned in the specification. What exactly having an effect'' means, depends on the command. Consider the following example.
+\begin{verbatim}
+\begin{frame}
+  \textbf{This line is bold on all three slides.}
+  \textbf<2>{This line is bold only on the second slide.}
+  \textbf<3>{This line is bold only on the third slide.}
+\end{frame}
+\end{verbatim}
+
+For the command |\textbf|, the overlay specification causes the text to be set in boldface only on the specified slides. On all other slides, the text is set in a normal font.
+
+For a second example, consider the following frame:
+\begin{verbatim}
+\begin{frame}
+  \only<1>{This line is inserted only on slide 1.}
+  \only<2>{This line is inserted only on slide 2.}
+\end{frame}
+\end{verbatim}
+
+The command |\only|, which is introduced by \beamer, normally simply inserts its parameter into the current frame. However, if an overlay specification is present, it throws away'' its parameter on slides that are not mentioned.
+
+Overlay specifications can only be written behind certain commands, not every command. Which commands you can use and which effects this will have is explained in the next section. However, it is quite easy to redefine an existing command such that it becomes overlay specification aware,'' see also Section~\ref{section-overlay-commands}.
+
+The syntax of (basic) overlay specifications is the following: They are comma-separated lists of slides and ranges. Ranges are specified like this: |2-5|, which means slide two through to five. The start or the end of a range can be omitted. For example, |3-| means slides three, four, five, and so on'' and |-5| means the same as |1-5|. A complicated example is |-3,6-8,10,12-15|, which selects the slides 1, 2, 3, 6, 7, 8, 10, 12, 13, 14, and 15.
+
+
+\subsection{Commands with Overlay Specifications}
+\label{section-overlay-commands}
+
+\textbf{Important:} Due to the way overlay specifications are implemented, the
+commands documented here are \emph{all} fragile even if the \LaTeXe{} kernel
+versions are not.
+
+For the following commands, adding an overlay specification causes the command to be simply ignored on slides that are not included in the specification: |\textbf|, |\textit|, |\textsl|, |\textrm|, |\textsf|, |\color|, |\alert|, |\structure|. If a command takes several arguments, like |\color|, the specification should directly follow the command as in the following example (but there are exceptions to this rule):
+\begin{verbatim}
+\begin{frame}
+  \color<2-3>[rgb]{1,0,0} This text is red on slides 2 and 3, otherwise black.
+\end{frame}
+\end{verbatim}
+
+For the following commands, the effect of an overlay specification is special:
+
+\begin{command}{\onslide\opt{\meta{modifier}}\sarg{overlay specification}\opt{\marg{text}}}
+  The behavior of this command depends on whether the optional argument \meta{text} is given or not (note that the optional argument is given in \emph{normal} braces, not in square brackets). If present, the \meta{modifier} can be either a~|+| or a~|*|.
+
+  If no \meta{text} is given, the following happens: All text following this command will only be shown  (uncovered) on the specified slides. On non-specified slides, the text still occupies space. If no slides are specified, the following text is always shown. You need not call this command in the same \TeX\ group, its effect transcends block groups. However, this command has a \emph{different} effect inside an |overprint| environment, see the description of |overprint|.
+
+  If the \meta{modifier} is |+|, hidden text will not be treated as covered, but as invisible. The difference is the same as the difference between |\uncover| and |\visible|. The modifier |*| may not be given if no \meta{text} argument is present.
+
+  \example
+\begin{verbatim}
+\begin{frame}
+  Shown on first slide.
+  \onslide<2-3>
+  Shown on second and third slide.
+  \begin{itemize}
+  \item
+    Still shown on the second and third slide.
+  \onslide+<4->
+  \item
+    Shown from slide 4 on.
+  \end{itemize}
+  Shown from slide 4 on.
+  \onslide
+  Shown on all slides.
+\end{frame}
+\end{verbatim}
+
+  If a \meta{text} argument is present, |\onslide| (without a \meta{modifier}) is mapped to |\uncover|, |\onslide+| is mapped to |\visible|, and |\onslide*| is mapped to |\only|.
+
+  \example
+\begin{verbatim}
+\begin{frame}
+  \onslide<1>{Same effect as the following command.}
+  \uncover<1>{Same effect as the previous command.}
+
+  \onslide+<2>{Same effect as the following command.}
+  \visible<2>{Same effect as the previous command.}
+
+  \onslide*<3>{Same effect as the following command.}
+  \only<3>{Same effect as the previous command.}
+\end{frame}
+\end{verbatim}
+\end{command}
+
+\begin{command}{\only\sarg{overlay specification}\marg{text}\sarg{overlay specification}}
+  If either \meta{overlay specification} is present (though only one may be present), the \meta{text} is inserted only into the specified slides. For other slides, the text is simply thrown away. In particular, it occupies no space.
+
+  \example
+  |\only<3->{Text inserted from slide 3 on.}|
+
+  Since the overlay specification may also be given after the text, you can often use |\only| to make other commands overlay specification-aware in a simple manner:
+
+  \example
+\begin{verbatim}
+\newcommand{\myblue}{\only{\color{blue}}}
+\begin{frame}
+  \myblue<2> This text is blue only on slide 2.
+\end{frame}
+\end{verbatim}
+\end{command}
+
+\begin{command}{\uncover\sarg{overlay specification}\marg{text}}
+  If the \meta{overlay specification} is present, the \meta{text} is shown (uncovered'') only on the specified slides. On other slides, the text still occupies space and it is still typeset, but it is not shown or only shown as if transparent. For details on how to specify whether the text is invisible or just transparent see Section~\ref{section-transparent}.
+
+  \example
+  |\uncover<3->{Text shown from slide 3 on.}|
+
+  \articlenote
+  This command has the same effect as |\only|.
+\end{command}
+
+\begin{command}{\visible\sarg{overlay specification}\marg{text}}
+  This command does almost the same as |\uncover|. The only difference is that if the text is not shown, it is never shown in a transparent way, but rather it is not shown at all. Thus, for this command the transparency settings have no effect.
+
+  \example
+  |\visible<2->{Text shown from slide 2 on.}|
+
+  \articlenote
+  This command has the same effect as |\only|.
+\end{command}
+
+\begin{command}{\invisible\sarg{overlay specification}\marg{text}}
+  This command is the opposite of |\visible|.
+
+  \example
+  |\invisible<-2>{Text shown from slide 3 on.}|
+\end{command}
+
+\begin{command}{\alt\sarg{overlay specification}\marg{default text}\marg{alternative text}\sarg{overlay specification}}
+  Only one \meta{overlay specification} may be given. The default text is shown on the specified slides, otherwise the alternative text. The specification must always be present.
+
+  \example
+  |\alt<2>{On Slide 2}{Not on slide 2.}|
+
+  Once more, giving the overlay specification at the end is useful when the command is used inside other commands.
+
+  \example
+  Here is the definition of |\uncover|:
+\begin{verbatim}
+\newcommand{\uncover}{\alt{\@firstofone}{\makeinvisible}}
+\end{verbatim}
+\end{command}
+
+\begin{command}{\temporal\ssarg{overlay specification}\marg{before slide text}\marg{default text}\marg{after slide text}}
+  This command alternates between three different texts, depending on whether the current slide is temporally before the specified slides, is one of the specified slides, or comes after them. If the \meta{overlay specification} is not an interval (that is, if it has a hole''), the hole'' is considered to be part of the before slides.
+
+  \example
+\begin{verbatim}
+  \temporal<3-4>{Shown on 1, 2}{Shown on 3, 4}{Shown 5, 6, 7, ...}
+  \temporal<3,5>{Shown on 1, 2, 4}{Shown on 3, 5}{Shown 6, 7, 8, ...}
+\end{verbatim}
+
+  As a possible application of the |\temporal| command consider the following example:
+
+  \example
+\begin{verbatim}
+\def\colorize<#1>{%
+  \temporal<#1>{\color{red!50}}{\color{black}}{\color{black!50}}}
+
+\begin{frame}
+  \begin{itemize}
+    \colorize<1> \item First item.
+    \colorize<2> \item Second item.
+    \colorize<3> \item Third item.
+    \colorize<4> \item Fourth item.
+  \end{itemize}
+\end{frame}
+\end{verbatim}
+\end{command}
+
+
+  \beamernote
+  Only one \meta{alert specification} may be given. The effect of \meta{alert specification} is described in Section~\ref{section-action-specifications}.
+
+  \example
+\begin{verbatim}
+\begin{frame}
+  \begin{itemize}
+  \item<1-> First point, shown on all slides.
+  \item<2-> Second point, shown on slide 2 and later.
+  \item<2-> Third point, also shown on slide 2 and later.
+  \item<3-> Fourth point, shown on slide 3.
+  \end{itemize}
+\end{frame}
+
+\begin{frame}
+  \begin{enumerate}
+  \item<3-| alert at 3>[0.] A zeroth point, shown at the very end.
+  \item<1-| alert at 1> The first and main point.
+  \item<2-| alert at 2> The second point.
+  \end{enumerate}
+\end{frame}
+\end{verbatim}
+
+  \articlenote
+  The \meta{action specification} is currently completely ignored.
+
+\end{command}
+
+The related command |\bibitem| is also overlay specification-aware in the same way as |\item|.
+
+\begin{command}{\label\sarg{overlay specification}\marg{label name}}
+  If the \meta{overlay specification} is present, the label is only inserted on the specified slide. Inserting a label on more than one slide will cause a multiple labels' warning. \emph{However}, if no overlay specification is present, the specification is automatically set to just 1' and the label is thus inserted only on the first slide. This is typically the desired behavior since it does not really matter on which slide the label is inserted, \emph{except} if you use an |\only| command and \emph{except} if you wish to use that label as a hyperjump target. Then you need to specify a slide.
+
+  Labels can be used as target of hyperjumps. A convenient way of labelling a frame is to use the |label=|\meta{name} option of the |frame| environment. However, this will cause the whole frame to be kept in memory till the end of the compilation, which may pose a problem.
+
+  \example
+\begin{verbatim}
+\begin{frame}
+  \begin{align}
+    a &= b + c   \label{first}\\ % no specification needed
+    c &= d + e   \label{second}\\% no specification needed
+  \end{align}
+
+  Blah blah, \uncover<2>{more blah blah.}
+
+  \only<3>{Specification is needed now.\label<3>{mylabel}}
+\end{frame}
+\end{verbatim}
+\end{command}
+
+
+\subsection{Environments with Overlay Specifications}
+
+Environments can also be equipped with overlay specifications. For most of the predefined environments, see Section~\ref{predefined}, adding an overlay specification causes the whole environment to be uncovered only on the specified slides. This is useful for showing things incrementally as in the following example.
+\begin{verbatim}
+\begin{frame}
+  \frametitle{A Theorem on Infinite Sets}
+
+  \begin{theorem}<1->
+    There exists an infinite set.
+  \end{theorem}
+
+  \begin{proof}<3->
+    This follows from the axiom of infinity.
+  \end{proof}
+
+  \begin{example}<2->
+    The set of natural numbers is infinite.
+  \end{example}
+\end{frame}
+\end{verbatim}
+
+In the example, the first slide only contains the theorem, on the second slide an example is added, and on the third slide the proof is also shown.
+
+For each of the basic commands |\only|, |\alt|, |\visible|, |\uncover|, and |\invisible| there exists environment versions'' |onlyenv|, |altenv|, |visibleenv|, |uncoverenv|, and |invisibleenv|. Except for |altenv| and |onlyenv|, these environments do the same as the commands.
+
+\begin{environment}{{onlyenv}\sarg{overlay specification}}
+  If the \meta{overlay specification} is given, the contents of the environment is inserted into the text only on the specified slides. The difference to |\only| is, that the text is actually typeset inside a box that is then thrown away, whereas |\only| immediately throws away its contents. If the text is not typesettable,'' the |onlyenv| may produce an error where |\only| would not.
+
+  \example
+\begin{verbatim}
+\begin{frame}
+  This line is always shown.
+  \begin{onlyenv}<2>
+    This line is inserted on slide 2.
+  \end{onlyenv}
+\end{frame}
+\end{verbatim}
+\end{environment}
+
+\begin{environment}{{altenv}\sarg{overlay specification}\marg{begin text}\marg{end text}\marg{alternate begin text}\marg{alternate end text}\sarg{overlay specification}}
+  Only one \meta{overlay specification} may be given. On the specified slides, \meta{begin text} will be inserted at the beginning of the environment and \meta{end text} will be inserted at the end. On all other slides, \meta{alternate begin text} and \meta{alternate end text} will be used.
+
+  \example
+\begin{verbatim}
+\begin{frame}
+  This
+  \begin{altenv}<2>{(}{)}{[}{]}
+    word
+  \end{altenv}
+  is in round brackets on slide 2 and in square brackets on slide 1.
+\end{frame}
+\end{verbatim}
+\end{environment}
+
+
+\subsection{Dynamically Changing Text or Images}
+
+You may sometimes wish to have some part of a frame change dynamically from slide to slide. On each slide of the frame, something different should be shown inside this area. You could achieve the effect of dynamically changing text by giving a list of |\only| commands like this:
+\begin{verbatim}
+  \only<1>{Initial text.}
+  \only<2>{Replaced by this on second slide.}
+  \only<3>{Replaced again by this on third slide.}
+\end{verbatim}
+
+The trouble with this approach is that it may lead to slight, but annoying differences in the heights of the lines, which may cause the whole frame to wobble'' from slide to slide. This problem becomes much more severe if the replacement text is several lines long.
+
+To solve this problem, you can use two environments: |overlayarea| and |overprint|. The first is more flexible, but less user-friendly.
+
+\begin{environment}{{overlayarea}\marg{area width}\marg{area height}}
+  Everything within the environment will be placed in a rectangular area of the specified size. The area will have the same size on all slides of a frame, regardless of its actual contents.
+
+  \example
+\begin{verbatim}
+\begin{overlayarea}{\textwidth}{3cm}
+  \only<1>{Some text for the first slide.\\Possibly several lines long.}
+  \only<2>{Replacement on the second slide.}
+\end{overlayarea}
+\end{verbatim}
+
+\end{environment}
+
+\begin{environment}{{overprint}\oarg{area width}}
+  The \meta{area width} defaults to the text width. Inside the environment, use |\onslide| commands to specify different things that should be shown for this environment on different slides. The |\onslide| commands are used like |\item| commands. Everything within the environment will be placed in a rectangular area of the specified width. The height and depth of the area are chosen large enough to accommodate the largest contents of the area. The overlay specifications of the |\onslide| commands must be disjoint. This may be a problem for handouts, since, there, all overlay specifications default to |1|. If you use the option |handout|, you can disable all but one |\onslide| by setting the others to |0|.
+
+  \example
+\begin{verbatim}
+\begin{overprint}
+  \onslide<1| handout:1>
+    Some text for the first slide.\\
+    Possibly several lines long.
+  \onslide<2| handout:0>
+    Replacement on the second slide. Supressed for handout.
+\end{overprint}
+\end{verbatim}
+
+\end{environment}
+
+A similar need for dynamical changes arises when you have, say, a series of pictures named |first.pdf|, |second.pdf|, and |third.pdf| that show different stages of some process. To make a frame that shows these pictures on different slides, the following code might be used:
+\begin{verbatim}
+\begin{frame}
+  \frametitle{The Three Process Stages}
+
+  \includegraphics<1>{first.pdf}
+  \includegraphics<2>{second.pdf}
+  \includegraphics<3>{third.pdf}
+\end{frame}
+\end{verbatim}
+
+The above code uses the fact the \beamer\ makes the |\includegraphics| command overlay specification-aware. It works nicely, but only if each |.pdf| file contains the complete graphic to be shown. However, some programs, like |xfig|, sometimes also produce series of graphics in which each file just contains the \emph{additional} graphic elements to be shown on the next slide. In this case, the first graphic must be shown not on overlay~1, but from overlay~1 on, and so on. While this is easy to achieve by changing the overlay specification |<1>| to |<1->|, the graphics must also be shown \emph{on top of each other}. An easy way to achieve this is to use \TeX's |\llap| command like this:
+\begin{verbatim}
+\begin{frame}
+  \frametitle{The Three Process Stages}
+
+  \includegraphics<1->{first.pdf}%
+  \llap{\includegraphics<2->{second.pdf}}%
+  \llap{\includegraphics<3->{third.pdf}}
+\end{frame}
+\end{verbatim}
+
+or like this:
+\begin{verbatim}
+\begin{frame}
+  \frametitle{The Three Process Stages}
+
+  \includegraphics{first.pdf}%
+  \pause%
+  \llap{\includegraphics{second.pdf}}%
+  \pause%
+  \llap{\includegraphics{third.pdf}}
+\end{frame}
+\end{verbatim}
+
+A more convenient way is to use the |\multiinclude| command, see Section~\ref{section-xmpmulti} for details.
+
+
+
+\subsubsection{Making Commands and Environments Overlay Specification-Aware}
+
+This section explains how to define new commands that are overlay specification-aware. Also, it explains how to setup counters correctly that should be increased from frame to frame (like equation numbering), but not from slide to slide. You may wish to skip this section, unless you  want to write your own extensions to the \beamer\ class.
+
+\beamer\ extends the syntax of \LaTeX's standard command |\newcommand|:
+
+\begin{command}{\newcommand\declare{|<>|}\marg{command name}\oarg{argument number}\oarg{default optional value}\marg{text}}
+  Declares the new command named \meta{command name}. The \meta{text} should contain the body of this command and it may contain occurrences of parameters like |#|\meta{number}. Here \meta{number} may be between 1 and $\mbox{\meta{argument number}}+1$. The additionally allowed argument is the overlay specification.
+
+  When \meta{command name} is used, it will scan as many as \meta{argument number} arguments. While scanning them, it will look for an overlay specification, which may be given between any two arguments, before the first argument, or after the last argument. If it finds an overlay specification like |<3>|, it will call \meta{text} with arguments 1 to \meta{argument number} set to the normal arguments and the argument number $\mbox{\meta{argument number}}+1$ set to |<3>| (including the pointed brackets). If no overlay specification is found, the extra argument is empty.
+
+  If the \meta{default optional value} is provided, the first argument of \meta{command name} is optional. If no optional argument is specified in square brackets, the \meta{default optional value} is used.
+
+  \example
+  The following command will typeset its argument in red on the specified slides:
+\begin{verbatim}
+\newcommand<>{\makered}[1]{{\color#2{red}#1}}
+\end{verbatim}
+
+  \example
+  Here is \beamer's definition of |\emph|:
+\begin{verbatim}
+\newcommand<>{\emph}[1]{{\only#2{\itshape}#1}}
+\end{verbatim}
+
+  \example
+  Here is \beamer's definition of |\transdissolve| (the command |\beamer at dotrans| mainly passes its argument to |hyperref|):
+\begin{verbatim}
+\newcommand<>{\transdissolve}[1][]{\only#2{\beamer at dotrans[#1]{Dissolve}}}
+\end{verbatim}
+\end{command}
+
+\begin{command}{\renewcommand\declare{|<>|}\marg{existing command name}\oarg{argument number}\oarg{default optional value}\marg{text}}
+  Redeclares a command that already exists in the same way as |\newcommand<>|. Inside \meta{text}, you can still access to original definitions using the command |\beameroriginal|, see the example.
+
+  \example
+  This command is used in \beamer\ to make |\hyperlink| overlay specification-aware:
+\begin{verbatim}
+\end{verbatim}
+\end{command}
+
+\begin{command}{\newenvironment\declare{|<>|}\marg{environment name}\oarg{argument number}\oarg{default optional value}\\ \marg{begin text}\marg{end text}}
+  Declares a new environment that is overlay specification-aware. If this environment is encountered, the same algorithm as for |\newcommand<>| is used to parse the arguments and the overlay specification.
+
+  Note that, as always, the \meta{end text} may not contain any arguments like |#1|. In particular, you do not have access to the overlay specification. In this case, it is usually a good idea to use |altenv| environment in the \meta{begin text}.
+
+  \example
+  Declare your own action block:
+\begin{verbatim}
+\newenvironment<>{myboldblock}[1]{%
+  \begin{actionenv}#2%
+    \textbf{#1}
+    \par}
+  {\par%
+  \end{actionenv}}
+
+\begin{frame}
+  \begin{myboldblock}<2>
+    This theorem is shown only on the second slide.
+  \end{myboldblock}
+\end{frame}
+\end{verbatim}
+
+  \example
+  Text in the following environment is normally bold and italic on non-specified slides:
+\begin{verbatim}
+\newenvironment<>{boldornormal}
+  {\begin{altenv}#1
+    {\begin{bfseries}}{\end{bfseries}}
+    {}{}}
+  {\end{altenv}}
+\end{verbatim}
+
+  Incidentally, since |altenv| also accepts its argument at the end, the same effect could have been achieved using just
+\begin{verbatim}
+\newenvironment{boldornormal}
+  {\begin{altenv}
+    {\begin{bfseries}}{\end{bfseries}}
+    {}{}}
+  {\end{altenv}}
+\end{verbatim}
+\end{command}
+
+\begin{command}{\renewenvironment\declare{|<>|}\marg{existing environment name}\oarg{argument number}\oarg{default optional value}\\ \marg{begin text}\marg{end text}}
+  Redefines an existing environment. The original environment is still available under the name |original|\meta{existing environment name}.
+
+  \example
+\begin{verbatim}
+\renewenvironment<>{verse}
+{\begin{actionenv}#1\begin{originalverse}}
+{\end{originalverse}\end{actionenv}}
+\end{verbatim}
+\end{command}
+
+The following two commands can be used to ensure that a certain counter is automatically reset on subsequent slides of a frame. This is necessary for example for the equation count. You might want this count to be increased from frame to frame, but certainly not from overlay slide to overlay slide. For equation counters and footnote counters (you should not use footnotes), these commands have already been invoked.
+
+\begin{command}{\resetcounteronoverlays\marg{counter name}}
+  After you have invoked this command, the value of the specified counter will be the same on all slides of every frame.
+  \example
+  |\resetcounteronoverlays{equation}|
+\end{command}
+
+\begin{command}{\resetcountonoverlays\marg{count register name}}
+  The same as |\resetcounteronoverlays|, except that this command should be used with counts that have been created using the \TeX\ primitive |\newcount| instead of \LaTeX's |\definecounter|.
+  \example
+\begin{verbatim}
+\newcount\mycount
+\resetcountonoverlays{mycount}
+\end{verbatim}
+\end{command}
+
+\subsubsection{Mode Specifications}
+
+This section is only important if you use \beamer's mode mechanism to create different versions of your presentation. If you are not familiar with \beamer's modes, please skip this section or read Section~\ref{section-modes} first.
+
+In certain cases you may wish to have different overlay specifications to apply to a command in different modes. For example, you might wish a certain text to appear only from the third slide on during your presentation, but in a handout for the audience there should be no third slide and the text should appear already on the second slide. In this case you could write
+\begin{verbatim}
+\only<3| handout:2>{Some text}
+\end{verbatim}
+
+The vertical bar separates the two different specifications |3| and |handout:2|. By writing a mode name before a colon, you specify that the following specification only applies to that mode. If no mode is given, as in |3|, the mode |beamer| is automatically added. For this reason, if you write |\only<3>{Text}| and you are in |handout| mode, the text will be shown on all slides since there is no restriction specified for handouts and since the |3| is the same as |beamer:3|.
+
+It is also possible to give an overlay specification that contains only a mode name (or several, separated by vertical bars):
+\begin{verbatim}
+\only<article>{This text is shown only in article mode.}
+\end{verbatim}
+
+An overlay specification that does not contain any slide numbers is called a (pure) \emph{mode specification}. If a mode specification is given, all modes that are not mentioned are automatically suppressed. Thus |<beamer:1->| means on all slides in |beamer| mode and also on all slides in all other modes, since nothing special is specified for them,'' whereas |<beamer>| means on all slides in |beamer| mode and not on any other slide.''
+
+Mode specifications can also be used outside frames as in the following examples:
+\begin{verbatim}
+\section<presentation>{This section exists only in the presentation modes}
+\section<article>{This section exists only in the article mode}
+\end{verbatim}
+
+Presentation modes include |beamer|, |trans| and |handout|.
+
+You can also mix pure mode specifications and overlay specifications, although this can get confusing:
+\begin{verbatim}
+\only<article| beamer:1>{Riddle}
+\end{verbatim}
+
+This will cause the text |Riddle| to be inserted in |article| mode and on the first slide of a frame in |beamer| mode, but not at all in |handout| or |trans| mode. (Try to find out how \verb/<beamer| beamer:1>/ differs from |<beamer>| and from |<beamer:1>|.)
+
+As if all this were not already complicated enough, there is another mode that behaves in a special way: the mode |second|. For this mode a special rule applies: An overlay specification for mode |beamer| also applies to mode |second| (but not the other way round). Thus, if we are in mode |second|, the specification |<second:2>| means on slide 2'' and |<beamer:2>| also means on slide 2''. To get a slide that is typeset in |beamer| mode, but not in |second| mode, you can use, |<second:0>|.
+
+\subsubsection{Action Specifications}
+\label{section-action-specifications}
+
+This section also introduces a rather advanced concept. You may also wish to skip it on first reading.
+
+Some overlay specification-aware commands cannot handle not only normal overlay specifications, but also so called \emph{action specifications}. In an action specification, the list of slide numbers and ranges is prefixed by \meta{action}|@|, where \meta{action} is the name of a certain action to be taken on the specified slides:
+\begin{verbatim}
+\item<3-| alert at 3> Shown from slide 3 on, alerted on slide 3.
+\end{verbatim}
+
+In the above example, the |\item| command, which allows actions to be specified, will uncover the item text from slide three on and it will, additionally, alert this item exactly on slide 3.
+
+Not all commands can take an action specification. Currently, only |\item| (though not in |article| mode currently), |\action|, the environment |actionenv|, and the block environments (like |block| or |theorem|) handle them.
+
+By default, the following actions are available:
+\begin{itemize}
+\item \declare{|alert|} alters the item or block.
+\item \declare{|uncover|} uncovers the item or block (this is the default, if no action is specified).
+\item \declare{|only|} causes the whole item or block to be inserted only on the specified slides.
+\item \declare{|visible|} causes the text to become visible only on the specified slides (the difference between |uncover| and |visible| is the same as between |\uncover| and |\visible|).
+\item \declare{|invisible|} causes the text to become invisible on the specified slides.
+\end{itemize}
+
+The rest of this section explains how you can add your own actions and make commands action-specification-aware. You may wish to skip it upon first reading.
+
+You can easily add your own actions: An action specification like \meta{action}|@|\meta{slide numbers} simply inserts an environment called \meta{action}|env| around the |\item| or parameter of |\action| with |<|\meta{slide numbers}|>| as overlay specification. Thus, by defining a new overlay specification-aware environment named \meta{my action name}|env|, you can add your own action:
+\begin{verbatim}
+\newenvironment{checkenv}{\only{\setbeamertemplate{itemize item}{X}}}{}
+\end{verbatim}
+
+You can then write
+\begin{verbatim}
+\item<beamer:check at 2> Text.
+\end{verbatim}
+
+This will change the itemization symbol before |Text.| to |X| on slide~2 in |beamer| mode. The definition of |checkenv| used the fact that |\only| also accepts an overlay specification given after its argument.
+
+The whole action mechanism is based on the following environment:
+
+\begin{environment}{{actionenv}\sarg{action specification}}
+  This environment extracts all actions from the \meta{action specification} for the current mode. For each action of the form \meta{action}|@|\meta{slide numbers}, it inserts the following text: |\begin{|\meta{action}|env}<|\meta{slide number}|>| at the beginning of the environment and the text |\end{|\meta{action}|env}| at the end. If there are several action specifications, several environments are opened (and closed in the appropriate order). An \meta{overlay specification} without an action is promoted to |uncover@|\meta{overlay specification}.
+
+  If the so called \emph{default overlay specification} is not empty, it will be used in case no \meta{action specification} is given. The default overlay specification is usually just empty, but it may be set either by providing an additional optional argument to the command |\frame| or to the environments |itemize|, |enumerate|, or |description| (see these for details). Also, the default action specification can be set using the command |\beamerdefaultoverlayspecification|, see below.
+
+  \example
+\begin{verbatim}
+\begin{frame}
+    This text is shown the same way as the text below.
+  \end{actionenv}
+
+  \begin{uncoverenv}<2->
+      This text is shown the same way as the text above.
+  \end{uncoverenv}
+\end{frame}
+\end{verbatim}
+\end{environment}
+
+\begin{command}{\action\sarg{action specification}\marg{text}}
+  This has the same effect as putting \meta{text} in an |actionenv|.
+
+  \example
+  |\action<alert at 2>{Could also have used \texttt{\string\alert<2>\char\{\char\}}.}|
+\end{command}
+
+\begin{command}{\beamerdefaultoverlayspecification\marg{default overlay specification}}
+  Locally sets the default overlay specification to the given value. This overlay specification will be used in every |actionenv| environment and every |\item| that does not have its own overlay specification. The main use of this command is to install an incremental overlay specification like |<+->| or \verb/<+-| alert at +>/, see Section~\ref{section-incremental}.
+
+  Usually, the default overlay specification is installed automatically by the optional arguments to |\frame|, |frame|, |itemize|, |enumerate|, and |description|. You will only have to use this command if you wish to do funny things.
+
+  If given outside any frame, this command sets the default overlay specification for all following frames for which you do not override the default overlay specification.
+
+  \example
+  |\beamerdefaultoverlayspecification{<+->}|
+
+  \example
+  |\beamerdefaultoverlayspecification{}| clears the default overlay specification. (Actually, it installs the default overlay specification |<*>|, which just means always,'' but the portable'' way of clearing the default overlay specification is this call.)
+\end{command}
+
+\subsubsection{Incremental Specifications}
+\label{section-incremental}
+
+This section is mostly important for people who have already used overlay specifications a lot and have grown tired of writing things like |<1->|, |<2->|, |<3->|, and so on again and again. You should skip this section on first reading.
+
+Often you want to have overlay specifications that follow a pattern similar to the following:
+\begin{verbatim}
+\begin{itemize}
+\item<1-> Apple
+\item<2-> Peach
+\item<3-> Plum
+\item<4-> Orange
+\end{itemize}
+\end{verbatim}
+
+The problem starts if you decide to insert a new fruit, say, at the beginning. In this case, you would have to adjust all of the overlay specifications. Also, if you add a |\pause| command before the |itemize|, you would also have to update the overlay specifications.
+
+\beamer\ offers a special syntax to make creating lists as the one above more robust.'' You can replace it by the following list of \emph{incremental overlay specifications}:
+\begin{verbatim}
+\begin{itemize}
+\item<+-> Apple
+\item<+-> Peach
+\item<+-> Plum
+\item<+-> Orange
+\end{itemize}
+\end{verbatim}
+
+The effect of the |+|-sign is the following: You can use it in any overlay specification at any point where you would usually use a number. If a |+|-sign is encountered, it is replaced by the current value of the \LaTeX\ counter |beamerpauses|, which is 1 at the beginning of the frame. Then the counter is increased by 1, though it is only increased once for every overlay specification, even if the specification contains multiple |+|-signs (they are replaced by the same number).
+
+In the above example, the first specification is replaced by |<1->|. Then the second is replaced by |<2->| and so forth. We can now easily insert new entries, without having to change anything else. We might also write the following:
+\begin{verbatim}
+\begin{itemize}
+\end{itemize}
+\end{verbatim}
+
+This will alert the current item when it is uncovered. For example, the first specification \verb/<+-| alert at +>/ is replaced by \verb/<1-| alert at 1>/, the second is replaced by \verb/<2-| alert at 2>/, and so on. Since the |itemize| environment also allows you to specify a default overlay specification, see the documentation of that environment, the above example can be written even more economically as follows:
+\begin{verbatim}
+\item Apple
+\item Peach
+\item Plum
+\item Orange
+\end{itemize}
+\end{verbatim}
+
+The |\pause| command also updates the counter |beamerpauses|. You can change this counter yourself using the normal \LaTeX\ commands |\setcounter| or |\addtocounter|.
+
+Any occurence of a |+|-sign may be followed by an
+\emph{offset} in round brackets. This offset will
+be added to the value of |beamerpauses|. Thus, if
+|beamerpauses| is 2, then |<+(1)->| expands to
+|<3->| and |<+(-1)-+>| expands to |<1-2>|. For example
+\begin{verbatim}
+\begin{frame}
+\frametitle{Method 1}
+\begin{itemize}
+\item<2-> Apple
+\item<3-> Peach
+\item<4-> Plum
+\item<5-> Orange
+\end{itemize}
+\end{verbatim}
+and
+\begin{verbatim}
+\begin{itemize}[<+(1)->]
+\item Apple
+\item Peach
+\item Plum
+\item Orange
+\end{itemize}
+\end{verbatim}
+are equivalent.
+
+There is another special sign you can use in an overlay specification that behaves similarly to the |+|-sign: a dot. When you write |<.->|, a similar thing as in |<+->| happens \emph{except} that the counter |beamerpauses| is \emph{not} incremented and \emph{except} that you get the value of |beamerpauses| decreased by one. Thus a dot, possibly followed by an offset, just expands to the current value of the counter |beamerpauses| minus one, possibly offset. This dot notation can be useful in case like the following:
+\begin{verbatim}
+\begin{itemize}[<+->]
+\item Apple
+\item<.-> Peach
+\item Plum
+\item Orange
+\end{itemize}
+\end{verbatim}
+
+In the example, the second item is shown at the same time as the first one since it does not update the counter.
+
+In the following example, each time an item is uncovered, the specified text is alerted. When the next item is uncovered, this altering ends.
+\begin{verbatim}
+\begin{itemize}[<+->]
+\end{itemize}
+\end{verbatim}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-overlays.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-solutions.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-solutions.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,64 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2013,2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\section{Solution Templates}
+\label{section-solutions}
+
+In the subdirectories of the directory |beamer/solutions| you will find \emph{solution templates} in different languages. A solution template is a \TeX-text that solves'' a specific problem. Such a problem might be I need to create a 20 minute talk for a conference'' or I want to create a slide that introduces the next speaker'' or I want to create a table that is uncovered piecewise.'' For such a problem, a solution template consists of a mixture of a template and an example that can be used to solve this particular problem. Just copy the solution template file (or parts of it) and freely adjust them to your needs.
+
+The collecting of \beamer\ solution templates has only begun and currently there are only very few of them. We hope that in the future more solutions will become available and we would like to encourage users of the \beamer\ class to send us solutions they develop. We would also like to encourage users to help in translating solutions to languages other than English and German. If you have written a solution or a translation, please feel free to send it to us (make sure however, that it contains about the same amount of explanations and justifications as do the existing solutions).
+
+The following list of solution templates is sorted by the length of the talks for which they provide a template. As always, the solutions can be found in the directory |beamer/solutions|.
+
+\begin{solution}{short-talks/speaker\_introduction-ornate-2min}
+  \begin{itemize}
+  \item
+    Introducing another speaker.
+  \item
+    Talk length is about 2min.
+  \item
+    Ornate style.
+  \end{itemize}
+
+  \beamernote
+  \TeX-version available in languages |de|, |en|, and |fr|.
+
+\end{solution}
+
+\begin{solution}{generic-talks/generic-ornate-15min-45min}
+  \begin{itemize}
+  \item
+    Generic solution template for talks on any subject.
+  \item
+    Talk length is between 15min and 45min.
+  \item
+    Ornate style.
+  \end{itemize}
+
+  \beamernote
+  \TeX-version available in languages |de|, |en|, and |fr|.
+
+\end{solution}
+
+\begin{solution}{conference-talks/conference-ornate-20min}
+  \begin{itemize}
+  \item
+    Talk at a conference/colloquium.
+  \item
+    Talk length is about 20 minutes.
+  \item
+    Ornate style.
+  \end{itemize}
+
+  \beamernote
+  \TeX-version available in languages |de|, |en|, and |fr|.
+
+\end{solution}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-solutions.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-themes.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-themes.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,341 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2012,2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\section{Themes}
+
+\subsection{Five Flavors of Themes}
+
+\emph{Themes} make it easy to change the appearance of a
+presentation. The \beamer\ class uses five different kinds of themes:
+\begin{description}
+\item[Presentation Themes]
+  Conceptually, a presentation theme dictates for every single detail of a presentation what it looks like. Thus, choosing a particular presentation theme will setup for, say, the numbers in enumeration what color they have, what color their background has, what font is used to render them, whether a circle or ball or rectangle or whatever is drawn behind them, and so forth. Thus, when you choose a presentation theme, your presentation will look the way someone (the creator of the theme) thought that a presentation should look like. Presentation themes typically only choose a particular color theme, font theme, inner theme, and outer theme that go well together.
+\item[Color Themes]
+  A color theme only dictates which colors are used in a presentation. If you have chosen a particular presentation theme and then choose a color theme, only the colors of your presentation will change. A color theme can specify colors in a very detailed way: For example, a color theme can specifically change the colors used to render, say, the border of a button, the background of a button, and the text on a button.
+\item[Font Themes]
+  A font theme dictates which fonts or font attributes are used in a presentation. As for colors, the font of all text elements used in a presentation can be specified independently.
+\item[Inner Themes]
+  An inner theme specifies how certain elements of a presentation are typeset. This includes all elements that are at the inside'' of the frame, that is, that are not part of the headline, footline, or sidebars. This includes all enumerations, itemize environments, block environments, theorem environments, or the table of contents. For example, an inner theme might specify that in an enumeration the number should be typeset without a dot and that a small circle should be shown behind it. The inner theme would \emph{not} specify what color should be used for the number or the circle (this is the job of the color theme) nor which font should be used (this is the job of the font theme).
+\item[Outer Themes]
+  An outer theme specifies what the outside'' or border'' of the presentation slides should look like. It specifies whether there are head- and footlines, what is shown in them, whether there is a sidebar, where the logo goes, where the navigation symbols and bars go, and so on. It also specifies where the frametitle is put and how it is typeset.
+\end{description}
+
+The different themes reside in the five subdirectories |theme|, |color|, |font|, |inner|, and |outer| of the directory |beamer/themes|. Internally, a theme is stored as a normal style file. However, to use a theme, the following special commands should be used:
+
+\begin{command}{\usetheme\oarg{options}\marg{name list}}
+  Installs the presentation theme named \meta{name}. Currently, the effect of this command is the same as saying |\usepackage| for the style file named |beamertheme|\meta{name}|.sty| for each \meta{name} in the \meta{name list}.
+\end{command}
+
+
+\begin{command}{\usecolortheme\oarg{options}\marg{name list}}
+  Same as |\usetheme|, only for color themes. Color style files are named |beamercolortheme|\meta{name}|.sty|.
+\end{command}
+
+\begin{command}{\usefonttheme\oarg{options}\marg{name}}
+  Same as |\usetheme|, only for font themes. Font style files are named |beamerfonttheme|\meta{name}|.sty|.
+\end{command}
+
+\begin{command}{\useinnertheme\oarg{options}\marg{name}}
+  Same as |\usetheme|, only for inner themes. Inner style files are named |beamerinnertheme|\meta{name}|.sty|.
+\end{command}
+
+\begin{command}{\useoutertheme\oarg{options}\marg{name}}
+  Same as |\usetheme|, only for outer themes. Outer style files are named |beameroutertheme|\meta{name}|.sty|.
+\end{command}
+
+If you do not use any of these commands, a sober \emph{default} theme is used for all of them. In the following, the presentation themes that come with the \beamer\ class are described. The element, layout, color, and font themes  are presented in the following sections.
+
+
+
+A presentation theme dictates for every single detail of a presentation what it looks like. Normally, having chosen a particular presentation theme, you do not need to specify anything else having to do with the appearance of your presentation---the creator of the theme should have taken care of that for you. However, you still \emph{can} change things afterward either by using a different color, font, element, or even layout theme; or by changing specific colors, fonts, or templates directly.
+
+When Till started naming the presentation themes, he soon ran out of ideas on how to call them. Instead of giving them more and more cumbersome names, he decided to switch to a different naming convention: Except for two special cases, all presentation themes are named after cities. These cities happen to be cities in which or near which there was a conference or workshop that he attended or that a co-author of his attended.
+
+All themes listed without author mentioned were developed by Till. If a theme has not been developped by us (that is, if someone else is to blame), this is indicated with the theme. We have sometimes slightly changed or corrected'' submitted themes, but we still list the original authors.
+
+\begin{themeexample}{default}
+  As the name suggests, this theme is installed by default. It is a sober no-nonsense theme that makes minimal use of color or font variations. This theme is useful for all kinds of talks, except for very long talks.
+\end{themeexample}
+
+  For this theme, you can specify an arbitrary number of templates for the boxes in the headline and in the footline. You can add a template for another box by using the following commands.
+
+    Each time this command is invoked, a new box is added to the head line, with the first added box being shown on the left. All boxes will have the same size.
+
+    The \meta{beamer color} will be used to setup the foreground and background colors of the box.
+
+    \example
+\begin{verbatim}
+\end{verbatim}
+
+    A similar effect as the above commands can be achieved by directly installing a head template that contains two |beamercolorbox|es:
+
+\begin{verbatim}
+{\leavevmode
+\end{beamercolorbox}%
+\begin{beamercolorbox}[width=.5\paperwidth]{structure}
+\end{beamercolorbox}
+}
+\end{verbatim}
+
+    While being more complicated, the above commands offer more flexibility.
+  \end{command}
+
+    \example
+\begin{verbatim}
+\end{verbatim}
+  \end{command}
+\end{themeexample}
+
+\begin{themeexample}[\oarg{options}]{Bergen}
+  A theme based on the |inmargin| inner theme and the |rectangles| inner theme. Using this theme is not quite trivial since getting the spacing right can be trickier than with most other themes. Also, this theme goes badly with columns. You may wish to consult the remarks on the |inmargin| inner theme.
+
+  Bergen is a town in Norway. It hosted \textsc{iwpec} 2004.
+\end{themeexample}
+
+  A theme giving much information in little space. The following \meta{options} may be given:
+  \begin{itemize}
+  \item \declare{|secheader|} causes a headline to be inserted showing the current section and subsection. By default, this headline is not shown.
+  \end{itemize}
+
+  \themeauthor Manuel Carro. Boadilla is a village in the vicinity of Madrid, hosting the University's Computer Science department.
+\end{themeexample}
+
+  Like the |Boadilla| theme, except that stronger colors are used and that the itemize icons are not modified. The same \meta{options} as for the |Boadilla| theme may be given.
+
+  \themeauthor Manuel Carro. Madrid is the capital of Spain.
+\end{themeexample}
+
+\begin{themeexample}{AnnArbor}
+  Like |Boadilla|, but using the colors of the University of Michigan.
+
+  \themeauthor Madhusudan Singh. The University of Michigan is located at Ann Arbor.
+\end{themeexample}
+
+\begin{themeexample}{CambridgeUS}
+  Like |Boadilla|, but using the colors of MIT.
+
+\end{themeexample}
+
+\begin{themeexample}{EastLansing}
+  Like |Boadilla|, but using the colors of Michigan State University.
+
+  \themeauthor Alan Munn. Michigan State University is located in East Lansing.
+\end{themeexample}
+
+\begin{themeexample}{Pittsburgh}
+  A sober theme. The right-flushed frame titles creates an interesting tension'' inside each frame.
+
+  Pittsburgh is a town in the eastern USA. It hosted the second \textsc{recomb} workshop of \textsc{snp}s and haplotypes, 2004.
+\end{themeexample}
+
+\begin{themeexample}[\oarg{options}]{Rochester}
+  A dominant theme without any navigational elements. It can be made less dominant by using a different color theme.
+
+  The following \meta{options} may be given:
+  \begin{itemize}
+  \item \declare{|height=|\meta{dimension}} sets the height of the frame title bar.
+  \end{itemize}
+
+  Rochester is a town in upstate New York, USA. Till visited Rochester in 2001.
+\end{themeexample}
+
+
+\subsection{Presentation Themes with a Tree-Like Navigation Bar}
+
+\begin{themeexample}{Antibes}
+  A dominant theme with a tree-like navigation at the top. The rectangular elements mirror the rectangular navigation at the top. The theme can be made less dominant by using a different color theme.
+
+  Antibes is a town in the south of France. It hosted \textsc{stacs} 2002.
+\end{themeexample}
+
+\begin{themeexample}{JuanLesPins}
+  A variation on the |Antibes| theme that has a much smoother'' appearance. It can be made less dominant by choosing a different color theme.
+
+  Juan--Les--Pins is a cozy village near Antibes. It hosted \textsc{stacs} 2002.
+\end{themeexample}
+
+\begin{themeexample}{Montpellier}
+  A sober theme giving basic navigational hints. The headline can be made more dominant by using a different color theme.
+
+  Montpellier is in the south of France. It hosted \textsc{stacs} 2004.
+\end{themeexample}
+
+
+
+\begin{themeexample}[\oarg{options}]{Berkeley}
+  A dominant theme. If the navigation bar is on the left, it dominates since it is seen first. The height of the frame title is fixed to two and a half lines, thus you should be careful with overly long titles. A logo will be put in the corner area. Rectangular areas dominate the layout. The theme can be made less dominant by using a different color theme.
+
+  By default, the current entry of the table of contents in the sidebar will be highlighted by using a more vibrant color. A good alternative is to highlight the current entry by using a different color for the background of the current point. The color theme |sidebartab| installs the appropriate colors, so you just have to say
+\begin{verbatim}
+\usecolortheme{sidebartab}
+\end{verbatim}
+
+  This color theme works with all themes that show a table of contents in the sidebar.
+
+  This theme is useful for long talks like lectures that require a table of contents to be visible all the time.
+
+  The following \meta{options} may be given:
+  \begin{itemize}
+  \item \declare{|hideallsubsections|} causes only sections to be shown in the sidebar. This is useful, if you need to save space.
+  \item \declare{|hideothersubsections|} causes only the subsections of the current section to be shown. This is useful, if you need to save space.
+  \item \declare{|left|} puts the sidebar on the left (default).
+  \item \declare{|right|} puts the sidebar on the right.
+  \item \declare{|width=|\meta{dimension}} sets the width of the sidebar. If set to zero, no sidebar is created.
+  \end{itemize}
+
+  Berkeley is on the western coast of the USA, near San Francisco. Till visited Berkeley for a year in 2004.
+\end{themeexample}
+
+\begin{themeexample}[\oarg{options}]{PaloAlto}
+  A variation on the |Berkeley| theme with less dominance of rectangular areas. The same \meta{options} as for the |Berkeley| theme can be given.
+
+  Palo Alto is also near San Francisco. It hosted the Bay Area Theory Workshop 2004.
+\end{themeexample}
+
+\begin{themeexample}[\oarg{options}]{Goettingen}
+  A relatively sober theme useful for a longer talk that demands a sidebar with a full table of contents.  The same \meta{options} as for the |Berkeley| theme can be given.
+
+  G\"ottingen is a town in Germany. It hosted the 42nd Theorietag.
+\end{themeexample}
+
+\begin{themeexample}[\oarg{options}]{Marburg}
+  A very dominant variation of the |Goettingen| theme. The same \meta{options} may be given.
+
+  Marburg is a town in Germany. It hosted the 46th Theorietag.
+\end{themeexample}
+
+\begin{themeexample}[\oarg{options}]{Hannover}
+  In this theme, the sidebar on the left is balanced by right-flushed frame titles.
+
+  The following \meta{options} may be given:
+  \begin{itemize}
+  \item \declare{|hideallsubsections|} causes only sections to be shown in the sidebar. This is useful, if you need to save space.
+  \item \declare{|hideothersubsections|} causes only the subsections of the current section to be shown. This is useful, if you need to save space.
+  \item \declare{|width=|\meta{dimension}} sets the width of the sidebar.
+  \end{itemize}
+
+  Hannover is a town in Germany. It hosted the 48th Theorietag.
+\end{themeexample}
+
+
+\subsection{Presentation Themes with a Mini Frame Navigation}
+
+\begin{themeexample}[\oarg{options}]{Berlin}
+  A dominant theme with strong colors and dominating rectangular areas. The head- and footlines give lots of information and leave little space for the actual slide contents. This theme is useful for conferences where the audience is not likely to know the title of the talk or who is presenting it. The theme can be made less dominant by using a different color theme.
+
+  The following \meta{options} may be given:
+  \begin{itemize}
+  \item \declare{|compress|} causes the mini frames in the headline to use only a single line. This is useful for saving space.
+  \end{itemize}
+
+  Berlin is the capital of Germany.
+\end{themeexample}
+
+\begin{themeexample}[\oarg{options}]{Ilmenau}
+  A variation on the |Berlin| theme. The same \meta{options} may be given.
+
+  Ilmenau is a town in Germany. It hosted the 40th Theorietag.
+\end{themeexample}
+
+\begin{themeexample}{Dresden}
+  A variation on the |Berlin| theme with a strong separation into navigational stuff at the top/bottom and a sober main text. The same \meta{options} may be given.
+
+  Dresden is a town in Germany. It hosted STACS 2001.
+\end{themeexample}
+
+
+  A theme with a strong separation into a navigational upper part and an informational main part. By using a different color theme, this separation can be lessened.
+
+  Darmstadt is a town in Germany.
+\end{themeexample}
+
+\begin{themeexample}{Frankfurt}
+  A variation on the |Darmstadt| theme that is slightly less cluttered by leaving out the subsection information.
+
+  Frankfurt is a town in Germany.
+\end{themeexample}
+
+\begin{themeexample}{Singapore}
+  A not-too-sober theme with navigation that does not dominate.
+
+  Singapore is located in south-eastern Asia. It hosted \textsc{cocoon} 2002.
+\end{themeexample}
+
+\begin{themeexample}{Szeged}
+  A sober theme with a strong dominance of horizontal lines.
+
+  Szeged is on the south border of Hungary. It hosted \textsc{dlt} 2003.
+\end{themeexample}
+
+
+\subsection{Presentation Themes with Section and Subsection Tables}
+
+\begin{themeexample}{Copenhagen}
+  A not-quite-too-dominant theme. This theme gives compressed information about the current section and subsection at the top and about the title and the author at the bottom. No shadows are used, giving the presentation a flat'' look. The theme can be made less dominant by using a different color theme.
+
+  Copenhagen is the capital of Denmark. It is connected to Malm\"o by the \O resund bridge.
+\end{themeexample}
+
+\begin{themeexample}{Luebeck}
+  A variation on the |Copenhagen| theme.
+
+  L\"ubeck is a town in nothern Germany. It hosted the 41st Theorietag.
+\end{themeexample}
+
+\begin{themeexample}{Malmoe}
+  A more sober variation of the |Copenhagen| theme.
+
+  Malm\"o is a town in southern Sweden. It hosted \textsc{fct} 2001.
+\end{themeexample}
+
+\begin{themeexample}{Warsaw}
+  A dominant variation of the |Copenhagen| theme.
+
+  Warsaw is the capital of Poland. It hosted \textsc{mfcs} 2002.
+\end{themeexample}
+
+
+\subsection{Presentation Themes Included For Compatibility}
+
+Earlier versions of \beamer\ included some further themes. These themes are still available for compatibility, though they are now implemented differently (they also mainly install appropriate color, font, inner, and outer themes). However, they may or may not honor color themes and they will not be supported in the future. The following list shows which of the new themes should be used instead of the old themes. (When switching, you may want to use the font theme |structurebold| with the option |onlysmall|.)
+
+\medskip
+\begin{tabular}{lp{13cm}}
+  Old theme & Replacement options \\\hline
+  none & Use |compatibility|. \\
+  |bars| & Try |Dresden| instead. \\
+  |classic| & Try |Singapore| instead. \\
+  |lined| & Try |Szeged| instead. \\
+  |plain| & Try none or |Pittsburgh| instead. \\
+  |sidebar| & Try |Goettingen| for the light version and |Marburg| for
+  the dark version. \\
+  |split| & Try |Malmoe| instead. \\
+  |tree| & Try |Montpellier| and, for the bars version, |Antibes| or
+  |JuansLesPins|.
+\end{tabular}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-themes.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-transparencies.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-transparencies.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,66 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\section{Creating Transparencies}
+\label{section-trans}
+\label{trans}
+
+The main aim of the \beamer\ class is to create presentations for projectors (sometimes called beamers, hence the name). However, it is often useful to print transparencies as backup, in case the hardware fails. A transparencies version of a talk often has less slides than the main version, since it takes more time to switch slides, but it may have more slides than the handout version. For example, while in a handout an animation might be condensed to a single slide, you might wish to print several slides for the transparency version.
+
+In order to create a transparencies version, specify the class option |trans|. If you do not specify anything else, this will cause all overlay specifications to be suppressed. For most cases this will create exactly the desired result.
+
+\begin{classoption}{trans}
+  Create a version that uses the |trans| overlay specifications.
+\end{classoption}
+
+In some cases, you may want a more complex behavior. For example, if you use many |\only| commands to draw an animation. In this case, suppressing all overlay specifications is not such a good idea, since this will cause all steps of the animation to be shown at the same time. In some cases this is not desirable. Also, it might be desirable to suppress some |\alert| commands that apply only to specific slides in the handout.
+
+For a fine-grained control of what is shown on a handout, you can use \emph{mode specifications}. They specify which slides of a frame should be shown for a special version, for example for the handout version. As explained in Section~\ref{section-concept-overlays}, a mode specification is written alongside the normal overlay specification inside the pointed brackets. It is separated from the normal specification by a vertical bar and a space. Here is an example:
+\begin{verbatim}
+  \only<1-3,5-9| trans:2-3,5>{Text}
+\end{verbatim}
+
+This specification says: Normally (in |beamer| mode), insert the text on slides 1--3 and 5--9. For the transparencies version, insert the text only on slides 2,~3, and~5.'' If no special mode specification is given for |trans| mode, the default is always.'' This causes the desirable effect that if you do not specify anything, the overlay specification is effectively suppressed for the handout.
+
+An especially useful specification is the following:
+\begin{verbatim}
+  \only<3| trans:0>{Not shown on transparencies.}
+\end{verbatim}
+
+Since there is no zeroth slide, the text is not shown. Likewise, \verb!\alert<3| trans:0>{Text}! will not alert the text on a transparency.
+
+You can also use a mode specification for the overlay specification of the |{frame}| environment as in the following example.
+\begin{verbatim}
+\begin{frame}<1-| trans:0>
+  Text...
+\end{frame}
+\end{verbatim}
+
+This causes the frame to be suppressed in the transparencies version. Also, you can restrict the presentation such that only specific slides of the frame are shown on the handout:
+\begin{verbatim}
+\begin{frame}<1-| trans:4-5>
+  Text...
+\end{frame}
+\end{verbatim}
+
+It is also possible to give only an alternate overlay specification. For example, |\alert<trans:0>{...}| causes the text to be always highlighted during the presentation, but never on the transparencies version. Likewise, |\frame<trans:0>{...}| causes the frame to be suppressed for the handout.
+
+Finally, note that it is possible to give more than one alternate overlay specification and in any order. For example, the following specification states that the text should be inserted on the first three slides in the presentation, in the first two slides of the transparency version, and not at all in the handout.
+\begin{verbatim}
+  \only<trans:1-2| 1-3| handout:0>{Text}
+\end{verbatim}
+
+If you wish to give the same specification in all versions, you can do so by specifying |all:| as the version. For example,
+\begin{verbatim}
+\frame<all:1-2>{blah...}
+\end{verbatim}
+
+ensures that the frame has two slides in all versions.

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-transparencies.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-tricks.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-tricks.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,195 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\section{How To Uncover Things Piecewise}
+
+
+\subsection{Uncovering an Enumeration Piecewise}
+
+A common usage of overlays is to show a list of points in an enumeration in a piecewise fashion. The easiest and most flexible way to do this is the following:
+\begin{verbatim}
+\begin{itemize}
+\item<1-> First point.
+\item<2-> Second point.
+\item<3-> Third point.
+\end{itemize}
+\end{verbatim}
+
+The advantage of this approach is that you retain total control over the order in which items are shown. By changing, for example, the last specification to |<2->|, you can have the last two points uncovered at the same time.
+
+A disadvantage of the approach is that you will have to renumber everything if you add a new item. This is usually not such a big problem, but it can be a nuisance.
+
+To automatize the uncovering, you can use the following code:
+\begin{verbatim}
+\begin{itemize}[<+->]
+\item First point.
+\item Second point.
+\item Third point.
+\end{itemize}
+\end{verbatim}
+
+The effect of the |[<+->]| is to install a \emph{default overlay specification}, see the definition of |itemize| for details.
+
+Now, suppose you wish the second and third point to be shown at the same time. You could achieve this by adding the specification |<2->| to either the second or third |\item| command. However, then you still have to do some renumbering if you add a new item at the beginning. A better approach is to temporarily use a different overlay specification and the dot-notation:
+\begin{verbatim}
+\begin{itemize}[<+->]
+\item First point.
+\item<.-> Second point.
+\item Third point.
+\end{itemize}
+\end{verbatim}
+
+You might wish to build your own macros based on these ideas (like an |itemstep| environment or a |\itemlikeprevious| command).
+
+
+\subsection{Highlighting the Current Item in an Enumeration}
+
+If you uncover an enumeration piecewise, it is sometimes a good idea to highlight the last uncovered point to draw the audience's attention to it. This is best achieved as follows:
+\begin{verbatim}
+\begin{itemize}
+\item<1-| alert at 1> First point.
+\item<2-| alert at 2> Second point.
+\item<3-| alert at 3> Third point.
+\end{itemize}
+\end{verbatim}
+
+or
+\begin{verbatim}
+\item First point.
+\item Second point.
+\item Third point.
+\end{itemize}
+\end{verbatim}
+
+Note that this will draw the little item symbol also in red.
+
+
+\subsection{Changing Symbol Before an Enumeration}
+
+When uncovering a list of tasks or problems, you may desire that the symbol in front of the last uncovered symbol is, say, a ballot~X, while for the previous items it is a check mark (you'll find these characters in some Dingbats fonts).
+
+The best way to achieve this is to implement a new action environment. If this action is activated, it temporarily changes the item symbol template to the other symbol:
+\begin{verbatim}
+\newenvironment{ballotenv}
+{\only{%
+  \setbeamertemplate{itemize item}{code for showing a ballot}%
+  \setbeamertemplate{itemize subitem}{code for showing a smaller ballot}%
+  \setbeamertemplate{itemize subsubitem}{code for showing a smaller ballot}}}
+{}
+
+\setbeamertemplate{itemize item}{code for showing a check mark}
+\setbeamertemplate{itemize subitem}{code for showing a smaller check mark}
+\setbeamertemplate{itemize subsubitem}{code for showing a smaller check mark}
+\end{verbatim}
+
+The effect of the code is to install a check mark as the default template. If the action |ballot| is now requested for some item, this template will temporarily be replaced by the ballot templates.
+
+Note that the |ballotenv| is invoked with the overlay specification given for the action directly following it. This causes the |\only| to be invoked exactly for the specified overlays.
+
+Here are example usages:
+\begin{verbatim}
+\begin{itemize}
+\item<1-| ballot at 1> First point.
+\item<2-| ballot at 2> Second point.
+\item<3-| ballot at 3> Third point.
+\end{itemize}
+\end{verbatim}
+
+and
+\begin{verbatim}
+\begin{itemize}[<+-| ballot at +>]
+\item First point.
+\item Second point.
+\item Third point.
+\end{itemize}
+\end{verbatim}
+
+In the following example, more and more items become checked'' from slide to slide:
+\begin{verbatim}
+\begin{itemize}[<ballot at +-| visible at 1-,+(1)>]
+\item First point.
+\item Second point.
+\item Third point.
+\end{itemize}
+\end{verbatim}
+
+The important point is |ballot at +|. The funny |visible at 1-,+(1)| has the following effect: Although it has no effect with respect to what is shown (after all, it applies to all slides), it ensures that in the enumeration the slide number 4 is mentioned. Thus there will also be a slide in which all three points are checked.
+
+
+\subsection{Uncovering Tagged Formulas Piecewise}
+
+Suppose you have a three-line formula as the following:
+\begin{verbatim}
+\begin{align}
+  A &= B \\
+    &= C \\
+    &= D
+\end{align}
+\end{verbatim}
+
+Uncovering this formula line-by-line is a little tricky. A first idea is to use the |\pause| or |\onslide| commands. Unfortunately, these do not work since |align| internally reprocesses its input several times, which messes up the delicate internals of the commands. The next idea is the following, which works a little better:
+\begin{verbatim}
+\begin{align}
+  A &= B \\
+    \uncover<2->{&= C \\}
+    \uncover<3->{&= D}
+\end{align}
+\end{verbatim}
+
+Unfortunately, this does not work in the presence of tags (so it works for the |align*| environment). What happens is that the tag of the last line is shown on all slides. The problem here is that the tag is created when |\\| is encountered or when |\end{align}| is encountered. In the last line these are already behind'' the |\uncover|.
+
+To solve this problem, you can add an empty line without a tag and then insert a negative vertical skip to undo the last line:
+\begin{verbatim}
+\begin{align}
+  A &= B \\
+    \uncover<2->{&= C \\}
+    \uncover<3->{&= D \\}
+    \notag
+  \end{align}
+\vskip-1.5em
+\end{verbatim}
+
+
+\subsection{Uncovering a Table Rowwise}
+
+When you wish to uncover a table line-by-line, you will run into all sorts of problems if there are vertical and horizontal lines in the table. The reason is that the first vertical line at the left end is drawn before the line is even read (and thus, in particular, before any |\onslide| command can be read). However, placing a |\pause| or |\uncover| at the end of the line before is also not helpful since it will then suppress the horizontal line below the last uncovered line.
+
+A possible way to solve this problem is not to use either horizontal or vertical lines. Instead, coloring the lines using the |colortbl| package is a good alternative to structure the table. Here is an optically pleasing example, where the table is uncovered line-wise:
+\begin{verbatim}
+\rowcolors[]{1}{blue!20}{blue!10}
+\begin{tabular}{l!{\vrule}cccc}
+  Class & A & B & C & D \\\hline
+  X     & 1 & 2 & 3 & 4 \pause\\
+  Y     & 3 & 4 & 5 & 6 \pause\\
+  Z     & 5 & 6 & 7 & 8
+\end{tabular}
+\end{verbatim}
+
+By using |\onslide| instead of |\pause|, you can get more fine-grained control over which line is shown on which slide.
+
+
+\subsection{Uncovering a Table Columnwise}
+
+The same problems as for uncovering a table linewise arise for uncovering it columnwise.
+
+Once more, using the |colortbl| package offers a solution. In the following example, the |tabular| header is used to insert |\onslide| commands, one for each column, that cover the entries in the column from a certain slide on. At the end of the last column, the |\onslide| without a specification ensures that the first column on the next row is once more shown normally.
+
+Inserting a horizontal line is tricky since it will protrude over the full width of the table also in the covered version. The best idea is just not to use horizontal bars.
+\begin{verbatim}
+\rowcolors[]{1}{blue!20}{blue!10}
+\begin{tabular}{l!{\vrule}c<{\onslide<2->}c<{\onslide<3->}c<{\onslide<4->}c<{\onslide}c}
+  Class & A & B & C & D \\
+  X     & 1 & 2 & 3 & 4 \\
+  Y     & 3 & 4 & 5 & 6 \\
+  Z     & 5 & 6 & 7 & 8
+\end{tabular}
+\end{verbatim}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-tricks.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-tutorial.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-tutorial.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,404 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2010,2011,2013,2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\section{Tutorial: Euclid's Presentation}
+\label{section-tutorial}
+
+This section presents a short tutorial that focuses on those features of \beamer\ that you are likely to use when you start using \beamer. It  leaves out all the glorious details that are explained in great detail later on.
+
+
+\subsection{Problem Statement}
+
+We wish to help Prof.\ Euclid of the University of Alexandria to create a presentation on his latest discovery: There are infinitely many prime numbers! Euclid wrote a paper on this and it got accepted at the 27th International Symposium on Prime Numbers $-280$ (ISPN~'80). Euclid wishes to use the \beamer\ class to create a presentation for the conference. On the conference webpage he found out that he will have twenty minutes for his talk, including questions.
+
+
+\subsection{Solution Template}
+
+The first thing Euclid should do is to look for a solution template for his presentation. Having a look at Section~\ref{section-solutions}, he finds that the file
+\begin{verbatim}
+beamer/solutions/conference-talks/conference-ornate-20min.en.tex
+\end{verbatim}
+might be appropriate. He creates a subdirectory |presentation| in the directory that contains the actual paper and copies the solution template to this subdirectory, renaming to |main.tex|.
+
+He opens the file in his favorite editor. It starts
+\begin{verbatim}
+\documentclass{beamer}
+\end{verbatim}
+which Euclid finds hardly surprising. Next comes a line reading
+\begin{verbatim}
+\mode<presentation>
+\end{verbatim}
+which Euclid does not understand. Since he finds more stuff in the file that he does not understand, he decides to ignore all of that for time being, hoping that it all serves some good purpose.
+
+
+\subsection{Title Material}
+
+The next thing that seems logical is the place where the |\title| command is used. Naturally, he replaces it with
+\begin{verbatim}
+\title{There Is No Largest Prime Number}
+\end{verbatim}
+since this was the title of the paper. He sees that the command |\title| also takes an optional short'' argument in square brackets, which is shown in places where there is little space, but he decides that the title is short enough by itself.
+
+Euclid next adjusts the |\author| and |\date| fields as follows:
+\begin{verbatim}
+%\author{Euclid of Alexandria}
+%\date[ISPN '80]{27th International Symposium of Prime Numbers}
+\end{verbatim}
+For the date, he felt that the name was a little long, so a short version is given (|ISPN '80|). On second thought, Euclid decides to add his email address and replaces the |\author| field as follows:
+\begin{verbatim}
+%\author[Euclid]{Euclid of Alexandria \\ \texttt{euclid at alexandria.edu}}
+\end{verbatim}
+Somehow Euclid does not like the fact that there is no |\email|'' command in \beamer. He decides to write an email to \beamer's author, asking him to fix this, but postpones this for later when the presentation is finished.
+
+There are two fields that Euclid does not know, but whose meaning he can guess: |\subtitle| and |\institute|. He adjusts them. (Euclid does not need to use the |\and| command, which is used to separate several authors, nor the |\inst| command, which just makes its argument a superscript).
+
+
+\subsection{The Title Page Frame}
+
+The next thing in the file that seems interesting is where the first frame'' is created, right after the |\||begin{document}|:
+\begin{verbatim}
+\begin{frame}
+  \titlepage
+\end{frame}
+\end{verbatim}
+In \beamer, a presentation consists of a series of frames. Each frame in turn may consist of several slides (if there is more than one, they are called overlays). Normally, everything between |\begin{frame}| and |\end{frame}| is put on a single slide. No page breaking is performed. So Euclid infers that the first frame is filled'' by the title page, which seems quite logical.
+
+
+\subsection{Creating the Presentation PDF File}
+
+Eager to find out how the first page will look, he invokes |pdflatex| on his file |main.tex| (twice). He could also use |latex| (twice), followed by |dvips|, and then possibly |ps2pdf|, or |lualatex| (twice), or |xelatex| (twice). Then he uses the Acrobat Reader, |xpdf|, |evince| or |okular| to view the resulting |main.pdf|. Indeed, the first page contains all the information Euclid has provided until now. It even looks quite impressive with the colorful title and the rounded corners and the shadows, but he is doubtful whether he should leave it like that. He decides to address this problem later.
+
+Euclid is delighted to find out that clicking on a section or subsection in the navigation bar at the top hyperjumps there. Also, the small symbols at the bottom seem to be clickable. Toying around with them for a while, he finds that clicking on the arrows left or right of a symbol hyperjumps him backward or forward one slide~/ frame~/ subsection~/ section. He finds the symbols quite small, but decides not to write an email to \beamer's authors since he also thinks that bigger symbols would be distracting.
+
+
+
+\begin{verbatim}
+\begin{frame}
+  \frametitle{Outline}
+  \tableofcontents
+\end{frame}
+\end{verbatim}
+Furthermore, this frame has an individual title (Outline). A comment in the frame says that Euclid might wish to try to add the |[pausesections]| option. He tries this, changing the frame to:
+\begin{verbatim}
+\begin{frame}
+  \frametitle{Outline}
+  \tableofcontents[pausesections]
+\end{frame}
+\end{verbatim}
+
+After re-pdf\LaTeX ing the presentation, he finds that instead of a single slide, there are now two table of contents'' slides in the presentation. On the first of these, only the first section is shown, on the second both sections are shown (scanning down in the file, Euclid finds that, indeed, there are |\section| commands introducing these sections). The effect of the |pausesections| seems to be that one can talk about the first section before the second one is shown. Then, Euclid can press the down- or right-key, to show the complete table of contents and can talk about the second section.
+
+
+\subsection{Sections and Subsections}
+
+The next commands Euclid finds are
+\begin{verbatim}
+\section{Motivation}
+\subsection{The Basic Problem That We Studied}
+\end{verbatim}
+These commands are given \emph{outside} of frames. So Euclid assumes that at the point of invocation they have no direct effect, they only create entries in the table of contents. Having a Motivation'' section seems reasonable to Euclid, but he changes the |\subsection| title.
+
+As he looks at the presentation, he notices that his assumption was not quite true: each |\subsection| command seems to insert a frame containing a table of contents into the presentation. Doubling back he finds the command that causes this: The |\AtBeginSubsection| inserts a frame with only the current subsection highlighted at the beginning of each section. If Euclid does not like this, he can just delete the whole |\AtBeginSubsection| stuff and the table of contents at the beginning of each subsection disappears.
+
+The |\section| and |\subsection| commands take optional short arguments. These short arguments are used whenever a short form of the section of subsection name is needed. While this is in keeping with the way \beamer\ treats the optional arguments of things like |\title|, it is \emph{different} from the usual way \LaTeX\ treats an optional argument for sections (where the optional argument dictates what is shown in the table of contents and the main argument dictates what is shown everywhere else; in \beamer\ things are exactly the other way round).
+
+
+\subsection{Creating a Simple Frame}
+
+Euclid then modifies the next frame, which is the first real'' frame of the presentation, as follows:
+\begin{verbatim}
+\begin{frame}
+  \frametitle{What Are Prime Numbers?}
+  A prime number is a number that has exactly two divisors.
+\end{frame}
+\end{verbatim}
+This yields the desired result. It might be a good idea to put some emphasis on the object being defined (prime numbers). Euclid tries |\emph| but finds that too mild an emphasis. \beamer\ offers the command |\alert|, which is used like |\emph| and, by default, typesets its argument in bright red.
+
+Next, Euclid decides to make it even clearer that he is giving a definition by putting a |definition| environment around the definition.
+\begin{verbatim}
+\begin{frame}
+  \frametitle{What Are Prime Numbers?}
+  \begin{definition}
+    A \alert{prime number} is a number that has exactly two divisors.
+  \end{definition}
+\end{frame}
+\end{verbatim}
+
+Other useful environments like |theorem|, |lemma|, |proof|, |corollary|, or |example| are also predefined by \beamer. As in |amsmath|, they take optional arguments that they show in brackets. Indeed, |amsmath| is automatically loaded by \beamer.
+
+Since it is always a good idea to add examples, Euclid decides to add one:
+\begin{verbatim}
+\begin{frame}
+  \frametitle{What Are Prime Numbers?}
+  \begin{definition}
+    A \alert{prime number} is a number that has exactly two divisors.
+  \end{definition}
+  \begin{example}
+    \begin{itemize}
+    \item 2 is prime (two divisors: 1 and 2).
+    \item 3 is prime (two divisors: 1 and 3).
+    \item 4 is not prime (\alert{three} divisors: 1, 2, and 4).
+    \end{itemize}
+  \end{example}
+\end{frame}
+\end{verbatim}
+
+
+\subsection{Creating Simple Overlays}
+
+The frame already looks quite nice, though, perhaps a bit colorful. However, Euclid would now like to show the three items one after another, not all three right away. To achieve this, he adds |\pause| commands after the first and second items:
+\begin{verbatim}
+  \begin{itemize}
+  \item 2 is prime (two divisors: 1 and 2).
+    \pause
+  \item 3 is prime (two divisors: 1 and 3).
+    \pause
+  \item 4 is not prime (\alert{three} divisors: 1, 2, and 4).
+  \end{itemize}
+\end{verbatim}
+
+By showing them incrementally, he hopes to focus the audience's attention on the item he is currently talking about. On second thought, he deletes the |\pause| stuff once more since in simple cases like the above the pausing is rather silly. Indeed, Euclids has noticed that good presentations make use of this uncovering mechanism only in special circumstances.
+
+Euclid finds that he can also add a |\pause| between the definition and the example. So, |\pause|s seem to transcede environments, which Euclid finds quite useful. After some experimentation he finds that |\pause| only does not work in |align| environments. He immediately writes an email about this to \beamer's author, but receives a polite answer stating that the implementation of |align| does wicked things and there is no fix for this. Also, Euclid is pointed to the last part of the user's guide, where a workaround is described.
+
+
+\subsection{Using Overlay Specifications}
+
+The next frame is to show his main argument and is put in a Results'' section. Euclid desires a more complicated overlay behavior for this frame: In an enumeration of four points he wishes to uncover the points one-by-one, but he wishes the fourth point to be shown at the same time as the first. The idea is to illustrate his new proof method, namely proof by contradiction, where a wrong assumption is brought to a contradiction at the end after a number of intermediate steps that are not important at the beginning. For this, Euclid uses \emph{overlay specifications}:
+\begin{verbatim}
+\begin{frame}
+  \frametitle{There Is No Largest Prime Number}
+  \framesubtitle{The proof uses \textit{reductio ad absurdum}.}
+
+  \begin{theorem}
+    There is no largest prime number.
+  \end{theorem}
+  \begin{proof}
+    \begin{enumerate}
+    \item<1-> Suppose $p$ were the largest prime number.
+    \item<2-> Let $q$ be the product of the first $p$ numbers.
+    \item<3-> Then $q + 1$ is not divisible by any of them.
+    \item<1-> But $q + 1$ is greater than $1$, thus divisible by some prime
+      number not in the first $p$ numbers.\qedhere
+    \end{enumerate}
+  \end{proof}
+  \uncover<4->{The proof used \textit{reductio ad absurdum}.}
+\end{frame}
+\end{verbatim}
+
+The overlay specifications are given in pointed brackets. The specification |<1->| means from slide 1 on.'' Thus, the first and fourth item are shown on the first slide of the frame, but the other two items are not shown. Rather, the second point is shown only from the second slide onward. \beamer\ automatically computes the number of slides needed for each frame. More generally, overlay specification are lists of numbers or number ranges where the start or ending of a range can be left open. For example |-3,5-6,8-| means on all slides, except for slides 4 and~7.''
+
+The |\qedhere| is used to put the \textsc{qed} symbol at the end of the line \emph{inside} the enumeration. Normally, the \textsc{qed} symbol is automatically inserted at the end of a proof environment, but that would be on an ugly empty line here.
+
+The |\item| command is not the only command that takes overlay specifications. Another useful command that takes one is the |\uncover| command. It only shows its argument on the slides specified in the overlay specification. On all other slides, the argument is hidden (though it still occupies space). The command |\only| is similar and Euclid could also have tried
+\begin{verbatim}
+  \only<4->{The proof used \textit{reductio ad absurdum}.}
+\end{verbatim}
+
+On non-specified slides the |\only| command simply throws its argument away'' and the argument does not occupy any space. This leads to different heights of the text on the first three slides and on the fourth slide. If the text is centered vertically, this will cause the text to wobble'' and thus |\uncover| should be used. However, you sometimes wish things to really disappear'' on some slides and then |\only| is useful. Euclid could also have used the class option |t|, which causes the text in frames to be vertically flushed to the top. Then a differing text height does not cause wobbling. Vertical flushing can also be achieved for only a single frame by giving the optional argument |[t]| like this to the |frame| environment as in
+\begin{verbatim}
+\begin{frame}[t]
+  \frametitle{There Is No Largest Prime Number}
+  ...
+\end{frame}
+\end{verbatim}
+Vice versa, if the |t| class option is given, a frame can be vertically centered using the |[c]| option for the frame.
+
+It turns out that certain environments, including the |theorem| and |proof| environments above, also take overlay specifications. If such a specification is given, the whole theorem or proof is only shown on the specified slides.
+
+
+\subsection{Structuring a Frame}
+
+On the next frame, Euclid wishes to contrast solved and open problems on prime numbers. Since there is no Solved problem'' environment similar to the |theorem| environment, Euclid decides to use the |block| environment, which allows him to give an arbitrary title:
+\begin{verbatim}
+\begin{frame}
+  \frametitle{What's Still To Do?}
+    How many primes are there?
+  \end{block}
+  \begin{block}{Open Questions}
+    Is every even number the sum of two primes?
+  \end{block}
+\end{frame}
+\end{verbatim}
+
+He could also have defined his own theorem-like environment by putting the following in the preamble:
+\begin{verbatim}
+%\newtheorem{openquestions}[theorem]{Open Questions}
+\end{verbatim}
+The optional argument |[theorem]| ensures that these environments are numbered the same way as everything else. Since these numbers are not shown anyway, it does not really matter whether they are given, but it's a good practice and, perhaps, Euclid might need these numbers some other time.
+
+An alternative would be nested |itemize|:
+\begin{verbatim}
+\begin{frame}
+  \frametitle{What's Still To Do?}
+  \begin{itemize}
+    \begin{itemize}
+    \item How many primes are there?
+    \end{itemize}
+  \item Open Questions
+    \begin{itemize}
+    \item Is every even number the sum of two primes?
+    \end{itemize}
+  \end{itemize}
+\end{frame}
+\end{verbatim}
+
+Pondering on the problem some more, Euclid decides that it would be even nicer to have the Answered Questions'' on the left and the Open Questions'' on the right, so as to create a stronger visual contrast. For this, he uses the |columns| environment. Inside this environment, |\column| commands create new columns.
+\begin{verbatim}
+\begin{frame}
+  \frametitle{What's Still To Do?}
+  \begin{columns}
+    \column{.5\textwidth}
+        How many primes are there?
+      \end{block}
+
+    \column{.5\textwidth}
+      \begin{block}{Open Questions}
+        Is every even number the sum of two primes?
+      \end{block}
+  \end{columns}
+\end{frame}
+\end{verbatim}
+
+Trying this, he is not quite satisfied with the result as the block on the left has a different height than the one on the right. He thinks it would be nicer if they were vertically top-aligned. So he adds the |[t]| option to the |columns| environment.
+
+Euclid is somewhat pleased to find out that a |\pause| at the end of the first column allows him to uncover'' the second column only on the second slide of the frame.
+
+
+
+Euclid decides that he would like to add a citation to his open questions list, since he would like to attribute the question to his good old friend Christian. Euclid is not really sure whether using a bibliography in his talk is a good idea, but he goes ahead anyway.
+
+To this end, he adds an entry to the bibliography, which he fortunately already finds in the solution file. Having the bibliography in the appendix does not quite suit Euclid, so he removes the |\appendix| command. He also notices |<presentation>| overlay specifications and finds them a bit strange, but they don't seem to hurt either. Hopefully they do something useful. His bibliography looks like this:
+\begin{verbatim}
+  \begin{thebibliography}{10}
+  \bibitem{Goldbach1742}[Goldbach, 1742]
+    Christian Goldbach.
+    \newblock A problem we should try to solve before the ISPN '43 deadline,
+    \newblock \emph{Letter to Leonhard Euler}, 1742.
+  \end{thebibliography}
+\end{verbatim}
+
+and he can then add a citation:
+\begin{verbatim}
+\begin{block}{Open Questions}
+  Is every even number the sum of two primes?
+  \cite{Goldbach1742}
+\end{block}
+\end{verbatim}
+
+
+\subsection{Verbatim Text}
+
+On another frame, Euclid would like to show a listing of an algorithm his friend Eratosthenes has sent him (saying he came up with it while reorganizing his sieve collection). Euclid normally uses the |verbatim| environment and sometimes also similar environments like |lstlisting| to typeset listings. He can also use them in \beamer, but he must add the |fragile| option to the frame:
+\begin{verbatim}
+\begin{frame}[fragile]
+  \frametitle{An Algorithm For Finding Prime Numbers.}
+
+%\begin{verbatim}
+int main (void)
+{
+  std::vector<bool> is_prime (100, true);
+  for (int i = 2; i < 100; i++)
+    if (is_prime[i])
+      {
+        std::cout << i << " ";
+        for (int j = i; j < 100; is_prime [j] = false, j+=i);
+      }
+  return 0;
+}
+\end{verbatim}
+\unskip{\MacroFont|\end{verbatim}|}
+                                %\begin{verbatim}
+\begin{verbatim}
+  \begin{uncoverenv}<2>
+    Note the use of \verb|std::|.
+  \end{uncoverenv}
+\end{frame}
+\end{verbatim}
+
+On second thought, Euclid would prefer to uncover part of the algorithm stepwise and to add an emphasis on certain lines or parts of lines. He can use package like |alltt| for this, but in simple cases the environment |{semiverbatim}| defined by \beamer\ is more useful: It works like |{verbatim}|, except that |\|, |{|, and |}| retain their meaning (one can typeset them by using |\\|, |\{|, and |\}|). Euclid might now typeset his algorithm as follows:
+\begin{verbatim}
+\begin{frame}[fragile]
+  \frametitle{An Algorithm For Finding Primes Numbers.}
+
+\begin{semiverbatim}
+\uncover<1->{\alert<1>{  for (int i = 2; i < 100; i++)}}
+\uncover<3->{\alert<3>{        for (int j = i; j < 100;}}
+\uncover<3->{\alert<3>{             is_prime [j] = false, j+=i);}}
+\end{semiverbatim}
+
+  \visible<4->{Note the use of \alert{\texttt{std::}}.}
+\end{frame}
+\end{verbatim}
+The |\visible| command does nearly the same as |\uncover|. A difference occurs if the command |\setbeamercovered{transparent}| has been used to make covered text transparent'' instead, |\visible| still makes the text completely invisible'' on non-specified slides. Euclid has the feeling that the naming convention is a bit strange, but cannot quite pinpoint the problem.
+
+
+\subsection{Changing the Way Things Look I: Theming}
+
+With the contents of this talk fixed, Euclid decides to have a second look at the way things look. He goes back to the beginning and finds the line
+\begin{verbatim}
+\usetheme{Warsaw}
+\end{verbatim}
+
+By substituting other cities (he notices that these cities seem to have in common that there has been a workshop or conference on theoretical computer science there at which always the same person had a paper, attended, or gave a talk) Euclid can change the way his presentation is going to look. He decides to choose some theme that is reasonably simple but, since his talk is not too short, shows a bit of navigational information.
+
+He settles on the |Frankfurt| theme but decides that the light-dark contrast is too strong. He adds
+\begin{verbatim}
+\usecolortheme{seahorse}
+\usecolortheme{rose}
+\end{verbatim}
+The result seems some more subdued to him.
+
+Euclid decides that the font used for the titles is not quite classical enough (classical fonts are the latest chic in Alexandria). So, he adds
+\begin{verbatim}
+\usefonttheme[onlylarge]{structuresmallcapsserif}
+\end{verbatim}
+Euclid notices that the small fonts in the navigation bars are a bit hard to read as they are so thin. Adding the following helps:
+\begin{verbatim}
+\usefonttheme[onlysmall]{structurebold}
+\end{verbatim}
+
+
+\subsection{Changing the Way Things Look II: Colors and Fonts}
+
+Since Euclid wants to give a \emph{perfect} talk, he decides that the font used for the title simply has to be a serif italics. To change only the font used for the title, Euclid uses the following command:
+\begin{verbatim}
+\setbeamerfont{title}{shape=\itshape,family=\rmfamily}
+\end{verbatim}
+
+He notices that the font is still quite large (which he likes), but wonders why this is the case since he did not specify this. The reason is that calls of |\setbeamerfont| accumulate and the size was already set to |\large| by some font theme. Using the starred version of |\setbeamerfont| resets'' the font.
+
+Euclid decides that he would also like to change the color of the title to a dashing red, though, perhaps, with a bit of black added. He uses the following command:
+\begin{verbatim}
+\setbeamercolor{title}{fg=red!80!black}
+\end{verbatim}
+Trying the following command, Euclid is delighted to find that specifying a background color also has an effect:
+\begin{verbatim}
+\setbeamercolor{title}{fg=red!80!black,bg=red!20!white}
+\end{verbatim}
+
+Finally, Euclid is satisfied with the presentation and goes ahead and gives a great talk at the conference, making many new friends. He also writes that email to \beamer's author containing that long list of things that he missed in \beamer\ or that do not work. He is a bit disappointed to learn that it might take till ISPN~'79 for all these things to be taken care of, but he also understands that \beamer's authors also need some time to do research or otherwise he would have nothing to give presentations about.

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-tutorial.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-twoscreens.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-twoscreens.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,118 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2012,2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\label{section-twoscreens}
+
+This section describes options provided by \beamer\ for taking advantage of computers that have more than one video output and can display different outputs on them. For such systems, one video output can be attached to a projector and the main presentation is shown there. The second video output is attached to a small extra monitor (or is just shown on the display of the computer) and shows, for example, special notes for you. Alternatively, the two outputs might be attached to two different projectors. One can then show the main presentation on the first projection and, say, the table of contents on the second. Or the second projection might show a version translated into a different language. Or the seoncd projection might always show the previous'' slide. Or \ldots---we are sure you can think of further useful things.
+
+The basic idea behind \beamer's support of two video outputs is the following: Using special options you can ask \beamer\ to create a \pdf-file in which the pages'' are unusually wide or high. By default, their height will still be 128mm, but their width will be 192mm (twice the usual default 96mm). These superwide'' pages will show the slides of the main presentation on the left and auxilliary material on the right (this can be switched using appropriate options, though hyperlinks will only work if the presentation is on the left and the second screen on the right).
+
+For the presentation you attach two screens to the system. The windowing system believes that the screen is twice as wide as it actually is. Everything the windowing system puts on the left half of this big virtual screen is redirected to the first video output, everything on the right half is redirected to the second video output.
+
+When the presentation program displays the specially prepared superwide \beamer-presentation, exactly the left half of the screen will be filled with the main presentation, the right part is filled with the auxilliary material---voil\a. Not all presentation programs support this special feature. For example, the Acrobat Reader 6.0.2 will only use one screen in fullscreen mode on MacOS~X. On the other hand, a program named PDF Presenter supports showing dual-screen presentations. Generally, you will have to find out for yourself whether your display program and system support showing superwide presentations stretching over two screens.
+
+\beamer\ uses the package |pgfpages| to typeset two-screen presentations. Because of this, your first step when creating a two-screen presentation is to include this package:
+\begin{verbatim}
+\documentclass{beamer}
+\usepackage{pgfpages}
+\end{verbatim}
+
+The next step is to choose an appropriate option for showing something special on the second screen. These options are discussed in the following sections.
+
+One of the things these options do is to setup a certain |pgfpages|-layout that is appropriate for two-screen presentations. However, you can still change the |pgfpages|-layout arbitrarily, afterwards. For example, you might wish to enlarge the virtual pages. For details, see the documentation of |pgfpages|.
+
+
+\subsection{Showing Notes on the Second Screen}
+
+The first way to use a second screen is to show the presentation on the main screen and to show your notes on the second screen. The option |show notes on second screen| can be used for this. It is described on page~\pageref{command-notesonsecondscreen}.
+
+
+\subsection{Showing Second Mode Material on the Second Screen}
+
+The second way to use the second screen is to show a different vesion'' of the presentation on the second screen. This different version might be a translation or it might just always be the current table of contents.
+
+To specify what is shown on the second screen, you can use a special \beamer-mode called |second|. This mode behaves similar to modes like |handout| or |beamer|, but its effect depends on the exact options used:
+
+\begin{beameroption}{second mode text on second screen}{|=|\meta{location}}
+  This option causes the second screen to show the second mode material. The \meta{location} of the second screen can be |left|, |right|, |bottom|, or |top|.
+
+  In detail, the following happens: When a new frame needs to be typeset, \beamer\ checks whether the special option |typeset second| is given. If not, the frame is typeset normally and the slides are put on the main presentation screen (more precisely, on the logical |pgfpages|-page number zero). The second screen (logical page number one) shows whatever it showed before the frame was typeset.
+
+  If the special frame option |typeset second| is given, after each slide of the frame the frame contents is typeset once more, but this time for the mode |second|. This results in another slide, which is put on the second screen (on logical page number one). Then the whole page is shipped out.
+
+  The |second| mode behaves more like the |beamer| mode than other modes: Any overlay specification for |beamer| will also apply to |second| mode, unless an explicit |second| mode specification is also given. In particular, |\only<1-2>{Text}| will be shown on slides 1 and 2 in |second| mode, but only on the first slide in |handout| mode or |trans| mode.
+
+  \example
+\begin{verbatim}
+\documentclass{beamer}
+\usepackage{pgfpages}
+\setbeameroption{second mode text on second screen}
+\begin{document}
+\begin{frame}[typeset second]
+  This text is shown on the left and on the right.
+  \only<second>{This text is only shown on the right.}
+  \only<second:0>{This text is only shown on the left.}
+\end{frame}
+\begin{frame}
+  This text is shown on the left. The right shows the same as for the
+  previous frame.
+\end{frame}
+\begin{frame}[typeset second]
+  \alt<second>{The \string\alt command is useful for second
+  {Here comes some normal text for the first slide.}
+\end{frame}
+\end{document}
+\end{verbatim}
+
+  \example
+  The following example shows how translations can be added in a comfortable way.
+\begin{verbatim}
+\documentclass{beamer}
+\usepackage{pgfpages}
+\setbeameroption{second mode text on second screen}
+\DeclareRobustCommand\translation[1]{\mytranslation#1\relax}
+\long\def\mytranslation#1|#2\relax{\alt<second>{#2}{#1}}
+\title{\translation{Preparing Presentations|Vortr\"age vorbereiten}}
+\author{Till Tantau}
+\begin{document}
+\begin{frame}[typeset second]
+  \titlepage
+\end{frame}
+\begin{frame}[typeset second]
+  \frametitle{\translation{This is the frame title.|Dies ist der Titel des Rahmens.}}
+  \begin{itemize}
+  \item<1-> \translation{First|Erstens}.
+  \item<2-> \translation{Second|Zweitens}.
+  \item<3-> \translation{Third|Drittens}.
+  \end{itemize}
+  \translation{Do not use line-by-line uncovering.|Man sollte Text nicht
+  Zeile f\"ur Zeile aufdecken.}
+\end{frame}
+\end{document}
+\end{verbatim}
+\end{beameroption}
+
+In the last of the above example, it is a bit bothersome that the option |typeset second| has to be added to each frame. The following option globally sets this option:
+
+\begin{beameroption}{always typeset second mode}{|=|\meta{true or false}}
+  When this option is set to true, every following frame will have the option |typeset second| set to true.
+\end{beameroption}
+
+
+\subsection{Showing the Previous Slide on the Second Screen}
+
+\begin{beameroption}{previous slide on second screen}{|=|\meta{location}}
+  This option causes the second screen to show the previous slide that was typeset, unless this is overruled by a frame with the |[typeset second]| option set. The idea is that if you have two projectors you can always present the last two'' slides simultaneously and talk about them.
+
+  Using this option will switch off the updating of external files like the table of contents.
+\end{beameroption}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-twoscreens.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beamerug-workflow.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beamerug-workflow.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,225 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2011--2013,2015 by Vedran Mileti\'c, Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\section{Workflow For Creating a Beamer Presentation}
+\label{section-workflow}
+
+This section presents a possible workflow for creating a \beamer\ presentation and possibly a handout to go along with it. Technical questions are addressed, like which programs to call with which parameters.
+
+
+\subsection{Step One: Setup the Files}
+
+\beamernote
+It is advisable that you create a folder for each presentation. Even though your presentation will usually reside in a single file, \TeX\ produces so many extra files that things can easily get very confusing otherwise. The folder's name should ideally start with the date of your talk in ISO format (like 2003-12-25 for a Christmas talk), followed by some reminder text of what the talk is all about. Putting the date at the front in this format causes your presentation folders to be listed nicely when you have several of them residing in one directory. If you use an extra directory for each presentation, you can call your main file |main.tex|.
+
+To create an initial |main.tex| file for your talk, copy an existing file from the |beamer/solutions| directory and adapt it to your needs. A list of possible \beamer\ solutions that contain templates for presentation \TeX-files can be found below.
+
+If you wish your talk to reside in the same file as some different, non-presentation article version of your text, it is advisable to setup a more elaborate file scheme. See Section~\ref{section-article-version-workflow} for details.
+
+
+The next step is to fill the presentation file with |\section| and |\subsection| to create a preliminary outline. You'll find some hints on how to create a good outline in Section~\ref{section-structure-guidelines}.
+
+Put |\section| and |\subsection| commands into the (more or less empty) main file. Do not create any frames until you have a first working version of a possible table of contents. The file might look like this:
+\begin{verbatim}
+\documentclass{beamer}
+%% This is the file main.tex
+
+\usetheme{Berlin}
+
+\title{Example Presentation Created with the Beamer Package}
+\author{Till Tantau}
+\date{\today}
+
+\begin{document}
+
+\begin{frame}
+  \titlepage
+\end{frame}
+
+
+\section*{Outline}
+\begin{frame}
+  \tableofcontents
+\end{frame}
+
+\section{Introduction}
+\subsection{Overview of the Beamer Class}
+\subsection{Overview of Similar Classes}
+
+\section{Usage}
+\subsection{...}
+\subsection{...}
+
+\section{Examples}
+\subsection{...}
+\subsection{...}
+
+\begin{frame}
+
+\end{document}
+\end{verbatim}
+The empty frame at the end (which should be deleted later) ensures that the sections and subsections are actually part of the table of contents. This frame is necessary since a |\section| or |\subsection| command following the last page of a document has no effect.
+
+
+\subsection{Step Three: Creating a PDF or PostScript File}
+
+\beamernote
+Once a first version of the structure is finished, you should try to create a first PDF or PostScript file of your (still empty) talk to ensure that everything is working properly. This file will only contain the title page and the table of contents.
+
+\subsubsection{Creating PDF}
+
+\beamernote
+To create a |PDF| version of this file, run the program |pdflatex| on |main.tex| at least twice. You need to run it twice, so that \TeX\ can create the table of contents. (It may even be necessary to run it more often since all sorts of auxiliary files are created.) In the following example, the greater-than-sign is the prompt.
+\begin{verbatim}
+> pdflatex main.tex
+    ... lots of output ...
+> pdflatex main.tex
+    ... lots of output ...
+\end{verbatim}
+Alternatively, you can use |lualatex| or |xelatex| instead of |pdflatex| in above commands.
+
+You can next use a program like the Acrobat Reader, |xpdf|, |evince| or |okular| to view the resulting presentation.
+\begin{verbatim}
+\end{verbatim}
+
+
+\subsubsection{Creating PostScript}
+\label{section-postscript}
+
+\beamernote
+To create a PostScript version, you should first ascertain that the \textsc{hyperref} package (which is automatically loaded by the \beamer\ class) uses the option |dvips| or some compatible option, see the documentation of the \textsc{hyperref} package for details. Whether this is the case depends on the contents of your local |hyperref.cfg| file. You can enforce the usage of this option by passing |dvips| or a compatible option to the \beamer\ class (write |\documentclass[dvips]{beamer}|), which will pass this option on to the \textsc{hyperref} package.
+
+You can then run |latex| twice, followed by |dvips|.
+\begin{verbatim}
+> latex main.tex
+    ... lots of output ...
+> latex main.tex
+    ... lots of output ...
+> dvips -P pdf main.dvi
+\end{verbatim}
+
+The option (|-P pdf|) tells |dvips| to use Type~1 outline fonts instead of the usual Type~3 bitmap fonts. You may wish to omit this option if there is a problem with it.
+
+You can convert a PostScript file to a pdf file using
+\begin{verbatim}
+> ps2pdf main.ps main.pdf
+\end{verbatim}
+
+\subsubsection{Ways of Improving Compilation Speed}
+\label{section-speedup}
+
+While working on your presentation, it may sometimes be useful to \TeX\ your |.tex| file quickly and have the presentation contain only the most important information. This is especially true if you have a slow machine. In this case, you can do several things to speed up the compilation. First, you can use the |draft| class option.
+
+\begin{classoption}{draft}
+  Causes the headlines, footlines, and sidebars to be replaced by gray rectangles (their sizes are still computed, though). Many other packages, including |pgf| and |hyperref|, also speed up'' when this option is given.
+\end{classoption}
+
+Second, you can use the following command:
+
+\begin{command}{{\includeonlyframes}\marg{frame label list}}
+  This command behaves a little bit like the |\includeonly| command: Only the frames mentioned in the list are included. All other frames are suppressed. Nevertheless, the section and subsection commands are still executed, so that you still have the correct navigation bars. By labeling the current frame as, say, |current| and then saying |\includeonlyframes{current}|, you can work on a single frame quickly.
+
+  The \meta{frame label list} is a comma-separated list (without spaces) of the names of frames that have been labeled. To label a frame, you must pass the option |label=|\meta{name} to the |\frame| command or |frame| environment.
+
+  \example
+\begin{verbatim}
+\includeonlyframes{example1,example3}
+
+\frame[label=example1]
+{This frame will be included. }
+
+\frame[label=example2]
+{This frame will not be included. }
+
+\frame{This frame will not be included.}
+
+\againframe{example1} % Will be included
+\end{verbatim}
+\end{command}
+
+
+\subsection{Step Four: Create Frames}
+
+Once the table of contents looks satisfactory, start creating frames for your presentation by adding |frame| environments. You'll find guidelines on what to put on a frame in Section~\ref{section-frame-guidelines}.
+
+
+
+\emph{Always} test your presentation. For this, you should vocalize or subvocalize your talk in a quiet environment. Typically, this will show that your talk is too long. You should then remove parts of the presentation, such that it fits into the allotted time slot. Do \emph{not} attempt to talk faster in order to squeeze the talk into the given amount of time. You are almost sure to lose your audience this way.
+
+Do not try to create the perfect'' presentation immediately. Rather, test and retest the talk and modify it as needed.
+
+
+\subsection{Step Six: Create a Handout}
+
+\subsubsection{Creating the Handout}
+
+Once your talk is fixed, you can create a handout, if this seems appropriate. For this, you can use the class option |handout| as explained in Section~\ref{handout}. Typically, you might wish to put several handout slides on one page, see below on how to do this easily.
+
+You may also wish to create an article version of your talk. An article version'' of your presentation is a normal \TeX\ text typeset using, for example, the document class |article| or perhaps |llncs| or a similar document class. The \beamer\ class offers facilities to have this version coexist with your presentation version in one file and to share code. Also, you can include slides of your presentation as figures in your article version. Details on how to setup the article version can be found in Section~\ref{section-article}.
+
+\subsubsection{Printing the Handout}
+\label{section-printing-version}
+
+The easiest way to print a presentation is to user the Acrobat Reader with the option expand small pages to paper size'' form the printer dialog enabled. This is necessary, because slides are by default only 128mm by 96mm large.
+
+For the PostScript version and for printing multiple slides on a single page this simple approach does not work. In such cases you can use the |pgfpages| package, which works directly with |pdflatex|, |lualatex|, |xelatex| and |latex| plus |dvips|. Note however \emph{that this package destroys hyperlinks}. This is due to fundamental flaws in the \pdf-specification and it is not likely to change.
+
+The |pgfpages| can do all sorts of tricks with pages. The most important one for printing \beamer\ slides is the following command:
+\begin{verbatim}
+\usepackage{pgfpages}
+\pgfpagesuselayout{resize to}[a4paper,border shrink=5mm,landscape]
+\end{verbatim}
+This says Resize all pages to landscape A4 pages, no matter what their original size was, but shrink the pages by 5mm, so that there is a bit of a border around everything.'' Naturally, instead of |a4paper| you can also use |letterpaper| or any of the other standard paper sizes. For further options and details see the documentation of |pgfpages|.
+
+The second thing you might wish to do is to put several slides on a single page. This can be done as follows:
+\begin{verbatim}
+\usepackage{pgfpages}
+\pgfpagesuselayout{2 on 1}[a4paper,border shrink=5mm]
+\end{verbatim}
+This says Put two pages on one page and then resize everything so that it fits on A4 paper.'' Note that this time we do not need landscape as the resulting page is, after all, not in landscape mode.
+
+Instead of |2 on 1| you can also use |4 on 1|, but then with |landscape| once more, and also |8 on 1| and even |16 on 1| to get a grand (though unreadable) overview.
+
+If you put several slides on one page and if these slides normally have a white background, it may be useful to write the following in your preamble:
+\begin{verbatim}
+\mode<handout>{\setbeamercolor{background canvas}{bg=black!5}}
+\end{verbatim}
+This will cause the slides of the handout version to have a very light gray background. This makes it easy to discern the slides' border if several slides are put on one page.
+
+%% If you wish each slide to completely fill a letter-sized page, use the
+
+%% \begin{verbatim}
+%% > dvips -P pdf -tletter main.dvi -o main.temp.ps
+%% > psnup -1 -W128mm -H96mm -pletter main.temp.ps main.ps
+%% \end{verbatim}
+
+%% For A4-sized paper, use:
+
+%% \begin{verbatim}
+%% > dvips -P pdf -ta4 main.dvi -o main.temp.ps
+%% > psnup -1 -W128mm -H96mm -pa4 main.temp.ps main.ps
+%% \end{verbatim}
+
+%% In order to create a white margin around the whole page (which is sometimes
+%% useful for printing), add the option |-m 1cm| to the options of
+%% |psnup|.
+
+%% To put two or four slides on one page, use |-2|, respectively
+%% |-4| instead of |-1| as the first parameter for
+%% |psnup|. In this case, you may wish to add the option
+%% |-b 1cm| to add a bit of space around the individual slides. The same
+%% trick as for the \pdf-version can be used to make the borders of
+%% slides more pronounced in the handout version.

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beamerug-workflow.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
(Binary files differ)

Index: trunk/Master/texmf-dist/doc/latex/beamer/beameruserguide.pdf
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beameruserguide.pdf	2017-12-19 00:07:03 UTC (rev 46094)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beameruserguide.pdf	2017-12-19 00:09:01 UTC (rev 46095)

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beameruserguide.pdf
___________________________________________________________________
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/beameruserguide.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/beameruserguide.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,212 @@
+% Copyright 2003--2007 by Till Tantau
+% Copyright 2010 by Vedran Mileti\'c
+% Copyright 2011--2015 by Vedran Mileti\'c, Joseph Wright
+% Copyright 2017 by Joseph Wright
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Free Documentation License.
+%
+
+\documentclass{ltxdoc}
+
+\def\beamerugversion{3.47}
+\def\beamerugpgfversion{1.00}
+\def\beamerugxcolorversion{2.00}
+
+\usepackage{cmap}
+\usepackage{lmodern}
+\usepackage[T1]{fontenc}
+\usepackage[utf8]{inputenc}
+\usepackage{amsmath,amssymb}
+\usepackage{pifont}
+\usepackage{makeidx}
+\usepackage{pgf,xcolor}
+\usepackage[pdfborder={0 0 0},bookmarksnumbered]{hyperref}
+\usepackage{translator}
+
+
+\input{beamerug-macros}
+
+\makeindex
+
+%\includeonly{beamerug-introduction}
+
+\begin{document}
+
+{
+\parindent 0pt
+\vbox{\Huge
+The \beamer\ \textit{class}
+
+\Large
+User Guide for version \beamerugversion.}
+\vskip 3cm
+
+
+
+
+\normalsize
+\begin{verbatim}
+\begin{frame}
+  \frametitle{There Is No Largest Prime Number}
+  \framesubtitle{The proof uses \textit{reductio ad absurdum}.}
+  \begin{theorem}
+    There is no largest prime number.
+  \end{theorem}
+  \begin{proof}
+    \begin{enumerate}
+    \item<1-| alert at 1> Suppose $p$ were the largest prime number.
+    \item<2-> Let $q$ be the product of the first $p$ numbers.
+    \item<3-> Then $q+1$ is not divisible by any of them.
+    \item<1-> But $q + 1$ is greater than $1$, thus divisible by some prime
+      number not in the first $p$ numbers.\qedhere
+    \end{enumerate}
+  \end{proof}
+\end{frame}
+\end{verbatim}
+\vskip 0cm plus 1.5fill
+\vbox{}
+\clearpage
+}
+
+{
+  \vbox{}
+  \vskip 0pt plus 1fill
+  F\"ur alle, die die Sch\"onheit von Wissenschaft anderen zeigen wollen.
+  \vskip 0pt plus 3fill
+
+  \parindent 0pt
+  Copyright 2003--2007 by Till Tantau
+
+  Copyright 2010,2011 by Joseph Wright and Vedran Mileti\'c
+
+  Copyright 2016,2017 by Joseph Wright
+
+  \medskip
+  Permission is granted to copy, distribute and/or modify \emph{the documentation} under the terms of the \textsc{gnu} Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled \textsc{gnu} Free Documentation License.
+
+  \medskip
+  Permission is granted to copy, distribute and/or modify \emph{the code of the package} under the terms of the \textsc{gnu} General Public License, Version 2 or any later version published by the Free Software Foundation. A copy of the license is included in the section entitled \textsc{gnu} General Public License.
+
+  \medskip
+  Permission is also granted to distribute and/or modify \emph{both the documentation and the code} under the conditions of the LaTeX Project Public License, either version 1.3c of this license or (at your option) any later version. A copy of the license is included in the section entitled \LaTeX\ Project Public License.
+
+  \vbox{}
+  \clearpage
+}
+
+\index{Themes|see{Presentation themes}}
+\index{Templates|see{Beamer templates}}
+\index{Colors|see{Beamer colors}}
+\index{Fonts|see{Beamer fonts}}
+\index{Beamer elements|see{Beamer templates, colors, and fonts}}
+\index{Elements|see{Beamer templates, colors, and fonts}}
+\index{Template inserts|see{Inserts}}
+
+\title{\Huge The \beamer\ \textit{class}\\
+\Large\url{https://github.com/josephwright/beamer}\\
+\Large User Guide for version \beamerugversion.}
+\author{\href{mailto:tantau at users.sourceforge.net}{Till Tantau}, \href{mailto:joseph.wright at morningstar2.co.uk}{Joseph Wright}, \href{mailto:vmiletic at inf.uniri.hr}{Vedran Mileti\'c}}
+
+\maketitle
+
+\tableofcontents
+
+
+\include{beamerug-introduction}
+
+
+
+\part{Getting Started}
+
+This part helps you getting started. It starts with an explanation of how to install the class. Hopefully, this will be very simple, with a bit of luck the whole class is already correctly installed! You will also find an explanation of special things you should consider when using certain other packages.
+
+Next, a short tutorial is given that explains most of the features that you'll need in a typical presentation. Following the tutorial you will find a possible workflow'' for creating a presentation. Following this workflow may help you avoid problems later on.
+
+This part includes a guidelines sections. Following these guidelines can help you create good presentations (no guarantees, though). This guideline section is kept as general as possible; most of what is said in that section applies to presentations in general, independent of whether they have been created using \beamer\ or not.
+
+At the end of this part you will find a summary of the solutions templates that come with \beamer. You can use solutions templates to kick-start the creation of your presentation.
+
+\include{beamerug-installation}
+\include{beamerug-tutorial}
+\include{beamerug-workflow}
+\include{beamerug-guidelines}
+\include{beamerug-solutions}
+
+
+
+\part{Building a Presentation}
+
+This part contains an explanation of all the commands that are used to create presentations. It starts with a section treating the commands and environments used to create \emph{frames}, the basic building blocks of presentations. Next, the creation of overlays is explained.
+
+The following three sections concern commands and methods of \emph{structuring} a presentation. In order, the \emph{static global} structure, the \emph{interactive global} structure, and the \emph{local} structure are treated.
+
+Two further sections treat graphics and animations. Much of the material in these sections applies to other packages as well, not just to \beamer.
+
+\include{beamerug-frames}
+\include{beamerug-overlays}
+\include{beamerug-globalstructure}
+\include{beamerug-interaction}
+\include{beamerug-localstructure}
+\include{beamerug-graphics}
+\include{beamerug-animations}
+
+
+
+\part{Changing the Way Things Look}
+
+\beamer\ offers ways to change the appearance of a presentation at all levels of detail. On the top level, \emph{themes} can be used to globally change the appearance conveniently. On the bottom level, \emph{templates} allow you to specify the appearance of every minute detail individually.
+
+Two important aspects of the appearance'' of a presentation are treated in extra sections: colors and fonts. Here, too, color and font themes can be used to globally change the colors or fonts used in a presentation, while you can still change the color or font of, say, block titles independently of everything else.
+
+\include{beamerug-themes}
+\include{beamerug-elements}
+\include{beamerug-color}
+\include{beamerug-fonts}
+
+
+
+\part{Creating Supporting Material}
+
+The objective of the \beamer\ class is to simplify the creation of presentations using a projector. However, a presentation rarely exists in isolation. Material that accompanies a presentation includes:
+\begin{itemize}
+\item
+  Presentations should normally be accompanied by \emph{handouts}, written text that the audience can read during and/or after your presentation is given.
+\item
+  You might wish to create notes for yourself that, ideally, are shown to you on your computer screen while the audience sees the presentation.
+\item
+  You might wish to create a printout of your talk, either for yourself or for checking for errors.
+\item
+  You might wish to create a transparencies version of your talk as a fall-back.
+\end{itemize}
+
+This part dicusses how \beamer\ helps you with the creation of the above.
+
+\include{beamerug-notes}
+\include{beamerug-transparencies}
+\include{beamerug-nonpresentation}
+\include{beamerug-twoscreens}
+
+
+
+\part{Howtos}
+
+This part contains explanations-of-how-to-do-things (commonly known as \emph{howtos}). These explanations are not really part of the \beamer\ core.'' Rather, they explain how to use \beamer\ to achieve a certain effect or how get something special done.
+
+The first howto is about tricky uncovering situations.
+
+The second howto explains how you can import (parts or) presentations created using some other \LaTeX-presentation class, like \prosper.
+
+\include{beamerug-tricks}
+\include{beamerug-emulation}
+
+\printindex
+
+\end{document}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/beameruserguide.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/conference-ornate-20min.de.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/conference-ornate-20min.de.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,293 @@
+% $Header$
+
+\documentclass{beamer}
+
+% Diese Datei enth\xE4lt eine L\xF6sungsvorlage f\xFCr:
+
+% - Vortr\xE4ge bei einer (deutschsprachigen) Konferenz/einem Kolloquium.
+% - Vortragsl\xE4nge von etwa 20 Minuten.
+% - Aussehen des Vortrags ist verschn\xF6rkelt/dekorativ.
+
+
+
+% Copyright 2004 by Till Tantau <tantau at users.sourceforge.net>.
+%
+% In principle, this file can be redistributed and/or modified under
+% the terms of the GNU Public License, version 2.
+%
+% However, this file is supposed to be a template to be modified
+% for your own needs. For this reason, if you use this file as a
+% template and not specifically distribute it as part of a another
+% package/program, I grant the extra permission to freely copy and
+% modify this file as you see fit and even to delete this copyright
+% notice.
+
+
+
+\mode<presentation>
+{
+  \usetheme{Warsaw}
+  % oder ...
+
+  \setbeamercovered{transparent}
+  % oder auch nicht
+}
+
+
+\usepackage[german]{babel}
+% oder was auch immer
+
+\usepackage[latin1]{inputenc}
+% oder was auch immer
+
+\usepackage{times}
+\usepackage[T1]{fontenc}
+% Oder was auch immer. Zu beachten ist, das Font und Encoding passen
+% m\xFCssen. Falls T1 nicht funktioniert, kann man versuchen, die Zeile
+% mit fontenc zu l\xF6schen.
+
+
+\title[Kurzversion des Titels] % (optional, nur bei langen Titeln n\xF6tig)
+{Titel wie im Tagunsband angegeben\\ (u.U.\ also englisch)}
+
+\subtitle
+{Untertitel nur angeben, wenn es einen im Tagungsband gibt}
+
+\author[Autor, Anders] % (optional, nur bei vielen Autoren)
+{F.~Autor\inst{1} \and S.~Anders\inst{2}}
+% - Namen m\xFCssen in derselben Reihenfolge wie im Papier erscheinen.
+% - Der \inst{?} Befehl sollte nur verwendet werden, wenn die Autoren
+%   unterschiedlichen Instituten angeh\xF6ren.
+
+\institute[Universit\xE4ten Hier und Dort] % (optional, aber oft n\xF6tig)
+{
+  \inst{1}%
+  Institut f\xFCr Informatik\\
+  Universit\xE4t Hier
+  \and
+  \inst{2}%
+  Institut f\xFCr theoretische Philosophie\\
+  Universit\xE4t Dort}
+% - Der \inst{?} Befehl sollte nur verwendet werden, wenn die Autoren
+%   unterschiedlichen Instituten angeh\xF6ren.
+% - Keep it simple, niemand interessiert sich f\xFCr die genau Adresse.
+
+\date[KPT 2003] % (optional, sollte der abgek\xFCrzte Konferenzname sein)
+{Konferenz \xFCber Pr\xE4sentationstechniken, 2004}
+% - Vollee oder abgek\xFCrzter Name sind m\xF6glich.
+% - Dieser Eintrag ist nicht f\xFCr das Publikum gedacht (das wei\xDF
+%   n\xE4mlich, bei welcher Konferenz es ist), sondern f\xFCr Leute, die die
+%   Folien sp\xE4ter lesen.
+
+\subject{Informatik}
+% Dies wird lediglich in den PDF Informationskatalog einf\xFCgt. Kann gut
+% weggelassen werden.
+
+
+% Falls eine Logodatei namens "university-logo-filename.xxx" vorhanden
+% ist, wobei xxx ein von latex bzw. pdflatex lesbares Graphikformat
+% ist, so kann man wie folgt ein Logo einf\xFCgen:
+
+% \pgfdeclareimage[height=0.5cm]{university-logo}{university-logo-filename}
+% \logo{\pgfuseimage{university-logo}}
+
+
+
+% Folgendes sollte gel\xF6scht werden, wenn man nicht am Anfang jedes
+% Unterabschnitts die Gliederung nochmal sehen m\xF6chte.
+\AtBeginSubsection[]
+{
+  \begin{frame}<beamer>{Gliederung}
+    \tableofcontents[currentsection,currentsubsection]
+  \end{frame}
+}
+
+
+% Falls Aufz\xE4hlungen immer schrittweise gezeigt werden sollen, kann
+% folgendes Kommando benutzt werden:
+
+%\beamerdefaultoverlayspecification{<+->}
+
+
+
+\begin{document}
+
+\begin{frame}
+  \titlepage
+\end{frame}
+
+\begin{frame}{Gliederung}
+  \tableofcontents
+  % Die Option [pausesections] k\xF6nnte n\xFCtzlich sein.
+\end{frame}
+
+
+
+% Einen Vortrag zu strukturieren ist nicht immer einfach. Die
+% nachfolgende Struktur kann unangemessen sein. Hier ein paar Regeln,
+% die f\xFCr diese L\xF6sungsvorlage gelten:
+
+% - Es sollte genau zwei oder drei Abschnitte geben (neben der
+%   Zusammenfassung).
+% - *H\xF6chstens* drei Unterabschnitte pro Abschnitt.
+% - Pro Rahmen sollte man zwischen 30s und 2min reden. Es sollte also
+%   15 bis 30 Rahmen geben.
+
+% - Konferenzteilnehmer wissen oft wenig von der Materie des
+%   Vortrags. Deshalb: vereinfachen!
+% - In 20 Minuten ist es schon schwer genug, die Hauptbotschaft zu
+%   vermitteln. Deshalb sollten Details ausgelassen werden, selbst
+%   wenn dies zu Ungenauigkeiten oder Halbwahrheiten f\xFChrt.
+% - Falls man Details wegl\xE4sst, die eigentlich wichtig f\xFCr einen
+%   Beweis/Implementation sind, so sagt man dies einmal n\xFCchtern. Alle
+%   werden damit gl\xFCcklich sein.
+
+\section{Motivation}
+
+\subsection{Das behandelte Problem}
+
+\begin{frame}{\xDCberschriften m\xFCssen informativ sein.\\
+    Korrekte Gro\xDF-/Kleinschreibung beachten.}{Untertitel sind optional.}
+  % - Eine \xDCberschrift fasst einen Rahmen verst\xE4ndlich zusammen. Man
+  %   muss sie verstehen k\xF6nnen, selbst wenn man nicht den Rest des
+  %   Rahmens versteht.
+
+  \begin{itemize}
+  \item
+    Viel \texttt{itemize} benutzen.
+  \item
+    Sehr kurze S\xE4tze oder Satzglieder verwenden.
+  \end{itemize}
+\end{frame}
+
+\begin{frame}{\xDCberschriften m\xFCssen informativ sein.}
+
+  Man kann Overlays erzeugen\dots
+  \begin{itemize}
+  \item mit dem \texttt{pause}-Befehl:
+    \begin{itemize}
+    \item
+      Erster Punkt.
+      \pause
+    \item
+      Zweiter Punkt.
+    \end{itemize}
+  \item
+    mittels Overlay-Spezifikationen:
+    \begin{itemize}
+    \item<3->
+      Erster Punkt.
+    \item<4->
+      Zweiter Punkt.
+    \end{itemize}
+  \item
+    mit dem allgemeinen \texttt{uncover}-Befehl:
+    \begin{itemize}
+      \uncover<5->{\item
+        Erster Punkt.}
+      \uncover<6->{\item
+        Zweiter Punkt.}
+    \end{itemize}
+  \end{itemize}
+\end{frame}
+
+
+\subsection{Fr\xFChere Arbeiten}
+
+\begin{frame}{\xDCberschriften m\xFCssen informativ sein.}
+\end{frame}
+
+\begin{frame}{\xDCberschriften m\xFCssen informativ sein.}
+\end{frame}
+
+
+\section{Unsere Resultate/Beitrag}
+
+\subsection{Hauptresultate}
+
+\begin{frame}{\xDCberschriften m\xFCssen informativ sein.}
+\end{frame}
+
+\begin{frame}{\xDCberschriften m\xFCssen informativ sein.}
+\end{frame}
+
+\begin{frame}{\xDCberschriften m\xFCssen informativ sein.}
+\end{frame}
+
+
+
+\subsection{Beweis-/Implementationsideen}
+
+\begin{frame}{\xDCberschriften m\xFCssen informativ sein.}
+\end{frame}
+
+\begin{frame}{\xDCberschriften m\xFCssen informativ sein.}
+\end{frame}
+
+\begin{frame}{\xDCberschriften m\xFCssen informativ sein.}
+\end{frame}
+
+
+
+\section*{Zusammenfassung}
+
+\begin{frame}{Zusammenfassung}
+
+  % Die Zusammenfassung sollte sehr kurz sein.
+  \begin{itemize}
+  \item
+    Die \alert{erste Hauptbotschaft} des Vortrags in ein bis zwei Zeilen.
+  \item
+    Die \alert{zweite Hauptbotschaft} des Vortrags in ein bis zwei Zeilen.
+  \item
+    Eventuell noch eine \alert{dritte Botschaft}, aber nicht noch mehr.
+  \end{itemize}
+
+  % Der folgende Ausblick ist optional.
+  \vskip0pt plus.5fill
+  \begin{itemize}
+  \item
+    Ausblick
+    \begin{itemize}
+    \item
+      Etwas, was wir noch nicht l\xF6sen konnten.
+    \item
+      Nochwas, das wir noch nicht l\xF6sen konnten.
+    \end{itemize}
+  \end{itemize}
+\end{frame}
+
+
+
+% Alles nachfolgende ist optional und typischerweise nicht n\xF6tig.
+\appendix
+\section<presentation>*{\appendixname}
+\subsection<presentation>*{Weiterf\xFChrende Literatur}
+
+\begin{frame}[allowframebreaks]
+  \frametitle<presentation>{Weiterf\xFChrende Literatur}
+
+  \begin{thebibliography}{10}
+
+  \beamertemplatebookbibitems
+  % Anfangen sollte man mit \xDCbersichtswerken.
+
+  \bibitem{Autor1990}
+    A.~Autor.
+    \newblock {\em Einf\xFChrung in das Pr\xE4sentationswesen}.
+    \newblock Klein-Verlag, 1990.
+
+
+  \beamertemplatearticlebibitems
+  % Vertiefende Literatur kommt sp\xE4ter. Die Liste sollte kurz sein.
+
+  \bibitem{Jemand2000}
+    S.~Jemand.
+    \newblock On this and that.
+    \newblock {\em Journal of This and That}, 2(1):50--100, 2000.
+  \end{thebibliography}
+\end{frame}
+
+\end{document}
+
+

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/conference-ornate-20min.de.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/conference-ornate-20min.en.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/conference-ornate-20min.en.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,285 @@
+% $Header$
+
+\documentclass{beamer}
+
+% This file is a solution template for:
+
+% - Talk at a conference/colloquium.
+% - Talk length is about 20min.
+% - Style is ornate.
+
+
+
+% Copyright 2004 by Till Tantau <tantau at users.sourceforge.net>.
+%
+% In principle, this file can be redistributed and/or modified under
+% the terms of the GNU Public License, version 2.
+%
+% However, this file is supposed to be a template to be modified
+% for your own needs. For this reason, if you use this file as a
+% template and not specifically distribute it as part of a another
+% package/program, I grant the extra permission to freely copy and
+% modify this file as you see fit and even to delete this copyright
+% notice.
+
+
+\mode<presentation>
+{
+  \usetheme{Warsaw}
+  % or ...
+
+  \setbeamercovered{transparent}
+  % or whatever (possibly just delete it)
+}
+
+
+\usepackage[english]{babel}
+% or whatever
+
+\usepackage[latin1]{inputenc}
+% or whatever
+
+\usepackage{times}
+\usepackage[T1]{fontenc}
+% Or whatever. Note that the encoding and the font should match. If T1
+% does not look nice, try deleting the line with the fontenc.
+
+
+\title[Short Paper Title] % (optional, use only with long paper titles)
+{Title As It Is In the Proceedings}
+
+\subtitle
+{Include Only If Paper Has a Subtitle}
+
+\author[Author, Another] % (optional, use only with lots of authors)
+{F.~Author\inst{1} \and S.~Another\inst{2}}
+% - Give the names in the same order as the appear in the paper.
+% - Use the \inst{?} command only if the authors have different
+%   affiliation.
+
+\institute[Universities of Somewhere and Elsewhere] % (optional, but mostly needed)
+{
+  \inst{1}%
+  Department of Computer Science\\
+  University of Somewhere
+  \and
+  \inst{2}%
+  Department of Theoretical Philosophy\\
+  University of Elsewhere}
+% - Use the \inst command only if there are several affiliations.
+% - Keep it simple, no one is interested in your street address.
+
+\date[CFP 2003] % (optional, should be abbreviation of conference name)
+{Conference on Fabulous Presentations, 2003}
+% - Either use conference name or its abbreviation.
+% - Not really informative to the audience, more for people (including
+%   yourself) who are reading the slides online
+
+\subject{Theoretical Computer Science}
+% This is only inserted into the PDF information catalog. Can be left
+% out.
+
+
+
+% If you have a file called "university-logo-filename.xxx", where xxx
+% is a graphic format that can be processed by latex or pdflatex,
+% resp., then you can add a logo as follows:
+
+% \pgfdeclareimage[height=0.5cm]{university-logo}{university-logo-filename}
+% \logo{\pgfuseimage{university-logo}}
+
+
+
+% the beginning of each subsection:
+\AtBeginSubsection[]
+{
+  \begin{frame}<beamer>{Outline}
+    \tableofcontents[currentsection,currentsubsection]
+  \end{frame}
+}
+
+
+% If you wish to uncover everything in a step-wise fashion, uncomment
+% the following command:
+
+%\beamerdefaultoverlayspecification{<+->}
+
+
+\begin{document}
+
+\begin{frame}
+  \titlepage
+\end{frame}
+
+\begin{frame}{Outline}
+  \tableofcontents
+  % You might wish to add the option [pausesections]
+\end{frame}
+
+
+% Structuring a talk is a difficult task and the following structure
+% may not be suitable. Here are some rules that apply for this
+% solution:
+
+% - Exactly two or three sections (other than the summary).
+% - At *most* three subsections per section.
+% - Talk about 30s to 2min per frame. So there should be between about
+%   15 and 30 frames, all told.
+
+% - A conference audience is likely to know very little of what you
+%   are going to talk about. So *simplify*!
+% - In a 20min talk, getting the main ideas across is hard
+%   enough. Leave out details, even if it means being less precise than
+%   you think necessary.
+% - If you omit details that are vital to the proof/implementation,
+%   just say so once. Everybody will be happy with that.
+
+\section{Motivation}
+
+\subsection{The Basic Problem That We Studied}
+
+\begin{frame}{Make Titles Informative. Use Uppercase Letters.}{Subtitles are optional.}
+  % - A title should summarize the slide in an understandable fashion
+  %   for anyone how does not follow everything on the slide itself.
+
+  \begin{itemize}
+  \item
+    Use \texttt{itemize} a lot.
+  \item
+    Use very short sentences or short phrases.
+  \end{itemize}
+\end{frame}
+
+\begin{frame}{Make Titles Informative.}
+
+  You can create overlays\dots
+  \begin{itemize}
+  \item using the \texttt{pause} command:
+    \begin{itemize}
+    \item
+      First item.
+      \pause
+    \item
+      Second item.
+    \end{itemize}
+  \item
+    using overlay specifications:
+    \begin{itemize}
+    \item<3->
+      First item.
+    \item<4->
+      Second item.
+    \end{itemize}
+  \item
+    using the general \texttt{uncover} command:
+    \begin{itemize}
+      \uncover<5->{\item
+        First item.}
+      \uncover<6->{\item
+        Second item.}
+    \end{itemize}
+  \end{itemize}
+\end{frame}
+
+
+\subsection{Previous Work}
+
+\begin{frame}{Make Titles Informative.}
+\end{frame}
+
+\begin{frame}{Make Titles Informative.}
+\end{frame}
+
+
+
+\section{Our Results/Contribution}
+
+\subsection{Main Results}
+
+\begin{frame}{Make Titles Informative.}
+\end{frame}
+
+\begin{frame}{Make Titles Informative.}
+\end{frame}
+
+\begin{frame}{Make Titles Informative.}
+\end{frame}
+
+
+\subsection{Basic Ideas for Proofs/Implementation}
+
+\begin{frame}{Make Titles Informative.}
+\end{frame}
+
+\begin{frame}{Make Titles Informative.}
+\end{frame}
+
+\begin{frame}{Make Titles Informative.}
+\end{frame}
+
+
+
+\section*{Summary}
+
+\begin{frame}{Summary}
+
+  % Keep the summary *very short*.
+  \begin{itemize}
+  \item
+    The \alert{first main message} of your talk in one or two lines.
+  \item
+    The \alert{second main message} of your talk in one or two lines.
+  \item
+    Perhaps a \alert{third message}, but not more than that.
+  \end{itemize}
+
+  % The following outlook is optional.
+  \vskip0pt plus.5fill
+  \begin{itemize}
+  \item
+    Outlook
+    \begin{itemize}
+    \item
+      Something you haven't solved.
+    \item
+      Something else you haven't solved.
+    \end{itemize}
+  \end{itemize}
+\end{frame}
+
+
+
+% All of the following is optional and typically not needed.
+\appendix
+\section<presentation>*{\appendixname}
+
+\begin{frame}[allowframebreaks]
+
+  \begin{thebibliography}{10}
+
+  \beamertemplatebookbibitems
+
+  \bibitem{Author1990}
+    A.~Author.
+    \newblock {\em Handbook of Everything}.
+    \newblock Some Press, 1990.
+
+
+  \beamertemplatearticlebibitems
+  % Followed by interesting articles. Keep the list short.
+
+  \bibitem{Someone2000}
+    S.~Someone.
+    \newblock On this and that.
+    \newblock {\em Journal of This and That}, 2(1):50--100,
+    2000.
+  \end{thebibliography}
+\end{frame}
+
+\end{document}
+
+

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/conference-ornate-20min.en.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/conference-ornate-20min.fr.tex	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/beamer/conference-ornate-20min.fr.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -0,0 +1,297 @@
+% /solutions/conference-talks/conference-ornate-20min.fr.tex, 22/02/2006 De Sousa
+
+\documentclass{beamer}
+
+% Ce fichier est un exemple d'expos\xE9
+
+% - pour des conf\xE9rences,
+% - d'une dur\xE9e approximative de 20 minutes,
+% - avec un style ornemental.
+
+
+% Copyright 2004 by Till Tantau <tantau at users.sourceforge.net>.
+%
+% Traduction de Philippe De Sousa <philippejjg at free.fr>
+%
+% En principe, ce fichier peut \xEAtre redistribu\xE9 et/ou modifi\xE9 conform\xE9ment
+% aux termes de la GNU Public License, version 2.
+%
+% Cependant, ce fichier est suppos\xE9 comme \xE9tant un "exemple-type" qui peut \xEAtre modifi\xE9
+% selon vos propres besoins. Pour cette raison, si vous utilisez ce fichier en tant qu'
+% "exemple-type" et non sp\xE9cifiquement pour le distribuer en tant que partie d'un
+% package ou programme, je vous donne la permission exceptionnelle de copier librement et
+% de modifier ce fichier et m\xEAme d'effacer ce message de copyright.
+
+
+\mode<presentation> {
+  \usetheme{Warsaw}
+  % ou autre ...
+
+  \setbeamercovered{transparent}
+  % ou autre chose (il est \xE9galement possible de supprimer cette ligne)
+}
+
+
+\usepackage[french]{babel}
+% or autre comme par exemple \usepackage[english]{babel}
+
+\usepackage[latin1]{inputenc}
+% or autre
+
+\usepackage{times}
+\usepackage[T1]{fontenc}
+% Or autre. Notez que le codage et la fonte doivent \xEAtre assortis. Si T1
+% ne para\xEEt pas tr\xE8s esth\xE9tique, essayer d'effacer la ligne contenant fontenc.
+
+
+\title[Titre court] % (facultatif, \xE0 utiliser uniquement si le titre de l'article est trop long)
+{Tr\xE8s long titre qui prend de la place}
+
+\subtitle {ne compl\xE9ter que si l'article poss\xE8de un sous-titre}
+
+\author[Auteur, Lautre] % (facultatif, \xE0 utiliser seulement avec plusieurs auteurs)
+{F.~Auteur\inst{1} \and S.~Lautre\inst{2}}
+% - Composez les noms dans l'ordre dans lequel ils appara\xEEtrons dans l'article
+% - Utilisez la commande \inst{?} uniquement si les auteurs ont des affiliations
+%   diff\xE9rentes.
+
+\institute[Universit\xE9s de Quelque Part et d'Ailleurs] % (facultatif mais g\xE9n\xE9ralement n\xE9cessaire)
+{
+  \inst{1}%
+  D\xE9partement  d'Informatique\\
+  Universit\xE9 de Quelque Part
+  \and
+  \inst{2}%
+  D\xE9partement de Philosophie Th\xE9orique\\
+  Universit\xE9 d'Ailleurs}
+% - Utilisez la commande \inst uniquement s'il y a plusieurs affectations
+% - Fa\xEEtes quelque chose de simple, personne ne s'int\xE9resse \xE0 votre adresse
+
+\date[CFP 2006] % (facultatif, peut \xEAtre une abr\xE9viation du nom de la conf\xE9rence)
+{Conf\xE9rence sur les Fantastiques Pr\xE9sentations, 2006}
+% - Utilisez \xE0 la fois le nom de la conf\xE9rence et son abr\xE9viation.
+% - N'a pas r\xE9ellement d'importance pour l'assistance qui sera pr\xE9sente lors de la conf\xE9rence,
+%   mais en a surtout pour les personnes (y compris vous-m\xEAme) qui liront les transparents en ligne.
+
+\subject{La th\xE9orie de l'Informatique}
+% Ins\xE9r\xE9 uniquement dans la page d'information du fichier PDF. Peut \xEAtre
+% supprim\xE9.
+
+
+
+% Si vous avez un fichier nomm\xE9 "universit\xE9-logo-nomfichier.xxx", o\xF9 xxx
+% est un format graphique accept\xE9 par latex ou pdflatex (comme par exemple .png),
+% alors vous pouvez ins\xE9rer votre logo ainsi :
+
+% \pgfdeclareimage[height=0.5cm]{le-logo}{universit\xE9-logo-nomfichier}
+% \logo{\pgfuseimage{le-logo}}
+
+
+
+% \xC0 supprimer si vous ne voulez pas que la table des mati\xE8res apparaisse
+% au d\xE9but de chaque sous-section :
+
+\AtBeginSubsection[] {
+  \begin{frame}<beamer>{Lignes directrices}
+    \tableofcontents[currentsection,currentsubsection]
+  \end{frame}
+}
+
+% Si vous souhaitez recouvrir vos transparents un \xE0 un,
+% utilisez la commande suivante (pour plus d'info, voir la page 74 du manuel
+% d'utilisation de Beamer (version 3.06) par Till Tantau) :
+
+%\beamerdefaultoverlayspecification{<+->}
+
+
+\begin{document}
+
+\begin{frame}
+  \titlepage
+\end{frame}
+
+\begin{frame}{Lignes directrices}
+  \tableofcontents
+  % Vous pouvez, si vous le souhaiter ajouter l'option [pausesections]
+\end{frame}
+
+
+% Structurer l'entretien est une t\xE2che difficile et la structure suivante
+% pourrait ne pas convenir. Voici quelques r\xE8gles \xE0 appliquer pour cet
+% exemple ci :
+
+% - Avoir exactement deux ou trois sections (autre que la table des mati\xE8res).
+% - Tout au plus trois sous-sections par section
+% - Parlez approximativement entre 30 secondes et 2 minutes par transparent. Il
+%   devrait donc y avoir entre 15 et 30 transparents, tous ayant \xE9t\xE9 comment\xE9s.
+
+% - Le public d'une conf\xE9rence conna\xEEtra probablement peu de chose sur le sujet
+%   que vous serez en train de traiter. Donc, *simplifiez* !
+% - Dans un expos\xE9 de 20 minutes, garder \xE0 l'esprit les id\xE9es principales est largement
+%   suffisant pour votre assistance. Laissez tomber certains d\xE9tails, m\xEAme s'ils vous
+%   semblent n\xE9cessaires.
+% - Si vous omettez un d\xE9tail qui est vital pour une preuve/mise en oeuvre,
+%   dites le simplement une fois. Ce sera suffisant pour tout le monde.
+
+\section{Motivation}
+
+\subsection{Le probl\xE8me \xE9tudi\xE9}
+
+\begin{frame}{Fa\xEEtes des titres qui informent.}{Les sous-titres sont facultatifs.}
+  % - Le titre doit r\xE9sumer le transparent dans un langage compr\xE9hensible
+  %   par tous ceux qui ne suivront rien de ce qu'il y a sur ce transparent.
+
+  \begin{itemize}
+  \item Utilisez \texttt{itemize} \xE0 volont\xE9.
+  \item Utilisez des phrases tr\xE8s courtes et de courtes expressions.
+  \end{itemize}
+\end{frame}
+
+\begin{frame}{Fa\xEEtes des titres qui informent}
+
+  Vous pouvez cr\xE9er des recouvrements\dots
+  \begin{itemize}
+  \item en utilisant la commande \texttt{pause} :
+    \begin{itemize}
+    \item
+      Premier item.
+      \pause
+    \item
+      Second item.
+    \end{itemize}
+  \item
+    en utilisant les sp\xE9cifications des recouvrements
+    \begin{itemize}
+    \item<3->
+      Premier item.
+    \item<4->
+      Second item.
+    \end{itemize}
+  \item
+    en utilisant en g\xE9n\xE9ral la commande \texttt{uncover} :
+    \begin{itemize}
+      \uncover<5->{\item
+        Premier item.}
+      \uncover<6->{\item
+        Second item.}
+    \end{itemize}
+  \end{itemize}
+\end{frame}
+
+
+\subsection{Travail pr\xE9alable}
+
+\begin{frame}{Fa\xEEtes des titres qui informent.}
+
+  {\scshape Beamer}, c'est vraiment super !
+\end{frame}
+
+\begin{frame}{Fa\xEEtes des titres qui informent.}
+
+  {\scshape Beamer}, c'est vraiment g\xE9nial !
+\end{frame}
+
+
+
+\section{Nos r\xE9sultats/contribution}
+
+\subsection{Principaux r\xE9sultats}
+
+\begin{frame}{Fa\xEEtes des titres qui informent.}
+
+  {\scshape Beamer} poss\xE8dent plusieurs th\xE8mes diff\xE9rents...
+\end{frame}
+
+\begin{frame}{Fa\xEEtes des titres qui informent.}
+
+  Merci \xE0 Till Tantau pour {\scshape Beamer} et son manuel.
+\end{frame}
+
+\begin{frame}{Fa\xEEtes des titres qui informent.}
+
+  Toute la puissance de \LaTeX{} pour cr\xE9er des pr\xE9sentations.
+\end{frame}
+
+
+\subsection{Id\xE9es de bases pour les preuves}
+
+\begin{frame}{Fa\xEEtes des titres qui informent.}
+
+  Une id\xE9e...
+\end{frame}
+
+\begin{frame}{Fa\xEEtes des titres qui informent.}
+
+  Une autre...
+\end{frame}
+
+\begin{frame}{Fa\xEEtes des titres qui informent.}
+
+  Et une derni\xE8re...
+\end{frame}
+
+
+
+\section*{R\xE9sum\xE9}
+
+\begin{frame}{R\xE9sum\xE9}
+
+  % Fa\xEEtes un r\xE9sum\xE9 *tr\xE8s court*.
+  \begin{itemize}
+  \item
+    Le \alert{premier message principal} de l'expos\xE9 en une ligne ou
+    deux.
+  \item
+    Le \alert{deuxi\xE8me message principal} de l'expos\xE9 en une ligne ou
+    deux.
+  \item
+    Peut-\xEAtre un \alert{troisi\xE8me message}, mais pas plus que \xE7a.
+  \end{itemize}
+
+  % Les perspectives suivantes sont facultatives.
+  \vskip0pt plus.5fill
+  \begin{itemize}
+  \item
+    Perspectives
+    \begin{itemize}
+    \item
+      Probl\xE8me non r\xE9solu.
+    \item
+      Autre probl\xE8me non r\xE9solu.
+    \end{itemize}
+  \end{itemize}
+\end{frame}
+
+
+
+% Tout ce qui suit est facultatif et n'est typiquement pas n\xE9cessaire.
+\appendix
+\section<presentation>*{\appendixname}
+\subsection<presentation>*{Lectures compl\xE9mentaires}
+
+\begin{frame}[allowframebreaks]
+  \frametitle<presentation>{Lectures compl\xE9mentaires}
+
+  \begin{thebibliography}{10}
+
+  \beamertemplatebookbibitems
+  % Commencer avec des livres (image d'un livre ins\xE9r\xE9e)
+
+  \bibitem{Auteur1990}
+    A.~Auteur.
+    \newblock {\em Livre de quelque chose}.
+    \newblock Une Edition, 1990.
+
+
+  \beamertemplatearticlebibitems
+  % Et continuer avec les articles (image d'un article incluse). Fa\xEEtes une liste br\xE8ve.
+
+  \bibitem{Quelqu'un2000}
+    S.~Quelqu'un.
+    \newblock Et ceci et cela.
+    \newblock {\em Journal de ceci et cela}, 2(1):50--100,
+    2000.
+  \end{thebibliography}
+\end{frame}
+
+\end{document}

Property changes on: trunk/Master/texmf-dist/doc/latex/beamer/conference-ornate-20min.fr.tex
___________________________________________________________________
## -0,0 +1 ##
+native
\ No newline at end of property
Deleted: trunk/Master/texmf-dist/doc/latex/beamer/doc/Makefile
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/doc/Makefile	2017-12-19 00:07:03 UTC (rev 46094)
+++ trunk/Master/texmf-dist/doc/latex/beamer/doc/Makefile	2017-12-19 00:09:01 UTC (rev 46095)
@@ -1,75 +0,0 @@
-AUXFILES = *.aux *.bbl *-blx.bib *.bcf *.blg *.fdb_latexmk *.idx *.ilg *.ind *.log *mpgraph.mp *.nav *.out *.snm *.synctex.gz *.tmp *.toc *.tui *.tuc *.tuo *.vrb *~
-
-rerun = "(There were undefined references|Rerun to get (cross-references|the bars) right)"
-doc   = beameruserguide
-
-themes = AnnArbor Antibes Berkeley Berlin Bergen Boadilla Copenhagen \
-  Darmstadt Dresden EastLansing Frankfurt Goettingen Hannover Ilmenau JuanLesPins \
-  Luebeck Malmoe Madrid Marburg Montpellier PaloAlto Pittsburgh \
-  Rochester Singapore Szeged Warsaw \
-  CambridgeUS \
-  default boxes
-
-fontthemes = default serif structurebold structureitalicserif structuresmallcapsserif
-
-colorthemes = default crane albatross seahorse whale dolphin \
-  rose orchid sidebartab lily structure dove seagull beetle fly wolverine spruce \
-  beaver monarca
-
-outerthemes = default infolines miniframes shadow sidebar smoothbars smoothtree split tree
-
-innerthemes = default circles rectangles rounded inmargin
-
-all: $(doc).pdf - -beameruserguide.idx: - touch beameruserguide.idx - -beameruserguide.ind: beameruserguide.idx - makeindex$(doc).idx
-
-beameruserguide.pdf: $(doc).tex$(doc).ind \
- $(themes:%=beamerugtheme%.pdf) \ -$(fontthemes:%=beamerugfonttheme%.pdf) \
- $(colorthemes:%=beamerugcolortheme%.pdf) \ - beamerugcolorthemealbatrossstylish.pdf \ -$(innerthemes:%=beameruginnertheme%.pdf) \
- $(outerthemes:%=beamerugoutertheme%.pdf) - pdflatex$(doc) ; \
-	if [ $$? = 0 ] ; then \ - makeindex (doc) ; \ - pdflatex (doc) ; \ - makeindex (doc) ; \ - pdflatex (doc) ; \ - else \ - echo " Compilation failed" ; \ - fi ; \ - rm -f (AUXFILES) - - -beamerugtheme%.pdf: beamerthemeexample.tex beamerthemeexamplebase.tex ../base/themes/theme/beamertheme%.sty - pdflatex \\def\\themename{(@:beamerugtheme%.pdf=%)}\\input beamerthemeexample.tex; - mv beamerthemeexample.pdf @ - -beamerugfonttheme%.pdf: beamerfontthemeexample.tex beamerthemeexamplebase.tex ../base/themes/font/beamerfonttheme%.sty - pdflatex \\def\\themename{(@:beamerugfonttheme%.pdf=%)}\\input beamerfontthemeexample.tex; - mv beamerfontthemeexample.pdf @ - -beamerugcolorthemealbatrossstylish.pdf: beamercolorthemeexample.tex beamerthemeexamplebase.tex ../base/themes/color/beamercolorthemealbatross.sty - pdflatex \\def\\themename{albatrossstylish}\\input beamercolorthemeexample.tex; - mv beamercolorthemeexample.pdf @ - -beamerugcolortheme%.pdf: beamercolorthemeexample.tex beamerthemeexamplebase.tex ../base/themes/color/beamercolortheme%.sty - pdflatex \\def\\themename{(@:beamerugcolortheme%.pdf=%)}\\input beamercolorthemeexample.tex; - mv beamercolorthemeexample.pdf @ - -beameruginnertheme%.pdf: beamerinnerthemeexample.tex beamerthemeexamplebase.tex ../base/themes/inner/beamerinnertheme%.sty - pdflatex \\def\\themename{(@:beameruginnertheme%.pdf=%)}\\input beamerinnerthemeexample.tex; - mv beamerinnerthemeexample.pdf @ - -beamerugoutertheme%.pdf: beamerouterthemeexample.tex beamerthemeexamplebase.tex ../base/themes/outer/beameroutertheme%.sty - pdflatex \\def\\themename{(@:beamerugoutertheme%.pdf=%)}\\input beamerouterthemeexample.tex; - mv beamerouterthemeexample.pdf @ - -clean: - rm -f (AUXFILES) beamerug*.pdf Deleted: trunk/Master/texmf-dist/doc/latex/beamer/doc/beamercolorthemeexample.tex =================================================================== --- trunk/Master/texmf-dist/doc/latex/beamer/doc/beamercolorthemeexample.tex 2017-12-19 00:07:03 UTC (rev 46094) +++ trunk/Master/texmf-dist/doc/latex/beamer/doc/beamercolorthemeexample.tex 2017-12-19 00:09:01 UTC (rev 46095) @@ -1,63 +0,0 @@ -% Copyright 2003--2007 by Till Tantau -% Copyright 2010 by Vedran Mileti\'c -% Copyright 2015 by Vedran Mileti\'c, Joseph Wright -% -% This file may be distributed and/or modified -% -% 1. under the LaTeX Project Public License and/or -% 2. under the GNU Free Documentation License. -% -% See the file doc/licenses/LICENSE for more details. - -\documentclass[hyperref={draft}]{beamer} - -\ifx\themename\undefined - \def\themename{default} -\fi - -\useoutertheme[height=0pt]{sidebar} - -\def\albatrossname{albatross} -\def\flyname{fly} -\def\beetlename{beetle} -\def\structurename{structure} - -\def\albatrossnamestylish{albatrossstylish} - -\ifx\themename\structurename - \usecolortheme[cmyk={0.69,0,0.50,0}]{\themename} -\else - \ifx\themename\albatrossnamestylish - \usecolortheme[overlystylish]{albatross} - \usecolortheme{lily} - \else - \usecolortheme{\themename} - \fi -\fi - -\ifx\themename\albatrossname - \makeatletter - \let\beamertemplatesolidbackgroundcolor=\@gobble - \makeatother -\fi - -\ifx\themename\albatrossnamestylish - \makeatletter - \let\beamertemplatesolidbackgroundcolor=\@gobble - \makeatother -\fi - -\ifx\themename\flyname - \makeatletter - \let\beamertemplatesolidbackgroundcolor=\@gobble - \makeatother -\fi - -\ifx\themename\beetlename - \makeatletter - \let\beamertemplatesolidbackgroundcolor=\@gobble - \makeatother -\fi - - -\input{beamerthemeexamplebase} Deleted: trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerfontthemeexample.tex =================================================================== --- trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerfontthemeexample.tex 2017-12-19 00:07:03 UTC (rev 46094) +++ trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerfontthemeexample.tex 2017-12-19 00:09:01 UTC (rev 46095) @@ -1,21 +0,0 @@ -% Copyright 2003--2007 by Till Tantau -% Copyright 2010 by Vedran Mileti\'c -% Copyright 2015 by Vedran Mileti\'c, Joseph Wright -% -% This file may be distributed and/or modified -% -% 1. under the LaTeX Project Public License and/or -% 2. under the GNU Free Documentation License. -% -% See the file doc/licenses/LICENSE for more details. - -\documentclass[hyperref={draft}]{beamer} - -\ifx\themename\undefined - \def\themename{default} -\fi - -\usefonttheme{\themename} - - -\input{beamerthemeexamplebase} Deleted: trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerinnerthemeexample.tex =================================================================== --- trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerinnerthemeexample.tex 2017-12-19 00:07:03 UTC (rev 46094) +++ trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerinnerthemeexample.tex 2017-12-19 00:09:01 UTC (rev 46095) @@ -1,29 +0,0 @@ -% Copyright 2003--2007 by Till Tantau -% Copyright 2010 by Vedran Mileti\'c -% Copyright 2015 by Vedran Mileti\'c, Joseph Wright -% -% This file may be distributed and/or modified -% -% 1. under the LaTeX Project Public License and/or -% 2. under the GNU Free Documentation License. -% -% See the file doc/licenses/LICENSE for more details. - -\documentclass[hyperref={draft}]{beamer} - -\ifx\themename\undefined - \def\themename{default} -\fi - -\useinnertheme{\themename} - -\usecolortheme{seahorse} -\usecolortheme{rose} - -\setbeamercolor*{frametitle}{parent=titlelike} -\setbeamercolor*{author}{parent=titlelike} -\setbeamercolor*{date}{parent=titlelike} -\setbeamercolor*{institute}{parent=titlelike} - - -\input{beamerthemeexamplebase} Deleted: trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerlogo.pdf =================================================================== (Binary files differ) Deleted: trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerouterthemeexample.tex =================================================================== --- trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerouterthemeexample.tex 2017-12-19 00:07:03 UTC (rev 46094) +++ trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerouterthemeexample.tex 2017-12-19 00:09:01 UTC (rev 46095) @@ -1,21 +0,0 @@ -% Copyright 2003--2007 by Till Tantau -% Copyright 2010 by Vedran Mileti\'c -% -% This file may be distributed and/or modified -% -% 1. under the LaTeX Project Public License and/or -% 2. under the GNU Free Documentation License. -% -% See the file doc/licenses/LICENSE for more details. - -\documentclass[hyperref={draft}]{beamer} - -\ifx\themename\undefined - \def\themename{default} -\fi - -\useoutertheme{\themename} -\usecolortheme{seahorse} - - -\input{beamerthemeexamplebase} Deleted: trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerthemeexample.tex =================================================================== --- trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerthemeexample.tex 2017-12-19 00:07:03 UTC (rev 46094) +++ trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerthemeexample.tex 2017-12-19 00:09:01 UTC (rev 46095) @@ -1,21 +0,0 @@ -% Copyright 2003--2007 by Till Tantau -% Copyright 2010 by Vedran Mileti\'c -% Copyright 2015 by Vedran Mileti\'c, Joseph Wright -% -% This file may be distributed and/or modified -% -% 1. under the LaTeX Project Public License and/or -% 2. under the GNU Free Documentation License. -% -% See the file doc/licenses/LICENSE for more details. - -\documentclass[hyperref={draft}]{beamer} - -\ifx\themename\undefined - \def\themename{default} -\fi - -\usetheme{\themename} - - -\input{beamerthemeexamplebase} Deleted: trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerthemeexamplebase.tex =================================================================== --- trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerthemeexamplebase.tex 2017-12-19 00:07:03 UTC (rev 46094) +++ trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerthemeexamplebase.tex 2017-12-19 00:09:01 UTC (rev 46095) @@ -1,53 +0,0 @@ -% Copyright 2003--2007 by Till Tantau -% Copyright 2010 by Vedran Mileti\'c -% Copyright 2015 by Vedran Mileti\'c, Joseph Wright -% -% This file may be distributed and/or modified -% -% 1. under the LaTeX Project Public License and/or -% 2. under the GNU Free Documentation License. -% -% See the file doc/licenses/LICENSE for more details. - -\beamertemplatesolidbackgroundcolor{black!5} -\beamertemplatetransparentcovered - -\usepackage{times} - -\title{There Is No Largest Prime Number} -\subtitle{With an introduction to a new proof technique} - -\author[Euklid]{Euklid of Alexandria} -\institute[Univ. Alexandria]{Department of Mathematics\\ University of Alexandria} -\date[ISPN '80]{27th International Symposium on Prime Numbers, --280} - -\begin{document} - -\begin{frame} - \titlepage - \tableofcontents -\end{frame} - -\section{Results} -\subsection{Proof of the Main Theorem} - -\begin{frame}<1> - \frametitle{There Is No Largest Prime Number} - \framesubtitle{The proof uses \textit{reductio ad absurdum}.} - - \begin{theorem} - There is no largest prime number. - \end{theorem} - \begin{proof} - \begin{enumerate} - % The strange way of typesetting math is to minimize font usage - % in order to keep the file sizes of the examples small. - \item<1-| alert at 1> Suppose p were the largest prime number. - \item<2-> Let q be the product of the first p numbers. - \item<3-> Then q\;+\,1 is not divisible by any of them. - \item<1-> Thus q\;+\,1 is also prime and greater than p.\qedhere - \end{enumerate} - \end{proof} -\end{frame} - -\end{document} Deleted: trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-animations.tex =================================================================== --- trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-animations.tex 2017-12-19 00:07:03 UTC (rev 46094) +++ trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-animations.tex 2017-12-19 00:09:01 UTC (rev 46095) @@ -1,517 +0,0 @@ -% Copyright 2003--2007 by Till Tantau -% Copyright 2010 by Vedran Mileti\'c -% Copyright 2012,2013,2015 by Vedran Mileti\'c, Joseph Wright -% Copyright 2016 by Joseph Wright -% -% This file may be distributed and/or modified -% -% 1. under the LaTeX Project Public License and/or -% 2. under the GNU Free Documentation License. -% -% See the file doc/licenses/LICENSE for more details. - -\section{Animations, Sounds, and Slide Transitions} - - -\subsection{Animations} - -\subsubsection{Including External Animation Files} -\label{section-multimedia} - -If you have created an animation using some external program (like a renderer), you can use the capabilities of the presentation program (like the Acrobat Reader) to show the animation. Unfortunately, currently there is no portable way of doing this and even the Acrobat Reader does not support this feature on all platforms. - -To include an animation in a presentation, you can use, for example, the package |multimedia.sty| which is part of the \beamer\ package. You have to include this package explicitly. Despite being distributed as part of the \beamer\ distribution, this package is perfectly self-sufficient and can be used independently of \beamer. - -\begin{package}{{multimedia}} - A stand-alone package that implements several commands for including external animation and sound files in a \pdf\ document. The package can be used together with both |dvips| plus |ps2pdf| and |pdflatex|, though the special sound support is available only in |pdflatex|. - - When including this package, you must also include the |hyperref| package. Since you will typically want to include |hyperref| only at the very end of the preamble, |multimedia| will not include |hyperref| itself. However, |multimedia| can be included both before and after |hyperref|. Since \beamer\ includes |hyperref| automatically, you need not worry about this when creating a presentation using \beamer. -\end{package} - -For including an animation in a \pdf\ file, you can use the command |\movie|, which is explained below. Depending on the used options, this command will either setup the \pdf\ file such that the viewer application (like the Acrobat Reader) itself will try to play the movie or that an external program will be called. The latter approach, though much less flexible, must be taken if the viewer application is unable to display the movie itself. - -\begin{command}{\movie\oarg{options}\marg{poster text}\marg{movie filename}} - This command will insert the movie with the filename \meta{movie filename} into the \pdf\ file. The movie file must reside at some place where the viewer application will be able to find it, which is typically only the directory in which the final \pdf\ file resides. The movie file will \emph{not} be embedded into the \pdf\ file in the sense that the actual movie data is part of the |main.pdf| file. The movie file must hence be copied and passed along with the \pdf\ file. (Nevertheless, one often says that the movie is embedded'' in the document, but that just means that one can click on the movie when viewing the document and the movie will start to play.) - - The movie will use a rectangular area whose size is determined either by the |width=| and |height=| options or by the size of the \meta{poster text}. The \meta{poster text} can be any \TeX\ text; for example, it might be a |\pgfuseimage| command or an |\includegraphics| command or a |pgfpicture| environment or just plain text. The \meta{poster text} is typeset in a box, the box is inserted into the normal text, and the movie rectangle is put exactly over this box. Thus, if the \meta{poster text} is an image from the movie, this image will be shown until the movie is started, when it will be exactly replaced by the movie itself. However, there is also a different, sometimes better, way of creating a poster image, namely by using the |poster| option as explained later on. - - The aspect ratio of the movie will \emph{not} be corrected automatically if the dimension of the \meta{poster text} box does not have the same aspect ratio. Most movies have an aspect ratio of 4:3 or 16:9. - - Despite the name, a movie may consist only of sound with no images. In this case, the \meta{poster text} might be a symbol representing the sound. There is also a different, dedicated command for including sounds in a \pdf\ file, see the |\sound| command in Section~\ref{section-sound}. - - Unless further options are given, the movie will start only when the user clicks on it. Whether the viewer application can actually display the movie depends on the application and the version. For example, the Acrobat Reader up to version~5 does not seem to be able to display any movies or sounds on Linux. On the other hand, the Acrobat Reader Version~6 on MacOS is able to display anything that QuickTime can display, which is just about everything. Embedding movies in a \pdf\ document is provided for by the \pdf\ standard and is not a peculiarity of the Acrobat Reader. In particular, one might expect other viewers like |xpdf| and |poppler|-based viewers (Okular, Evince) to support embedded movies in the future. - - \example - |\movie{\pgfuseimage{myposterimage}}{mymovie.avi}| - - \example - |\movie[width=3cm,height=2cm,poster]{}{mymovie.mpg}| - - If your viewer application is not able to render your movie, but some external application is, you must use the |externalviewer| option. This will ask the viewer application to launch an application for showing the movie instead of displaying it itself. Since this application is started in a new window, this is not nearly as nice as having the movie displayed directly by the viewer (unless you use evil trickery to suppress the frame of the viewer application). Which application is chosen is left to the discretion of the viewer application, which tries to make its choice according to the extension of the \meta{movie filename} and according to some mapping table for mapping extensions to viewer applications. How this mapping table can be modified depends on the viewer application, please see the release notes of your viewer. - - The following \meta{options} may be given: - \begin{itemize} - \item - \declare{|autostart|}. Causes the movie to start playing immediately when the page is shown. At most one movie can be started in this way. The viewer application will typically be able to show at most one movie at the same time anyway. When the page is no longer shown, the movie immediately stops. This can be a problem if you use the |\movie| command to include a sound that should be played on after the page has been closed. In this case, the |\sound| command must be used. - \item - \declare{|borderwidth=|}\meta{\TeX\ dimension}. Causes a border of thickness \meta{\TeX\ dimension} to be drawn around the movie. Some versions of the Acrobat Reader seem to have a bug and do not display this border if is smaller than 0.5bp (about 0.51pt). - \item - \declare{|depth=|}\meta{\TeX\ dimension}. Overrides the depth of the \meta{poster text} box and sets it to the given dimension. - \item - \declare{|duration=|}\meta{time}|s|. Specifies in seconds how long the movie should be shown. The \meta{time} may be a fractional value and must be followed by the letter |s|. For example, |duration=1.5s| will show the movie for one and a half seconds. In conjunction with the |start| option, you can cut out'' a part of a movie for display. - \item - \declare{|externalviewer|}. As explained above, this causes an external application to be launched for displaying the movie in a separate window. Most options, like |duration| or |loop|, have no effect since they are not passed along to the viewer application. - \item - \declare{|height=|}\meta{\TeX\ dimension}. Overrides the height of the \meta{poster text} box and sets it to the given dimension. - \item - \declare{|label=|}\meta{movie label}. Assigns a label to the movie such that it can later be referenced by the command |\hyperlinkmovie|, which can be used to stop the movie or to show a different part of it. The \meta{movie label} is not a normal label. It should not be too fancy, since it is inserted literally into the \pdf\ code. In particular, it should not contain closing parentheses. - \item - \declare{|loop|}. Causes the movie to start again when the end has been reached. Normally, the movie just stops at the end. - \item - \declare{|once|}. Causes the movie to just stop at the end. This is the default. - \item - \declare{|open|}. Causes the player to stay open when the movie has finished. - \item - \declare{|palindrome|}. Causes the movie to start playing backwards when the end has been reached, and to start playing forward once more when the beginning is reached, and so on. - \item - \declare{|poster|}. Asks the viewer application to show the first image of the movie when the movie is not playing. Normally, nothing is shown when the movie is not playing (and thus the box containing the \meta{poster text} is shown). For a movie that does not have any images (but sound) or for movies with an uninformative first image this option is not so useful. - \item - \declare{|repeat|} is the same as |loop|. - \item - \declare{|showcontrols=|}\meta{true or false}. Causes a control bar to be displayed below the movie while it is playing. Instead of |showcontrols=true| you can also just say |showcontrols|. By default, no control bar is shown. - \item - \declare{|start=|}\meta{time}|s|. Causes the first \meta{time} seconds of the movie to be skipped. For example, |start=10s,duration=5s| will show seconds 10 to 15 of the movie, when you play the movie. - \item - \declare{|width=|}\meta{\TeX dimension} works like the |height| option, only for the width of the poster box. - \end{itemize} - - \example - The following example creates a background sound'' for the slide. - -\begin{verbatim} -\movie[autostart]{}{test.wav} -\end{verbatim} - - \example - A movie with two extra buttons for showing different parts of the movie. - -\begin{verbatim} -\movie[label=cells,width=4cm,height=3cm,poster,showcontrols,duration=5s]{}{cells.avi} - -\hyperlinkmovie[start=5s,duration=7s]{cells}{\beamerbutton{Show the middle stage}} - -\hyperlinkmovie[start=12s,duration=5s]{cells}{\beamerbutton{Show the late stage}} -\end{verbatim} -\end{command} - -A movie can serve as the destination of a special kind of hyperlink, namely a hyperlink introduced using the following command: - -\begin{command}{\hyperlinkmovie\oarg{options}\marg{movie label}\marg{text}} - Causes the \meta{text} to become a movie hyperlink. When you click on the \meta{text}, the movie with the label \meta{movie label} will start to play (or stop or pause or resume, depending on the \meta{options}). The movie must be on the same page as the hyperlink. - - The following \meta{options} may be given, many of which are the same as for the |\movie| command; if a different option is given for the link than for the movie itself, the option for the link takes precedence: - \begin{itemize} - \item - \declare{|duration=|}\meta{time}|s|. As for |\movie|, this causes the movie to be played only for the given number of seconds. - \item - \declare{|loop|} and \declare{|repeat|}. As for |\movie|, this causes the movie to loop. - \item - \declare{|once|}. As for |\movie|, this causes the movie to played only once. - \item - \declare{|palindrome|}. As for |\movie|, this causes the movie to be played forth and back. - \item - \declare{|pause|}. Causes the playback of the movie to be paused, if the movie was currently playing. If not, nothing happens. - \item - \declare{|play|}. Causes the movie to be played from whatever start position is specified. If the movie is already playing, it will be stopped and restarted at the starting position. This is the default. - \item - \declare{|resume|}. Resumes playback of the movie, if it has previously been paused. If has not been paused, but not started or is already playing, nothing happens. - \item - \declare{|showcontrols=|}\meta{true or false}. As for |\movie|, this causes a control bar to be shown or not shown during playback. - \item - \declare{|start=|}\meta{time}|s|. As for |\movie|, this causes the given number of seconds to be skipped at the beginning of the movie if |play| is used to start the movie. - \item - \declare{|stop|}. Causes the playback of the movie to be stopped. - \end{itemize} -\end{command} - -\subsubsection{Animations Created by Showing Slides in Rapid Succession} - -You can create an animation in a portable way by using the overlay commands of the \beamer\ package to create a series of slides that, when shown in rapid succession, present an animation. This is a flexible approach, but such animations will typically be rather static since it will take some time to advance from one slide to the next. This approach is mostly useful for animations where you want to explain each picture'' of the animation. When you advance slides by hand,'' that is, by pressing a forward button, it typically takes at least a second for the next slide to show. - -More lively'' animations can be created by relying on a capability of the viewer program. Some programs support showing slides only for a certain number of seconds during a presentation (for the Acrobat Reader this works only in full-screen mode). By setting the number of seconds to zero, you can create a rapid succession of slides. - -To facilitate the creation of animations using this feature, the following commands can be used: |\animate| and |\animatevalue|. - -\begin{command}{\animate\ssarg{overlay specification}} - The slides specified by \meta{overlay specification} will be shown as quickly as possible. - - \example -\begin{verbatim} -\begin{frame} - \frametitle{A Five Slide Animation} - \animate<2-4> - - The first slide is shown normally. When the second slide is shown - (presumably after pressing a forward key), the second, third, and - fourth slides flash by.'' At the end, the content of the fifth - slide is shown. - - ... code for creating an animation with five slides ... -\end{frame} -\end{verbatim} - - \articlenote - This command is ignored in |article| mode. -\end{command} - -\begin{command}{\animatevalue|<|\meta{start slide}|-|\meta{end slide}|>| \marg{name}\marg{start value}\marg{end value}} - The \meta{name} must be the name of a counter or a dimension. It will be varied between two values. For the slides in the specified range, the counter or dimension is set to an interpolated value that depends on the current slide number. On slides before the \meta{start slide}, the counter or dimension is set to \meta{start value}; on the slides after the \meta{end slide} it is set to \meta{end value}. - - \example -\begin{verbatim} -\newcount\opaqueness -\begin{frame} - \animate<2-10> - \animatevalue<1-10>{\opaqueness}{100}{0} - \begin{colormixin}{\the\opaqueness!averagebackgroundcolor} - \frametitle{Fadeout Frame} - - This text (and all other frame content) will fade out when the - second slide is shown. This even works with - {\color{green!90!black}colored} \alert{text}. - \end{colormixin} -\end{frame} - -\newcount\opaqueness -\newdimen\offset -\begin{frame} - \frametitle{Flying Theorems (You Really Shouldn't!)} - - \animate<2-14> - - \animatevalue<1-15>{\opaqueness}{100}{0} - \animatevalue<1-15>{\offset}{0cm}{-5cm} - \begin{colormixin}{\the\opaqueness!averagebackgroundcolor} - \hskip\offset - \begin{minipage}{\textwidth} - \begin{theorem} - This theorem flies out. - \end{theorem} - \end{minipage} - \end{colormixin} - - \animatevalue<1-15>{\opaqueness}{0}{100} - \animatevalue<1-15>{\offset}{-5cm}{0cm} - \begin{colormixin}{\the\opaqueness!averagebackgroundcolor} - \hskip\offset - \begin{minipage}{\textwidth} - \begin{theorem} - This theorem flies in. - \end{theorem} - \end{minipage} - \end{colormixin} -\end{frame} -\end{verbatim} - - \articlenote - This command is ignored in |article| mode. -\end{command} - -If your animation graphics'' reside in individual external graphic files, you might also consider using the |\multiinclude| command, which is explained in Section~\ref{section-mpmulti}, together with |\animate|. For example, you might create an animation like this, assuming you have created graphic files named |animation.1| through to |animation.10|: - -\begin{verbatim} -\begin{frame} - \animate<2-9> - \multiinclude[start=1]{animation} -\end{frame} -\end{verbatim} - -\subsubsection{Including External Animations Residing in Multiple Image Files} -\label{section-xmpmulti} -\label{section-mpmulti} - -Some animations reside in external files in the following way: For each stage of the animation there is an image file containing an image for this stage. You can include such a series of images conveniently by using the style |mpmulti.sty| from the ppower4 package. This style, written by Klaus Guntermann, introduces a command called |\multiinclude| that takes the base name of a graphic file like |mygraphic| and will then search for files called |mygraphic.0|, |mygraphic.1|, and so on, till no more files are found. It will then include these graphics files using the |\includegraphics| command, but will put these graphics on top of each other.'' Furthermore, and this is the important part, it inserts a |\pause| command after each graphic. This command is defined in the ppower4 package and has the same effect as the |\pause| command of \beamer. For this reason, both ppower4 and also \beamer\ will first display the basic graphic and will then additionally show the next graphic on each slide. - -If you try to use |mpmulti.sty| directly, you will run into the problem that it includes a file called |pause.sty|, which is part of the ppower4 package. - -You might also consider using the style |xmpmulti.sty| that comes with \beamer. This file is mainly identical to |mpmulti|, except for two differences: First, it does not include |pause.sty|, a style that conceptually clashes with \beamer, although \beamer\ contains a workaround that sidesteps the problem. Second, it extends the |\multiinclude| command by allowing a special default overlay specification to be given. The effect of this is explained below. - -\begin{package}{{xmpmulti}} - Defines the command |\multiinclude|. The code of this package is due to Klaus Guntermann with some additions of mine. It can be used together with \beamer\ and with ppower4, i.\,e., it can be used as a replacement for |mpmulti| if the |pause| package is also included in a ppower4-presentation. -\end{package} - -\begin{command}{\multiinclude\opt{|[<|\meta{default overlay specification}|>]|}\oarg{options}\marg{base file name}} - Except for the possibility of specifying a \meta{default overlay specification}, this command is identical to the |\multiinclude| command from the ppower4 package. - - If no overlay specification is given, the command will search for files called \meta{base file name}|.|\meta{number} for increasing numbers \meta{number}, starting with zero. As long as it finds these files, it issues an |\includegraphics| command on them. The files following the first one are put on top'' of the first one. Between any two invocations of |\includegraphics|, a |\pause| command is inserted. You can modify this behavior in different ways by given suitable \meta{options}, see below. - - \example - Assume that MetaPost has created files called |gra.0|, |gra.1|, and |gra.2|. You can then create frame consisting of three slides that incrementally show the graphic as follows: - -\begin{verbatim} -\begin{frame} - \multiinclude{gra} -\end{frame} -\end{verbatim} - - The effect of providing a \meta{default overlay specification} is the following: First, no |\pause| command is inserted between graphics. Instead, each graphic is surrounded by an |actionenv| environment with the overlay specification set to \meta{default overlay specification}. - - \example - You can create the same effect as in the previous example using |\multiinclude[<+->]{gra}|. - - \example - For a more interesting usage of the \meta{default overlay specification}, consider the following usage: - -\begin{verbatim} -\multiinclude[<alert at +| +->]{gra} -\end{verbatim} - - This will always paint the most recently added part of the graphic in red (assuming you do not use special colors in the graphic itself). - - \example - In order to have each graphic completely \emph{replace} the previous one, you could use |\multiinclude[<+>]{gra}|. - - The following \meta{options} may be given (these are the same as for the original command from the ppower4 package): - \begin{itemize} - \item - \declare{|pause=|\meta{command}} replaces the default pausing command |\pause| by \meta{command}. If a \meta{default overlay specification} is given, the default pausing command is empty; otherwise it is |\pause|. Note that commands like |\pauselevel| are not available in |\beamer|. - \item - \declare{|graphics=|\meta{options}} passes the \meta{options} to the |\includegraphics| command. - - \example |\multiinclude[graphics={height=5cm}]{gra}| - \item - \declare{|format=|\meta{extension}} will cause the file names for which we search change from \meta{base file name}|.|\meta{number} to \meta{base file name}|-|\meta{number}|.|\meta{extension}. Note the change from the dot to a hyphen. This option allows you to include, say, |.jpg| files. - \item - \declare{|start=|\meta{number}} specifies the start \meta{number}. The default is zero. - \item - \declare{|end=|\meta{number}} specifies the end \meta{number}. The default is infinity. - \end{itemize} -\end{command} - -Note that, if you do not use the |format=| option, the |\includegraphics| command will be somewhat at a loss in which format your graphic file actually is. After all, it ends with the cryptic format suffix'' |.0| or |.1|. You can tell |\includegraphics| that any file having a suffix it knows nothing about is actually in format, say, |.mps|, using the following command: - -\begin{verbatim} -\DeclareGraphicsRule{*}{mps}{*}{} -\end{verbatim} - - -\subsection{Sounds} -\label{section-sound} - -You can include sounds in a presentation. Such sound can be played when you open a slide or when a certain button is clicked. The commands for including sounds are defined in the package |multimedia|, which is introduced in Section~\ref{section-multimedia}. - -As was already pointed out in Section~\ref{section-multimedia}, a sound can be included in a \pdf\ presentation by treating it as a movie and using the |\movie| command. While this is perfectly sufficient in most cases, there are two cases where this approach is not satisfactory: -\begin{enumerate} -\item - When a page is closed, any playing movie is immediately stopped. Thus, you cannot use the |\movie| command to create sounds that persist for a longer time. -\item - You cannot play two movies at the same time. -\end{enumerate} - -The \pdf\ specification introduces special sound objects, which are treated quite differently from movie objects. You can create a sound object using the command |\sound|, which is somewhat similar to |\movie|. There also exists a |\hyperlinksound| command, which is similar to |\hyperlinkmovie|. While it is conceptually better to use |\sound| for sounds, there are a number of things to consider before using it: -\begin{itemize} -\item - Several sounds \emph{can} be played at the same time. In particular, it is possible to play a general sound in parallel to a (hopefully silent) movie. -\item - A sound playback \emph{can} persist after the current page is closed (though it need not). -\item - The data of a sound file \emph{can} be completely embedded in a \pdf\ file, obliterating the need to carry around'' other files. -\item - The sound objects do \emph{not} work together with |dvips| and |ps2pdf|. They only work with |pdflatex|. -\item - There is much less control over what part of a sound should be played. In particular, no control bar is shown and you can specify neither the start time nor the duration. -\item - A bug in some versions of the Acrobat Reader makes it necessary to provide very exact details on the encoding of the sound file. You have to provide the sampling rate, the number of channels (mono or stereo), the number of bits per sample, and the sample encoding method (raw, signed, Alaw or \mulaw). If you do not know this data or provide it incorrectly, the sound will be played incorrectly. -\item - It seems that you can only include uncompressed sound data, which can easily become huge. This is not required by the specification, but some versions of Acrobat Reader are unable to play any compressed data. Data formats that \emph{do} work are |.aif| and |.au|. -\end{itemize} - -\begin{command}{\sound\oarg{options}\marg{sound poster text}\marg{sound filename}} - This command will insert the sound with the filename \meta{sound filename} into the \pdf\ file. As for |\movie|, the file must be accessible when the sound is to be played. Unlike |\movie|, you can however use the option |inlinesound| to actually embed the sound data in the \pdf\ file. - - Also as for a movie, the \meta{sound poster text} will be be put in a box that, when clicked on, will start playing the movie. However, you might also leave this box empty and only use the |autostart| option. Once playback of a sound has started, it can only be stopped by starting the playback of a different sound or by use of the |\hyperlinkmute| command. - - The supported sound formats depend on the viewer application. Some versions of Acrobat Reader support |.aif| and |.au|. Sometimes you also need to specify information like the sampling rate, even though this information could be extracted from the sound file and even though the \pdf\ standard specifies that the viewer application should do so. In this regard, some versions of Acrobat Reader seem to be non-standard-conforming. - - This command only works together with |pdflatex|. If you use |dvips|, the poster is still shown, but clicking it has no effect and no sound is embedded in any way. - - \example - |\sound[autostart,samplingrate=22050]{}{applause.au}| - - The following \meta{options} may be given: - \begin{itemize} - \item - \declare{|autostart|}. Causes the sound to start playing immediately when the page is shown. - \item - \declare{|automute|}. Causes all sounds to be muted when the current page is left. - \item - \declare{|bitspersample=|}\meta{8 or 16}. Specifies the number of bits per sample in the sound file. If this number is 16, this option need not be specified. - \item - \declare{|channels=|}\meta{1 or 2}. Specifies whether the sound is mono or stereo. If the sound is mono, this option need not be specified. - \item - \declare{|depth=|}\meta{\TeX\ dimension}. Overrides the depth of the \meta{sound poster text} box and sets it to the given dimension. - \item - \declare{|encoding=|}\meta{method}. Specifies the encoding method, which may be |Raw|, |Signed|, |muLaw|, or |ALaw|. If the method is |muLaw|, this option need not be specified. - \item - \declare{|height=|}\meta{\TeX\ dimension}. Overrides the height of the \meta{sound poster text} box and sets it to the given dimension. - \item - \declare{|inlinesound|} causes the sound data to be stored directly in the \pdf-file. - \item - \declare{|label=|}\meta{sound label}. Assigns a label to the sound such that it can later be referenced by the command |\hyperlinksound|, which can be used to start a sound. The \meta{sound label} is not a normal label. - \item - \declare{|loop|} or \declare{|repeat|}. Causes the sound to start again when the end has been reached. - \item - \declare{|mixsound=|}\meta{true or false}. If set to |true|, the sound is played in addition to any sound that is already playing. If set to |false| all other sounds (though not sound from movies) are stopped before the sound is played. The default is |false|. - \item - \declare{|samplingrate=|}\meta{number}. Specifies the number of samples per second in the sound file. If this number is 44100, this option need not be specified. - \item - \declare{|width=|}\meta{\TeX\ dimension} works like the |height| option, only for the width of the poster box. - \end{itemize} - - \example - The following example creates a background sound'' for the slide, assuming that |applause.au| is encoded correctly (44100 samples per second, mono, \mulaw encoded, 16 bits per sample). - -\begin{verbatim} -\sound[autostart]{}{applause.au} -\end{verbatim} -\end{command} - -Just like movies, sounds can also serve as destinations of special sound hyperlinks. - -\begin{command}{\hyperlinksound\oarg{options}\marg{sound label}\marg{text}} - Causes the \meta{text} to become a sound hyperlink. When you click on the \meta{text}, the sound with the label \meta{sound label} will start to play. - - The following \meta{options} may be given: - \begin{itemize} - \item - \declare{|loop|} or \declare{|repeat|}. Causes the sound to start again when the end has been reached. - \item - \declare{|mixsound=|}\meta{true or false}. If set to |true|, the sound is played in addition to any sound that is already playing. If set to |false| all other sounds (though not sound from movies) are stopped before the sound is played. The default is |false|. - \end{itemize} -\end{command} - -Since there is no direct way of stopping the playback of a sound, the following command is useful: - -\begin{command}{\hyperlinkmute\marg{text}} - Causes the \meta{text} to become a hyperlink that, when clicked, stops the playback of all sounds. -\end{command} - - -\subsection{Slide Transitions} - -\pdf\ in general, and the Acrobat Reader in particular, offer a standardized way of defining \emph{slide transitions}. Such a transition is a visual effect that is used to show the slide. For example, instead of just showing the slide immediately, whatever was shown before might slowly dissolve'' and be replaced by the slide's content. - -There are a number of commands that can be used to specify what effect should be used when the current slide is presented. Consider the following example: -\begin{verbatim} -\frame{\pgfuseimage{youngboy}} -\frame{ - \transdissolve - \pgfuseimage{man} -} -\end{verbatim} -The command |\transdissolve| causes the slide of the second frame to be shown in a dissolved way.'' Note that the dissolving is a property of the second frame, not of the first one. We could have placed the command anywhere on the frame. - -The transition commands are overlay-specification-aware. We could collapse the two frames into one frame like this: -\begin{verbatim} -\begin{frame} - \only<1>{\pgfuseimage{youngboy}} - \only<2>{\pgfuseimage{man}} - \transdissolve<2> -\end{frame} -\end{verbatim} -This states that on the first slide the young boy should be shown, on the second slide the old man should be shown, and when the second slide is shown, it should be shown in a dissolved way.'' - -In the following, the different commands for creating transitional effects are listed. All of them take an optional argument that may contain a list of \meta{key}|=|\meta{value} pairs. The following options are possible: -\begin{itemize} -\item - |duration=|\meta{seconds}. Specifies the number of \meta{seconds} the transition effect needs. Default is one second, but often a shorter one (like 0.2 seconds) is more appropriate. Viewer applications, especially Acrobat, may interpret this option in slightly strange ways. -\item - |direction=|\meta{degree}. For directed'' effects, this option specifies the effect's direction. Allowed values are |0|, |90|, |180|, |270|, and for the glitter effect also |315|. -\end{itemize} - -\articlenote -All of these commands are ignored in |article| mode. - -\begin{command}{\transblindshorizontal\sarg{overlay specification}\oarg{options}} - Show the slide as if horizontal blinds were pulled away. - \example|\transblindshorizontal| -\end{command} - -\begin{command}{\transblindsvertical\sarg{overlay specification}\oarg{options}} - Show the slide as if vertical blinds were pulled away. - \example|\transblindsvertical<2,3>| -\end{command} - -\begin{command}{\transboxin\sarg{overlay specification}\oarg{options}} - Show the slide by moving to the center from all four sides. - \example|\transboxin<1>| -\end{command} - -\begin{command}{\transboxout\sarg{overlay specification}\oarg{options}} - Show the slide by showing more and more of a rectangular area that is centered on the slide center. - \example|\transboxout| -\end{command} - -\begin{command}{\transcover\sarg{overlay specification}\oarg{options}} - Show the slide by covering the content that was shown before. - \example|\transcover| -\end{command} - -\begin{command}{\transdissolve\sarg{overlay specification}\oarg{options}} - Show the slide by slowly dissolving what was shown before. - \example|\transdissolve[duration=0.2]| -\end{command} - -\begin{command}{\transfade\sarg{overlay specification}\oarg{options}} - Show the slide by slowly fading what was shown before. - \example|\transfade| -\end{command} - -\begin{command}{\transglitter\sarg{overlay specification}\oarg{options}} - Show the slide with a glitter effect that sweeps in the specified direction. - \example|\transglitter<2-3>[direction=90]| -\end{command} - -\begin{command}{\transpush\sarg{overlay specification}\oarg{options}} - Show the slide by pushing what was shown before off the screen using - the new content. - \example|\transpush| -\end{command} - -\begin{command}{\transreplace\sarg{overlay specification}\oarg{options}} - Replace the previous slide directly (default behaviour). -\end{command} - -\begin{command}{\transsplitverticalin\sarg{overlay specification}\oarg{options}} - Show the slide by sweeping two vertical lines from the sides inward. - \example|\transsplitverticalin| -\end{command} - -\begin{command}{\transsplitverticalout\sarg{overlay specification}\oarg{options}} - Show the slide by sweeping two vertical lines from the center outward. - \example|\transsplitverticalout| -\end{command} - -\begin{command}{\transsplithorizontalin\sarg{overlay specification}\oarg{options}} - Show the slide by sweeping two horizontal lines from the sides inward. - \example|\transsplithorizontalin| -\end{command} - -\begin{command}{\transsplithorizontalout\sarg{overlay specification}\oarg{options}} - Show the slide by sweeping two horizontal lines from the center outward. - \example|\transsplithorizontalout| -\end{command} - -\begin{command}{\transwipe\sarg{overlay specification}\oarg{options}} - Show the slide by sweeping a single line in the specified direction, thereby wiping out'' the previous contents. - \example|\transwipe[direction=90]| -\end{command} - -You can also specify how \emph{long} a given slide should be shown, using the following overlay-specification-aware command: -\begin{command}{\transduration\sarg{overlay specification}\marg{number of seconds}} - In full screen mode, show the slide for \meta{number of seconds}. If zero is specified, the slide is shown as short as possible. This can be used to create interesting pseudo-animations. - \example|\transduration<2>{1}| - Notice that the \emph{duration} of a slide transition is entire separate from the \emph{type} of transition which takes place. Most notably, to cancel an existing auto-advance you need to use - \example|\transduration{}| -possibly with an overlay specification. -\end{command} Deleted: trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-color.tex =================================================================== --- trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-color.tex 2017-12-19 00:07:03 UTC (rev 46094) +++ trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-color.tex 2017-12-19 00:09:01 UTC (rev 46095) @@ -1,548 +0,0 @@ -% Copyright 2003--2007 by Till Tantau -% Copyright 2010 by Vedran Mileti\'c -% Copyright 2012,2013,2015 by Vedran Mileti\'c, Joseph Wright -% -% This file may be distributed and/or modified -% -% 1. under the LaTeX Project Public License and/or -% 2. under the GNU Free Documentation License. -% -% See the file doc/licenses/LICENSE for more details. - -\section{Colors} - -\label{section-colors} - -\beamer's color management allows you to specify the color of every element (like, say, the color of the section entries in a table of contents or, say, the color of the subsection entries in a mini table of contents in a sidebar). While the system is quite powerful, it is not trivial to use. To simplify the usage of the color system, you should consider using a predefined color theme, which takes care of everything for you. - -In the following, color themes are explained first. The rest of the section consists of explanations of how the color management works internally. You will need to read these sections only if you wish to write your own color themes; or if you are quite happy with the predefined themes but you absolutely insist that displayed mathematical text simply has to be typeset in a lovely pink. - - -\subsection{Color Themes} - -In order to also show the effect of the different color themes on the sidebar, in the following examples the color themes are used together with the outer theme |sidebar|. - -\subsubsection{Default and Special-Purpose Color Themes} - -\begin{colorthemeexample}{default} - The |default| color theme is very sober. It installs little special colors and even less backgrounds. The default color theme sets up the default parent relations between the different \beamer-colors. - - The main colors set in the |default| color theme are the following: - \begin{itemize} - \item - |normal text| is black on white. - \item - |alerted text| is red. - \item - |example text| is a dark green (green with 50\% black). - \item - |structure| is set to a light version of MidnightBlue (more precisely, 20\% red, 20\% green, and 70\% blue). - \end{itemize} - Use this theme for a no-nonsense presentation. Since this theme is loaded by default, you cannot reload'' it after having loaded another color theme. -\end{colorthemeexample} - -\begin{colorthemeexample}[\oarg{options}]{structure} - The example was created using |\usecolortheme[named=SeaGreen]{structure}|. - - This theme offers a convenient way of changing the color used for structural elements. More precisely, it just changes the foreground of the \beamer-color |structure|. You can also achieve this by directly invoking the function |\setbeamercolor|, but this color theme makes things a bit easier. - - The theme offers several \meta{options}, which can be used to specify the color to be used for structural elements: - \begin{itemize} - \item - \declare{|rgb=|\marg{rgb tuple}} sets the |structure| foreground to the specified red-green-blue tuple. The numbers are given as decimals between 0 and 1. For example, |rgb={0.5,0,0}| yields a dark red. - \item - \declare{|RGB=|\marg{rgb tuple}} does the same as |rgb|, except that the numbers range between 0 and 255. For example, |RGB={128,0,0}| yields a dark red. - \item - \declare{|cmyk=|\marg{cmyk tuple}} sets the |structure| foreground to the specified cyan-magenta-yellow-black tuple. The numbers are given as decimals between 0 and 1. For example, |cmyk={0,1,1,0.5}| yields a dark red. - \item - \declare{|cmy=|\marg{cmy tuple}} is similar to |cmyk|, except that the black component is not specified. - \item - \declare{|hsb=|\marg{hsb tuple}} sets the |structure| foreground to the specified hue-saturation-brightness tuple. The numbers are given as decimals between 0 and 1. For example, |hsb={0,1,.5}| yields a dark red. - \item - \declare{|named=|\marg{color name}} sets the |structure| foreground to a named color. This color must previously have been defined using the |\DefineNamedColor| command. Adding the class option |xcolor=dvipsnames| or |xcolor=svgnames| will install a long list of standard |dvips| or SVG color names (respectively). See the file |dvipsnam.def| for the list. - \end{itemize} -\end{colorthemeexample} - -\begin{colorthemeexample}{sidebartab} - This theme changes the colors in a sidebar such that the current entry in a table of contents shown there gets highlighted by showing a different background behind it. -\end{colorthemeexample} - -\subsubsection{Complete Color Themes} - -A complete'' color theme is a color theme that completely specifies all colors for all parts of a frame. It installs specific colors and does not derive the colors from, say, the |structure| \beamer-color. Complete color themes happen to have names of flying animals. - -\begin{colorthemeexample}{albatross} - The color theme is a dark'' or inverted'' theme using yellow on blue as the main colors. The color theme also installs a slightly darker background color for blocks, which is necessary for presentation themes that use shadows, but which (in Till's opinion) is undesirable for all other presentation themes. By using the |lily| color theme together with this theme, the backgrounds for blocks can be removed. - - When using a light-on-dark theme like this one, be aware that there are certain disadvantages: - \begin{itemize} - \item - If the room in which the talk is given has been darkened,'' using such a theme makes it more difficult for the audience to take or read notes. - \item - Since the room becomes darker, the pupil becomes larger, thus making it harder for the eye to focus. This \emph{can} make text harder to read. - \item - Printing such slides is difficult at best. - \end{itemize} - - On the other hand, a light-on-dark presentation often appears to be more stylish'' than a plain black-on-white one. - - The following \meta{options} may be given: - \begin{itemize} - \item - \declare{|overlystylish|} installs a background canvas that is, in Till's opinion, way too stylish. But then, it is not his intention to press his taste on other people. When using this option, it is probably a very good idea to also use the |lily| color theme. - \end{itemize} - - \example - The |overlystylish| option together with the |lily| color theme: \genericthemeexample{colorthemealbatrossstylish} -\end{colorthemeexample} - -\begin{colorthemeexample}{beetle} - The main theme behind this theme'' is to use white and black text on gray background. The white text is used for special emphasis, the black text for normal text. The outer stuff'' like the headline and the footline use, however, a bluish color. To change this color, change the background of |palette primary|. - - Great care must be taken with this theme since both the white/gray and the black/gray contrasts are much lower than with other themes. Make sure that the contrast is high enough for the actual presentation. - - You can change the grayish'' background by changing the background of |normal text|. -\end{colorthemeexample} - -\begin{colorthemeexample}{crane} - This theme uses the colors of Lufthansa, whose logo is a crane. It is \emph{not} an official theme by that company, however. -\end{colorthemeexample} - -\begin{colorthemeexample}{dove} - This theme is nearly a black and white theme and useful for creating presentations that are easy to print on a black-and-white printer. The theme uses grayscale in certain unavoidable cases, but never color. It also changes the font of alerted text to boldface. - - When using this theme, you should consider using the class option |gray|, which ensures that all colors are converted to grayscale. Also consider using the |structurebold| font theme. -\end{colorthemeexample} - -\begin{colorthemeexample}{fly} - This theme is the consequent'' version of |beetle| and uses white/black/gray throughout. It does not go particularly well with themes that use shadows. -\end{colorthemeexample} - -\begin{colorthemeexample}{monarca} - The theme is based on the colors of the Monarch butterfly. - - \themeauthor Max Dohse. -\end{colorthemeexample} - -\begin{colorthemeexample}{seagull} - Like the |dove| color theme, this theme is useful for printing on a black-and-white printer. However, it uses different shades of gray extensively, which may or may not look good on a transparency. -\end{colorthemeexample} - -\begin{colorthemeexample}{wolverine} - The theme is based on the colors of the University of Michigan's mascot, a wolverine. - - \themeauthor Madhusudan Singh. -\end{colorthemeexample} - -\begin{colorthemeexample}{beaver} - The theme is based on the colors of MIT's mascot, a beaver. - - \themeauthor Madhusudan Singh. -\end{colorthemeexample} - -\begin{colorthemeexample}{spruce} - The theme is based on the colors of Michigan State University. - - \themeauthor Alan Munn. -\end{colorthemeexample} - -\subsubsection{Inner Color Themes} - -Inner color themes only specify the colors of elements used in inner themes. Most noticably, they specify the colors used for blocks. They can be used together with other (color) themes. If they are used to change the inner colors installed by a presentation theme or another color theme, they should obviously be specified \emph{after} the other theme has been loaded. Inner color themes happen to have flower names. - -\begin{colorthemeexample}{lily} - This theme is mainly used to \emph{uninstall} any block colors setup by another theme, restoring the colors used in the |default| theme. In particular, using this theme will remove all background colors for blocks. -\end{colorthemeexample} - -\begin{colorthemeexample}{orchid} - This theme installs white-on-dark block titles. The background of the title of a normal block is set to the foreground of the structure color, the foreground is set to white. The background of alerted blocks are set to red and of example blocks to green. The body of blocks get a nearly transparent background. -\end{colorthemeexample} - -\begin{colorthemeexample}{rose} - This theme installs nearly transparent backgrounds for both block titles and block bodies. This theme is much less aggressive'' than the |orchid| theme. The background colors are derived from the foreground of the structure \beamer-color. -\end{colorthemeexample} - -\subsubsection{Outer Color Themes} - -An outer color theme changes the palette colors, on which the colors used in the headline, footline, and sidebar are based by default. Outer color themes normally do not change the color of inner elements, except possibly for |titlelike|. They happen to be sea-animal names. - -\begin{colorthemeexample}{whale} - Installs a white-on-dark palette for the headline, footline, and sidebar. The backgrounds used there are set to shades between the structure \beamer-color and black. The foreground is set to white. - - While this color theme can appear to be aggressive, you should note that a dark bar at the border of a frame will have a somewhat different appearance during a presentation than it has on paper: During a presentation the projection on the wall is usually surrounded by blackness. Thus, a dark bar will not create a contrast as opposed to the way it does on paper. Indeed, using this theme will cause the main part of the frame to be more at the focus of attention. - - The counterpart to the theme with respect to blocks is the |orchid| theme. However, pairing it with the |rose| color theme is also interesting. -\end{colorthemeexample} - -\begin{colorthemeexample}{seahorse} - Installs a near-transparent backgrounds for the headline, footline, and sidebar. Using this theme will cause navigational elements to be much less dominant'' than when using the |whale| theme (see the discussion on contrast there, though). - - It goes well with the |rose| or the |lily| color theme. Pairing it with the |orchid| overemphasizes blocks (in Till's opinion). -\end{colorthemeexample} - -\begin{colorthemeexample}{dolphin} - A color theme somewhere in the middle between the whale and the seahorse. It was graciously donated by Manuel Carro. Like the seahorse, it goes well with the |rose| and the |lily| color theme. -\end{colorthemeexample} - - -\subsection{Changing the Colors Used for Different Elements of a Presentation} - -This section explains how \beamer's color management works. - -\subsubsection{Overview of Beamer's Color Management} - -In \beamer's philosophy, every element of a presentation can have a different color. Unfortunately, it turned out that simply assigning a single color to every element of a presentation is not such a good idea. First of all, we sometimes want colors of elements to change during a presentation, like the color of the item indicators when they become alerted or inside an example block. Second, some elements naturally have two colors, namely a foreground and a background, but not always. Third, sometimes elements somehow should not have any special color but should simply run along'' with the color of their surrounding. Finally, giving a special color to every element makes it very hard to globally change colors (like changing all the different kind-of-blue things into kind-of-red things) and it makes later extensions even harder. - -For all these reasons, the color of an element in \beamer\ is a structured object, which we call a \emph{\beamer-color}. Every \beamer-color has two parts: a foreground and a background. Either of these may be empty,'' which means that whatever foreground or background was active before should remain active when the color is used. - -\beamer-colors can \emph{inherit} from other \beamer-colors and the default themes make extensive use of this feature. For example, there is a \beamer-color called |structure| and all sorts of elements inherit from this color. Thus, if someone changes |structure|, the color of all these elements automatically change accordingly. When a color inherits from another color, it can nevertheless still override only the foreground or the background. - -It is also possible to inherit'' from another \beamer-color in a more sophisticated way, which is more like \emph{using} the other \beamer-color in an indirect way. You can specify that, say, the background of the title should be a 90\% of the background of normal text and 10\% of the foreground of |structure|. - -Inheritance and using of other \beamer-colors is done dynamically. This means that if one of the parent \beamer-colors changes during the presentation, the derived colors automatically also change. - -The default color theme, which is always loaded, installs numerous \beamer-colors and inheritance relations between them. These colors are explained throughout this guide. The color used for, say, frametitles is discussed in the section on frametitles, and so on. - -\subsubsection{Using Beamer's Colors} - -A \beamer-color is not a normal color as defined by the |color| and |xcolor| packages and, accordingly, cannot be used directly as in commands like |\color| or |\colorlet|. Instead, in order to use a \beamer-color, you should first call the command |\usebeamercolor|, which is explained below. This command will setup two (normal) colors called |fg| (for foreground) and |bg| (for, well, guess what). You can then say |\color{fg}| to install the foreground color and |\color{bg}| to install the background color. You can also use the colors |fg| and |bg| in any context in which you normally use a color like, say, |red|. If a \beamer-color does not have a foreground or a background, the colors |fg| or |bg| (or both) remain unchanged. - -Inside templates, this command will typically have already been called for you with the option |[fg]|. - -\begin{command}{\usebeamercolor\opt{|*|}\oarg{fg or bg}\marg{beamer-color name}} - This command (possibly) changes the two colors |fg| and |bg| to the foreground and background color of the \meta{beamer-color name}. If the \beamer-color does not specify a foreground, |fg| is left unchanged; if does not specify a background, |bg| is left unchanged. - - You will often wish to directly use the color |fg| or |bg| after using this command. For this common situation, the optional argument \meta{fg or bg} is useful, which may be either |fg| or |bg|. Giving this option will cause the foreground |fg| or the background |bg| to be immediately installed after they have been setup. Thus, the following command - -\begin{verbatim} -\usebeamercolor[fg]{normal text} -\end{verbatim} - is a shortcut for -\begin{verbatim} -\usebeamercolor{normal text} -\color{fg} -\end{verbatim} - - If you use the starred version of this command, the \beamer-color |normal text| is used before the command is invoked. This ensures that, barring evil trickery, the colors |fg| and |bg| will be setup independently of whatever colors happened to be in use when the command is invoked. - - This command has special side-effects. First, the (normal) color |parent.bg| is set to the value of |bg| prior to this call. Thus you can access the color that was in use prior to the call of this command via the color |parent.bg|. - - Second, the special color \meta{beamer-color name}|.fg| is \emph{globally} set to the same value as |fg| and \meta{beamer-color name}|.bg| is globally set to the value of |bg|. This allows you to access the foreground or background of a certain \meta{beamer-color name} after another \beamer-color has been used. However, referring to these special global colors should be kept to the unavoidable minimum and should be done as locally as possible since a change of the \beamer-color will not reflect in a change of the colors \meta{beamer-color name}|.fg| and \meta{beamer-color name}|.bg| until the next invocation of |\usebeamercolor|. Also, if the \meta{beamer-color name} does not specify a foreground or a background color, then the values of the special colors are whatever happened to be the foreground or background at the time of the last invocation of |\usebeamercolor|. - - So, try not to get into the habit of writing |\color{structure.fg}| all the time, at least not without a |\usebeamercolor{structure}| close by. - - \example -\begin{verbatim} - This text is {\usebeamercolor[fg]{alerted text} alerted}. The - following box uses the fore- and background of frametitles: - { - \usebeamercolor[fg]{frametitle} - \colorbox{bg}{Frame Title} - } -\end{verbatim} - - \articlenote - This command has no effect in |article| mode. -\end{command} - - -\begin{command}{\ifbeamercolorempty\oarg{fg or bg}\marg{beamer-color name}\marg{if undefined}\marg{if defined}} - This command can be used to check whether the foreground or background of some \meta{beamer-color name} is non-empty. If the foreground or background of \meta{beamer-color name} is defined, \meta{if defined} will be executed, otherwise the \meta{if undefined} code. - - \example -\begin{verbatim} -\ifbeamercolorempty[bg]{frametitle} -{ % Transparent background'' - \usebeamercolor[fg]{frametitle} - \insertframetitle -} -{ % Opaque background - \usebeamercolor[fg]{frametitle} - \colorbox{bg}{\insertframetitle} -} -\end{verbatim} -\end{command} - -\subsubsection{Setting Beamer's Colors} - -To set or to change a \beamer-color, you can use the command |\setbeamercolor|. - -\begin{command}{\setbeamercolor\opt{|*|}\marg{beamer-color name}\marg{options}} - Sets or changes a \beamer-color. The \meta{beamer-color name} should be a reasonably simple text (do not try too much trickery and avoid punctuation symbols), but it may contain spaces. Thus, |normal text| is a valid \meta{beamer-color name} and so is |My Color Number 2|. - - In the most simple case, you just specify a foreground by giving the |fg=| option and, possibly, also a background using the |bg=| option. - - \example |\setbeamercolor{normal text}{fg=black,bg=mylightgrey}| - \example |\setbeamercolor{alerted text}{fg=red!80!black}| - - The effect of this command is accumulative, thus the following two commands - -\begin{verbatim} -\setbeamercolor{section in toc}{fg=blue} -\setbeamercolor{section in toc}{bg=white} -\end{verbatim} - have the same effect as -\begin{verbatim} -\setbeamercolor{section in toc}{fg=blue,bg=white} -\end{verbatim} - - Naturally, a second call with the same kind of \meta{option} set to a different value overrides a previous call. - - The starred version first resets everything, thereby switching off'' the accumulative effect. Use this starred version to completely reset the definition of some \beamer-color. - - The following \meta{options} may be given: - \begin{itemize} - \item - \declare{|fg=|\meta{color}} sets the foreground color of \meta{beamer-color name} to the given (normal) \meta{color}. The \meta{color} may also be a color expression like |red!50!black|, see the manual of the \textsc{xcolor} package. If \meta{color} is empty, the \meta{beamer-color name} has no special foreground'' and when the color is used, the foreground currently in force should not be changed. - - Specifying a foreground this way will override any inherited foreground color. - \item - \declare{|bg=|\meta{color}} does the same as the |fg| option, but for the background. - \item - \declare{|parent=|\meta{parent beamer-color(s)}} specifies that \meta{beamer-color name} should inherit from the specified \meta{parent beamer-color(s)}. Any foreground and/or background color set by the parents will also be used when \meta{beamer-color name} is used. If multiple parents specify a foreground, the last one wins''; and likewise for the backgrounds. - - \example -\begin{verbatim} -\setbeamercolor{father}{fg=red} -\setbeamercolor{mother}{bg=green} -\setbeamercolor{child}{parent={father,mother}} -\begin{beamercolorbox}{child} - Terrible red on green text. -\end{beamercolorbox} - -\setbeamercolor{father}{fg=blue} -\begin{beamercolorbox}{child} - Now terrible blue on green text, since parent was changed. -\end{beamercolorbox} -\end{verbatim} - - Note that a change of the foreground or background of a parent changes the corresponding foreground or background of the child (unless it is overruled). - - A \beamer-color can not only have parents, but also grandparents and so on. - \item - \declare{|use=|\meta{another beamer-color}} is used to make sure that another \beamer-color is setup correctly before the foreground or background color specification are evaluated. - - Suppose you wish the foreground of items to be a mixture of 50\% of the foreground of structural elements and 50\% of the normal foreground color. You could try - -\begin{verbatim} -\setbeamercolor{item}{fg=structure.fg!50!normal text.fg} -\end{verbatim} - - However, this will not necessarily give the desired result: If the \beamer-color |structure| changes, the (normal) color |structure.fg| is not immediately updated. In order to ensure that the normal color |structure.fg| is correct, use the following: - -\begin{verbatim} -\setbeamercolor{item}{use={structure,normal text},fg=structure.fg!50!normal text.fg} -\end{verbatim} - - This will guarantee that the colors |structure.fg| and |normal text.fg| are setup correctly when the foreground of |item| is computed. - - To show the difference, consider the following example: - -\begin{verbatim} -\setbeamercolor{grandfather}{fg=red} -\setbeamercolor{grandmother}{bg=white} -\setbeamercolor{father}{parent={grandfather,grandmother}} -\setbeamercolor{mother}{fg=black} -{ - \usebeamercolor{father}\usebeamercolor{mother} - %% Defines father.fg and mother.fg globally -} -\setbeamercolor{my color A}{fg=father.fg!50!mother.fg} -\setbeamercolor{my color B}{use={father,mother},fg=father.fg!50!mother.fg} - -{\usebeamercolor[fg]{my color A} dark red text} -{\usebeamercolor[fg]{my color B} also dark red text} - -\setbeamercolor{grandfather}{fg=green} - -{\usebeamercolor[fg]{my color A} still dark red text} -{\usebeamercolor[fg]{my color B} now dark green text} -\end{verbatim} - \end{itemize} -\end{command} - - -\subsection{The Color of Mathematical Text} - -By default, mathematical text does not have any special color---it just inherits the surrounding'' color. Some people prefer mathematical text to have some special color. Though we do not recommend this (we believe mathematical text should \emph{not} stand out amid the normal text), \beamer\ makes it (reasonably) easy to change the color of mathematical text. Simply change the following colors: - -\begin{element}{math text}\no\yes\no - This color is the parent of |math text inlined| and |math text displayed|. It is empty by default. See those colors for details. -\end{element} - -\begin{element}{math text inlined}\no\yes\no - \colorparents{math text} - If the foreground of this color is set, inlined mathematical text is typeset using this color. This is done via some |\everymath| hackery and may not work in all cases. If not, you'll have to try to find a way around the problem. The background is currently ignored. -\end{element} - -\begin{element}{math text displayed}\no\yes\no - \colorparents{math text} - Like |math text inlined|, only for so-called displayed'' mathematical text. This is mathematical text between |$| and |$| or between |$$| and || or inside environments like |equation| or |align|. The setup of this color is somewhat fragile, use at your own risk. The background is currently ignored.
-\end{element}
-
-\begin{element}{normal text in math text}\no\yes\no
-  If the foreground of this color is set, normal text inside mathematical text (which is introduced using the |\text| command) will be typeset using this color. The background is currently ignored.
-\end{element}
-
-
-\subsection{The Color Palettes}
-
-When one designs a color theme, one faces the following problem: Suppose we want the colors in the headline to gradually change from black to, say, blue. Whatever is at the very top of the headline should be black, what comes right below it should be dark blue, and at the bottom of the headline things should just be blue. Unfortunately, different outer themes will put different things at the top. One theme might put the author at the top, another theme might put the document title there. This makes it impossible to directly assign one of the three colors black'', dark blue,'' and blue'' to the different elements that are typically rendered in the headline. No matter how we assign them, things will look wrong for certain outer themes.
-
-To circumvent this problem, \beamer\ uses a layer of \emph{palette colors}. Color themes typically only change these palette colors. For example, a color theme might make the \beamer-color |palette primary| blue, make |palette secondary| a dark blue, and make |palette tertiary| black. Outer themes can now setup things such that whatever they show at the top of the headline inherits from |palette primary|, what comes below inherits from |palette secondary|, and whatever is at the bottom inherits from |palette tertiary|. This way, color themes can change the way even complicated outer themes look and they can do so consistently.
-
-Note that the user can still change the color of every element individually, simply by overriding the color(s) of the elements in the headline. In a sense, the palette colors are just a suggestion'' how things should be colored by an outer theme.
-
-In detail, the following palette colors are used by outer themes.
-
-\begin{element}{palette primary}\no\yes\no
-  Outer themes (should) base the color of navigational elements and, possibly, also of other elements, on the four palette colors. The primary'' palette should be used for the most important navigational elements, which are usually the ones that change most often and hence require the most attention by the audience. The secondary'' and tertiary'' are less important, the quaternary'' one is the least important.
-
-  By default, the palette colors do not have a background and the foreground ranges from |structure.fg| to |black|.
-
-  For the sidebar, there is an extra set of palette colors, see |palette sidebar primary|.
-\end{element}
-
-\begin{element}{palette secondary}\no\yes\no
-  See |palette primary|.
-\end{element}
-
-\begin{element}{palette tertiary}\no\yes\no
-  See |palette primary|.
-\end{element}
-
-\begin{element}{palette quaternary}\no\yes\no
-  See |palette primary|.
-\end{element}
-
-\begin{element}{palette sidebar primary}\no\yes\no
-  Similar to |palette primary|, only outer themes (should) base the colors of elements in the sidebar on the four sidebar palette colors.
-\end{element}
-
-\begin{element}{palette sidebar secondary}\no\yes\no
-  See |palette sidebar primary|.
-\end{element}
-
-\begin{element}{palette sidebar tertiary}\no\yes\no
-  See |palette sidebar primary|.
-\end{element}
-
-\begin{element}{palette sidebar quaternary}\no\yes\no
-  See |palette sidebar primary|.
-\end{element}
-
-
-\subsection{Miscellaneous Colors}
-
-In this section some basic'' colors are listed that do not belong'' to any special commands.
-
-\begin{element}{normal text}\no\yes\yes
-  The color is used for normal text. At the beginning of the document the foreground color is installed as |\normalcolor|. The background of this color is used by the default background canvas for the background of the presentation, see Section~\ref{section-canvas}. The background is also the default value of the normal color |bg|.
-
-  Since the color is the root'' of all other \beamer-colors, both a foreground and a background must be installed. In particular, to get a transparent background canvas, make the background of the \beamer-color |background canvas| empty, not the background of this color.
-
-  The \beamer-font currently is not used. In particular, redefining this font will not have any effect. This is likely to change in the future.
-\end{element}
-
-\begin{element}{example text}\no\yes\yes
-  The color/font is used when text is typeset inside an |example| block.
-\end{element}
-
-\begin{element}{titlelike}\no\yes\yes
-  This color/font is a more specialized form of the |structure| color/font. It is the base for all elements that are like titles.'' This includes the frame title and subtitle as well as the document title and subtitle.
-\end{element}
-
-\begin{element}{separation line}\no\yes\no
-  The foreground of this color is used for separating lines. If the foreground is empty, no separation line is drawn.
-\end{element}
-
-  \colorparents{separation line}
-  Special case for the uppermost separation line in a headline.
-\end{element}
-
-  \colorparents{separation line}
-  Special case for the middle separation line in a headline.
-\end{element}
-
-  \colorparents{separation line}
-  Special case for the lower separation line in a headline.
-\end{element}
-
-\begin{element}{upper separation line foot}\no\yes\no
-  \colorparents{separation line}
-  Special case for the uppermost separation line in a footline.
-\end{element}
-
-\begin{element}{middle separation line foot}\no\yes\no
-  \colorparents{separation line}
-  Special case for the middle separation line in a footline.
-\end{element}
-
-\begin{element}{lower separation line foot}\no\yes\no
-  \colorparents{separation line}
-  Special case for the lower separation line in a footline.
-\end{element}
-
-
-\subsection{Transparency Effects}
-\label{section-transparent}
-
-By default, \emph{covered} items are not shown during a presentation. Thus if you write |\uncover<2>{Text.}|, the text is not shown on any but the second slide. On the other slides, the text is not simply printed using the background color -- it is not shown at all. This effect is most useful if your background does not have a uniform color.
-
-Sometimes however, you might prefer that covered items are not completely covered. Rather, you would like them to be shown already in a very dim or shaded way. This allows your audience to get a feeling for what is yet to come, without getting distracted by it. Also, you might wish text that is covered once more'' still to be visible to some degree.
-
-Ideally, there would be an option to make covered text transparent.'' This would mean that when covered text is shown, it would instead be mixed with the background behind it. Unfortunately, |pgf| does not support real transparency yet. Instead, transparency is created by mixing the color of the object you want to show with the current background color (the color |bg|, which has hopefully been setup such that it is the average color of the background on which the object should be placed). To install this effect, you can use:
-
-\begin{verbatim}
-\setbeamercovered{transparent}
-\end{verbatim}
-
-This command allows you to specify in a quite general way how a covered item should be rendered. You can even specify different ways of rendering the item depending on how long it will take before this item is shown or for how long it has already been covered once more. The transparency effect will automatically apply to all colors, \emph{except} for the colors in images. For images there is a workaround, see the documentation of the \pgfname\ package.
-
-\begin{command}{\setbeamercovered\marg{options}}
-  This command offers several different options, the most important of which is |transparent|. All options are internally mapped to the two options |still covered| and |again covered|.
-
-  In detail, the following \meta{options} may be given:
-  \begin{itemize}
-  \item
-    \declare{|invisible|} is the default and causes covered text to completely disappear''.
-  \item
-    \declare{|transparent|}\opt{|=|\meta{opaqueness}} causes covered text to be typset in a transparent'' way. By default, this means that 85\% of the background color is mixed into all colors or that the \meta{opaqueness} of the text is 15\%. You can specify a different \meta{percentage}, where |0| means totally transparent'' and |100| means totally opaque.''
-
-    Unfortunately, this value is kind of specific'' to every projector. What looks good on your screen need not look good during a presentation.
-  \item
-    \declare{|dynamic|} Makes all covered text quite transparent, but in a dynamic way. The longer it will take till the text is uncovered, the stronger the transparency.
-  \item
-    \declare{|highly dynamic|} Has the same effect as |dynamic|, but the effect is stronger.
-  \item
-    \declare{|still covered=|\meta{not yet list}} specifies how to render covered items that have not yet been uncovered. The \meta{not yet list} should be a list of |\opaqueness| commands, see the description of that command, below.
-    \example
-\begin{verbatim}
-\setbeamercovered{%
-  still covered={\opaqueness<1>{15}\opaqueness<2>{10}\opaqueness<3>{5}\opaqueness<4->{2}},
-  again covered={\opaqueness<1->{15}}}
-\end{verbatim}
-
-  \item
-    \declare{|again covered=|\meta{once more list}} specifies how to render covered items that have once more been covered, that is, that had been shown before but are now covered again.
-  \end{itemize}
-\end{command}
-
-\begin{command}{\opaqueness\ssarg{overlay specification}\marg{percentage of opaqueness}}
-  The \meta{overlay specification} specifies on which slides covered text should have which \meta{percentage of opaqueness}. Unlike other overlay specifications, this \meta{overlay specification} is a relative'' overlay specification. For example, the specification 3'' here means things that will be uncovered three slides ahead,'' respectively things that have once more been covered for three slides.'' More precisely, if an item is uncovered for more than one slide and then covered once more, only the first moment of uncovering'' is used for the calculation of how long the item has been covered once more.
-
-  An opaqueness of 100 is fully opaque and 0 is fully transparent. Currently, since real transparency is not yet implemented, this command causes all colors to get a mixing of \meta{percentage of opaqueness} of the current |bg|. At some future point this command might result in real transparency.
-
-  The alternate \pgfname\ extension used inside an opaque area is \meta{percentage of opaqueness}|opaque|. In case of nested calls, only the innermost opaqueness specification is used.
-  \example
-\begin{verbatim}
-\setbeamercovered{still covered={\opaqueness<1->{15}},again covered={\opaqueness<1->{15}}}
-\pgfdeclareimage{book}{book}
-\pgfdeclareimage{book.!15opaque}{filenameforbooknearlytransparent}
-\end{verbatim}
-
-  Makes everything that is uncovered in two slides only 15 percent opaque.
-\end{command}

Deleted: trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-compatibility.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-compatibility.tex	2017-12-19 00:07:03 UTC (rev 46094)
+++ trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-compatibility.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -1,235 +0,0 @@
-% Copyright 2003--2007 by Till Tantau
-% Copyright 2010 by Vedran Mileti\'c
-% Copyright 2012,2015 by Vedran Mileti\'c, Joseph Wright
-%
-% This file may be distributed and/or modified
-%
-% 1. under the LaTeX Project Public License and/or
-% 2. under the GNU Free Documentation License.
-%
-
-\subsection{Compatibility with Other Packages and Classes}
-
-When using certain packages or classes together with the |beamer| class, extra options or precautions may be necessary.
-
-\begin{package}{{AlDraTex}}
-  Graphics created using AlDraTex must be treated like verbatim text. The reason is that DraTex fiddles with catcodes and spaces much like verbatim does. So, in order to insert a picture, either add the |fragile| option to the frame or use the |\defverbatim| command to create a box containing the picture.
-\end{package}
-
-\begin{package}{{alltt}}
-  Text in an |alltt| environment must be treated like verbatim text. So add the |fragile| option to frames containing this environment or use |\defverbatim|.
-\end{package}
-
-\begin{package}{{amsthm}}
-  This package is automatically loaded since \beamer\ uses it for typesetting theorems. If you do not wish it to be loaded, which can be necessary especially in |article| mode if the package is incompatible with the document class, you can use the class option |noamsthm| to suppress its loading. See Section~\ref{section-theorems} for more details.
-\end{package}
-
-\begin{package}{{babel}|[|\declare{|french|}|]|}
-  When using the |french| style, certain features that clash with the functionality of the \beamer\ class will be turned off. For example, enumerations are still produced the way the theme dictates, not the way the |french| style does.
-\end{package}
-
-\begin{package}{{babel}|[|\declare{|spanish|}|]|}
-  \beamernote
-  When using the |spanish| style, certain features that clash with the functionality of the \beamer\ class will be turned off. In particular, the special behavior of the pointed brackets |<| and |>| is deactivated.
-
-  \articlenote
-  To make the characters |<| and |>| active in |article| mode, pass the option |activeospeccharacters| to the package |beamerbasearticle|. This will lead to problems with overlay specifications.
-\end{package}
-
-\begin{package}{{color}}
-  \beamernote
-  The |color| package is automatically loaded by |beamer.cls|. This makes it impossible to pass options to |color| in the preamble of your document in the normal manner. To pass a \meta{list of options} to |color|, you can use the following class option:
-
-  \begin{classoption}{color={\normalfont\meta{list of options}}}
-  Causes the \meta{list of options} to be passed on to the |color| package. If the \meta{list of options} contains more than one option you must enclose it in curly brackets.
-  \end{classoption}
-
-  \articlenote
-  The |color| package is not loaded automatically if |beamerarticle| is loaded with the |noxcolor| option.
-\end{package}
-
-\begin{package}{{colortbl}}
-  \beamernote
-  With newer versions of |xcolor.sty|, you need to pass the option |table| to |xcolor.sty| if you wish to use |colortbl|. See the notes on |xcolor| below, on how to do this.
-\end{package}
-
-\begin{package}{{CJK}}
-  \beamernote
-  When using the |CJK| package for using Asian fonts, you must use the class option \declare{|CJK|}.
-\end{package}
-
-\begin{package}{{deluxetable}}
-  \beamernote
-  The caption generation facilities of |deluxetable| are deactivated. Instead, the caption template is used.
-\end{package}
-
-\begin{package}{{DraTex}}
-  See |AlDraTex|.
-\end{package}
-
-\begin{package}{{enumerate}}
-  \articlenote
-  This package is loaded automatically in the |presentation| modes, but not in the |article| mode. If you use its features, you have to load the package by hand'' in the |article| mode.
-\end{package}
-
-\begin{class}{{foils}}
-  If you wish to emulate the |foils| class using \beamer, please see Section~\ref{section-foiltex}.
-\end{class}
-
-\begin{package}{{fontenc}|[|\declare{|T1,EU1,EU2|}|]|}
-  Use the |T1| option \emph{only} with fonts that have outline fonts available in the T1 encoding like |times| or the |lmodern| fonts. In a standard installation standard Computer Modern fonts (the fonts Donald Knuth originally designed and which are used by default) are \emph{not} available in the T1 encoding. Using this option with them will result in very poor rendering of your presentation when viewed with \pdf\ viewer applications like Acrobat, |xpdf|, |evince| or |okular|. To use the Computer Modern fonts with the T1 encoding, use the package |lmodern|. See also Section~\ref{section-font-encoding}. This applies both to |latex|+|dvips| and |pdflatex|
-
-  Use the |EU1| option with |xelatex|, and |EU2| option with |lualatex|. Note that |xelatex| and |luatex| support OpenType fonts, and font encodings work very different compared to |pdflatex|. Again, see Section~\ref{section-font-encoding} for more information.
-\end{package}
-
-\begin{package}{{fourier}}
-  The package switches to a T1~encoding, but it does not redefine all fonts such that outline fonts (non-bitmapped fonts) are used by default. For example, the sans-serif text and the typewriter text are not replaced. To use outline fonts for these, write |\usepackage{lmodern}| \emph{before} including the |fourier| package.
-\end{package}
-
-\begin{package}{{HA-prosper}}
-  You cannot use this package with \beamer. However, you might try to use the package |beamerprosper| instead, see Section~\ref{section-prosper}.
-\end{package}
-
-\begin{package}{{hyperref}}
-  \beamernote
-  The |hyperref| package is automatically loaded by |beamer.cls| and certain options are set up. In order to pass additional options to |hyperref| or to override options, you can use the following class option:
-
-  \begin{classoption}{hyperref={\normalfont\meta{list of options}}}
-    Causes the \meta{list of options} to be passed on to the |hyperref| package.
-
-    \example |\documentclass[hyperref={bookmarks=false}]{beamer}|
-  \end{classoption}
-
-  Alternatively, you can also use the |\hypersetup| command.
-
-  \articlenote
-  In the |article| version, you must include |hyperref| manually if you want to use it. You can do so by passing option |hyperref| to |beamerarticle|. It is not included automatically.
-\end{package}
-
-\begin{package}{{inputenc}|[|\declare{|utf8,utf8x|}|]|}
-  \beamernote
-  When using Unicode, you may wish to use \emph{some} of the following class options:
-  \begin{classoption}{ucs}
-    Loads the package |ucs| and passes the correct Unicode options to |hyperref|. Also, it preloads the Unicode code pages zero and one.
-  \end{classoption}
-
-  \begin{classoption}{utf8x}
-    Same as the option |ucs|, but also sets the input encoding to |utf8x|. You could also use the option |ucs| and say |\usepackage[utf8x]{inputenc}| in the preamble. This also automatically loads |ucs| package in most \TeX\ systems.
-  \end{classoption}
-
-  If you use a Unicode character outside the first two code pages (which includes the Latin alphabet and the extended Latin alphabet) in a section or subsection heading, you have to use the command |\PreloadUnicodePage{|\meta{code page}|}| to give |ucs| a chance to preload these code pages. You will know that a character has not been preloaded, if you get a message like Please insert into preamble.'' The code page of a character is given by the unicode number of the character divided by 256.
-
-  \begin{classoption}{utf8}
-    This option sets the input encoding to |utf8|. It's designed to be used \emph{without} |ucs|. It's the same as saying |\usepackage[utf8]{inputenc}| in the preamble.
-  \end{classoption}
-
-  Note that \emph{none} of these options apply to |lualatex| and |xelatex|, since both support Unicode natively without any extra packages. Most of the time using these options actually harms output quality, so be careful about what you use. If you want to have a document that allows compiling with multiple drivers, take a look at |iftex|, |ifxetex| and |ifluatex| packages.
-
-  \articlenote
-  Passing option |utf8| to |beamerarticle| has the same effect as saying |\usepackage[utf8]{inputenc}| in the preamble.
-
-  Again, take care if you use |lualatex| or |xelatex|.
-\end{package}
-
-\begin{package}{{listings}}
-  \beamernote
-  Note that you must treat |lstlisting| environments exactly the same way as you would treat |verbatim| environments. When using |\defverbatim| that contains a colored |lstlisting|, use the |colored| option of |\defverbatim|.
-  \example
-\begin{verbatim}
-\usepackage{listings}
-
-\begin{document}
-\defverbatim[colored]\mycode{%
-  \begin{lstlisting}[frame=single, emph={cout}, emphstyle={\color{blue}}]
-    cout << "Hello world!";
-  \end{lstlisting}
-  }
-
-\begin{frame}
-  \mycode
-\end{frame}
-\end{document}
-\end{verbatim}
-\end{package}
-
-\begin{package}{{msc}}
-  \beamernote
-  Since this package uses |pstricks| internally, everything that applies to pstricks also applies to |msc|.
-\end{package}
-
-\begin{package}{{musixtex}}
-  When using MusiX\TeX\ to typeset musical scores, you have to have $\varepsilon$-\TeX extensions enabled. Most modern distributions enable that by default both in |pdflatex| and |latex|. However, if you have an older distribution, the document must be compiled with |pdfelatex| or |elatex| instead of |pdflatex| or |latex|.
-
-  Inside a |music| environment, the |\pause| is redefined to match MusiX\TeX's definition (a rest during one quarter of a whole). You can use the |\beamerpause| command to create overlays in this environment.
-\end{package}
-
-\begin{package}{{pdfpages}}
-  Commands like |\includepdf| only work \emph{outside} frames as they produce pages by themselves.'' You may also wish to say
-\begin{verbatim}
-\setbeamercolor{background canvas}{bg=}
-\end{verbatim}
-  when you use such a command since the background (even a white background) will otherwise be printed over the image you try to include.
-
-  \example
-\begin{verbatim}
-\begin{document}
-\begin{frame}
-  \titlepage
-\end{frame}
-
-{
-  \setbeamercolor{background canvas}{bg=}
-  \includepdf{somepdfimages.pdf}
-}
-
-\begin{frame}
-  A normal frame.
-\end{frame}
-\end{document}
-\end{verbatim}
-\end{package}
-
-\begin{package}{{\normalfont\meta{professional font package}}}
-  \beamernote
-  If you use a professional font package, \beamer's internal redefinition of how variables are typeset may interfere with the font package's superior way of typesetting them. In this case, you should use the class option |professionalfonts| to suppress any font substitution. See Section~\ref{section-substition} for details.
-\end{package}
-
-\begin{class}{{prosper}}
-  If you wish to (partly) emulate the |prosper| class using \beamer, please see Section~\ref{section-prosper}.
-\end{class}
-
-\begin{package}{{pstricks}}
-  You should add the option |xcolor=pst| to make |xcolor| aware of the fact that you are using |pstricks|.
-\end{package}
-
-\begin{class}{{seminar}}
-  If you wish to emulate the |seminar| class using \beamer, please see Section~\ref{section-seminar}.
-\end{class}
-
-\begin{package}{{texpower}}
-  You cannot use this package with \beamer. However, you might try to use the package |beamertexpower| instead, see Section~\ref{section-texpower}.
-\end{package}
-
-\begin{package}{{textpos}}
-  \beamernote
-  \beamer\ automatically installs a white background behind everything, unless you install a different background template. Because of this, you must use the |overlay| option when using |textpos|, so that it will place boxes \emph{in front of} everything. Alternatively, you can install an empty background template, but this may result in an incorrect display in certain situtations with older versions of the Acrobat Reader.
-\end{package}
-
-\begin{package}{{ucs}}
-  See |\usepackage[utf8,utf8x]{inputenc}|.
-\end{package}
-
-\begin{package}{{xcolor}}
-  \beamernote
-  The |xcolor| package is automatically loaded by |beamer.cls|. The same applies as to |color|.
-
-  \begin{classoption}{xcolor={\normalfont\meta{list of options}}}
-    Causes the \meta{list of options} to be passed on to the |xcolor| package.
-  \end{classoption}
-
-  When using \beamer\ together with the |pstricks| package, be sure to pass the |xcolor=pst| option to \beamer\ (and hence to |xcolor|).
-
-  \articlenote
-  The |color| package is not loaded automatically if |beamerarticle| is loaded with the |noxcolor| option.
-\end{package}

Deleted: trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-elements.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-elements.tex	2017-12-19 00:07:03 UTC (rev 46094)
+++ trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-elements.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -1,486 +0,0 @@
-% Copyright 2003--2007 by Till Tantau
-% Copyright 2010 by Vedran Mileti\'c
-% Copyright 2012,2014,2015 by Vedran Mileti\'c, Joseph Wright
-%
-% This file may be distributed and/or modified
-%
-% 1. under the LaTeX Project Public License and/or
-% 2. under the GNU Free Documentation License.
-%
-
-\section{Inner Themes, Outer Themes, and Templates}
-\label{section-elements}
-
-This section discusses the inner and outer themes that are available in \beamer. These themes install certain \emph{templates} for the different elements of a presentation. The template mechanism is explained at the end of the section.
-
-Before we plunge into the details, let us agree on some terminology for this section. In \beamer, an \emph{element} is part of a presentation that is potentially typeset in some special way. Examples of elements are frame titles, the author's name, or the footnote sign. The appearance of every element is governed by a \emph{template} for this element. Appropriate templates are installed by inner and outer themes, where the \emph{inner} themes only install templates for elements that are typically inside the main text,'' while \emph{outer} themes install templates for elements around the main text.'' Thus, from the templates's point of view, there is no real difference between inner and outer themes.
-
-
-\subsection{Inner Themes}
-
-An inner theme installs templates that dictate how the following elements are typeset:
-\begin{itemize}
-\item Title and part pages.
-\item Itemize environments.
-\item Enumerate environments.
-\item Description environments.
-\item Block environments.
-\item Theorem and proof environments.
-\item Figures and tables.
-\item Footnotes.
-\item Bibliography entries.
-\end{itemize}
-
-In the following examples, the color themes |seahorse| and |rose| are used to show where and how background colors are honored. Furthermore, background colors have been specified for all elements that honor them in the default theme. In the default color theme, all of the large rectangular areas are transparent.
-
-\begin{innerthemeexample}{default}
-  The default element theme is quite sober. The only extravagance is the fact that a little triangle is used in |itemize| environments instead of the usual dot.
-
-  In some cases the theme will honor background color specifications for elements. For example, if you set the background color for block titles to green, block titles will have a green background. The background specifications are currently honored for the following elements:
-  \begin{itemize}
-  \item Title, author, institute, and date fields in the title page.
-  \item Block environments, both for the title and for the body.
-  \end{itemize}
-  This list may increase in the future.
-\end{innerthemeexample}
-
-\begin{innerthemeexample}{circles}
-\end{innerthemeexample}
-
-\begin{innerthemeexample}{rectangles}
-\end{innerthemeexample}
-
-\begin{innerthemeexample}[\oarg{options}]{rounded}
-  In this theme, |itemize| and |enumerate| items and table of contents entries start with small balls. If a background is specified for blocks, then the corners of the background rectangles will be rounded off. The following \meta{options} may be given:
-
-  \begin{itemize}
-  \end{itemize}
-\end{innerthemeexample}
-
-\begin{innerthemeexample}{inmargin}
-  The idea behind this theme is to have structuring'' information on the left and normal'' information on the right. To this end, blocks are redefined such that the block title is shown on the left and the block body is shown on the right.
-
-  The code used to place text in the margin is a bit fragile. You may often need to adjust the spacing by hand,'' so use at your own risk.
-
-  Itemize items are redefined such that they appear on the left. However, only the position is changed by changing some spacing parameters; the code used to draw the items is not changed otherwise. Because of this, you can load another inner theme first and then load this theme afterwards.
-
-  This theme is a dirty'' inner theme since it messes with things that an inner theme should not mess with. In particular, it changes the width of the left sidebar to a large value. However, you can still use it together with most outer themes.
-
-  Using columns inside this theme is problematic. Most of the time, the result will not be what you expect.
-\end{innerthemeexample}
-
-
-\subsection{Outer Themes}
-
-An outer theme dictates (roughly) the overall layout of frames. It specifies where any navigational elements should go (like a mini table of contents or navigational mini frames) and what they should look like. Typically, an outer theme specifies how the following elements are rendered:
-\begin{itemize}
-\item The sidebars.
-\item The logo.
-\item The frame title.
-\end{itemize}
-
-An outer theme will not specify how things like |itemize| environments should be rendered---that is the job of an inner theme.
-
-In the following examples the color theme |seahorse| is used. Since the default color theme leaves most backgrounds empty, most of the outer themes look too unstructured with the default color theme.
-
-\begin{outerthemeexample}{default}
-  The default layout theme is the most sober and minimalistic theme around. It will flush left the frame title and it will not install any head- or footlines. However, even this theme honors the background color specified for the frame title. If a color is specified, a bar occupying the whole page width is put behind the frame title. A background color of the frame subtitle is ignored.
-\end{outerthemeexample}
-
-\begin{outerthemeexample}{infolines}
-  This theme installs a headline showing the current section and the current subsection. It installs a footline showing the author's name, the institution, the presentation's title, the current date, and a frame count. This theme uses only little space.
-
-  The colors used in the headline and footline are drawn from |palette primary|, |palette secondary|, and |primary tertiary| (see Section~\ref{section-colors} for details on how to change these).
-\end{outerthemeexample}
-
-\begin{outerthemeexample}[\oarg{options}]{miniframes}
-  This theme installs a headline in which a horizontal navigational bar is shown. This bar contains one entry for each section of the presentation. Below each section entry, small circles are shown that represent the different frames in the section. The frames are arranged subsection-wise, that is, there is a line of frames for each subsection. If the class option |compress| is given, the frames will instead be arranged in a single row for each section. The navigation bars draws its color from |section in head/foot|.
-
-  Below the navigation bar, a line is put showing the title of the current subsection. The color is drawn from |subsection in head/foot|.
-
-  At the bottom, two lines are put that contain information such as the author's name, the institution, or the paper's title. What is shown exactly is influenced by the \meta{options} given. The colors are drawn from the appropriate \beamer-colors like |author in head/foot|.
-
-  At the top and bottom of both the head- and footline and between the navigation bar and the subsection name, separation lines are drawn \emph{if} the background color of |separation line| is set. This separation line will have a height of 3pt. You can get even more fine-grained control over the colors of the separation lines by setting appropriate colors like |lower separation line head|.
-
-  The following \meta{options} can be given:
-  \begin{itemize}
-  \item \declare{|footline=empty|} suppresses the footline (default).
-  \item \declare{|footline=authorinstitute|} shows the author's name and the institute in the footline.
-  \item \declare{|footline=authortitle|} shows the author's name and the title in the footline.
-  \item \declare{|footline=institutetitle|} shows the institute and the title in the footline.
-  \item \declare{|footline=authorinstitutetitle|} shows the author's name, the institute, and the title in the footline.
-  \item \declare{|subsection=|\meta{true or false}} shows or suppresses line showing the subsection in the headline. It is shown by default. If the document does not use subsections, this option should be set |false|.
-  \end{itemize}
-\end{outerthemeexample}
-
-\begin{outerthemeexample}[\oarg{options}]{smoothbars}
-  This theme behaves very much like the |miniframes| theme, at least with respect to the headline. The only differences are that smooth transitions are installed between the background colors of the navigation bar, the (optional) bar for the subsection name, and the background of the frame title. No footline is created. You can get the footlines of the |miniframes| theme by first loading that theme and then loading the |smoothbars| theme.
-
-  The following \meta{options} can be given:
-  \begin{itemize}
-  \item \declare{|subsection=|\meta{true or false}} shows or suppresses line showing the subsection in the headline. It is shown by default.
-  \end{itemize}
-\end{outerthemeexample}
-
-\begin{outerthemeexample}[\oarg{options}]{sidebar}
-  In this layout, a sidebar is shown that contains a small table of contents with the current section, subsection, or subsubsection highlighted. The frame title is vertically centered in a rectangular area at the top that always occupies the same amount of space in all frames. Finally, the logo is shown in the corner'' resulting from the sidebar and the frame title rectangle.
-
-  There are several ways of modifying the layout using the \meta{options}. If you set the width of the sidebar to 0pt, it is not shown, giving you a layout in which the frame title does not wobble'' since it always occupies the same amount of space on all slides. Conversely, if you set the height of the frame title rectangle to 0pt, the rectangular area is not used and the frame title is inserted normally (occupying as much space as needed on each slide).
-
-  The background color of the sidebar is taken from |sidebar|, the background color of the frame title from |frametitle|, and the background color of the logo corner from |logo|.
-
-  The colors of the entries in the table of contents are drawn from the \beamer-color |section in sidebar| and |section in sidebar current| as well as the corresponding \beamer-colors for subsections. If an entry does not fit on a single line it is automatically linebroken.''
-
-  The following \meta{options} may be given:
-  \begin{itemize}
-  \item
-    \declare{|height=|\meta{dimension}} specifies the height of the frame title rectangle. If it is set to 0pt, no frame title rectangle is created. Instead, the frame title is inserted normally into the frame. The default is 2.5 base line heights of the frame title font. Thus, there is about enough space for a two-line frame title plus a one-line subtitle.
-  \item
-    \declare{|hideothersubsections|} causes all subsections except those of the current section to be suppressed in the table of contents. This is useful if you have lots of subsections.
-  \item
-  \item
-    \declare{|left|} puts the sidebar on the left side. Note that in a left-to-right reading culture this is the side people look first. Note also that this table of contents is usually \emph{not} the most important part of the frame, so you do not necessarily want people to look at it first. Nevertheless, it is the default.
-  \item
-    \declare{|right|} puts the sidebar of the right side.
-  \item
-    \declare{|width=|\meta{dimension}} specifies the width of the sidebar. If it is set to 0pt, it is completely suppressed. The default is 2.5 base line heights of the frame title font.
-  \end{itemize}
-\end{outerthemeexample}
-
-\begin{outerthemeexample}{split}
-  This theme installs a headline in which, on the left, the sections of the talk are shown and, on the right, the subsections of the current section. If the class option |compress| has been given, the sections and subsections will be put in one line; normally there is one line per section or subsection.
-
-  The footline shows the author on the left and the talk's title on the right.
-
-  The colors are taken from |palette primary| and |palette quaternary|.
-\end{outerthemeexample}
-
-  This layout theme extends the |split| theme by putting a horizontal shading behind the frame title and adding a little shadow'' at the bottom of the headline.
-\end{outerthemeexample}
-
-\begin{outerthemeexample}[\oarg{options}]{tree}
-  In this layout, the headline contains three lines that show the title of the current talk, the current section in this talk, and the current subsection in the section. The colors are drawn from |title in head/foot|, |section in head/foot|, and |subsection in head/foot|.
-
-  In addition, separation lines of height 3pt are shown above and below the three lines \emph{if} the background of |separation line| is set. More fine-grained control of the colors of these lines can be gained by setting |upper separation line head| and |lower separation line head|.
-
-  The following \meta{options} may be given:
-  \begin{itemize}
-  \item
-    \declare{|hooks|} causes little hooks'' to be drawn in front of the section and subsection entries. These are supposed to increase the tree-like appearance.
-  \end{itemize}
-\end{outerthemeexample}
-
-\begin{outerthemeexample}{smoothtree}
-  This layout is similar to the |tree| layout. The main difference is that the background colors change smoothly.
-\end{outerthemeexample}
-
-
-\subsection{Changing the Templates Used for Different Elements of a Presentation}
-\label{section-templates}
-
-This section explains how \beamer's template management works.
-
-\subsubsection{Overview of Beamer's Template Management}
-
-If you only wish to modify the appearance of a single or few elements, you do not need to create a whole new inner or outer theme. Instead, you can modify the appropriate template.
-
-A template specifies how an element of a presentation is typeset. For example, the |frametitle| template dictates where the frame title is put, which font is used, and so on.
-
-As the name suggests, you specify a template by writing the exact \LaTeX\ code you would also use when typesetting a single frame title by hand. Only, instead of the actual title, you use the command |\insertframetitle|.
-
-\example
-Suppose we would like to have the frame title typeset in red, centered, and boldface. If we were to typeset a single frame title by hand, it might be done like this:
-
-\begin{verbatim}
-\begin{frame}
-  \begin{centering}
-    \color{red}
-    \textbf{The Title of This Frame.}
-    \par
-  \end{centering}
-
-  Blah, blah.
-\end{frame}
-\end{verbatim}
-
-In order to typeset the frame title in this way on all slides, in the simplest case we can change the frame title template as follows:
-
-\begin{verbatim}
-\setbeamertemplate{frametitle}
-{
-  \begin{centering}
-    \color{red}
-    \textbf{\insertframetitle}
-    \par
-  \end{centering}
-}
-\end{verbatim}
-We can then use the following code to get the desired effect:
-\begin{verbatim}
-\begin{frame}
-  \frametitle{The Title of This Frame.}
-
-  Blah, blah.
-\end{frame}
-\end{verbatim}
-
-When rendering the frame, \beamer\ will use the code of the frame title template to typeset the frame title and it will replace every occurrence of |\insertframetitle| by the current frame title.
-
-We can take this example a step further. It would be nicer if we did not have to hardwire'' the color of the frametitle, but if this color could be specified independently of the code for the template. This way, a color theme could change this color. Since this is a problem that is common to most templates, \beamer\ will automatically setup the \beamer-color |frametitle| when the template |frametitle| is used. Thus, we can remove the |\color{red}| command if we set the \beamer-color |frametitle| to red at some point.
-
-\begin{verbatim}
-\setbeamercolor{frametitle}{fg=red}
-\setbeamertemplate{frametitle}
-{
-  \begin{centering}
-    \textbf{\insertframetitle}
-    \par
-  \end{centering}
-}
-\end{verbatim}
-
-Next, we can also make the font themable.'' Just like the color, the \beamer-font |frametitle| is installed before the |frametitle| template is typeset. Thus, we should rewrite the code as follows:
-
-\begin{verbatim}
-\setbeamercolor{frametitle}{fg=red}
-\setbeamerfont{frametitle}{series=\bfseries}
-\setbeamertemplate{frametitle}
-{
-  \begin{centering}
-    \insertframetitle\par
-  \end{centering}
-}
-\end{verbatim}
-
-Users, themes, or whoever can now easily change the color or font of the frametitle without having to mess with the code used to typeset it.
-
-\articlenote
-In |article| mode, most of the template mechanism is switched off and has no effect. However, a few templates are also available. If this is the case, it is specially indicated.
-\smallskip
-
-Here are a few hints that might be helpful when you wish to set a template:
-\begin{itemize}
-\item
-  Usually, you might wish to copy code from an existing template. The code often takes care of some things that you may not yet have thought about. The default inner and outer themes might be useful starting points. Also, the file |beamerbaseauxtemplates.sty| contains interesting auxilliary'' templates.
-\item
-  When copying code from another template and when inserting this code in the preamble of your document (not in another style file), you may have to switch on'' the at-character (|@|). To do so, add the command |\makeatletter| before the |\setbeamertemplate| command and the command |\makeatother| afterward.
-\item
-  Most templates having to do with the frame components (headlines, sidebars, etc.)\ can only be changed in the preamble. Other templates can be changed during the document.
-\item
-  The height of the headline and footline templates is calculated automatically. This is done by typesetting the templates and then having a look'' at their heights. This recalculation is done right at the beginning of the document, \emph{after} all packages have been loaded and even \emph{after} these have executed their |\AtBeginDocument| initialization.
-\item
-  Getting the boxes right inside any template is often a bit of a hassle. You may wish to consult the \TeX\ book for the glorious details on Making Boxes.'' If your headline is simple, you might also try putting everything into a |pgfpicture| environment, which makes the placement easier.
-\end{itemize}
-
-\subsubsection{Using Beamer's Templates}
-
-As a user of the \beamer\ class you typically do not use'' or invoke'' templates yourself, directly. For example, the frame title template is automatically invoked by \beamer\ somewhere deep inside the frame typesetting process. The same is true of most other templates. However, if, for whatever reason, you wish to invoke a template yourself, you can use the following command.
-
-\begin{command}{\usebeamertemplate\opt{|***|}\marg{element name}}
-  If none of the stars is given, the text of the \meta{element name} is directly inserted at the current position. This text should previously have been specified using the |\setbeamertemplate| command. No text is inserted if this command has not been called before.
-  \example
-\begin{verbatim}
-\setbeamertemplate{my template}{correct}
-...
-\end{verbatim}
-
-  If you add one star, three things happen. First, the template is put inside a \TeX-group, thereby limiting most side effects of commands used inside the template. Second, inside this group the \beamer-color named \meta{element name} is used and the foreground color is selected. Third, the \beamer-font \meta{element name} is also used. This one-starred version is usually the best version to use.
-
-  If you add a second star, nearly the same happens as with only one star. However, in addition, the color is used with the command |\setbeamercolor*|. This causes the colors to be reset to the normal text color if no special foreground or background is specified by the \beamer-color \meta{element name}. Thus, in this twice-starred version, the color used for the template is guaranteed to be independent of the color that was currently in use when the template is used.
-
-  Finally, adding a third star will also cause a star to be added to the |\setbeamerfont*| command. This causes the font used for the template also to be reset to normal text, unless the \beamer-font \meta{element name} specifies things differently. This three-star version is the most protected'' version available.
-\end{command}
-
-\begin{command}{\ifbeamertemplateempty\marg{beamer template name}\marg{executed if empty}\marg{executed otherwise}}
-  This command checks whether a template is defined and set to a non-empty text. If the text is empty or the template is not defined at all, \meta{executed if empty} is executed. Otherwise, \meta{executed otherwise} is executed.
-\end{command}
-
-\begin{command}{\expandbeamertemplate\marg{beamer template name}}
-  This command does the same as |\usebeamertemplate|\marg{beamer template name}. The difference is that this command performs a direct expansion and does not scan for a star. This is important inside, for example, an |\edef|. If you don't know the difference between |\def| and |\edef|, you won't need this command.
-\end{command}
-
-\subsubsection{Setting Beamer's Templates}
-
-To set  a \beamer-template, you can use the following command:
-
-\begin{command}{\setbeamertemplate\marg{element name}\oarg{predefined option}\meta{args}}
-  In the simplest case, if no \meta{predefined option} is given, the \meta{args} must be a single argument and the text of the template \meta{element name} is setup to be this text. Upon later invocation of the template by the command |\usebeamertemplate| this text is used.
-
-  \example
-\begin{verbatim}
-...
-\end{verbatim}
-
-  If you specify a \meta{predefined option}, this command behaves slightly differently. In this case, someone has used the command |\defbeamertemplate| to predefine a template for you. By giving the name of this predefined template as the optional parameter \meta{predefined option}, you cause the template \meta{element name} to be set to this template.
-
-  \example
-  |\setbeamertemplate{bibliography item}[book]| causes the bibliography items to become little book icons. This command causes a subsequent call of |\usebeamertemplate{bibliography item}| to insert the predefined code for inserting a book.
-
-  Some predefined template options take parameters themselves. In such a case, the parameters are given as \meta{args}.
-
-  \example
-  The \meta{predefined option} |grid| for the template |background| takes an optional argument:
-\begin{verbatim}
-\setbeamertemplate{background}[grid][step=1cm]
-\end{verbatim}
-
-  In the example, the second argument in square brackets is the optional argument.
-
-  In the descriptions of elements, if there are possible \meta{predefined option}, the description shows how the \meta{predefined option} can be used together with its arguments, but the |\setbeamertemplate{xxxx}| is omitted. Thus, the above example would be documented in the description of the |background| element like this:
-  \begin{itemize}
-    \itemoption{grid}{\oarg{step options}} causes a light grid to be \dots
-  \end{itemize}
-\end{command}
-
-  This command adds the \meta{pre-text} before the text that is currently installed as the template \meta{element name} and the \meta{post-text} after it. This allows you a limited form of modification of existing templates.
-
-  \example
-  The following commands have the same effect:
-
-\begin{verbatim}
-\setbeamertemplate{my template}{Hello world!}
-
-\setbeamertemplate{my template}{world}
-\end{verbatim}
-
-  If a new template is installed, any additions will be deleted. On the other hand, you can repeatedly use this command to add multiple things.
-\end{command}
-
-\begin{command}{\defbeamertemplate\sarg{mode specification}\opt{|*|}\marg{element name}\marg{predefined option}\\ \oarg{argument number}\oarg{default optional argument}\marg{predefined text}\\ \opt{|[action]|\marg{action command}}}
-  This command installs a \emph{predefined option} for the template \meta{element name}. Once this command has been used, users can access the predefined template using the |\setbeamertemplate| command.
-
-  \example
-  |\defbeamertemplate{itemize item}{double arrow}{$\Rightarrow$}|
-
-  After the above command has been invoked, the following two commands will have the same effect:
-
-\begin{verbatim}
-\setbeamertemplate{itemize item}{$\Rightarrow$}
-\setbeamertemplate{itemize item}[double arrow]
-\end{verbatim}
-
-  Sometimes, a predefined template needs to get an argument when it is installed. Suppose, for example, we want to define a predefined template that draws a square as the itemize item and we want to make this size of this square configurable. In this case, we can specify the \meta{argument number} of the predefined option the same way one does for the |\newcommand| command:
-
-\begin{verbatim}
-\defbeamertemplate{itemize item}{square}[1]{\hrule width #1 height #1}
-
-%% The following have the same effect:
-\setbeamertemplate{itemize item}[square]{3pt}
-\setbeamertemplate{itemize item}{\hrule width 3pt height 3pt}
-\end{verbatim}
-  As for the |\newcommand| command, you can also specify a \meta{default optional argument}:
-\begin{verbatim}
-\defbeamertemplate{itemize item}{square}[1][1ex]{\hrule width #1 height #1}
-
-%% The following have the same effect:
-\setbeamertemplate{itemize item}[square][3pt]
-\setbeamertemplate{itemize item}{\hrule width 3pt height 3pt}
-
-%% So do the following:
-\setbeamertemplate{itemize item}[square]
-\setbeamertemplate{itemize item}{\hrule width 1ex height 1ex}
-\end{verbatim}
-
-  The starred version of the command installs the predefined template option, but then immediately calls |\setbeamertemplate| for this option. This is useful for the default templates. If there are any arguments necessary, these are set to |\relax|.
-
-  In certain cases, if a predefined template option is chosen, you do not only wish the template text to be installed, but certain extra actions'' must also be taken once. For example, a shading must be defined that should not be redefined every time the shading is used later on. To implement such actions,'' you can use the optional argument \meta{action} following the keyword |[action]|. Thus, after the normal use of the |\defbeamertemplate| you add the text |[action]| and then any commands that should be executed once when the \meta{predefined option} is selected by the |\setbeamertemplate| command.
-
-  \example
-\begin{verbatim}
-{
-}
-[action]
-{
-  {color(0cm)=(#1); color(\the\paperheight)=(#2)}
-}
-...
-
-%% \usebeamertemplate{background canvas} will yield
-%% \pgfuseshading{myshading}''.
-\end{verbatim}
-
-  \articlenote
-  Normally, this command has no effect in |article| mode. However, if a \meta{mode specification} is given, this command is applied for the specified modes. Thus, this command behaves like the |\\| command, which also gets the implicit mode specification |<presentation>| if no other specification is given.
-
-  \example
-  |\defbeamertemplate{my template}{default}{something}| has no effect in |article| mode.
-
-  \example
-  |\defbeamertemplate<article>{my template}{default}{something}| has no effect in |presentation| modes, but has an effect in |article| mode.
-
-  \example
-  |\defbeamertemplate<all>{my template}{default}{something}| applies to all modes.
-\end{command}
-
-It is often useful to have access to the same template option via different names. For this, you can use the following command to create aliases:
-\begin{command}{\defbeamertemplatealias\marg{element name}\marg{new predefined option name}\marg{existing predefined option name}}
-  Causes the two predefined options to have the same effect.
-\end{command}
-
-There is no inheritance relation among templates as there is for colors and fonts. This is due to the fact the templates for one element seldom make sense for another. However, sometimes certain elements behave similarly'' and one would like a |\setbeamertemplate| to apply to a whole set of templates via inheritance. For example, one might want that |\setbeamertemplate{items}[circle]| causes all items to use the |circle| option, though the effects for the |itemize item| as opposed to the |itemize subsubitem| as opposed to |enumerate item| must be slightly different.
-
-The \beamer-template mechanism implements a simple form of inheritance via \emph{parent templates}. In element descriptions, parent templates are indicated via a check mark in parentheses.
-
-\begin{command}{\defbeamertemplateparent\marg{parent template name}\oarg{predefined option name}\marg{child template list}\\ \oarg{argument number}\oarg{default optional argument}\marg{arguments for children}}
-  The effect of this command is that whenever someone calls |\setbeamertemplate{|\meta{parent template name}|}{|\meta{args}|}|, the command |\setbeamertemplate{|\meta{child template name}|}{|\meta{args}|}| is called for each \meta{child template name} in the \meta{child template list}.
-
-  The \meta{arguments for children} come into play if the |\setbeamertemplate| command is called with a predefined option name (not necessarily the same as the \meta{predefined option name}, we'll come to that). If |\setbeamertemplate| is called with some predefined option name, the children are called with the \meta{arguments for children} instead. Let's look at two examples:
-
-  \example
-  The following is the typical, simple usage:
-
-\begin{verbatim}
-\defbeamertemplateparent{itemize items}{itemize item,itemize subitem,itemize subsubitem}
-{}
-
-%% The following command has the same effect as the three commands below:
-\setbeamertemplate{itemize items}[circle]
-
-\setbeamertemplate{itemite item}[circle] % actually, the empty'' argument is added
-\setbeamertemplate{itemize subitem}[circle]
-\setbeamertemplate{itemize subsubitem}[circle]
-\end{verbatim}
-
-  \example
-  In the following case, an argument is passed to the children:
-
-\begin{verbatim}
-{[#1]}
-
-%% The following command has the same effect as the two commands below:
-
-
-
-%% Again:
-
-\end{verbatim}
-
-  In detail, the following happens: When |\setbeamertemplate| is encountered for a parent template, \beamer\ first checks whether a predefined option follows. If not, a single argument is read and |\setbeamertemplate| is called for all children for this template. If there is a predefined template option set, \beamer\ evaluates the \meta{argument for children}. It may contain parameters like |#1| or |#2|. These parameters are filled with the arguments that follow the call of |\setbeamertemplate| for the parent template. The number of arguments must be the number given as \meta{argument number}. An optional argument can also be specified in the usual way. Once the \meta{arguments for the children} have been computed, |\setbeamertemplate| is called for all children for the predefined template and with the computed arguments.
-
-  You may wonder what happens when certain predefined options take a certain number of arguments, but another predefined option takes a different number of arguments. In this case, the above-described mechanism cannot differentiate between the predefined options and it is unclear which or even how many arguments should be contained in \meta{arguments for children}. For this reason, you can give the optional argument \meta{predefined option name} when calling |\defbeamertemplateparent|. If this optional argument is specified, the parenthood of the template applies only to this particular \meta{predefined option name}. Thus, if someone calls |\setbeamertemplate| for this \meta{predefined option name}, the given \meta{argument for children} is used. For other predefined option names a possibly different definition is used. You can imaging that leaving out the optional \meta{predefined option name} means this \meta{argument for children} applies to all predefined option names that have not been specially defined differently.''
-\end{command}

Deleted: trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-emulation.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-emulation.tex	2017-12-19 00:07:03 UTC (rev 46094)
+++ trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-emulation.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -1,721 +0,0 @@
-% Copyright 2003--2007 by Till Tantau
-% Copyright 2010 by Vedran Mileti\'c
-% Copyright 2015 by Vedran Mileti\'c, Joseph Wright
-%
-% This file may be distributed and/or modified
-%
-% 1. under the LaTeX Project Public License and/or
-% 2. under the GNU Free Documentation License.
-%
-
-\section[How To Import Presentations Based on Other Packages and Classes]{How To Import Presentations Based on\\ Other Packages and Classes}
-
-The \beamer\ class comes with a number of emulation layers for classes or packages that do not support \beamer\ directly. For example, the package |beamerseminar| maps some (not all) commands of the \seminar\ class to appropriate \beamer\ commands. This way, individual slides or whole sets of slides that have been prepared for a presentation using \seminar\ can be used inside \beamer, provided they are reasonably simple.
-
-None of the emulation layers is a perfect substitute for the original (emulations seldom are) and it is not intended that they ever will be. If you want/need/prefer the features of another class, use that class for preparing your presentations. The intention of these layers is just to help speed up creating \beamer\ presentations that use parts of old presentations. You can simply copy these parts in verbatim, without having to worry about the subtle differences in syntax.
-
-A useful effect of using an emulation layer is that you get access to all the features of \beamer\ while using the syntax of another class. For example, you can use the |article| mode to create a nice article version of a \prosper\ talk.
-
-
-\subsection{Prosper, HA-Prosper and Powerdot}
-\label{section-prosper}
-
-The package |beamerprosper| maps the commands of the \prosper\ package, developed by Fr\'ed\'eric Goualard, to \beamer\ commands. Also, some commands of the \textsc{ha}-\prosper\ and \textsc{powerdot} packages, developed by Hendri Adriaens, are mapped to \beamer\ commands. \emph{These mappings cannot perfectly emulate all of Prosper!} Rather, these mappings are intended as an aid when porting parts of presentations created using \prosper\ to \beamer. \emph{No styles are implemented that mimick Prosper styles.} Rather, the normal \beamer\ themes must be used (although, one could implement \beamer\ themes that mimicks existing \prosper\ styles; we have not done that and do not intend to).
-
-The workflow for creating a \beamer\ presentation that uses \prosper\ code is the following:
-\begin{enumerate}
-\item
-  Use the document class |beamer|, not |prosper|. Most options passed to |prosper| do not apply to |beamer| and should be omitted.
-\item
-  Add a |\usepackage{beamerprosper}| to start the emulation.
-\item
-  If you add slides relying on \textsc{ha}-\prosper, you may wish to add the option |framesassubsections| to |beamerprosper|, though we do not recommend it (use the normal |\subsection| command instead; it gives you more fine-grained control).
-\item
-  If you also copy the title commands, it may be necessary to adjust the content of commands like |\title| or |\author|. Note that in \prosper\ the |\email| command is given outside the |\author| command, whereas in \beamer\ and also in \textsc{ha}-\prosper\ it is given inside.
-\item
-  When copying slides containing the command |\includegraphics|, you will almost surely have to adjust its usage. If you use pdf\LaTeX\ to typeset the presentation, than you cannot include PostScript files. You should convert them to |.pdf| or to |.png| and adjust any usage of |\includegraphics| accordingly.
-\item
-  When starting to change things, you can use all of \beamer's commands and even mix them with \prosper\ commands.
-\end{enumerate}
-
-An example can be found in the file |beamerexample-prosper.tex|.
-
-There are, unfortunately, quite a few places where you may run into problems:
-\begin{itemize}
-\item
-  In \beamer, the command |\PDForPS| will do exactly what the name suggests: insert the first argument when run by |pdflatex|, insert the second argument when run by |latex|. However, in \prosper, the code inserted for the \pdf\ case is actually PostScript code, which is only later converted to \pdf\ by some external program. You will need to adjust this PostScript code such that it works with |pdflatex| (which is not always possible).
-\item
-  If you used fine-grained spacing commands, like adding a little horizontal skip   here and a big negative vertical skip there, the typesetting of the text may be poor. It may be a good idea to just remove these spacing commands.
-\item
-  If you use |pstricks| commands, you will either have to stick to using |latex| and |dvips| or will have to work around them using, for example, |pgf|. Porting lots of |pstricks| code is bound to be difficult, if you wish to switch over to |pdflatex|, so be warned. You can read more about that in Section~\ref{section-graphics} that talks about graphics.
-\item
-  If the file cannot be compiled because some \prosper\ command is not implemented, you will have to delete this command and try to mimick its behavior using some \beamer\ command.
-\end{itemize}
-
-\begin{package}{{beamerprosper}}
-  Include this package in a |beamer| presentation to get access to \prosper\ commands. Use |beamer| as the document class, not |prosper|. Most of the options passed to the class |prosper| make no sense in |beamer|, so just delete them.
-
-  This package takes the following options:
-  \begin{itemize}
-  \item
-    \declare{|framesassubsections|} causes each frame to create its own subsection with the frame title as subsection name. This behavior mimicks \textsc{ha}-\textsc{prosper}'s behavior. In a long talk this will create way too many subsections.
-  \end{itemize}
-
-  \articlenote
-  The |framesassubsections| option has no effect in |article| mode.
-
-  \example
-\begin{verbatim}
-\documentclass[notes]{beamer}
-
-\usepackage[framesassubsections]{beamerprosper}
-
-\title{A Beamer Presentation Using (HA-)Prosper Commands}
-\subtitle{Subtitles Are Also Supported}
-\author{Till Tantau}
-\institution{The Institution is Mapped To Institute}
-
-\begin{document}
-
-\maketitle
-
-\tsectionandpart{Introduction}
-
-\overlays{2}{
-  \begin{itemstep}
-  \item
-    This is a beamer presentation.
-  \item
-    You can use the prosper and the HA-prosper syntax.
-  \item
-    This is done by mapping prosper and HA-prosper commands to beamer
-    commands.
-  \item
-    The emulation is by no means perfect.
-  \end{itemstep}
-\end{slide}
-}
-
-\section{Second Section}
-\subsection{A subsection}
-\begin{frame}
-  \frametitle{A frame created using the \texttt{frame} environment.}
-
-  \begin{itemize}[<+->]
-  \item You can still use the original beamer syntax.
-  \item The emulation is intended only to make recycling slides
-    easier, not to install a whole new syntax for beamer.
-  \end{itemize}
-\end{frame}
-
-\begin{notes}{Notes for these slides}
-My notes for these slides.
-\end{notes}
-\end{document}
-\end{verbatim}
-  You can run, for example, pdf\LaTeX\ on the file to get a \beamer\ presentation with overlays. Adding the |notes| option will also show the notes. Certain commands, like |\LeftFoot|, are ignored. You can change the theme using the usual commands. You can also use all normal \beamer\ commands and concepts, like overlay-specifications, in the file. You can also create an |article| version by using the class |article| and including the package |beamerarticle|.
-\end{package}
-
-In the following, the effects of \prosper\ commands in \beamer\ are listed.
-
-\begin{command}{\email\marg{text}}
-  Simply typesets its argument in typewriter text. Should hence be given \emph{inside} the |\author| command.
-\end{command}
-
-\begin{command}{\institution\marg{text}}
-  This command is mapped to \beamer's |\institute| command if given \emph{outside} the |\author| command, otherwise it typesets its argument in a smaller font.
-\end{command}
-
-\begin{command}{\Logo\opt{|(|\meta{x}|,|\meta{y}|)|}\marg{logo text}}
-  This is mapped to |\logo{|\meta{logo text}|}|. The coordinates are ignored.
-\end{command}
-
-\begin{environment}{{slide}\oarg{options}\marg{frame title}}
-  Inserts a frame with the |fragile=singleslide| option set. The \meta{frame title} will be enclosed in a |\frametitle| command.
-
-  The following \meta{options} may be given:
-  \begin{itemize}
-  \item
-    \declare{|trans=|\meta{prosper transition}} installs the specified \meta{prosper transition} as the transition effect when showing the slide.
-  \item
-    \declare{\meta{prosper transition}} has the same effect as |trans=|\meta{prosper transition}.
-  \item
-    \declare{|toc=|\meta{entry}} overrides the subsection table of contents entry created by this slide by \meta{entry}. Note that a subsection entry is created for a slide only if the |framesassubsections| options is specified.
-  \item
-    \declare{|template|=\meta{text}} is ignored.
-  \end{itemize}
-
-  \example
-  The following two texts have the same effect:
-
-\begin{verbatim}
-\begin{slide}[trans=Glitter,toc=short]{A Title}
-  Hi!
-\end{slide}
-\end{verbatim}
-  and
-\begin{verbatim}
-\subsection{short} % omitted, if framesassubsections is not specified
-\begin{frame}[fragile=singleslide]
-  \transglitter
-  \frametitle{A Title}
-  Hi!
-\end{frame}
-\end{verbatim}
-\end{environment}
-
-\begin{command}{\overlays\marg{number}\marg{slide environment}}
-  This will put the \meta{slide environment} into a frame that does not have the |fragile| option and which can hence contain overlayed text. The \meta{number} is ignored since the number of necessary overlays is computed automatically by \beamer.
-
-  \example
-  The following code fragments have the same effect:
-
-\begin{verbatim}
-\overlays{2}{
-\begin{slide}{A Title}
-  \begin{itemstep}
-  \item Hi!
-  \item Ho!
-  \end{itemstep}
-\end{slide}}
-\end{verbatim}
-  and
-\begin{verbatim}
-\subsection{A Title} % omitted, if framesassubsections is not specified
-\begin{frame}
-  \frametitle{A Title}
-  \begin{itemstep}
-  \item Hi!
-  \item Ho!
-  \end{itemstep}
-\end{frame}
-\end{verbatim}
-\end{command}
-
-\begin{command}{\fromSlide\marg{slide number}\marg{text}}
-  This is mapped to |\uncover<|\meta{slide number}|->{|\meta{text}|}|.
-\end{command}
-
-\begin{command}{\fromSlide|*|\marg{slide number}\marg{text}}
-  This is mapped to |\only<|\meta{slide number}|->{|\meta{text}|}|.
-\end{command}
-
-\begin{command}{\onlySlide\marg{slide number}\marg{text}}
-  This is mapped to |\uncover<|\meta{slide number}|>{|\meta{text}|}|.
-\end{command}
-
-\begin{command}{\onlySlide|*|\marg{slide number}\marg{text}}
-  This is mapped to |\only<|\meta{slide number}|>{|\meta{text}|}|.
-\end{command}
-
-\begin{command}{\untilSlide\marg{slide number}\marg{text}}
-  This is mapped to |\uncover<-|\meta{slide number}|>{|\meta{text}|}|.
-\end{command}
-
-\begin{command}{\untilSlide|*|\marg{slide number}\marg{text}}
-  This is mapped to |\only<-|\meta{slide number}|>{|\meta{text}|}|.
-\end{command}
-
-\begin{command}{\FromSlide\marg{slide number}}
-  This is mapped to |\onslide<|\meta{slide number}|->|.
-\end{command}
-
-\begin{command}{\OnlySlide\marg{slide number}}
-  This is mapped to |\onslide<|\meta{slide number}|>|.
-\end{command}
-
-\begin{command}{\UntilSlide\marg{slide number}}
-  This is mapped to |\onslide<-|\meta{slide number}|>|.
-\end{command}
-
-\begin{command}{\slideCaption\marg{text}}
-  This is mapped to |\date{|\meta{text}|}|.
-\end{command}
-
-\begin{command}{\fontTitle\marg{text}}
-  Simply inserts \meta{text}.
-\end{command}
-
-\begin{command}{\fontText\marg{text}}
-  Simply inserts \meta{text}.
-\end{command}
-
-\begin{command}{\PDFtransition\marg{prosper transition}}
-  Maps the \meta{prosper transition} to an appropriate |\transxxxx| command.
-\end{command}
-
-\begin{environment}{{Itemize}}
-  This is mapped to |itemize|.
-\end{environment}
-
-\begin{environment}{{itemstep}}
-  This is mapped to |itemize| with the option |[<+->]|.
-\end{environment}
-
-\begin{environment}{{enumstep}}
-  This is mapped to |enumerate| with the option |[<+->]|.
-\end{environment}
-
-\begin{command}{\hiddenitem}
-  This is mapped to |\addtocounter{beamerpauses}{1}|.
-\end{command}
-
-\begin{command}{\prosperpart\oarg{options}\marg{text}}
-  This command has the same effect as \prosper's |\part| command. \beamer's normal |\part| command retains its normal semantics. Thus, you might wish to replace all occurrences of |\part| by |\prosperpart|.
-\end{command}
-
-\begin{command}{\tsection\opt{|*|}\marg{section name}}
-  Creates a section named \meta{section name}. The star, if present, is ignored.
-\end{command}
-
-\begin{command}{\tsectionandpart\opt{|*|}\marg{part text}}
-  Mapped to a |\section| command followed by a |\prosperpart| command.
-
-  \articlenote
-  In |article| mode, no part page is added.
-\end{command}
-
-\begin{command}{\dualslide\oarg{x}\oarg{y}\oarg{z}\marg{options}\marg{left column}\marg{right column}}
-  This command is mapped to a |columns| environment. The \meta{left column} text is shown in the left column, the \meta{right column} text is shown in the right column. The options \meta{x}, \meta{y}, and \meta{z} are ignored. Also, all \meta{options} are ignored, except for \declare{|lcolwidth=|} and \declare{|rcolwidth=|}. These set the width of the left or right column, respectively.
-\end{command}
-
-\begin{command}{\PDForPS\marg{PostScript text}\marg{PDF text}}
-  Inserts either the \meta{PostScript text} or the \meta{PDF text}, depending on whether |latex| or |pdflatex| is used. When porting, the \meta{PDF text} will most likely be \emph{incorrect}, since in \prosper\ the \meta{PDF text} is actually PostScript text that is later transformed to \pdf\ by some external program.
-
-  If the \meta{PDF text} contains an |\includegraphics| command (which is its usual use), you should change the name of the graphic file that is included to a name ending |.pdf|, |.png|, or |.jpg|. Typically, you will have to convert your graphic to this format.
-\end{command}
-
-\begin{command}{\onlyInPDF\meta{PDF text}}
-  The \meta{PDF text} is only included if |pdflatex| is used. The same as for the command |\PDForPS| applies here.
-\end{command}
-
-\begin{command}{\onlyInPS\meta{PS text}}
-  The \meta{PS text} is only included if |latex| is used.
-\end{command}
-
-\begin{environment}{{notes}\marg{title}}
-  Mapped to |\note{\textbf{|\meta{title}|}|\meta{environment contents}|}| (more or less).
-\end{environment}
-
-The following commands are parsed by \beamer, but have no effect:
-\begin{itemize}\itemsep=0pt\parskip=0pt
-\item |\myitem|,
-\item |\FontTitle|,
-\item |\FontText|,
-\item |\ColorFoot|,
-\item |\DefaultTransition|,
-\item |\NoFrenchBabelItemize|,
-\item |\TitleSlideNav|,
-\item |\NormalSlideNav|,
-\item |\HAPsetup|,
-\item |\LeftFoot|, and
-\item |\RightFoot|.
-\end{itemize}
-
-
-\subsection{Seminar}
-\label{section-seminar}
-
-The package |beamerseminar| maps a subset of the commands of the \seminar\ package to \beamer. As for \prosper, the emulation cannot be perfect. For example, no portrait slides are supported, no automatic page breaking, the framing of slides is not emulated. Unfortunately, for all frames (|slide| environments) that contain overlays, you have to put the environment into a |frame| environment by hand'' and must remove all occurrences of |\newslide| inside the environment by closing the slide and opening a new one (and then putting these into |frame| environments).
-
-The workflow for the migration is the following:
-\begin{enumerate}
-\item
-  Use the document class |beamer|, not |seminar|. Most options passed to |seminar| do not apply to |beamer| and should be omitted.
-\item
-  If you copy parts of a presentation that is mixed with normal text, add the |ignorenonframetext| option and place \emph{every} |slide| environment inside a |frame| since \beamer\ will not recognize the |\begin{slide}| as the beginning of a frame.
-\item
-  Add a |\usepackage{beamerseminar}| to start the emulation. Add the option |accumulated| if you wish to create a presentation to be held with a video projector.
-\item
-  Possibly add commands to install themes and templates.
-\item
-  There should not be commands in the preamble having to do with page and slide styles. They do not apply to |beamer|.
-\item
-  If a |\newslide| command is used in a |slide| (or similarly |slide*|) environment that contains an overlay, you must replace it by a closing |\end{slide}| and an opening |\begin{slide}|.
-\item
-  Next, for each |slide| or |slide*| environment that contains an overlay, you must place a |frame| environment around it. You can remove the |slide| environment (and hence effectively replace it by |frame|), unless you use the |accumulated| option.
-\item
-  If you use |\section| or |\subsection| commands inside slides, you will have to move them \emph{outside} the frames. It may then be necessary to add a |\frametitle| command to the slide.
-\item
-  If you use pdf\LaTeX\ to typeset the presentation, you cannot include PostScript files. You should convert them to |.pdf| or to |.png| and adjust any usage of |\includegraphics| accordingly.
-\item
-  When starting to change things, you can use all of \beamer's commands and even mix them with \seminar\ commands.
-\end{enumerate}
-
-An example can be found in the file |beamerexample-seminar.tex|.
-
-There are, unfortunately, numerous places where you may run into problems:
-\begin{itemize}
-\item
-  The whole |note| management of |seminar| is so different from |beamer|'s, that you will have to edit notes by hand.'' In particular, commands like |\ifslidesonly| and |\ifslide| may not do exactly what you expect.
-\item
-  If you use |pstricks| commands, you will either have to stick to using |latex| and |dvips| or will have to work around them using, for example, |pgf|. Porting lots of |pstricks| code is bound to be difficult, if you wish to switch over to |pdflatex|, so be warned.
-\item
-  If the file cannot be compiled because some \seminar\ command is not implemented, you will have to delete this command and try to mimick its behavior using some \beamer\ command.
-\end{itemize}
-
-\begin{package}{{beamerseminar}}
-  Include this package in a |beamer| presentation to get access to \seminar\ commands. Use |beamer| as the document class, not |seminar|. Most of the options passed to the class |seminar| make no sense in |beamer|, so just delete them.
-
-  This package takes the following options:
-  \begin{itemize}
-  \item
-    \declare{|accumulated|} causes overlays to be accumulated. The original behavior of the \seminar\ package is that in each overlay only the really new'' part of the overlay is shown. This makes sense, if you really print out the overlays on transparencies and then really stack overlays on top of each other. For a presentation with a video projector, you rather want to present an accumulated'' version of the overlays. This is what this option does: When the new material of the $i$-th overlay is shown, the material of all previous overlays is also shown.
-  \end{itemize}
-
-  \example
-  The following example is an extract of |beamerexample-seminar.tex|:
-
-\begin{verbatim}
-\documentclass[ignorenonframetext]{beamer}
-\usepackage[accumulated]{beamerseminar}
-\usepackage{beamerthemeclassic}
-
-\title{A beamer presentation using seminar commands}
-\author{Till Tantau}
-
-
-\begin{document}
-
-\begin{frame}
-  \maketitle
-\end{frame}
-
-This is some text outside any frame. It will only be shown in the
-article version.
-
-\begin{frame}
-  \begin{slide}
-    \heading{This is a frame title.}
-
-    \begin{enumerate}
-      {\overlay1
-      \item Overlays are a little tricky in seminar.
-        {\overlay2
-        \item But it is possible to use them in beamer.
-        }
-      }
-    \end{enumerate}
-  \end{slide}
-\end{frame}
-\end{document}
-\end{verbatim}
-  You can use all normal \beamer\ commands and concepts, like overlay-specifications, in the file. You can also create an |article| version by using the class |article| and including the package |beamerarticle|.
-\end{package}
-
-In the following, the effects of \seminar\ commands in \beamer\ are listed.
-
-\begin{command}{\overlay\marg{number}}
-  Shows the material till the end of the current \TeX\ group only on overlay numbered $\hbox{\meta{number}}+1$ or, if the |accumulated| option is given, from that overlay on. Usages of this command may be nested (as in \seminar). If an |\overlay| command is given inside another, it temporarily overrules'' the outer one as demonstrated in the following example, where it is assumed that the |accumulated| option is given.
-
-  \example
-\begin{verbatim}
-\begin{frame}
-  \begin{slide}
-    This is shown from the first slide on.
-    {\overlay{2}
-      This is shown from the third slide on.
-      {\overlay{1}
-        This is shown from the second slide on.
-      }
-      This is shown once more from the third slide on.
-    }
-  \end{slide}
-\end{frame}
-\end{verbatim}
-\end{command}
-
-\begin{environment}{{slide}\opt{|*|}}
-  Mainly installs an |\overlay{0}| around the \meta{environment contents}. If the |accumulated| option is given, this has no effect, but otherwise it will cause the main text of the slide to be shown \emph{only} on the first slide. This is useful if you really wish to physically place slides on top of each other.
-
-  The starred version does the same as the nonstarred one.
-
-  If this command is not issued inside a |\frame|, it sets up a frame with the |fragile=singleframe| option set. Thus, this frame will contain only a single slide.
-
-  \example
-\begin{verbatim}
-\begin{slide}
-  Some text.
-\end{slide}
-
-\frame{
-\begin{slide}
-  Some text. And an {\overlay{1} overlay}.
-\end{slide}
-}
-\end{verbatim}
-\end{environment}
-
-\begin{command}{\red}
-  Mapped to |\color{red}|.
-\end{command}
-
-\begin{command}{\blue}
-  Mapped to |\color{blue}|.
-\end{command}
-
-\begin{command}{\green}
-  Mapped to |\color{green}|.
-\end{command}
-
-\begin{command}{\ifslide}
-  True in the |presentation| modes, false in the |article| mode.
-\end{command}
-
-\begin{command}{\ifslidesonly}
-  Same as |\ifslide|.
-\end{command}
-
-\begin{command}{\ifarticle}
-  False in the |presentation| modes, true in the |article| mode.
-\end{command}
-
-\begin{command}{\ifportrait}
-  Always false.
-\end{command}
-
-The following commands are parsed by \beamer, but have no effect:
-\begin{itemize}\itemsep=0pt\parskip=0pt
-\item |\ptsize|.
-\end{itemize}
-
-
-\subsection{Foil\TeX}
-\label{section-foiltex}
-
-The package |beamerfoils| maps a subset of the commands of the \foils\ package to \beamer. Since this package defines only few non-standard \TeX\ commands and since \beamer\ implements all the standard commands, the emulation layer is pretty simple.
-
-A copyright notice: The Foil\TeX\ package has a restricted license. For this reason, no example from the \foils\ package is included in the \beamer\ class. The emulation itself does not use the code of the \foils\ package (rather, it just maps \foils\ commands to \beamer\ commands). For this reason, our understanding is that the \emph{emulation} offered by the \beamer\ class is free'' and legally so. IBM has a copyright on the \foils\ class, not on the effect the commands of this class have. (At least, that's our understanding of things.)
-
-The workflow for the migration is the following:
-\begin{enumerate}
-\item
-  Use the document class |beamer|, not |foils|.
-\item
-  Add a |\usepackage{beamerfoils}| to start the emulation.
-\item
-  Possibly add commands to install themes and templates.
-\item
-  If the command |\foilhead| is used inside a |\frame| command or |frame| environment, it behaves like |\frametitle|. If it used outside a frame, it will start a new frame (with the |allowframebreaks| option, thus no overlays are allowed). This frame will persist till the next occurrence of |\foilhead| or of the new command |\endfoil|. Note that a |\frame| command will \emph{not} end a frame started using |\foilhead|.
-\item
-  If you rely on automatic frame creation based on |\foilhead|, you will need to insert an |\endfoil| before the end of the document to end the last frame.
-\item
-  If you use pdf\LaTeX\ to typeset the presentation, than you cannot include PostScript files. You should convert them to |.pdf| or to |.png| and adjust any usage of |\includegraphics| accordingly.
-\item
-  Sizes of objects are different in \beamer, since the scaling is done by the viewer, not by the class. Thus a framebox of size 6 inches will be way too big in a \beamer\ presentation. You will have to manually adjust explicit dimension occurring in a foil\TeX\ presentation.
-\end{enumerate}
-
-\begin{package}{{beamerfoils}}
-  Include this package in a |beamer| presentation to get access to \foils\ commands. Use |beamer| as the document class, not |foils|.
-
-  \example
-  In the following example, frames are automatically created. The |\endfoil| at the end is needed to close the last frame.
-
-\begin{verbatim}
-\documentclass{beamer}
-\usepackage{beamerfoils}
-
-\begin{document}
-
-\maketitle
-
-
-This is on the first frame.
-\pagebreak
-This is on the second frame, which is a continuation of the first.
-
-
-This is on the third frame.
-
-\endfoil
-\end{document}
-\end{verbatim}
-
-  \example
-  In this example, frames are manually inserted. No |\endfoil| is needed.
-
-\begin{verbatim}
-\documentclass{beamer}
-\usepackage{beamerfoils}
-
-\begin{document}
-
-\frame{\maketitle}
-
-\frame{
-This is on the first frame.
-}
-
-\frame{
-This is on the second frame.
-}
-\end{document}
-\end{verbatim}
-\end{package}
-
-In the following, the effects of \foils\ commands in \beamer\ are listed.
-
-\begin{command}{\MyLogo\marg{logo text}}
-  This is mapped to |\logo|, though the logo is internally stored, such that it can be switched on and off using |\LogoOn| and |\LogoOff|.
-\end{command}
-
-\begin{command}{\LogoOn}
-  Makes the logo visible.
-\end{command}
-
-\begin{command}{\LogoOff}
-  Makes the logo invisible.
-\end{command}
-
-  If used inside a |\frame| command or |frame| environment, this is mapped to |\frametitle{|\meta{frame title}|}|. If used outside any frames, a new frame is started with the option |allowframebreaks|. If a frame was previously started using this command, it will be closed before the next frame is started. The \meta{dimension} is ignored.
-\end{command}
-
-  This command has exactly the same effect as |\foilhead|.
-\end{command}
-
-\begin{command}{\endfoil}
-  This is a command that is \emph{not} available in \foils. In \beamer, it can be used to end a frame that has automatically been opened using |\foildhead|. This command must be given before the end of the document if the last frame was opened using |\foildhead|.
-\end{command}
-
-\begin{environment}{{boldequation}\opt{|*|}}
-  This is mapped to the |equation| or the |equation*| environment, with |\boldmath| switched on.
-\end{environment}
-
-\begin{command}{\FoilTeX}
-  Typesets the foil\TeX\ name as in the \foils\ package.
-\end{command}
-
-\begin{command}{\bm\marg{text}}
-  Implemented as in the \foils\ package.
-\end{command}
-
-\begin{command}{\bmstyle\marg{text}\marg{more text}}
-  Implemented as in the \foils\ package.
-\end{command}
-
-The following additional theorem-like environments are predefined:
-\begin{itemize}
-\item |Theorem*|,
-\item |Lemma*|,
-\item |Corollary*|,
-\item |Proposition*|, and
-\item |Definition*|.
-\end{itemize}
-For example, the first is defined using |\newtheorem*{Theorem*}{Theorem}|.
-
-The following commands are parsed by \beamer, but have no effect:
-\begin{itemize}
-\item |\leftfooter|,
-\item |\rightfooter|,
-\item |\Restriction|, and
-\item |\marginpar|.
-\end{itemize}
-
-
-\subsection{\TeX Power}
-\label{section-texpower}
-
-The package |beamertexpower| maps a subset of the commands of the \texpower\ package, due to Stephan Lehmke, to \beamer. This subset is currently rather small, so a lot of adaptions may be necessary. Note that \texpower\ is not a full class by itself, but a package that needs another class, like |seminar| or |prosper| to do the actual typesetting. It may thus be necessary to additionally load an emulation layer for these also. Indeed, it \emph{might} be possible to directly use \texpower\ inside \beamer, but we have not tried that. Perhaps this will be possible in the future.
-
-Currently, the package |beamertexpower| mostly just maps the |\stepwise| and related commands to appropriate \beamer\ commands. The |\pause| command need not be mapped since it is directly implemented by \beamer\ anyway.
-
-The workflow for the migration is the following:
-\begin{enumerate}
-\item
-  Replace the document class by |beamer|. If the document class is |seminar| or |prosper|, you can use the above emulation layers, that is, you can include the files |beamerseminar| or |beamerprosper| to emulate the class.
-
-  All notes on what to do for the emulation of \seminar\ or \prosper\ also apply here.
-\item
-\end{enumerate}
-
-\begin{package}{{beamertexpower}}
-  Include this package in a |beamer| presentation to get access to the \texpower\ commands having to do with the |\stepwise| command.
-\end{package}
-
-A note on the |\pause| command: Both \beamer\ and \texpower\ implement this command and they have the same semantics; so there is no need to map this command to anything different in |beamertexpower|. However, a difference is that |\pause| can be used almost anywhere in \beamer, whereas it may only be used in non-nested situations in \texpower. Since \beamer\ is only more flexible than \texpower\ here, this will not cause problems when porting.
-
-In the following, the effect of \texpower\ commands in \beamer\ are listed.
-
-\begin{command}{\stepwise\marg{text}}
-  As in \texpower, this initiates text in which commands like |\step| or |\switch| may be given. Text contained in a |\step| command will be enclosed in an |\only| command with the overlay specification |<+(1)->|. This means that the text of the first |\step| is inserted from the second slide onward, the text of the second |\step| is inserted from the third slide onward, and so on.
-\end{command}
-
-\begin{command}{\parstepwise\marg{text}}
-  Same as |\stepwise|, only |\uncover| is used instead of |\only| when mapping the |\step| command.
-\end{command}
-
-\begin{command}{\liststepwise\marg{text}}
-  Same as |\stepwise|, only an invisible horizontal line is inserted before the \meta{text}. This is presumably useful for solving some problems related to vertical spacing in \texpower.
-\end{command}
-
-\begin{command}{\step\marg{text}}
-  This is either mapped to |\only<+(1)->|\meta{text} or to |\uncover<+(1)->|\meta{text}, depending on whether this command is used inside a |\stepwise| environment or inside a |\parstepwise| environment.
-\end{command}
-
-\begin{command}{\steponce\marg{text}}
-  This is either mapped to |\only<+(1)>|\meta{text} or to |\uncover<+(1)>|\meta{text}, depending on whether this command is used inside a |\stepwise| environment or inside a |\parstepwise| environment.
-\end{command}
-
-\begin{command}{\switch\marg{alternate text}\marg{text}}
-  This is mapped to |\alt<+(1)->{|\meta{text}|}{|\meta{alternate text}|}|. Note that the arguments are swapped.
-\end{command}
-
-\begin{command}{\bstep\marg{text}}
-  This is always mapped to |\uncover<+(1)->|\meta{text}.
-\end{command}
-
-\begin{command}{\dstep}
-  This just advances the counter |beamerpauses| by one. It has no other effect.
-\end{command}
-
-\begin{command}{\vstep}
-  Same as |\dstep|.
-\end{command}
-
-\begin{command}{\restep\marg{text}}
-  Same as |\step|, but the \meta{text} is shown on the same slide as the previous |\step| command. This is implemented by first decreasing the counter |beamerpauses| by one before calling |\step|.
-\end{command}
-
-\begin{command}{\reswitch\marg{alternate text}\meta{text}}
-  Like |\restep|, only for the |\switch| command.
-\end{command}
-
-\begin{command}{\rebstep\meta{text}}
-  Like |\restep|, only for the |\bstep| command.
-\end{command}
-
-\begin{command}{\redstep}
-  This command has no effect.
-\end{command}
-
-\begin{command}{\revstep}
-  This command has no effect.
-\end{command}
-
-\begin{command}{\boxedsteps}
-  Temporarily (for the current \TeX\ group) changes the effect of |\step| to issue an |\uncover|, even if used inside a |\stepwise| environment.
-\end{command}
-
-\begin{command}{\nonboxedsteps}
-  Temporarily (for the current \TeX\ group) changes the effect of |\step| to issue an |\only|, even if used inside a |\parstepwise| environment.
-\end{command}
-
-\begin{command}{\code\marg{text}}
-  Typesets the argument using a boldface typewriter font.
-\end{command}
-
-\begin{command}{\codeswitch}
-  Switches to a boldface typewriter font.
-\end{command}

Deleted: trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-fonts.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-fonts.tex	2017-12-19 00:07:03 UTC (rev 46094)
+++ trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-fonts.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -1,251 +0,0 @@
-% Copyright 2003--2007 by Till Tantau
-% Copyright 2010 by Vedran Mileti\'c
-% Copyright 2015 by Vedran Mileti\'c, Joseph Wright
-%
-% This file may be distributed and/or modified
-%
-% 1. under the LaTeX Project Public License and/or
-% 2. under the GNU Free Documentation License.
-%
-
-\section{Fonts}
-\label{section-fonts}
-
-The first subsection introduces the predefined font themes that come with \beamer\ and which make it easy to change the fonts used in a presentation. The next subsection describes further special commands for changing some basic attributes of the fonts used in a presentation. The last subsection explains how you can get a much more fine-grained control over the fonts used for every individual element of a presentation.
-
-
-\subsection{Font Themes}
-
-\beamer\ comes with a set of font themes. When you use such a theme, certain fonts are changed as described below. You can use several font themes in concert. For historical reasons, you cannot change all aspects of the fonts used using font themes---in some cases special commands and options are needed, which are described in the next subsection.
-
-The following font themes only change certain font attributes, they do not choose special font families (although that would also be possible and themes doing just that might be added in the future). Currently, to change the font family, you need to load special packages as explained in the next subsection.
-
-
-\begin{fontthemeexample}{default}
-  The default font theme installs a sans serif font for all text of the presentation. The default theme installs different font sizes for things like titles or head- and footlines, but does not use boldface or italics for highlighting.'' To change some or all text to a serif font, use the |serif| theme.
-
-  Note: The command |\mathrm| will always produce upright (not slanted), serif text and the command |\mathsf| will always produce upright, sans-serif text. The command |\mathbf| will produce upright, bold-face, sans-serif or serif text, depending on whether |mathsans| or |mathserif| is used.
-
-  To produce an upright, sans-serif or serif text, depending on whether |mathsans| or |mathserif| is used, you can use for instance the command |\operatorname| from the |amsmath| package. Using this command instead of |\mathrm| or |\mathsf| directly will automatically adjust upright mathematical text if you switch from sans-serif to serif or back.
-\end{fontthemeexample}
-
-\begin{fontthemeexample*}{professionalfonts}
-  This font theme does not really change any fonts. Rather, it \emph{suppresses} certain internal replacements performed by \beamer. If you use professional fonts'' (fonts that you buy and that come with a complete set of every symbol in all modes), you do not want \beamer\ to meddle with the fonts you use. \beamer\ normally replaces certain character glyphs in mathematical text by more appropriate versions. For example, \beamer\ will normally replace glyphs such that the italic characters from the main font are used for variables in mathematical text. If your professional font package takes care of this already, \beamer's meddling should be switched off. Note that \beamer's substitution is automatically turned off if one of the following packages is loaded: |arevmath|, |hvmath|, |kpfonts|, |lmodern|, |lucidabr|, |lucimatx|, |mathastext|, |mathpmnt|, |mathpple|, |mathtime|, |mtpro|, and |mtpro2|. If your favorite professional font package is not among these, use the |professionalfonts| option (and write us an email, so that the package can be added).
-\end{fontthemeexample*}
-
-\begin{fontthemeexample}[\oarg{options}]{serif}
-  This theme causes all text to be typeset using the default serif font (except if you specify certain \meta{options}). You might wish to consult Section~\ref{section-guidelines-serif} on whether you should use serif fonts.
-
-  The following \meta{options} may be given:
-  \begin{itemize}
-  \item
-    \declare{|stillsansserifmath|}
-    causes mathematical text still to be typeset using sans serif. This option only makes sense if you also use the |stillsansseriftext| option since sans serif math inside serif text looks silly.
-  \item
-    \declare{|stillsansserifsmall|}
-    will cause small'' text to be still typeset using sans serif. This refers to the text in the headline, footline, and sidebars. Using this options is often advisable since small text is often easier to read in sans serif.
-  \item
-    \declare{|stillsansseriflarge|}
-    will cause large'' text like the presentation title or the frame title to be still typeset using sans serif. Sans serif titles with serif text are a popular combination in typography.
-  \item
-    \declare{|stillsansseriftext|}
-    will cause normal text (none of the above three) to be still typeset using sans serif. If you use this option, you should most likely also use the first two. However, by not using |stillsansseriflarge|, you get a serif (possibly italic) title over a sans serif text. This can be an interesting visual effect. Naturally, interesting typographic effect'' can mean terrible typographic effect'' if you choose the wrong fonts combinations or sizes. You'll need some typographic experience to judge this correctly. If in doubt, try asking someone who should know.
-  \item
-    \declare{|onlymath|}
-    is a short-cut for selecting all of the above options except for the first. Thus, using this option causes only mathematical text to by typeset using a serif font. Recall that, by default, mathematical formulas are also typeset using sans-serif letters. In most cases, this is visually the most pleasing and easily readable way of typesetting mathematical formulas if the surrounding text is typeset using sans serif. However, in mathematical texts the font used to render, say, a variable is sometimes used to differentiate between different meanings of this variable. In such case, it may be necessary to typeset mathematical text using serif letters. Also, if you have a lot of mathematical text, the audience may be quicker to parse'' it if it is typeset the way people usually read mathematical text: in a serif font.
-  \end{itemize}
-\end{fontthemeexample}
-
-\begin{fontthemeexample}[\oarg{options}]{structurebold}
-  This font theme will cause titles and text in the headlines, footlines, and sidebars to be typeset in a bold font.
-
-  The following \meta{options} may be given:
-  \begin{itemize}
-  \item
-    \declare{|onlysmall|}
-    will cause only small'' text to be typeset in bold. More precisely, only the text in the headline, footline, and sidebars is changed to be typeset in bold. Large titles are not affected.
-  \item
-    \declare{|onlylarge|}
-    will cause only large'' text to be typeset in bold. These are the main title, frame titles, and section entries in the table of contents.
-  \end{itemize}
-
-  As pointed out in Section~\ref{section-sizes}, you should use this theme (possibly with the |onlysmall| option) if your font is not scaled down properly or for light-on-dark text.
-
-  The normal themes do not install this theme by default, while the old compatibility themes do. Since you can reload the theme once it has been loaded, you cannot use this theme with the old compatibility themes to set also titles to a bold font.
-\end{fontthemeexample}
-
-\begin{fontthemeexample}[\oarg{options}]{structureitalicserif}
-  This theme is similarly as the |structurebold| font theme, but where |structurebold| makes text bold, this theme typesets it in italics and in the standard serif font. The same \meta{options} as for the |structurebold| theme are supported. See Section~\ref{section-italics} for the pros and cons of using italics.
-\end{fontthemeexample}
-
-\begin{fontthemeexample}[\oarg{options}]{structuresmallcapsserif}
-  Again, this theme does exactly the same as the |structurebold| font theme, only this time text is set using small caps and a serif font. The same \meta{options} as for the |structurebold| theme are supported. See Section~\ref{section-smallcaps} for the pros and cons of using small caps.
-\end{fontthemeexample}
-
-
-\subsection{Font Changes Made Without Using Font Themes}
-
-While most font decisions can be made using font themes, for historical reasons some changes can only be made using class options or by loading special packages. These options are explained in the following. Possibly, these options will be replaced by themes in the future.
-
-\subsubsection{Choosing a Font Size for Normal Text}
-
-As pointed out in Section~\ref{section-sizes}, measuring the default font size in points is not really a good idea for presentations. Nevertheless, \beamer\ does just that, setting the default font size to 11pt as usual. This may seem ridiculously small, but the actual size of each frame size is by default just 128mm by 96mm and the viewer application enlarges the font. By specifying a default font size smaller than 11pt you can put more onto each slide, by specifying a larger font size you can fit on less.
-
-To specify the font size, you can use the following class options:
-
-\begin{classoption}{8pt}
-  This is way too small. Requires that the package |extsize| is installed.
-\end{classoption}
-
-\begin{classoption}{9pt}
-  This is also too small. Requires that the package |extsize| is installed.
-\end{classoption}
-
-\begin{classoption}{10pt}
-  If you really need to fit more onto each frame, use this option. Works without |extsize|.
-\end{classoption}
-
-\begin{classoption}{smaller}
-  Same as the |10pt| option. \end{classoption}
-
-\begin{classoption}{11pt}
-  The default font size. You need not specify this option.
-\end{classoption}
-
-\begin{classoption}{12pt}
-  Makes all fonts a little bigger, which makes the text more readable. The downside is that less fits onto each frame.
-\end{classoption}
-
-\begin{classoption}{bigger}
-  Same as the |12pt| option.
-\end{classoption}
-
-\begin{classoption}{14pt}
-  Makes all fonts somewhat bigger. Requires |extsize| to be installed.
-\end{classoption}
-
-\begin{classoption}{17pt}
-  This is about the default size of PowerPoint and OpenOffice.org Impress. Requires |extsize| to be installed.
-\end{classoption}
-
-\begin{classoption}{20pt}
-  This is really huge. Requires |extsize| to be installed.
-\end{classoption}
-
-\subsubsection{Choosing a Font Family}
-
-\label{section-substition}
-
-By default, \beamer\ uses the Computer Modern fonts. To change this, you can use one of the prepared packages of \LaTeX's font mechanism. For example, to change to Times/Helvetica, simply add
-\begin{verbatim}
-\usepackage{mathptmx}
-\usepackage{helvet}
-\end{verbatim}
-in your preamble. Note that if you do not use the |serif| font theme, Helvetica (not Times) will be selected as the text font.
-
-There may be many other fonts available on your installation. Typically, at least some of the following packages should be available: |arev|, |avant|, |bookman|, |chancery|, |charter|, |euler|, |helvet|, |lmodern|, |mathtime|, |mathptm|, |mathptmx|, |newcent|, |palatino|, |pifont|, |utopia|.
-
-\subsubsection{Choosing a Font Encodings}
-\label{section-font-encoding}
-
-The same font can come in different encodings, which are (very roughly spoken) the ways the characters of a text are mapped to glyphs (the actual shape of a particular character in a particular font at a particular size). In \TeX\ two encodings are often used with Latin characters: the T1~encoding and the OT1~encoding (old T1~encoding).
-
-Conceptually, the newer T1~encoding is preferable over the old OT1~encoding. For example, hyphenation of words containing umlauts (like the famous German word Fr\"aulein) will work only if you use the T1~encoding. Unfortunately, the EC fonts, that is, the T1-encoded Computer Modern fonts, are distributed on small installations just as MetaFont sources and only have bitmap renditions of each glyph. For this reason, using the T1-encoded EC fonts on such small installations will produce \pdf\ files that render poorly.
-
-\TeX\ Live (cross-platform; replaced older \texttt{teTeX} for \textsc{unix}\slash Linux) and MiK\TeX\ (for Windows platforms) can be installed with different levels of completeness. Concerning the Computer Modern fonts, the following packages can be installed: |cm-super| fonts, |lmodern| (Latin Modern) fonts, and |lgc| fonts, the latter containing the Latin, Greek, and Cyrillic alphabets. Concerning other fonts, the |txfonts| and |pxfonts| are two extended sets of the Times and the Palatino PostScript fonts, both packages containing extended sets of mathematical glyphs. Most other standard PostScript fonts are also available in T1~encoding.
-
-Among the packages that make available the Computer Modern fonts in the T1~encoding, the package |lmodern| may be suggested. If you use |lmodern|, several extra fonts become available (like a sans-serif boldface math) and extra symbols (like proper guillemots).
-
-To select the T1 encoding, use \verb|\usepackage[T1]{fontenc}|. Thus, if you have the LM~fonts installed, you could write
-\begin{verbatim}
-\usepackage[T1]{fontenc}
-\usepackage{lmodern}
-\end{verbatim}
-to get beautiful outline fonts and correct hyphenation. Note, however, that certain older versions of the LM~bundle did not include correct glyphs for ligatures like fi,'' which may cause trouble. Double check that all ligatures are displayed correctly and, if not, update your installation.
-
-Everything mentioned above applies to |pdflatex| and |latex|+|dvips|. Unlike those engines, |xelatex| and |lualatex| support OpenType fonts, and that means that you can use system fonts in your documents relatively easy. Details will eventually be documented in this manual. For now, you can take a look at the documentation for the |fontspec| package which supports both engines. Also, note that when you use |lualatex| or |xelatex| with EU2 or EU1 encoding, respectively, by default you get OpenType Latin Modern fonts.
-
-
-\subsection{Changing the Fonts Used for Different Elements of a Presentation}
-
-This section explains how \beamer's font management works.
-
-\subsubsection{Overview of Beamer's Font Management}
-
-\beamer's font mechanism is somewhat similar to \beamer's color mechanism, but not quite the same. As for colors, every \beamer\ element, like the frame titles, the document title, the footnotes, and so on has a certain \beamer-font. As for colors, on the one hand you can specify the font of each element individually; on the other hand fonts also use inheritance, thereby making it easy to globally change the fonts used for, say, titlelike things'' or for itemizelike things.''
-
-While a \beamer-color has a certain foreground and a certain background, either of which may be empty, a \beamer-font has a size, a shape, a series, and a family, each of which may be empty. The inheritance relation among \beamer-fonts is not necessarily the same as between \beamer-colors, though we have tried to match them whenever possible.
-
-Multiple inheritance plays a more important rule for fonts than it does for colors. A font might inherit the attributes of two different fonts. If one of them specifies that the font should be, say, boldface and the other specifies that the font should be, say, large, then the child font will be both large and bold.
-
-As for fonts, the description of the font used for an element is given after the description of the element.
-
-
-\subsubsection{Using Beamer's Fonts}
-
-To use a \beamer-font, you can use the command |\usebeamerfont|. Inside the templates for elements, this command will (typically) have already been called for you, so you will only seldomly have to use this command.
-
-\begin{command}{\usebeamerfont\opt{|*|}\marg{beamer-font name}}
-  This command changes the current font to the font specified by the \meta{beamer-font name}. The \meta{beamer-font name} can be a not-too-fancyful text and may contain spaces. Typical examples are |frametitle| or |section in toc| or |My Font 1|. \beamer-fonts can have (and should) have the same name as \beamer-templates and \beamer-colors.
-
-  \example |\usebeamerfont{frametitle}|
-  In the unstarred version of this command, the font is changed according to the attributes specified in the \meta{beamer-font name}, but unspecified attributes remain unchanged. For example, if the font specifies that the font should be bold,'' but specifies nothing else, and if the current font is large, then |\usebeamerfont| causes the current font to become large and bold.
-
-  In the starred version of this command, the font is first reset before the font's attributes are applied. Thus, in the above example of a \beamer-font having only the attribute boldface'' set, saying |\usebeamerfont*| will \emph{always} cause the current font to become a normal-size, normal-shape, bold, default-family font.
-\end{command}
-
-
-\subsubsection{Setting Beamer's Fonts}
-
-As for \beamer-colors, there exists a central command for setting and
-changing \beamer-fonts.
-
-\begin{command}{\setbeamerfont\opt{|*|}\marg{beamer-font name}\marg{attributes}}
-  This command sets or resets certain attributes of the \beamer-font \meta{beamer-font name}. In the unstarred version, this command just adds those attributes that have not been mentioned in a previous call and overwrites those that have been mentioned. Thus, the following two command blocks have the same effect:
-
-  \example
-\begin{verbatim}
-\setbeamerfont{frametitle}{size=\large}
-\setbeamerfont{frametitle}{series=\bfseries}
-
-\setbeamerfont{frametitle}{size=\large,series=\bfseries}
-\end{verbatim}
-
-  In the starred version, the font attributes are first completely reset, that is, set to be empty.
-
-  The following \meta{attributes} may be given:
-  \begin{itemize}
-  \item \declare{|size=|\meta{size command}} sets the size attribute of the \beamer\ font. The \meta{size command} should be a normal \LaTeX-command used for setting the font size or it should be empty. Useful commands include |\tiny|, |\scriptsize|, |\footnotesize|, |\small|, |\normalsize|, |\large|, |\Large|, |\huge|, and |\Huge|. \beamer\ also introduces the two font sizes |\Tiny| and |\TINY| for \emph{really} small text. But you should know \emph{exactly} what you are doing if you use them. You have been warned.
-
-    Note that there is a difference between specifying an empty command and specifying |\normalsize|: Making the size attribute empty'' means that the font size should not be changed when this font is used, while specifying |\normalsize| means that the size should be set to the normal size whenever this font is used.
-  \item \declare{|size*=|\marg{size in pt}\marg{baselineskip}} sets the size attribute of the font to the given \meta{size in pt} and the baseline skip to the given value. Note that, depending on what kind of font you use, not all font sizes may be available. Also, certain font sizes are much less desirable than other ones; the standard commands take care of choosing appropriate sizes for you. Do not use this option unless you have a good reason. This command has the same effect as |size={\fontsize|\marg{size in pt}\marg{baselineskip}|}|.
-  \item \declare{|shape=|\meta{shape command}} sets the shape attribute of the font. The command should be a command like |\itshape|, |\slshape|, |\scshape|, or |\upshape|.
-  \item \declare{|shape*=|\marg{shape attribute abbreviation}} sets the shape attribute of the font using the \LaTeX's abbreviations for attributes. This command has the same effect as |shape={\fontshape|\marg{shape attributes abbreviation}|}|.
-  \item \declare{|series=|\meta{series command}} sets the series'' attribute of the font. The command should be a command like |\bfseries|.
-  \item \declare{|series*=|\marg{series attribute abbreviation}} has the same effect as |series={\fontseries|\marg{series attributes abbreviation}|}|.
-  \item \declare{|family=|\meta{family command}} sets the font family attribute. The command should be a \LaTeX-font command like |\rmfamily| or |\sffamily|.
-  \item \declare{|family*=|\marg{family name}} sets the font family attribute to the given \meta{family name}. The command has the same effect as |family={\fontfamily|\marg{family name}|}|. The \meta{family name} is, normally, a somewhat cryptic abbreviation of a font family name that installed somewhere on the system. For example, the \meta{family name} for Times happens to be |ptm|. No one can remember these names, so it's perfectly normal if you have to look them up laboriously.
-  \item \declare{|parent=|\marg{parent list}} specifies a list of parent fonts. When the \beamer-font is used, the parents are used first. Thus, any font attributes set by one of the parents is inherited by the \beamer-font, except if this attribute is overwritten by the font.
-  \end{itemize}
-
-  \example
-\begin{verbatim}
-\setbeamerfont{parent A}{size=\large}
-\setbeamerfont{parent B}{series=\bfseries}
-\setbeamerfont{child}{parent={parent A, parent B},size=\small}
-
-\normalfont
-This text is in a normal font.
-\usebeamerfont{parent A}
-This text is large.
-\usebeamerfont{parent B}
-This text is large and bold.
-\usebeamerfont{parent B}
-This text is still large and bold.
-\usebeamerfont*{parent B}
-This text is only bold, but not large.
-\usebeamerfont{child}
-This text is small and bold.
-\end{verbatim}
-\end{command}

Deleted: trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-frames.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-frames.tex	2017-12-19 00:07:03 UTC (rev 46094)
+++ trunk/Master/texmf-dist/doc/latex/beamer/doc/beamerug-frames.tex	2017-12-19 00:09:01 UTC (rev 46095)
@@ -1,1162 +0,0 @@
-% Copyright 2003--2007 by Till Tantau
-% Copyright 2010 by Vedran Mileti\'c
-% Copyright 2013,2015 by Vedran Mileti\'c, Joseph Wright
-% Copyright 2016 by Joseph Wright
-%
-% This file may be distributed and/or modified
-%
-% 1. under the LaTeX Project Public License and/or
-% 2. under the GNU Free Documentation License.
-%
-
-\section{Creating Frames}
-\label{section-frames}
-
-
-\subsection{The Frame Environment}
-
-A presentation consists of a series of frames. Each frame consists of a series of slides. You create a frame using |frame| environment.\footnote{The command \texttt{\textbackslash frame} is supported for legacy documents.} All of the text that is not tagged by overlay specifications is shown on all slides of the frame. (Overlay specifications are explained in more detail in later sections. For the moment, let's just say that an overlay specification is a list of numbers or number ranges in pointed brackets that is put after certain commands as in |\uncover<1,2>{Text}|.) If a frame contains commands that have an overlay specification, the frame will contain multiple slides; otherwise it contains only one slide.
-
-\begin{environment}{{frame}\sarg{overlay specification}\opt{|[<|\meta{default overlay specification}|>]|}\oarg{options}\opt{\marg{title}\marg{subtitle}}}
-  The \meta{overlay specification} dictates which slides of a frame are to be shown. If left out, the number is calculated automatically. The \meta{environment contents} can be normal \LaTeX\ text, but may not contain |\verb| commands or |verbatim| environments or any environment that changes the character codes, unless the |fragile| option is given.
-
-  The optional \meta{title} is detected by an opening brace, that is, if the first thing in the frame is an opening brace then it is assumed that a frame title follows. Likewise, the optional \meta{subtitle} is detected the same way, that is, by an opening brace following the \meta{title}. The title and subtitle can also be given using the |\frametitle| and |\framesubtitle| commands.
-
-  The normal \LaTeX\ command |\frame| is available \emph{inside} frames with its usual meaning. Both outside and inside frames it is always available as {\color{red!75!black}|\framelatex|}.
-
-  \example
-\begin{verbatim}
-\begin{frame}{A title}
-  Some content.
-\end{frame}
-%% Same effect:
-\begin{frame}
-  \frametitle{A title}
-  Some content.
-\end{frame}
-\end{verbatim}
-
-  \example
-\begin{verbatim}
-\begin{frame}<beamer>{Outline}  % frame is only shown in beamer mode
-  \tabelofcontent[current]
-\end{frame}
-\end{verbatim}
-
-  Normally, the complete \meta{environment contents} is put on a slide. If the text does not fit on a slide, being too high, it will be squeezed as much as possible, a warning will be issued, and the text just extends unpleasantly over the bottom. You can use the option |allowframebreaks| to cause the \meta{frame text} to be split among several slides, though you cannot use overlays then. See the explanation of the |allowframebreaks| option for details.
-
-  The \meta{default overlay specification} is an optional argument that is detected'' according to the following rule: If the first optional argument in square brackets starts with a |<|, then this argument is a \meta{default overlay specification}, otherwise it is a normal \meta{options} argument. Thus |\begin{frame}[<+->][plain]| would be legal, but also |\begin{frame}[plain]|.
-
-  The effect of the \meta{default overlay specification} is the following: Every command or environment \emph{inside the frame} that accepts an action specification, see Section~\ref{section-action-specifications}, (this includes the |\item| command, the |actionenv| environment, |\action|, and all block environments) and that is not followed by an overlay specification gets the \meta{default overlay specification} as its specification. By providing an incremental specification like |<+->|, see Section~\ref{section-incremental}, this will essentially cause all blocks and all enumerations to be uncovered piece-wise (blocks internally employ action specifications).
-
-  \example
-  In this frame, the theorem is shown from the first slide on, the proof from the second slide on, with the first two itemize points shown one after the other; the last itemize point is shown together with the first one. In total, this frame will contain four slides.
-
-\begin{verbatim}
-\begin{frame}[<+->]
-  \begin{theorem}
-    $A = B$.
-  \end{theorem}
-  \begin{proof}
-    \begin{itemize}
-    \item Clearly, $A = C$.
-    \item As shown earlier,  $C = B$.
-    \item<3-> Thus $A = B$.
-    \end{itemize}
-  \end{proof}
-\end{frame}
-\end{verbatim}
-
-  The following \meta{options} may be given:
-  \begin{itemize}
-  \item
-    \declare{|allowdisplaybreaks|}\opt{|=|\meta{break desirability}} causes the AMS\TeX\ command |\allowdisplaybreaks|\penalty0|[|\meta{break desirability}|]| to be issued for the current frame. The \meta{break desirability} can be a value between 0 (meaning formulas may never be broken) and 4 (the default, meaning that formulas can be broken anywhere without any penalty). The option is just a convenience and makes sense only together with the |allowsframebreaks| option.
-  \item
-    \declare{|allowframebreaks|}\opt{|=|\meta{fraction}}. When this option is given, the frame will be automatically broken up into several frames if the text does not fit on a single slide. In detail, when this option is given, the following things happen:
-    \begin{enumerate}
-    \item
-      Overlays are not supported.
-    \item
-      Any notes for the frame created using the |\note| command will be inserted after the first page of the frame.
-    \item
-      Any footnotes for the frame will be inserted on the last page of the frame.
-    \item
-      If there is a frame title, each of the pages will have this frame title, with a special note added indicating which page of the frame that page is. By default, this special note is a Roman number. However, this can be changed using the following template.
-      \begin{element}{frametitle continuation}\yes\yes\yes
-        The text of this template is inserted at the end of every title of a frame with the |allowframebreaks| option set.
-        \begin{templateoptions}
-          \itemoption{default}{}
-          Installs a Roman number as the template. The number indicates the current page of the frame.
-
-          \itemoption{roman}{}
-          Alias for the default.
-
-          \itemoption{from second}{\oarg{text}}
-          Installs a template that inserts \meta{text} from the second page of a frame on. By default, the text inserted is |\insertcontinuationtext|,  which  in turn is |(cont.)| by default.
-        \end{templateoptions}
-        The following inserts are available:
-        \begin{templateinserts}
-          \iteminsert{\insertcontinuationcount}
-          inserts the current page of the frame as an arabic number.
-          \iteminsert{\insertcontinuationcountroman}
-          inserts the current page of the frame as an (uppercase) Roman number.
-          \iteminsert{\insertcontinuationtext}
-          just inserts the text |(cont.)| or, possibly, a translation thereof (like |(Forts.)| in German).
-        \end{templateinserts}
-      \end{element}
-    \end{enumerate}
-
-    If a frame needs to be broken into several pages, the material on all but the last page fills only 95\% of each page by default. Thus, there will be some space left at the top and/or bottom, depending on the vertical placement option for the frame. This yields a better visual result than a 100\% filling, which typically looks crowded. However, you can change this percentage using the optional argument \meta{fraction}, where 1 means 100\% and 0.5 means 50\%. This percentage includes the frame title. Thus, in order to split a frame roughly in half,'' you should give 0.6 as \meta{fraction}.
-
-    Most of the fine details of normal \TeX\ page breaking also apply to this option. For example, when you wish equations to be broken automatically, be sure to use the |\allowdisplaybreaks| command. You can insert |\break|, |\nobreak|, and |\penalty| commands to control where breaks should occur. The commands |\pagebreak| and |\nopagebreak| also work, including their options. Since you typically do not want page breaks for the frame to apply also to the |article| mode, you can add a mode specification like |<presentation>| to make these commands apply only to the presentation modes. The command \declare{|\string\framebreak|} is a shorthand for |\pagebreak<presentation>| and \declare{|\string\noframebreak|} is a shorthand for |\nopagebreak<presentation>|.
-
-    The use of this option is \emph{evil}. In a (good) presentation you prepare each slide carefully and think twice before putting something on a certain slide rather than on some different slide. Using the |allowframebreaks| option invites the creation of horrible, endless presentations that resemble more a paper projected on the wall'' than a presentation. Nevertheless, the option does have its uses. Most noticeably, it can be convenient for automatically splitting bibliographies or long equations.
-
-    \example
-\begin{verbatim}
-\begin{frame}[allowframebreaks]{References}
-  \begin{thebibliography}{XX}
-
-  \bibitem...
-  \bibitem...
-    ...
-  \bibitem...
-  \end{thebibliography}
-\end{frame}
-\end{verbatim}
-
-    \example
-\begin{verbatim}
-\begin{frame}[allowframebreaks,allowdisplaybreaks]{A Long Equation}
-  \begin{align}
-    \zeta(2) &= 1 + 1/4 + 1/9 + \cdots \\
-    &= ... \\
-    ...
-    &= \pi^2/6.
-  \end{align}
-\end{frame}
-\end{verbatim}
-
-  \item
-    \declare{|b|}, \declare{|c|}, \declare{|t|} will cause the frame to be vertically aligned at the bottom/center/top. This overrides the global placement policy, which is governed by the class options |t| and |c|.
-  \item
-    \declare{|fragile|\opt{|=singleslide|}} tells \beamer\ that the frame contents is fragile.'' This means that the frame contains text that is not interpreted as usual.'' For example, this applies to verbatim text, which is, obviously, interpreted somewhat differently from normal text.
-
-    If a frame contains fragile text, different internal mechanisms are used to typeset the frame to ensure that inside the frame the character codes can be reset. The price of switching to another internal mechanism is that either you cannot use overlays or an external file needs to be written and read back (which is not always desirable).
-
-    In detail, the following happens when this option is given for normal (pdf)\LaTeX: The contents of the frame is scanned and then written to a special file named \meta{jobname}|.vrb| or, if a label has been assigned to the frame, \meta{jobname}|.|\meta{current frame number}|.vrb|. Then, the frame is started anew and the content of this file is read back. Since, upon reading of a file, the character codes can be modified, this allows you to use both verbatim text and overlays.
-
-    To determine the end of the frame, the following rule is used: The first occurrence of a single line containing exactly |\end{|\meta{frame environment name}|}| ends the frame. The \meta{environment name} is normally |frame|, but it can be changed using the |environment| option. This special rule is needed since the frame contents is, after all, not interpreted when it is gathered.
-
-    You can also add the optional information |=singleslide|. This tells \beamer\ that the frame contains only a single slide. In this case, the frame contents is \emph{not} written to a special file, but interpreted directly, which is faster and cleaner.''
-  \item
-    \declare{|environment=|\meta{frame environment name}}. This option is useful only in conjunction with the |fragile| option (but it is not used for |fragile=singleslide|, only for the plain |fragile|). The \meta{frame environment name} is used to determine the end of the scanning when gathering the frame contents. Normally, the frame ends when a line reading |\end{frame}| is reached. However, if you use |\begin{frame}| inside another environment, you need to use this option:
-
-    \example
-\begin{verbatim}
-\newenvironment{slide}[1]
-  {\begin{frame}[fragile,environment=slide]
-      \frametitle{#1}}
-  {\end{frame}}
-
-\begin{slide}{My title}
-  Text.
-\end{slide}
-\end{verbatim}
-
-    If you did not specify the option |environment=slide| in the above example, \TeX\ would miss'' the end of the slide since it does not interpret text while gathering the frame contents.
-  \item
-    \declare{|label=|\meta{name}} causes the frame's contents to be stored under the name \meta{name} for later resumption using the command |\againframe|. Furthermore, on each slide of the frame a label with the name \meta{name}|<|\meta{slide number}|>| is created. On the \emph{first} slide, furthermore, a label with the name \meta{name} is created (so the labels \meta{name} and \meta{name}|<1>| point to the same slide). Note that labels in general, and these labels in particular, can be used as targets for hyperlinks.
-
-    You can use this option together with |fragile|.
-  \item
-    \declare{|plain|} causes the headlines, footlines, and sidebars to be suppressed. This is useful for creating single frames with different head- and footlines or for creating frames showing big pictures that completely fill the frame.
-
-    \example
-    A frame with a picture completely filling the frame:
-
-\begin{verbatim}
-\begin{frame}[plain]
-  \begin{centering}%
-    \pgfimage[height=\paperheight]{somebigimagefile}%
-    \par%
-  \end{centering}%
-\end{frame}
-\end{verbatim}
-
-    \example
-    A title page, in which the head- and footlines are replaced by two graphics.
-
-\begin{verbatim}
-\setbeamertemplate{title page}
-{
-  \pgfuseimage{toptitle}
-  \vskip0pt plus 1filll
-
-  \begin{centering}
-    {\usebeamerfont{title}\usebeamercolor[fg]{title}\inserttitle}
-
-    \insertdate
-  \end{centering}
-
-  \vskip0pt plus 1filll
-  \pgfuseimage{bottomtitle}
-}
-\begin{frame}[plain]
-  \titlepage
-\end{frame}
-\end{verbatim}
-
-  \item
-    \declare{|shrink|}\opt{|=|\meta{minimum shrink percentage}}. This option will cause the text of the frame to be shrunk if it is too large to fit on the frame. \beamer\ will first normally typeset the whole frame. Then it has a look at vertical size of the frame text (excluding the frame title). If this vertical size is larger than the text height minus the frame title height, \beamer\ computes a shrink factor and scales down the frame text by this factor such that the frame text then fills the frame completely. Using this option will automatically cause the |squeeze| option to be used, also.
-
-    Since the shrinking takes place only after everything has been typeset, shrunk frame text will not fill the frame completely horizontally. For this reason, you can specify a \meta{minimum shrink percentage} like |20|. If this percentage is specified, the frame will be shrunk \emph{at least} by this percentage. Since \beamer\ knows this, it can increase the horizontal width proportionally such that the shrunk text once more fills the entire frame. If, however, the percentage is not enough, the text will be shrunk as needed and you will be punished with a warning message.
-
-    The best way to use this option is to identify frames that are overly full, but in which all text absolutely has to be fit on a single frame. Then start specifying first |shrink=5|, then |shrink=10|, and so on, until no warning is issued any more (or just ignore the warning when things look satisfactory).
-
-    Using this option is \emph{very evil}. It will result in changes of the font size from slide to slide, which is a typographic nightmare. Its usage can \emph{always} be avoided by restructuring and simplifying frames, which will result in a better presentation.
-
-    \example
-\begin{verbatim}
-\begin{frame}[shrink=5]
-  Some evil endless slide that is 5\% too large.
-\end{frame}
-\end{verbatim}
-
-  \item
-    \declare{|squeeze|} causes all vertical spaces in the text to be squeezed together as much as possible. Currently, this just causes the vertical space in enumerations or itemizations to be reduced to zero.
-
-    Using this option is not good, but also not evil.
-  \end{itemize}
-
-  \articlenote
-  In |article| mode, the |frame| environment does not create any visual reference to the original frame (no frame is drawn). Rather, the frame text is inserted into the normal text. To change this, you can modify the templates |frame begin| and |frame end|, see below. To suppress a frame in |article| mode, you can, for example, specify |<presentation>| as overlay specification.
-
-  \begin{element}{frame begin}\yes\no\no
-    The text of this template is inserted at the beginning of each frame in |article| mode (and only there). You can use it, say, to start a |minipage| environment at the beginning of a frame or to insert a horizontal bar or whatever.
-  \end{element}
-
-  \begin{element}{frame end}\yes\no\no
-    The text of this template is inserted at the end of each frame in |article| mode.
-  \end{element}
-\end{environment}
-
-You \emph{can} use the |frame| environment inside other environments like this
-
-\begin{verbatim}
-\newenvironment{slide}{\begin{frame}}{\end{frame}}
-\end{verbatim}
-
-or like this
-
-\begin{verbatim}
-\newenvironment{myframe}[1]
-  {\begin{frame}[fragile,environment=myframe]\frametitle{#1}}
-  {\end{frame}}
-\end{verbatim}
-
-However, the actual mechanics are somewhat sensitive since the collecting'' of the frame contents is not easy, so do not attempt anything too fancy. As a rule, the beginning of the environment can be pretty arbitrary, but the ending must end with |\end{frame}| and should not contain any |\end{xxx}|. Anything really complex is likely to fail. If you need some |\end{xxx}| there, define a new command that contains this stuff as in the following example:
-
-\begin{verbatim}
-\newenvironment{itemizeframe}
-  {\begin{frame}\startitemizeframe}
-  {\stopitemizeframe\end{frame}}
-
-\newcommand\startitemizeframe{\begin{bfseries}\begin{itemize}}
-\newcommand\stopitemizeframe{\end{itemize}\end{bfseries}}
-
-\begin{itemizeframe}
-\item First item
-\end{itemizeframe}
-\end{verbatim}
-
-
-\subsection{Components of a Frame}
-
-Each frame consists of several components:
-\begin{enumerate}\itemsep=0pt\parskip=0pt
-\item a headline and a footline,
-\item a left and a right sidebar,
-\item a logo,
-\item a frame title,
-\item a background, and
-\item some frame contents.
-\end{enumerate}
-
-A frame need not have all of these components. Usually, the first three components are automatically setup by the theme you are using.
-
-
-The headline of a frame is the area at the top of the frame. If it is not empty, it should show some information that helps the audience orientate itself during your talk. Likewise, the footline is the area at the bottom of the frame.
-
-\beamer\ does not use the standard \LaTeX\ mechanisms for typesetting the headline and the footline. Instead, the special |headline| and |footline| templates are used to typeset them.
-
-The size of the headline and the footline is determined as follows: Their width is always the paper width. Their height is determined by tentatively typesetting the headline and the footline right after the |\begin{document}| command. The head of the headline and the footline at that point is frozen'' and will be used throughout the whole document, even if the headline and footline vary in height later on (which they should not).
-
-The appearance of the headline and footline is determined by the following templates:
-
-  This template is used to typeset the headline. The \beamer-color and -font |headline| are installed at the beginning. The background of the \beamer-color is not used by default, that is, no background rectangle is drawn behind the headline and footline (this may change in the future with the introduction of a headline and a footline canvas).
-
-  The width of the headline is the whole paper width. The height is determined automatically as described above. The headline is typeset in vertical mode with interline skip turned off and the paragraph skip set to zero.
-
-  Inside this template, the |\\| command is changed such that it inserts a comma instead.
-
-  \example
-\begin{verbatim}
-{%
-  \end{beamercolorbox}%
-}
-\end{verbatim}
-
-  \begin{templateoptions}
-    \itemoption{default}{}
-    The default is just an empty headline. To get the default headline of earlier versions of the \beamer\ class, use the |compatibility| theme.
-    \itemoption{infolines theme}{}
-    This option becomes available (and is used) if the |infolines| outer theme is loaded. The headline shows current section and subsection.
-    \itemoption{miniframes theme}{}
-    This option becomes available (and is used) if the |miniframes| outer theme is loaded. The headline shows the sections with small clickable mini frames below them.
-    \itemoption{sidebar theme}{}
-    This option becomes available (and is used) if the |sidebar| outer theme is loaded and if the head height (and option of the |sidebar| theme) is not zero. In this case, the headline is an empty bar of the background color |frametitle| with the logo to the left or right of this bar.
-    \itemoption{smoothtree theme}{}
-    This option becomes available (and is used) if the |smoothtree| outer theme is loaded. A smoothed'' navigation tree is shown in the headline.
-    \itemoption{smoothbars theme}{}
-    This option becomes available (and is used) if the |smoothbars| outer theme is loaded. A smoothed'' version of the |miniframes| headline is shown.
-    \itemoption{tree}{}
-    This option becomes available (and is used) if the |tree| outer theme is loaded. A navigational tree is shown in the headline.
-    \itemoption{split theme}{}
-    This option becomes available (and is used) if the |split| outer theme is loaded. The headline is split into a left part showing the sections and a right part showing the subsections.
-    \itemoption{text line}{\marg{text}}
-    The headline is typeset more or less as if it were a normal text line with the \meta{text} as contents. The left and right margin are setup such that they are the same as the margins of normal text. The \meta{text} is typeset inside an |\hbox|, while the headline is normally typeset in vertical mode.
-  \end{templateoptions}
-
-  Inside the template numerous inserts can be used:
-  \begin{itemize}
-    Inserts a horizontal navigation bar of the given \meta{width} into a template. The bar lists the sections and below them mini frames for each frame in that section.
-
-    \iteminsert{\insertpagenumber}
-    Inserts the current page number into a template.
-
-    \iteminsert{\insertsection}
-    Inserts the current section into a template.
-
-    Inserts a vertical navigation bar containing all sections, with the current section highlighted.
-
-    Inserts a horizontal navigation bar containing all sections, with the current section highlighted. The \meta{left insert} will be inserted to the left of the sections, the \marg{right insert} to the right. By inserting a triple fill (a |filll|) you can flush the bar to the left or right.
-    \example
-\begin{verbatim}
-\end{verbatim}
-
-    \iteminsert{\insertshortauthor}\oarg{options}
-    Inserts the short version of the author into a template. The text will be printed in one long line, line breaks introduced using the |\\| command are suppressed. The following \meta{options} may be given:
-    \begin{itemize}
-      \item
-      \declare{|width=|\meta{width}}
-      causes the text to be put into a multi-line minipage of the given size. Line breaks are still suppressed by default.
-      \item
-      \declare{|center|}
-      centers the text inside the minipage created using the |width| option, rather than having it left aligned.
-      \item
-      \declare{|respectlinebreaks|}
-      causes line breaks introduced by the |\\| command to be honored.
-    \end{itemize}
-
-    \example
-    |\insertauthor[width={3cm},center,respectlinebreaks]|
-
-    \iteminsert{\insertshortdate}\oarg{options}
-    Inserts the short version of the date into a template. The same options as for |\insertshortauthor| may be given.
-
-    \iteminsert{\insertshortinstitute}\oarg{options}
-    Inserts the short version of the institute into a template. The same options as for |\insertshortauthor| may be given.
-
-    \iteminsert{\insertshortpart}\oarg{options}
-    Inserts the short version of the part name into a template. The same options as for |\insertshortauthor| may be given.
-
-    \iteminsert{\insertshorttitle}\oarg{options}
-    Inserts the short version of the document title into a template. Same options as for |\insertshortauthor| may be given.
-
-    \iteminsert{\insertshortsubtitle}\oarg{options}
-    Inserts the short version of the document subtitle. Same options as for |\insertshortauthor| may be given.
-
-    \iteminsert{\insertsubsection}
-    Inserts the current subsection into a template.
-
-    \iteminsert{\insertsubsubsection}
-    Inserts the current subsection into a template.
-
-    Inserts a vertical navigation bar containing all subsections of the current section, with the current subsection highlighted.
-
-
-    Inserts a vertical navigation bar of the given \meta{width} into a template. The bar shows a little table of contents. The individual lines are typeset using the templates |section in head/foot| and |subsection in head/foot|.
-
-    Inserts the number of the current frame (not slide) into a template.
-
-    \iteminsert{\insertslidenumber}
-    Inserts the number of the current slide in frame into a template.
-
-    \iteminsert{\insertoverlaynumber}
-    Inserts the number of current overlay counter into a template. This is generally equal to |\insertslidenumber|, except when an overlay specification is used in a |frame| environment.
-
-    Inserts the total number of the frames (not slides) into a template. The number is only correct on the second run of \TeX\ on your document.
-
-    \iteminsert{\insertframestartpage}
-    Inserts the page number of the first page of the current frame.
-
-    \iteminsert{\insertframeendpage}
-    Inserts the page number of the last page of the current frame.
-
-    \iteminsert{\insertsubsectionstartpage}
-    Inserts the page number of the first page of the current subsection.
-
-    \iteminsert{\insertsubsectionendpage}
-    Inserts the page number of the last page of the current subsection.
-
-    \iteminsert{\insertsectionstartpage}
-    Inserts the page number of the first page of the current section.
-
-    \iteminsert{\insertsectionendpage}
-    Inserts the page number of the last page of the current section.
-
-    \iteminsert{\insertpartstartpage}
-    Inserts the page number of the first page of the current part.
-
-    \iteminsert{\insertpartendpage}
-    Inserts the page number of the last page of the current part.
-
-    \iteminsert{\insertpresentationstartpage}
-    Inserts the page number of the first page of the presentation.
-
-    \iteminsert{\insertpresentationendpage}
-    Inserts the page number of the last page of the presentation (excluding the appendix).
-
-    \iteminsert{\insertappendixstartpage}
-    Inserts the page number of the first page of the appendix. If there is no appendix, this number is the last page of the document.
-
-    \iteminsert{\insertappendixendpage}
-    Inserts the page number of the last page of the appendix. If there is no appendix, this number is the last page of the document.
-
-    \iteminsert{\insertdocumentstartpage}
-    Inserts 1.
-
-    \iteminsert{\insertdocumentendpage}
-    Inserts the page number of the last page of the document (including the appendix).
-  \end{itemize}
-\end{element}
-
-\begin{element}{footline}\yes\yes\yes
-  This template behaves exactly the same way as the headline. Note that, sometimes quite annoyingly, \beamer\ currently adds a space of 4pt between the bottom of the frame's text and the top of the footline.
-
-  \begin{templateoptions}
-    \itemoption{default}{}
-    The default is an empty footline. Note that the navigational symbols are \emph{not} part of the footline by default. Rather, they are part of an (invisible) right sidebar.
-    \itemoption{infolines theme}{}
-    This option becomes available (and is used) if the |infolines| outer theme is loaded. The footline shows things like the author's name and the title of the talk.
-    \itemoption{miniframes theme}{}
-    This option becomes available (and is used) if the |miniframes| outer theme is loaded. Depending on the exact options that are used when the |miniframes| theme is loaded, different things can be shown in the footline.
-    \itemoption{page number}{}
-    Shows the current page number in the footline.
-    \itemoption{frame number}{}
-    Shows the current frame number in the footline.
-    \itemoption{split}{}
-    This option becomes available (and is used) if the |split| outer theme is loaded. The footline (just like the headline) is split into a left part showing the author's name and a right part showing the talk's title.
-    \itemoption{text line}{\marg{text}}
-    The footline is typeset more or less as if it were a normal text line with the \meta{text} as contents. The left and right margin are setup such that they are the same as the margins of normal text. The \meta{text} is typeset inside an |\hbox|, while the headline is normally typeset in vertical mode. Using the |\strut| command somewhere in such a line might be a good idea.
-  \end{templateoptions}
-
-  The same inserts as for headlines can be used.
-
-    These \beamer-color and -font are used to typeset the page number or frame number in the footline.
-  \end{element}
-\end{element}
-
-\subsubsection{The Sidebars}
-
-Sidebars are vertical areas that stretch from the lower end of the headline to the top of the footline. There can be a sidebar at the left and another one at the right (or even both). Sidebars can show a table of contents, but they could also be added for purely aesthetic reasons.
-
-When you install a sidebar template, you must explicitly specify the horizontal size of the sidebar using the command |\setbeamersize| with the option |sidebar width left| or |sidebar width right|. The vertical size is determined automatically. Each sidebar has its own background canvas, which can be setup using the sidebar canvas templates.
-
-Adding a sidebar of a certain size, say 1\,cm, will make the main text 1\,cm narrower. The distance between the inner side of a side bar and the outer side of the text, as specified by the command |\setbeamersize| with the option |text margin left| and its counterpart for the right margin, is not changed when a sidebar is installed.
-
-Internally, the sidebars are typeset by showing them as part of the headline. The \beamer\ class keeps track of six dimensions, three for each side: the variables |\beamer at leftsidebar| and |\beamer at rightsidebar| store the (horizontal) sizes of the side bars, the variables |\beamer at leftmargin| and |\beamer at rightmargin| store the distance between sidebar and text, and the macros |\Gm at lmargin| and |\Gm at rmargin| store the distance from the edge of the paper to the edge of the text. Thus the sum |\beamer at leftsidebar| and |\beamer at leftmargin| is exactly |\Gm at lmargin|. Thus, if you wish to put some text right next to the left sidebar, you might write |\hskip-\beamer at leftmargin| to get there.
-
-\begin{element}{sidebar left}\yes\yes\yes
-  \colorfontparents{sidebar}
-  The template is used to typeset the left sidebar. As mentioned above, the size of the left sidebar is set using the command
-
-\begin{verbatim}
-\setbeamersize{sidebar width left=2cm}
-\end{verbatim}
-
-  \beamer\ will not clip sidebars automatically if they are too large.
-
-  When the sidebar is typeset, it is put inside a |\vbox|. You should currently setup things like the |\hsize| or the |\parskip| yourself.
-
-  \begin{templateoptions}
-    \itemoption{default}{}
-    installs an empty template.
-    \itemoption{sidebar theme}{}
-    This option is available if the outer theme |sidebar| is loaded with the |left| option. In this case, this options is selected automatically. It shows a mini table of contents in the sidebar.
-  \end{templateoptions}
-\end{element}
-
-\begin{element}{sidebar right}\yes\yes\yes
-  \colorfontparents{sidebar}
-  This template works the same way as the template for the left.
-
-  \begin{templateoptions}
-    \itemoption{default}{}
-    The default right sidebar has zero width. Nevertheless, it shows navigational symbols and, if installed, a logo at the bottom of the sidebar, protruding to the left into the text.
-    \itemoption{sidebar theme}{}
-    This option is available, if the outer theme |sidebar| is loaded with the |right| option. In this case, this option is selected automatically. It shows a mini table of contents in the sidebar. % FIXME: unsure
-  \end{templateoptions}
-\end{element}
-
-\begin{element}{sidebar canvas left}\yes\no\no
-  Like the overall background canvas, this canvas is drawn behind the actual text of the sidebar. This template should normally insert a rectangle of the size of the sidebar, though a too large height will not lead to an error or warning. When this template is called, the \beamer-color |sidebar left| will have been installed.
-
-  \begin{templateoptions}
-    \itemoption{default}{}
-    uses a large rectangle colored with |sidebar.bg| as the sidebar canvas. However, if the background of |sidebar| is empty, nothing is drawn and the canvas is transparent.''
-
-      \declare{|midpoint=|\meta{factor}} specifies at which point of the page the middle color is used. A factor of |0| is the bottom of the page, a factor of |1| is the top. The default,