texlive[71912] Master: hypcap (27jul24)

commits+karl at tug.org commits+karl at tug.org
Sat Jul 27 22:47:17 CEST 2024


Revision: 71912
          https://tug.org/svn/texlive?view=revision&revision=71912
Author:   karl
Date:     2024-07-27 22:47:17 +0200 (Sat, 27 Jul 2024)
Log Message:
-----------
hypcap (27jul24)

Modified Paths:
--------------
    trunk/Master/tlpkg/bin/tlpkg-ctan-check
    trunk/Master/tlpkg/libexec/ctan2tds
    trunk/Master/tlpkg/tlpsrc/collection-latex.tlpsrc

Added Paths:
-----------
    trunk/Master/texmf-dist/doc/latex/hypcap/
    trunk/Master/texmf-dist/doc/latex/hypcap/README.md
    trunk/Master/texmf-dist/doc/latex/hypcap/hypcap.pdf
    trunk/Master/texmf-dist/source/latex/hypcap/
    trunk/Master/texmf-dist/source/latex/hypcap/hypcap.dtx
    trunk/Master/texmf-dist/tex/latex/hypcap/
    trunk/Master/texmf-dist/tex/latex/hypcap/hypcap.sty
    trunk/Master/tlpkg/tlpsrc/hypcap.tlpsrc

