beamer (21jan22)

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

11 files changed, 160 insertions, 35 deletions

diff --git a/Master/texmf-dist/doc/latex/beamer/CHANGELOG.md b/Master/texmf-dist/doc/latex/beamer/CHANGELOG.md
index 35d499eb0b0..cc44d05103a 100644
--- a/Master/texmf-dist/doc/latex/beamer/CHANGELOG.md
+++ b/Master/texmf-dist/doc/latex/beamer/CHANGELOG.md
@@ -8,6 +8,27 @@ a major and minor version only.
 
 ## [Unreleased]
 
+## [v3.65]
+
+### Added
+
+- adding new `onlytextwidth` class option to use this key for all `columns` environments by default (see #731)
+- adding new stretchable frame option `s` (see #696)
+- adding user-accessible commands for `\beamersidebarwidth` and `\beamerheadheight` (see #537)
+- allow custom values for `aspectratio` option (see #549)
+
+### Fixed
+
+- using `gray` colormodel for the delcarartion of fadings (workaround for #718)
+- fixed bullet colour of alerted items for custom item colour (see #735)
+- workaround to make miniframes clickable in xelatex (see #332)
+- added missing encoding value to multimedia sound macro (see #607)
+- imporoved problem with shadow of blocks without title (see #647)
+- reduced artefacts in poppler based viewers for shadow blocks (see #647)
+- workaround to make `\framezoom` clickable in xelatex (see #619)
+- exclude invisible frames from being counted (see #592)
+- fixed cut off miniframes for 8pt and 9pt (see #752)
+
 ## [v3.64]
 
 ### Added
@@ -165,7 +186,8 @@ a major and minor version only.
 - Support for `noxcolor` with `beamerarticle` (see #483)
 - Treatment of mixed overlay/alert specifications
 
-[Unreleased]: https://github.com/josephwright/beamer/compare/v3.64...HEAD
+[Unreleased]: https://github.com/josephwright/beamer/compare/v3.65...HEAD
+[v3.65]: https://github.com/josephwright/beamer/compare/v3.64...v3.65
 [v3.64]: https://github.com/josephwright/beamer/compare/v3.63...v3.64
 [v3.63]: https://github.com/josephwright/beamer/compare/v3.62...v3.63
 [v3.62]: https://github.com/josephwright/beamer/compare/v3.61...v3.62
diff --git a/Master/texmf-dist/doc/latex/beamer/beamerexample-conference-talk.pdf b/Master/texmf-dist/doc/latex/beamer/beamerexample-conference-talk.pdf
index 09da4c74c6a..18854724fbf 100644
--- a/Master/texmf-dist/doc/latex/beamer/beamerexample-conference-talk.pdf
+++ b/Master/texmf-dist/doc/latex/beamer/beamerexample-conference-talk.pdf
diff --git a/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-beamer-version.pdf b/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-beamer-version.pdf
index 95425d5d642..944799cbdd0 100644
--- a/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-beamer-version.pdf
+++ b/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-beamer-version.pdf
diff --git a/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-print-version.pdf b/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-print-version.pdf
index caadeb41cc2..49ed6ecdff1 100644
--- a/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-print-version.pdf
+++ b/Master/texmf-dist/doc/latex/beamer/beamerexample-lecture-print-version.pdf
diff --git a/Master/texmf-dist/doc/latex/beamer/beamerug-frames.tex b/Master/texmf-dist/doc/latex/beamer/beamerug-frames.tex
index de4449ad7da..60848464323 100644
--- a/Master/texmf-dist/doc/latex/beamer/beamerug-frames.tex
+++ b/Master/texmf-dist/doc/latex/beamer/beamerug-frames.tex
@@ -146,6 +146,8 @@ A presentation consists of a series of frames. Each frame consists of a series o
   \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{|s|} will cause the content of the frame to be distributed vertically across the whole frame. For a reasonable usage of the option, the user has to add ``stretchable'' material to the frame content, e.g. |\vfill| or similar macros.
+  \item
     \declare{|noframenumbering|} tells \beamer\ not to step the |framenumber| counter for this frame.
   \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.
@@ -293,7 +295,99 @@ Each frame consists of several components:
 \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.
+A frame need not have all of these components. Usually, the first three components are automatically setup by the theme you are using. 
+Figure \ref{fig:framelayers} shows an overview of the order in which the different components are drawn.
+
+\begin{figure}[htbp]
+% the following code is based on https://gist.githubusercontent.com/loopspace/c37dd788b217f2e963587278c3532f73/raw/f6e4708f36f661193ea7aed3cba7d389226658cc/beamerframe.tex
+\begin{tikzpicture}[z={(0.97,0)},x={(.55,.4)}]
+
+% colour palette generated by mycolor.space to match beamer's beamer@blendedblue
+\definecolor{fc_col1}{HTML}{3333b3}
+\definecolor{fc_col2}{HTML}{b1a3d9}
+\definecolor{fc_col3}{HTML}{fffade}
+\definecolor{fc_col4}{HTML}{68baa5}
+\definecolor{fc_col5}{HTML}{ae0000}
+
+\colorlet{base}{fc_col3}
+\colorlet{background canvas}{base}
+\colorlet{logo bg}{fc_col1}
+\colorlet{sidebar left}{fc_col4}
+\colorlet{sidebar right}{fc_col4}
+\colorlet{section in sidebar}{fc_col5}
+\colorlet{logo fg}{white}
+\colorlet{footline}{fc_col2}
+\colorlet{navigation symbols}{fc_col1}
+
+\pgfmathsetmacro{\bepgw}{12.8}
+\pgfmathsetmacro{\bepgh}{9.6}
+\newcommand{\component}[3][1]{%
+\path (#2) [draw,<-,thick] -- (#2 |- 0,-\bepgh-#1,0) node[below,text width=2cm,align=center] (#3) {#3};
+\stepcounter{zlayer}}
+\newcounter{zlayer}
+\setcounter{zlayer}{0}
+\def\zlayer{\the\value{zlayer}}
+
+\foreach \z in {0,...,10} {
+  \draw[gray,ultra thick] (0,-\bepgh,\z) -- (\bepgw,-\bepgh,\z) -- (\bepgw,0,\z);
+}
+
+% background canvas
+\fill[background canvas] (0,0,\zlayer) -- ++(\bepgw,0,0) -- ++(0,-\bepgh,0) -- ++(-\bepgw,0,0) -- cycle;
+\component[1]{1,-\bepgh,\zlayer}{background canvas}
+
+% background
+\draw[gray] \foreach \x in {0,...,\bepgw} \foreach \y in {0,...,\bepgh} {(\x,0,\zlayer) -- (\x,-\bepgh,\zlayer) (0,-\y,\zlayer) -- (\bepgw,-\y,\zlayer)};
+\component[2]{1,-\bepgh,\zlayer}{background}
+
+% left sidebar
+\fill[sidebar left] (0,0,\zlayer) -- ++(2,0,0) -- ++(0,-\bepgh,0) -- ++(-2,0,0) -- cycle;
+\component[3]{1,-\bepgh,\zlayer}{sidebar canvas left}
+
+% section in sidebar
+\node[yslant=.7,right,align=left,text=section in sidebar,font=\sffamily] at (0,-.45*\bepgh,\zlayer) (a section in sidebar) {First slide \\ Second slide \\ Third slide};
+\component[1]{1,-\bepgh,\zlayer}{section in sidebar}
+
+% right sidebar
+\fill[sidebar right] (\bepgw,0,\zlayer) -- ++(-2,0,0) -- ++(0,-\bepgh,0) -- ++(2,0,0) -- cycle;
+\component[2]{1,-\bepgh,\zlayer}{sidebar canvas right}
+
+% section in right sidebar
+\node[yslant=.7,left,align=right,text=section in sidebar,font=\sffamily] at (\bepgw,-.45*\bepgh,\zlayer) (a section in right sidebar) {First slide \\ Second slide \\ Third slide};
+\component[3]{1,-\bepgh,\zlayer}{section in right sidebar}
+
+%navigation
+\node[yslant=.7,above left,align=right,text=navigation symbols,font=\sffamily] at (\bepgw,-\bepgh,\zlayer) (navigation) {Navigation symbols};
+\component[1]{1,-\bepgh,\zlayer}{navigation symbols}
+
+% logo
+\fill[logo bg] (0,0,\zlayer) -- ++(2,0,0) -- ++(0,-2,0) -- ++(-2,0,0) -- cycle;
+\node[yslant=.7,text=logo fg,align=right,font=\sffamily] at (1,-1,\zlayer) {your\\ logo\\ here};
+\component[2]{1,-\bepgh,\zlayer}{logo}
+
+% headline
+\fill[footline] (0,0,\zlayer) -- ++(\bepgw,0,0) -- ++(0,-1,0) -- ++(-\bepgw,0,0) -- cycle;
+\node[yslant=.7,text=logo fg,align=left,font=\sffamily] at (1.5,-0.5,\zlayer) {Headline};
+\component[3]{1,-\bepgh,\zlayer}{headline}
+
+% content
+\node[yslant=.7,left,align=left,text=black,font=\sffamily] at (3,-.45*\bepgh,\zlayer) (a section in right sidebar) {Content};
+\component[1]{1,-\bepgh,\zlayer}{frame content}
+
+% footline
+\fill[footline] (0,-\bepgh,\zlayer) -- ++(\bepgw,0,0) -- ++(0,.5,0) -- ++(-\bepgw,0,0) -- cycle;
+\component[2]{1,-\bepgh,\zlayer}{footline}
+
+\addtocounter{zlayer}{-1}
+
+\foreach \z in {0,...,\zlayer} {
+  \draw[gray,ultra thick] (0,-\bepgh,\z) -- (0,0,\z) -- (\bepgw,0,\z);
+}
+
+\end{tikzpicture}
+\caption{Diagram of the order in which the different frame components are drawn (Image originally created by \href{https://tex.stackexchange.com/a/27302}{Andrew Stacey})}
+\label{fig:framelayers}
+\end{figure}
 
 \subsubsection{The Headline and Footline}
 
@@ -530,6 +624,8 @@ Adding a sidebar of a certain size, say 1\,cm, will make the main text 1\,cm nar
 
 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@leftsidebar| and |\beamer@rightsidebar| store the (horizontal) sizes of the side bars, the variables |\beamer@leftmargin| and |\beamer@rightmargin| store the distance between sidebar and text, and the macros |\Gm@lmargin| and |\Gm@rmargin| store the distance from the edge of the paper to the edge of the text. Thus the sum |\beamer@leftsidebar| and |\beamer@leftmargin| is exactly |\Gm@lmargin|. Thus, if you wish to put some text right next to the left sidebar, you might write |\hskip-\beamer@leftmargin| to get there.
 
+For convenience, the width of the sidebar and the height of its headline are accessible through the macros |\beamersidebarwidth| and |\beamerheadheight|, respectively. 
+
 \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
@@ -1152,6 +1248,17 @@ To change ``paper size'' and aspect ratio, you can use the following class optio
   Sets aspect ratio to 3:2, and frame size to 135\,mm by 90\,mm.
 \end{classoption}
 
+\begin{classoption}{aspectratio=xxxx}
+  Allows the user to set their own aspect ratio. For the height of the resulting frame, the default value of 96\,mm is used and the width will be calculated accordingly to match the desired aspect ratio.
+  
+  The custom aspect ratio allows for two to four digits and will be interpreted as shown in the following examples:
+  \begin{itemize}
+    \item two digits: |aspectratio=42| as 4:2
+    \item three digits: |aspectratio=137| as 13:7 (e.g. always in landscape format)
+    \item four digits: |aspectratio=1024| as 10:24
+  \end{itemize} 
+\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 1\,cm. To change them, you should use the following command:
 
 \begin{command}{\setbeamersize\marg{options}}
@@ -1197,3 +1304,5 @@ You can also specify the number of slides in the frame ``by hand.'' To do so, yo
 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.
+
+Frames which are hidden with |<0>| behave like the |noframenumbering| option and will not be counted for the number of frames (this only applies if no mode is specified, e.g. not for |<all:0>|). 
diff --git a/Master/texmf-dist/doc/latex/beamer/beamerug-localstructure.tex b/Master/texmf-dist/doc/latex/beamer/beamerug-localstructure.tex
index 845ecda4dac..1f58012eac0 100644
--- a/Master/texmf-dist/doc/latex/beamer/beamerug-localstructure.tex
+++ b/Master/texmf-dist/doc/latex/beamer/beamerug-localstructure.tex
@@ -948,7 +948,9 @@ The main environment for creating columns is called |columns|. Inside this envir
   \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|.
+    \declare{|onlytextwidth|} is the same as |totalwidth=\textwidth|. This option can also be set for the whole document with the |onlytextwidth| class option:
+    \begin{classoption}{onlytextwidth}
+    \end{classoption}
   \item
     \declare{|t|} will cause the first lines of the columns to be aligned. Default if global option |t| is used.
   \item
diff --git a/Master/texmf-dist/doc/latex/beamer/beamerug-nonpresentation.tex b/Master/texmf-dist/doc/latex/beamer/beamerug-nonpresentation.tex
index 728741b3174..eb9a23170dc 100644
--- a/Master/texmf-dist/doc/latex/beamer/beamerug-nonpresentation.tex
+++ b/Master/texmf-dist/doc/latex/beamer/beamerug-nonpresentation.tex
@@ -271,35 +271,20 @@ In addition to these modes, \beamer\ recognizes the following names for modes se
 \end{itemize}
 
 \begin{center}
-	\begin{pgfpicture}
-	  \pgftransformshift{\pgfpoint{0cm}{0cm}}
-	  \pgfnode{rectangle}{center}{|all|}{allnode}{}
-	  \pgftransformshift{\pgfpoint{-2cm}{-1.25cm}}
-	  \pgfnode{rectangle}{center}{|presentation|}{presentationnode}{}
-	  \pgftransformshift{\pgfpoint{4cm}{0cm}}
-	  \pgfnode{rectangle}{center}{|article|}{articlenode}{}
-	  \pgftransformshift{\pgfpoint{-7cm}{-1.5cm}}
-	  \pgfnode{rectangle}{center}{|beamer|}{beamernode}{}    
-	  \pgftransformshift{\pgfpoint{2cm}{0cm}}
-	  \pgfnode{rectangle}{center}{|second|}{secondnode}{}
-	  \pgftransformshift{\pgfpoint{2cm}{0cm}}        
-	  \pgfnode{rectangle}{center}{|handout|}{handoutnode}{}
-	  \pgftransformshift{\pgfpoint{2cm}{0cm}}
-	  \pgfnode{rectangle}{center}{|trans|}{transnode}{}
-	  \pgfpathmoveto{\pgfpointanchor{allnode}{south west}}
-	  \pgfpathlineto{\pgfpointanchor{presentationnode}{north}}
-	  \pgfpathmoveto{\pgfpointanchor{allnode}{south east}}
-	  \pgfpathlineto{\pgfpointanchor{articlenode}{north}}    
-	  \pgfpathmoveto{\pgfpointanchor{presentationnode}{south west}}
-	  \pgfpathlineto{\pgfpointanchor{beamernode}{north}}
-	  \pgfpathmoveto{\pgfpointadd{\pgfpointanchor{presentationnode}{south}}{\pgfpoint{-0.3cm}{0cm}}}
-	  \pgfpathlineto{\pgfpointanchor{secondnode}{north}}
-	  \pgfpathmoveto{\pgfpointadd{\pgfpointanchor{presentationnode}{south}}{\pgfpoint{0.3cm}{0cm}}}
-	  \pgfpathlineto{\pgfpointanchor{handoutnode}{north}}
-	  \pgfpathmoveto{\pgfpointanchor{presentationnode}{south east}}
-	  \pgfpathlineto{\pgfpointanchor{transnode}{north}}            
-	  \pgfusepath{stroke}    
-	\end{pgfpicture}
+  \begin{tikzpicture}[
+    every node/.style={draw,anchor=base,font=\ttfamily\strut},
+    level 1/.style={sibling distance=50mm},
+    level 2/.style={sibling distance=20mm}
+  ]
+    \node {all}
+      child {node {presentation}
+        child {node {beamer}}
+        child {node {second}}
+        child {node {handout}}
+        child {node {trans}}
+      }
+      child {node {article}};
+  \end{tikzpicture}
 \end{center}
 
 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|.
diff --git a/Master/texmf-dist/doc/latex/beamer/beamerug-notes.tex b/Master/texmf-dist/doc/latex/beamer/beamerug-notes.tex
index a54dc4ecff0..2fef37f1bfb 100644
--- a/Master/texmf-dist/doc/latex/beamer/beamerug-notes.tex
+++ b/Master/texmf-dist/doc/latex/beamer/beamerug-notes.tex
@@ -101,7 +101,7 @@ The following element dictates how the note pages are rendered:
     \itemoption{plain}{}
     Just inserts the note text, no fancy hints.
     \itemoption{lined}{\oarg{number}}
-    Instead of printing the note text, this option fills the note page with lines on which the audience can write their own notes on. \meta{number} specifies how many lines will be shown, the default is 6 lines.
+    Instead of printing the note text, this option fills the note page with lines on which the audience can write their own notes on. \meta{number} specifies how many lines will be shown, the default is 6 lines. For a more sophisticated interface, the \href{https://www.ctan.org/pkg/handoutwithnotes}{|handoutwithnotes|} package can be used.
   \end{templateoptions}
   The following two inserts are useful for note pages:
   \begin{itemize}
diff --git a/Master/texmf-dist/doc/latex/beamer/beamerug-overlays.tex b/Master/texmf-dist/doc/latex/beamer/beamerug-overlays.tex
index 57a8546f9b4..c3d770701cd 100644
--- a/Master/texmf-dist/doc/latex/beamer/beamerug-overlays.tex
+++ b/Master/texmf-dist/doc/latex/beamer/beamerug-overlays.tex
@@ -545,6 +545,13 @@ This section explains how to define new commands that are overlay specification-
 \end{verbatim}
 \end{command}
 
+In a similar way |\NewDocumentCommand|, |\NewDocumentEnvironment| etc. can be used to define overlay aware commands and environments. The overlay argument can be specified via |d<>| (without default value) or |D<>{}| (with default value) type arguments.
+
+\example
+\begin{verbatim}
+\NewDocumentCommand{\makeblue}{D<>{.-} m}{{\color<#1>{blue}#2}}
+\end{verbatim}
+
 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}}
diff --git a/Master/texmf-dist/doc/latex/beamer/beameruserguide.pdf b/Master/texmf-dist/doc/latex/beamer/beameruserguide.pdf
index 4a307329c02..6ef87a6ab64 100644
--- a/Master/texmf-dist/doc/latex/beamer/beameruserguide.pdf
+++ b/Master/texmf-dist/doc/latex/beamer/beameruserguide.pdf
diff --git a/Master/texmf-dist/doc/latex/beamer/beameruserguide.tex b/Master/texmf-dist/doc/latex/beamer/beameruserguide.tex
index 3ddbee05e13..46002a15dfa 100644
--- a/Master/texmf-dist/doc/latex/beamer/beameruserguide.tex
+++ b/Master/texmf-dist/doc/latex/beamer/beameruserguide.tex
@@ -13,7 +13,7 @@
 
 \documentclass{ltxdoc}
 
-\def\beamerugversion{3.64}
+\def\beamerugversion{3.65}
 \def\beamerugpgfversion{3.1.7}
 \def\beamerugxcolorversion{2.00}
 
@@ -28,7 +28,7 @@
 \usepackage[pdfborder={0 0 0},bookmarksnumbered]{hyperref}
 \usepackage[left=2.25cm,right=2.25cm,top=2.5cm,bottom=2.5cm,nohead]{geometry}
 \usepackage{translator}
-
+\usepackage{tikz}
 
 \input{beamerug-macros}