Skip to content

Commit

Permalink
Add comment about beamer work-around
Browse files Browse the repository at this point in the history
  • Loading branch information
gusbrs committed Nov 14, 2024
1 parent 48b2acc commit 26cfb04
Showing 1 changed file with 10 additions and 1 deletion.
11 changes: 10 additions & 1 deletion zref-clever-doc.tex
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,7 @@

\NewDocumentCommand\opt{m}{\texttt{#1}}

\NewDocumentCommand\contributor{m}{#1}
\NewDocumentCommand\username{m}{`\texttt{#1}'}

\makeatletter
Expand Down Expand Up @@ -2341,6 +2342,12 @@ \section{Work-arounds}

\subsection*{\cls{beamer}}

Before using this, note that, if you are up-to-date, you might no longer need
a work-around for \cls{beamer}.\footnote{See
\url{https://github.com/josephwright/beamer/issues/917}. Thanks to
\contributor{Ulrike Fischer}, see also
\url{https://tex.stackexchange.com/a/730792}.}

\cls{beamer} does some really atypical things with regard to cross-references.
To start with, it redefines \cs{label} to receive an optional
\texttt{<\meta{overlay specification}>} argument. Then, presumably to support
Expand All @@ -2355,7 +2362,7 @@ \subsection*{\cls{beamer}}
appear to break \pkg{cleveref}.\footnote{See, for example,
\url{https://tex.stackexchange.com/q/266080},
\url{https://tex.stackexchange.com/q/668998}, and
\url{https://github.com/josephwright/beamer/issues/750}. The workaround
\url{https://github.com/josephwright/beamer/issues/750}. The work-around
provided at \url{https://tex.stackexchange.com/a/266109} is not general
enough since it breaks \pkg{cleveref}'s ability to receive a list of labels
as argument.}
Expand Down Expand Up @@ -2472,6 +2479,8 @@ \section{Acknowledgments}
% 2023-01-02: https://tex.stackexchange.com/q/670399 (comments)
% 2023-06-01: https://github.com/latex3/latex2e/pull/956
% 2023-07-27: https://chat.stackexchange.com/transcript/message/64067726#64067726
% 2024-11-14: https://tex.stackexchange.com/a/730792
% 2024-11-14: https://github.com/josephwright/beamer/issues/917
Phelype Oleinik,
% 2021-08-20: https://tex.stackexchange.com/q/611370 (comments)
% 2021-09-09: https://tex.stackexchange.com/a/614704
Expand Down

0 comments on commit 26cfb04

Please sign in to comment.