Added: trunk/Master/texmf-dist/doc/latex/hypcap/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/latex/hypcap/README.md	                        (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/hypcap/README.md	2024-07-27 20:47:17 UTC (rev 71912)
@@ -0,0 +1,20 @@
+# hypcap package for LaTeX
+
+* adjusting anchors of captions;
+
+Version: 2024-07-26 v1.13
+
+This package tries a solution of the problem with
+hyperref, that links to floats points below the
+caption and not at the beginning of the float.
+Therefore this package divides the task into two
+part, the link setting with `\capstart` or
+automatically at the beginning of a float and
+the rest in the `\caption` command.
+
+## Copyright (C)
+*    1999-2001, 2006-2008, 2011 Heiko Oberdiek
+*    2016-2024 Oberdiek Package Support Group
+
+## License
+LATEX Project Public License, version 1.3c or later.


Property changes on: trunk/Master/texmf-dist/doc/latex/hypcap/README.md
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/latex/hypcap/hypcap.pdf
===================================================================
(Binary files differ)

Index: trunk/Master/texmf-dist/doc/latex/hypcap/hypcap.pdf
===================================================================
--- trunk/Master/texmf-dist/doc/latex/hypcap/hypcap.pdf	2024-07-27 20:45:22 UTC (rev 71911)
+++ trunk/Master/texmf-dist/doc/latex/hypcap/hypcap.pdf	2024-07-27 20:47:17 UTC (rev 71912)

Property changes on: trunk/Master/texmf-dist/doc/latex/hypcap/hypcap.pdf
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
Added: trunk/Master/texmf-dist/source/latex/hypcap/hypcap.dtx
===================================================================
--- trunk/Master/texmf-dist/source/latex/hypcap/hypcap.dtx	                        (rev 0)
+++ trunk/Master/texmf-dist/source/latex/hypcap/hypcap.dtx	2024-07-27 20:47:17 UTC (rev 71912)
@@ -0,0 +1,709 @@
+% \iffalse meta-comment
+%
+% File: hypcap.dtx
+% Version: 2024-07-26 v1.13
+% Info: Adjusting the anchors of captions
+%
+% Copyright (C)
+%    1999-2001, 2006-2008, 2011 Heiko Oberdiek
+%    2016-2024 Oberdiek Package Support Group
+%    https://github.com/ho-tex/hypcap/issues
+%
+% This work may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License, either
+% version 1.3c of this license or (at your option) any later
+% version. This version of this license is in
+%    https://www.latex-project.org/lppl/lppl-1-3c.txt
+% and the latest version of this license is in
+%    https://www.latex-project.org/lppl.txt
+% and version 1.3 or later is part of all distributions of
+% LaTeX version 2005/12/01 or later.
+%
+% This work has the LPPL maintenance status "maintained".
+%
+% The Current Maintainers of this work are
+% Heiko Oberdiek and the Oberdiek Package Support Group
+% https://github.com/ho-tex/hypcap/issues
+%
+% This work consists of the main source file hypcap.dtx
+% and the derived files
+%    hypcap.sty, hypcap.pdf, hypcap.ins, hypcap.drv.
+%
+% Distribution:
+%    CTAN:macros/latex/contrib/hypcap/hypcap.dtx
+%    CTAN:macros/latex/contrib/hypcap/hypcap.pdf
+%
+% Unpacking:
+%    (a) If hypcap.ins is present:
+%           tex hypcap.ins
+%    (b) Without hypcap.ins:
+%           tex hypcap.dtx
+%    (c) If you insist on using LaTeX
+%           latex \let\install=y\input{hypcap.dtx}
+%        (quote the arguments according to the demands of your shell)
+%
+% Documentation:
+%    (a) If hypcap.drv is present:
+%           latex hypcap.drv
+%    (b) Without hypcap.drv:
+%           latex hypcap.dtx; ...
+%    The class ltxdoc loads the configuration file ltxdoc.cfg
+%    if available. Here you can specify further options, e.g.
+%    use A4 as paper format:
+%       \PassOptionsToClass{a4paper}{article}
+%
+%    Program calls to get the documentation (example):
+%       pdflatex hypcap.dtx
+%       makeindex -s gind.ist hypcap.idx
+%       pdflatex hypcap.dtx
+%       makeindex -s gind.ist hypcap.idx
+%       pdflatex hypcap.dtx
+%
+% Installation:
+%    TDS:tex/latex/hypcap/hypcap.sty
+%    TDS:doc/latex/hypcap/hypcap.pdf
+%    TDS:source/latex/hypcap/hypcap.dtx
+%
+%<*ignore>
+\begingroup
+  \catcode123=1 %
+  \catcode125=2 %
+  \def\x{LaTeX2e}%
+\expandafter\endgroup
+\ifcase 0\ifx\install y1\fi\expandafter
+         \ifx\csname processbatchFile\endcsname\relax\else1\fi
+         \ifx\fmtname\x\else 1\fi\relax
+\else\csname fi\endcsname
+%</ignore>
+%<*install>
+\input docstrip.tex
+\Msg{************************************************************************}
+\Msg{* Installation}
+\Msg{* Package: hypcap 2024-07-26 v1.13 Adjusting the anchors of captions (HO)}
+\Msg{************************************************************************}
+
+\keepsilent
+\askforoverwritefalse
+
+\let\MetaPrefix\relax
+\preamble
+
+This is a generated file.
+
+Project: hypcap
+Version: 2024-07-26 v1.13
+
+Copyright (C)
+   1999-2001, 2006-2008, 2011 Heiko Oberdiek
+   2016-2024 Oberdiek Package Support Group
+
+This work may be distributed and/or modified under the
+conditions of the LaTeX Project Public License, either
+version 1.3c of this license or (at your option) any later
+version. This version of this license is in
+   https://www.latex-project.org/lppl/lppl-1-3c.txt
+and the latest version of this license is in
+   https://www.latex-project.org/lppl.txt
+and version 1.3 or later is part of all distributions of
+LaTeX version 2005/12/01 or later.
+
+This work has the LPPL maintenance status "maintained".
+
+The Current Maintainers of this work are
+Heiko Oberdiek and the Oberdiek Package Support Group
+https://github.com/ho-tex/hypcap/issues
+
+
+This work consists of the main source file hypcap.dtx
+and the derived files
+   hypcap.sty, hypcap.pdf, hypcap.ins, hypcap.drv.
+
+\endpreamble
+\let\MetaPrefix\DoubleperCent
+
+\generate{%
+  \file{hypcap.ins}{\from{hypcap.dtx}{install}}%
+  \file{hypcap.drv}{\from{hypcap.dtx}{driver}}%
+  \usedir{tex/latex/hypcap}%
+  \file{hypcap.sty}{\from{hypcap.dtx}{package}}%
+}
+
+\catcode32=13\relax% active space
+\let =\space%
+\Msg{************************************************************************}
+\Msg{*}
+\Msg{* To finish the installation you have to move the following}
+\Msg{* file into a directory searched by TeX:}
+\Msg{*}
+\Msg{*     hypcap.sty}
+\Msg{*}
+\Msg{* To produce the documentation run the file `hypcap.drv'}
+\Msg{* through LaTeX.}
+\Msg{*}
+\Msg{* Happy TeXing!}
+\Msg{*}
+\Msg{************************************************************************}
+
+\endbatchfile
+%</install>
+%<*ignore>
+\fi
+%</ignore>
+%<*driver>
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesFile{hypcap.drv}%
+  [2024-07-26 v1.13 Adjusting the anchors of captions (HO)]%
+\documentclass{ltxdoc}
+\usepackage{holtxdoc}[2011/11/22]
+\begin{document}
+  \DocInput{hypcap.dtx}%
+\end{document}
+%</driver>
+% \fi
+%
+%
+%
+% \GetFileInfo{hypcap.drv}
+%
+% \title{The \xpackage{hypcap} package}
+% \date{2024-07-26 v1.13}
+% \author{Heiko Oberdiek\thanks
+% {Please report any issues at \url{https://github.com/ho-tex/hypcap/issues}}}
+%
+% \maketitle
+%
+% \begin{abstract}
+% This package tries a solution of the problem with
+% hyperref, that links to floats points below the
+% caption and not at the beginning of the float.
+% Therefore this package divides the task into two
+% part, the link setting with \cs{capstart} or
+% automatically at the beginning of a float and
+% the rest in the \cs{caption} command.
+% \end{abstract}
+%
+% \tableofcontents
+%
+% \newpage
+% \section{Usage}
+%    The package \Package{hypcap} requires that \Package{hyperref}
+%    is loaded first:
+%    \begin{quote}
+%      |\usepackage[...]{hyperref}|\\
+%      |\usepackage[...]{hypcap}|
+%    \end{quote}
+%
+% \subsection{Package options}
+%    The names of the four float environments |figure|, |figure*|,
+%    |table|, or |table*| can be used as option. Then the package
+%    redefines the environment in order to insert \cmd{\capstart}
+%    (see below) in the beginning of the environment automatically.
+%
+%    Option |all| enables the redefinitions of all four
+%    float environments. For other environments see
+%    the user command \cmd{\hypcapredef}.
+%
+% \subsection{User commands}
+%    \begin{description}
+%    \item[\cmd{\capstart}:]\DescribeMacro{\capstart}
+%      First this command increments the counter (\cmd{\@captype}).
+%      Then it makes an anchor for package \Package{hyperref}.
+%      At last \cmd{\caption} is redefined to remove the
+%      anchor setting part from \Package{hyperref}'s \cmd{\caption}.
+%
+%      The package expects the following structure of a float
+%      environment:
+%      \begin{quote}
+%        |\begin{|\textit{|float|}|}...|\\
+%        |\capstart|\\
+%        |...|\\
+%        |\caption{...}|\\
+%        |...|\\
+%        |\end{|\textit{|float|}|}|
+%      \end{quote}
+%      There can be several \cmd{\caption} commands. For these
+%      you need \cmd{\capstart} again:
+%      \begin{quote}
+%        |\capstart ... \caption... \capstart ... \caption...|
+%      \end{quote}
+%      And the \cmd{\caption} command itself can be put in a group.
+%
+%      With the options, described above, the extra
+%      writing of \cmd{\capstart} can be avoided.
+%      Consequently, there must be a \cmd{\caption} in every
+%      environment of this type, specified by the option.
+%      If you want to use more than one \cmd{\caption} in this
+%      environment, you have to state \cmd{\capstart} again.
+%    \item[\cmd{\hypcapspace}:]\DescribeMacro{\hypcapspace}
+%      Because it looks poor, if the link points exactly at top of
+%      the figure, there is additional space: \cmd{\hypcapspace},
+%      the default is |0.5\baselineskip|, examples:
+%      \begin{quote}
+%        |\renewcommand{\hypcapspace}{0pt}| removes the space\\
+%        |\renewcommand{\hypcapspace}{1pt}| sets a fix value
+%      \end{quote}
+%    \item[\cmd{\hypcapredef}:]\DescribeMacro{\hypcapredef}
+%      If there are other float environments, that
+%      should automatically execute \cmd{\capstart}, then
+%      a redefinition with \cmd{\hypcapredef} can be tried:
+%      \begin{quote}
+%        |\hypcapredef{myfloat}|
+%      \end{quote}
+%      Only environments with one optional parameter are
+%      supported.
+%    \item[\cs{capstartfalse}, \cs{capstarttrue}:]^^A
+%      \DescribeMacro{\capstartfalse}^^A
+%      \DescribeMacro{\capstarttrue}^^A
+%      Since 2008/09/08 v1.10.\\
+%      They disable and enable \cs{capstart}. They can be used to
+%      cancel the effect of a redefined float environment.
+%      Example:
+%\begin{quote}
+%\catcode`Y=\active
+%\def Y#1Z{\textit{\cs{#1}}}
+%\begin{verbatim}
+%\documentclass{article}
+%\usepackage{hyperref}
+%\usepackage[figure]{hypcap}[2008/09/08]
+%
+%\begin{document}
+%  \section{Hello World}
+%  \begin{figure}
+%    \caption{Figure with caption A}
+%  \end{figure}
+%  YcapstartfalseZ
+%  \begin{figure}
+%    Figure without caption
+%  \end{figure}
+%  YcapstarttrueZ
+%  \begin{figure}
+%    \caption{Figure with caption B}
+%  \end{figure}
+%\end{document}
+%\end{verbatim}
+%\end{quote}
+%    \end{description}
+%
+% \subsection{Limitations}
+%    \begin{itemize}
+%    \item Packages that redefine \cmd{\caption} or
+%          \cmd{\@caption}.
+%    \end{itemize}
+%
+% \StopEventually{
+% }
+%
+% \section{Implementation}
+%    \begin{macrocode}
+%<*package>
+%    \end{macrocode}
+%    Package identification.
+%    \begin{macrocode}
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{hypcap}%
+  [2024-07-26 v1.13 Adjusting the anchors of captions (HO)]
+%    \end{macrocode}
+%
+%    For unique command names this package uses |hc@| as prefix
+%    for internal command names.
+%
+%    First we check, if package \Package{hyperref} is loaded:
+%    \begin{macrocode}
+\@ifundefined{hyper@@anchor}{%
+  \PackageError{hypcap}{You have to load 'hyperref' first}\@ehc
+  \endinput
+}{}
+%    \end{macrocode}
+%
+%    \begin{macrocode}
+\RequirePackage{letltxmacro}[2008/06/24]
+%    \end{macrocode}
+%
+%    \begin{macro}{\hc at org@caption}
+%    Save the original meaning of \cmd{\caption}:
+%    \begin{macrocode}
+\newcommand*\hc at org@caption{}
+\let\hc at org@caption\caption
+%    \end{macrocode}
+%    \end{macro}
+%
+%    \newcommand*{\BeginMacro}[1]{\expandafter\DoBeginMacro\csname#1\endcsname}
+%    \newcommand*{\DoBeginMacro}[1]{\begin{macro}{#1}}
+%    \newcommand*{\Cmd}[1]{\expandafter\cmd\csname#1\endcsname}
+%    \BeginMacro{if at capstart}
+%     The switch \Cmd{if at capstart} helps to detect
+%     \cmd{\capstart} commands with missing \cmd{\caption} macros.
+%     Because \cmd{\caption} can occur inside a group, assignments
+%     to the switch have to be made global.
+%    \begin{macrocode}
+\newif\if at capstart
+%    \end{macrocode}
+%    \end{macro}
+%
+%    \begin{macro}{\hypcapspace}
+%    The anchor is raised.by \cmd{\hypcapspace}.
+%    \begin{macrocode}
+\newcommand*\hypcapspace{.5\baselineskip}
+%    \end{macrocode}
+%    \end{macro}
+%
+%    \begin{macro}{\ifcapstart}
+%    \begin{macrocode}
+\newif\ifcapstart
+\capstarttrue
+%    \end{macrocode}
+%    \end{macro}
+%
+%    \begin{macro}{\capstart}
+%     The macro \cmd{\capstart} contains the first part of
+%     the \cmd{\caption} command: Incrementing the counter
+%     and setting the anchor.
+%    \begin{macrocode}
+\newcommand*\capstart{%
+  \ifcapstart
+    \H at refstepcounter\@captype % first part of caption
+    \hyper at makecurrent\@captype
+    \global\let\hc at currentHref\@currentHref
+    \vspace*{-\hypcapspace}%
+    \begingroup
+      \let\leavevmode\relax
+      \hyper@@anchor\@currentHref\relax
+    \endgroup
+    \vspace*{\hypcapspace}%
+    \hc at hyperref{\let\caption\hc at caption}%
+    \global\@capstarttrue
+    \global\advance\csname c@\@captype\endcsname\m at ne
+  \fi
+}
+%    \end{macrocode}
+%    \end{macro}
+%
+%    \begin{macrocode}
+\@ifpackagelater{hyperref}{2007/04/09}{%
+  \let\hc at hyperref\@gobble
+}{%
+  \let\hc at hyperref\@firstofone
+}
+%    \end{macrocode}
+%
+%    \begin{macro}{\hc at caption}
+%    The new \cmd{\caption} command without the first part
+%    is defined in the macro \cmd{\hc at caption}.
+%    \begin{macrocode}
+\def\hc at caption{%
+  \global\advance\csname c@\@captype\endcsname\@ne
+  \@dblarg{\hc@@caption\@captype}%
+}
+%    \end{macrocode}
+%    \end{macro}
+%
+%    \begin{macro}{\hc@@caption}
+%    This is a copy of package \Package{hyperref}'s \cmd{\@caption}
+%    macro without making the anchor, because this is already done
+%    in \cmd{\capstart}.
+%    \begin{macrocode}
+\long\def\hc@@caption#1[#2]#3{%
+  \let\caption\hc at org@caption
+  \global\@capstartfalse
+  \ifHy at hypertexnames
+    \hyper at makecurrent\@captype
+  \else
+    \global\let\@currentHref\hc at currentHref
+  \fi
+  \par\addcontentsline{%
+    \csname ext@#1\endcsname}{#1}{%
+    \protect\numberline{%
+      \csname the#1\endcsname
+    }{\ignorespaces #2}%
+  }%
+  \begingroup
+    \@parboxrestore
+    \normalsize
+    \@makecaption{\csname fnum@#1\endcsname}{%
+      \ignorespaces#3%
+    }%
+    \par
+  \endgroup
+}
+%    \end{macrocode}
+%    \end{macro}
+%
+%    \begin{macro}{\hypcapredef}
+%    The macro \cmd{\hypcapredef} prepares the call of
+%    \cmd{\hc at redef} that will redefine the environment
+%    that is given in the argument.
+%    \begin{macrocode}
+\def\hypcapredef#1{%
+  \expandafter\hc at redef\csname hc at org#1\expandafter\endcsname
+                       \csname hc at orgend#1\expandafter\endcsname
+                       \expandafter{#1}%
+}
+%    \end{macrocode}
+%    \end{macro}
+%    \begin{macro}{\hc at redef}
+%    The old meaning of the environment is saved. Then
+%    \cmd{\capstart} is appended in the begin part.
+%    The end part contains a check
+%    that produces an error message in case of \cmd{\capstart}
+%    without \cmd{\capstart} (\cmd{\capstart} has incremented
+%    the counter).
+%    \begin{macrocode}
+\def\hc at redef#1#2#3{%
+  \newcommand#1{}%
+  \expandafter\LetLtxMacro\expandafter#1\csname#3\endcsname
+  \expandafter\LetLtxMacro\expandafter#2\csname end#3\endcsname
+  \renewenvironment*{#3}[1][]{%
+    \ifx\\##1\\%
+      #1\relax
+    \else
+      #1[##1]% hash-ok (compatibility for float)
+    \fi
+    \capstart
+  }{%
+    \if at capstart
+      \PackageWarning{hypcap}{You have forgotten to use \string\caption}%
+      \global\@capstartfalse
+    \else
+    \fi
+    #2%
+  }%
+}
+%    \end{macrocode}
+%    \end{macro}
+%
+%     At last the options are defined and processed.
+%    \begin{macrocode}
+\DeclareOption{figure}{\hypcapredef{\CurrentOption}}
+\DeclareOption{figure*}{\hypcapredef{\CurrentOption}}
+\DeclareOption{table}{\hypcapredef{\CurrentOption}}
+\DeclareOption{table*}{\hypcapredef{\CurrentOption}}
+\DeclareOption{all}{%
+  \hypcapredef{figure}%
+  \hypcapredef{figure*}%
+  \hypcapredef{table}%
+  \hypcapredef{table*}%
+}
+\ProcessOptions\relax
+%    \end{macrocode}
+%
+%    \begin{macrocode}
+%</package>
+%    \end{macrocode}
+%
+% \section{Installation}
+%
+% \subsection{Download}
+%
+% \paragraph{Package.} This package is available on
+% CTAN\footnote{\CTANpkg{hypcap}}:
+% \begin{description}
+% \item[\CTAN{macros/latex/contrib/hypcap/hypcap.dtx}] The source file.
+% \item[\CTAN{macros/latex/contrib/hypcap/hypcap.pdf}] Documentation.
+% \end{description}
+%
+%
+% \subsection{Package installation}
+%
+% \paragraph{Unpacking.} The \xfile{.dtx} file is a self-extracting
+% \docstrip\ archive. The files are extracted by running the
+% \xfile{.dtx} through \plainTeX:
+% \begin{quote}
+%   \verb|tex hypcap.dtx|
+% \end{quote}
+%
+% \paragraph{TDS.} Now the different files must be moved into
+% the different directories in your installation TDS tree
+% (also known as \xfile{texmf} tree):
+% \begin{quote}
+% \def\t{^^A
+% \begin{tabular}{@{}>{\ttfamily}l@{ $\rightarrow$ }>{\ttfamily}l@{}}
+%   hypcap.sty & tex/latex/hypcap/hypcap.sty\\
+%   hypcap.pdf & doc/latex/hypcap/hypcap.pdf\\
+%   hypcap.dtx & source/latex/hypcap/hypcap.dtx\\
+% \end{tabular}^^A
+% }^^A
+% \sbox0{\t}^^A
+% \ifdim\wd0>\linewidth
+%   \begingroup
+%     \advance\linewidth by\leftmargin
+%     \advance\linewidth by\rightmargin
+%   \edef\x{\endgroup
+%     \def\noexpand\lw{\the\linewidth}^^A
+%   }\x
+%   \def\lwbox{^^A
+%     \leavevmode
+%     \hbox to \linewidth{^^A
+%       \kern-\leftmargin\relax
+%       \hss
+%       \usebox0
+%       \hss
+%       \kern-\rightmargin\relax
+%     }^^A
+%   }^^A
+%   \ifdim\wd0>\lw
+%     \sbox0{\small\t}^^A
+%     \ifdim\wd0>\linewidth
+%       \ifdim\wd0>\lw
+%         \sbox0{\footnotesize\t}^^A
+%         \ifdim\wd0>\linewidth
+%           \ifdim\wd0>\lw
+%             \sbox0{\scriptsize\t}^^A
+%             \ifdim\wd0>\linewidth
+%               \ifdim\wd0>\lw
+%                 \sbox0{\tiny\t}^^A
+%                 \ifdim\wd0>\linewidth
+%                   \lwbox
+%                 \else
+%                   \usebox0
+%                 \fi
+%               \else
+%                 \lwbox
+%               \fi
+%             \else
+%               \usebox0
+%             \fi
+%           \else
+%             \lwbox
+%           \fi
+%         \else
+%           \usebox0
+%         \fi
+%       \else
+%         \lwbox
+%       \fi
+%     \else
+%       \usebox0
+%     \fi
+%   \else
+%     \lwbox
+%   \fi
+% \else
+%   \usebox0
+% \fi
+% \end{quote}
+% If you have a \xfile{docstrip.cfg} that configures and enables \docstrip's
+% TDS installing feature, then some files can already be in the right
+% place, see the documentation of \docstrip.
+%
+% \subsection{Refresh file name databases}
+%
+% If your \TeX~distribution
+% (\TeX\,Live, \mikTeX, \dots) relies on file name databases, you must refresh
+% these. For example, \TeX\,Live\ users run \verb|texhash| or
+% \verb|mktexlsr|.
+%
+% \subsection{Some details for the interested}
+%
+% \paragraph{Unpacking with \LaTeX.}
+% The \xfile{.dtx} chooses its action depending on the format:
+% \begin{description}
+% \item[\plainTeX:] Run \docstrip\ and extract the files.
+% \item[\LaTeX:] Generate the documentation.
+% \end{description}
+% If you insist on using \LaTeX\ for \docstrip\ (really,
+% \docstrip\ does not need \LaTeX), then inform the autodetect routine
+% about your intention:
+% \begin{quote}
+%   \verb|latex \let\install=y\input{hypcap.dtx}|
+% \end{quote}
+% Do not forget to quote the argument according to the demands
+% of your shell.
+%
+% \paragraph{Generating the documentation.}
+% You can use both the \xfile{.dtx} or the \xfile{.drv} to generate
+% the documentation. The process can be configured by the
+% configuration file \xfile{ltxdoc.cfg}. For instance, put this
+% line into this file, if you want to have A4 as paper format:
+% \begin{quote}
+%   \verb|\PassOptionsToClass{a4paper}{article}|
+% \end{quote}
+% An example follows how to generate the
+% documentation with pdf\LaTeX:
+% \begin{quote}
+%\begin{verbatim}
+%pdflatex hypcap.dtx
+%makeindex -s gind.ist hypcap.idx
+%pdflatex hypcap.dtx
+%makeindex -s gind.ist hypcap.idx
+%pdflatex hypcap.dtx
+%\end{verbatim}
+% \end{quote}
+%
+% \begin{History}
+%   \begin{Version}{1999/02/13 v1.0}
+%   \item
+%     A beginning version, published in newsgroup \xnewsgroup{comp.text.tex}:\\
+%     \URL{``\link{Re: \xpackage{hyperref} and figures}''}^^A
+%     {https://groups.google.com/group/comp.text.tex/msg/5c9b47b001a9379c}
+%   \end{Version}
+%   \begin{Version}{2000/08/14 v1.1}
+%   \item
+%     Global assignments of \cs{if at capstart}
+%     in order to allow \cs{caption} in groups.
+%   \item
+%     Option \texttt{all} added.
+%   \end{Version}
+%   \begin{Version}{2000/09/07 v1.2}
+%   \item
+%     Package in dtx format.
+%   \end{Version}
+%   \begin{Version}{2001/08/27 v1.3}
+%   \item
+%     Bug fix with hyperref's pdfmark driver\\
+%     (\cs{leavevmode} in
+%     \cs{hyper@@anchor}/\cs{pdf at rect}).
+%   \end{Version}
+%   \begin{Version}{2001/09/06 v1.4}
+%   \item
+%     Small fixes in the dtx file.
+%   \end{Version}
+%   \begin{Version}{2006/02/20 v1.5}
+%   \item
+%     Code is not changed.
+%   \item
+%     New DTX framework.
+%   \end{Version}
+%   \begin{Version}{2007/02/19 v1.6}
+%   \item
+%     Fix for hypertexnames=false.
+%   \end{Version}
+%   \begin{Version}{2007/04/09 v1.7}
+%   \item
+%     Stuff in \cs{caption} moved to \xpackage{hyperref}.
+%     This avoids redefinitions of \cs{caption} and \cs{@caption}
+%     (idea of Axel Sommerfeldt).
+%   \item
+%     Fix for subfigure (Marco Kuhlmann, Amilcar do Carmo Lucas).
+%   \end{Version}
+%   \begin{Version}{2008/04/14 v1.8}
+%   \item
+%     \cs{hc at redef} fixed to get package \xpackage{float} work
+%     (Axel Sommerfeldt).
+%   \end{Version}
+%   \begin{Version}{2008/08/11 v1.9}
+%   \item
+%     Code is not changed.
+%   \item
+%     URLs updated.
+%   \end{Version}
+%   \begin{Version}{2008/09/08 v1.10}
+%   \item
+%     \cs{capstartfalse} and \cs{capstarttrue} added.
+%   \end{Version}
+%   \begin{Version}{2011/02/16 v1.11}
+%   \item
+%     \cs{hc at redef} fixed by using package \xpackage{letltxmacro}.
+%   \end{Version}
+%   \begin{Version}{2016/05/16 v1.12}
+%   \item
+%     Documentation updates.
+%   \end{Version}
+%   \begin{Version}{2024-07-26 v1.13}
+%   \item Change error into warning, issue \#1
+%   \end{Version}
+% \end{History}
+%
+% \PrintIndex
+%
+% \Finale
+\endinput


Property changes on: trunk/Master/texmf-dist/source/latex/hypcap/hypcap.dtx
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/tex/latex/hypcap/hypcap.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/hypcap/hypcap.sty	                        (rev 0)
+++ trunk/Master/texmf-dist/tex/latex/hypcap/hypcap.sty	2024-07-27 20:47:17 UTC (rev 71912)
@@ -0,0 +1,138 @@
+%%
+%% This is file `hypcap.sty',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% hypcap.dtx  (with options: `package')
+%% 
+%% This is a generated file.
+%% 
+%% Project: hypcap
+%% Version: 2024-07-26 v1.13
+%% 
+%% Copyright (C)
+%%    1999-2001, 2006-2008, 2011 Heiko Oberdiek
+%%    2016-2024 Oberdiek Package Support Group
+%% 
+%% This work may be distributed and/or modified under the
+%% conditions of the LaTeX Project Public License, either
+%% version 1.3c of this license or (at your option) any later
+%% version. This version of this license is in
+%%    https://www.latex-project.org/lppl/lppl-1-3c.txt
+%% and the latest version of this license is in
+%%    https://www.latex-project.org/lppl.txt
+%% and version 1.3 or later is part of all distributions of
+%% LaTeX version 2005/12/01 or later.
+%% 
+%% This work has the LPPL maintenance status "maintained".
+%% 
+%% The Current Maintainers of this work are
+%% Heiko Oberdiek and the Oberdiek Package Support Group
+%% https://github.com/ho-tex/hypcap/issues
+%% 
+%% This work consists of the main source file hypcap.dtx
+%% and the derived files
+%%    hypcap.sty, hypcap.pdf, hypcap.ins, hypcap.drv.
+%% 
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{hypcap}%
+  [2024-07-26 v1.13 Adjusting the anchors of captions (HO)]
+\@ifundefined{hyper@@anchor}{%
+  \PackageError{hypcap}{You have to load 'hyperref' first}\@ehc
+  \endinput
+}{}
+\RequirePackage{letltxmacro}[2008/06/24]
+\newcommand*\hc at org@caption{}
+\let\hc at org@caption\caption
+\newif\if at capstart
+\newcommand*\hypcapspace{.5\baselineskip}
+\newif\ifcapstart
+\capstarttrue
+\newcommand*\capstart{%
+  \ifcapstart
+    \H at refstepcounter\@captype % first part of caption
+    \hyper at makecurrent\@captype
+    \global\let\hc at currentHref\@currentHref
+    \vspace*{-\hypcapspace}%
+    \begingroup
+      \let\leavevmode\relax
+      \hyper@@anchor\@currentHref\relax
+    \endgroup
+    \vspace*{\hypcapspace}%
+    \hc at hyperref{\let\caption\hc at caption}%
+    \global\@capstarttrue
+    \global\advance\csname c@\@captype\endcsname\m at ne
+  \fi
+}
+\@ifpackagelater{hyperref}{2007/04/09}{%
+  \let\hc at hyperref\@gobble
+}{%
+  \let\hc at hyperref\@firstofone
+}
+\def\hc at caption{%
+  \global\advance\csname c@\@captype\endcsname\@ne
+  \@dblarg{\hc@@caption\@captype}%
+}
+\long\def\hc@@caption#1[#2]#3{%
+  \let\caption\hc at org@caption
+  \global\@capstartfalse
+  \ifHy at hypertexnames
+    \hyper at makecurrent\@captype
+  \else
+    \global\let\@currentHref\hc at currentHref
+  \fi
+  \par\addcontentsline{%
+    \csname ext@#1\endcsname}{#1}{%
+    \protect\numberline{%
+      \csname the#1\endcsname
+    }{\ignorespaces #2}%
+  }%
+  \begingroup
+    \@parboxrestore
+    \normalsize
+    \@makecaption{\csname fnum@#1\endcsname}{%
+      \ignorespaces#3%
+    }%
+    \par
+  \endgroup
+}
+\def\hypcapredef#1{%
+  \expandafter\hc at redef\csname hc at org#1\expandafter\endcsname
+                       \csname hc at orgend#1\expandafter\endcsname
+                       \expandafter{#1}%
+}
+\def\hc at redef#1#2#3{%
+  \newcommand#1{}%
+  \expandafter\LetLtxMacro\expandafter#1\csname#3\endcsname
+  \expandafter\LetLtxMacro\expandafter#2\csname end#3\endcsname
+  \renewenvironment*{#3}[1][]{%
+    \ifx\\##1\\%
+      #1\relax
+    \else
+      #1[##1]% hash-ok (compatibility for float)
+    \fi
+    \capstart
+  }{%
+    \if at capstart
+      \PackageWarning{hypcap}{You have forgotten to use \string\caption}%
+      \global\@capstartfalse
+    \else
+    \fi
+    #2%
+  }%
+}
+\DeclareOption{figure}{\hypcapredef{\CurrentOption}}
+\DeclareOption{figure*}{\hypcapredef{\CurrentOption}}
+\DeclareOption{table}{\hypcapredef{\CurrentOption}}
+\DeclareOption{table*}{\hypcapredef{\CurrentOption}}
+\DeclareOption{all}{%
+  \hypcapredef{figure}%
+  \hypcapredef{figure*}%
+  \hypcapredef{table}%
+  \hypcapredef{table*}%
+}
+\ProcessOptions\relax
+\endinput
+%%
+%% End of file `hypcap.sty'.


Property changes on: trunk/Master/texmf-dist/tex/latex/hypcap/hypcap.sty
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/Master/tlpkg/bin/tlpkg-ctan-check
===================================================================
--- trunk/Master/tlpkg/bin/tlpkg-ctan-check	2024-07-27 20:45:22 UTC (rev 71911)
+++ trunk/Master/tlpkg/bin/tlpkg-ctan-check	2024-07-27 20:47:17 UTC (rev 71912)
@@ -423,7 +423,7 @@
     hpsdiss href-ul hrefhide hrlatex
     hu-berlin-bundle huawei huaz huffman hulipsum hustthesis
     hvarabic hvextern hvfloat hvindex hvlogos hvpygmentex hvqrurl
-    hwemoji hycolor hypdestopt hypdoc hypdvips
+    hwemoji hycolor hypcap hypdestopt hypdoc hypdvips
     hyper hyperbar hypernat hyperref hyperxmp
     hyph-utf8 hyphen-base
     hyphenat hyphenex hyplain

Modified: trunk/Master/tlpkg/libexec/ctan2tds
===================================================================
--- trunk/Master/tlpkg/libexec/ctan2tds	2024-07-27 20:45:22 UTC (rev 71911)
+++ trunk/Master/tlpkg/libexec/ctan2tds	2024-07-27 20:47:17 UTC (rev 71912)
@@ -3329,6 +3329,7 @@
  'hu-berlin-bundle' => 'luatex',
  'hycolor'	=> 'tex',
  'hypdestopt'	=> 'etex',
+ 'hypcap'	=> 'tex',
  'hypdoc'	=> 'tex',
  'hyperbar'	=> 'tex',
  'inputnormalization' => 'etex -8bit',

Modified: trunk/Master/tlpkg/tlpsrc/collection-latex.tlpsrc
===================================================================
--- trunk/Master/tlpkg/tlpsrc/collection-latex.tlpsrc	2024-07-27 20:45:22 UTC (rev 71911)
+++ trunk/Master/tlpkg/tlpsrc/collection-latex.tlpsrc	2024-07-27 20:47:17 UTC (rev 71912)
@@ -31,6 +31,7 @@
 depend grfext
 depend hopatch
 depend hycolor
+depend hypcap
 depend hyperref
 depend intcalc
 depend kvdefinekeys

Added: trunk/Master/tlpkg/tlpsrc/hypcap.tlpsrc
===================================================================


More information about the tex-live-commits mailing list.