xr-hyper.dtx

% \iffalse meta-comment
%
% Copyright (C) 1993-2026 David Carlisle
%
% This file is part of the `Hyperref Bundle'.
% -------------------------------------------
%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either version 1.3
% of this license or (at your option) any later version.
% The latest version of this license is in
%   http://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 Maintainer of this work is the LaTeX Project.
%
% The list of all files belonging to the `Hyperref Bundle' is
% given in the file `manifest.txt'.
%
% \fi
% \iffalse
%% File: xr-hyper.dtx Copyright (C) 1993-2026 David Carlisle
%
%<package>\NeedsTeXFormat{LaTeX2e}
%<package>\ProvidesPackage{xr-hyper}
%<package>         [2026-11-03 v7.01t eXternal References (DPC)]
%
%<*driver>
\documentclass{l3doc}
\usepackage{xr-hyper}
\GetFileInfo{xr-hyper.sty}
\begin{document}
\title{The \textsf{xr-hyper} package\thanks{This file
        has version number \fileversion, last
        revised \filedate.}}
\author{David Carlisle}
\date{\filedate}
\maketitle
\DocInput{xr-hyper.dtx}
\end{document}
%</driver>
% \fi
%
% \changes{v5.00}{1993/07/07}
%         {First DPC version (by agreement with J-PD).  New mechanism
%         (\cs{read} instead of \cs{input}). (xr)}
%
% \changes{v5.01}{1993/07/20}{Fix bug added by DPC, v5.00 did not import
%           aux files of \cs{include}'ed files. (Reported by J-PD) (xr)}
%
% \changes{v5.02}{1994/05/28}{Update for LaTeX2e}
% \changes{v5.03}{2018/10/01}{Fix for conditionals in aux file (xr)}
% \changes{v5.05}{2019/07/20}{include xcite (xr)}
%
% \changes{v6.00 beta2}{1997/10/06}
%         {}
%
% \changes{v6.00 beta3}{1999/09/01}
%         {Definitions of \cs{XR@addURL} corrected (Heiko Oberdiek)}
%
% \changes{v6.00 beta 4}{2000/03/22}
%         {\cmd\xdef changed to \cs{protected@xdef}} 
%
% \changes{v6.1}{2019/10/03}
%         {Incorporate updates to \pkg{xr} (including citation support)}
%
% \changes{v7.00e}{2020-05-14}
%         {add additional braces to \cs{r@}\meta{label} only if \pkg{hyperref} is not detected in the aux
%          of the source document (https://github.com/latex3/hyperref/issues/118)}
%
% \changes{v7.00z}{2023-05-15}
%         {unified and simplified the brace handling: all defined references have now
%          five brace groups. Together with the planned change in LaTeX 2023-06-01 this
%          will improve the combination of hyperref/non-hyperref documents.}
%          
% \changes{v7.01g}{2023-11-26}
%         {Always store the URL/file name of the external document to allow file links
%          even if it has no destinations.}
%  
% \changes{v7.01h}{2024-01-20}
%         {do not expand the labels when reading, (https://github.com/latex3/hyperref/issues/327)}
%         
% \changes{v7.01h}{2024-01-20}
%         {support \LaTeX\ properties.}
%
% \changes{v7.01h}{2024-01-20}
%         {support \LaTeX\ properties.}       
%                 
% \changes{v7.01t}{2026-11-03}
%         {Make xr-hyper an alias of xr.}       
%
% This package was an extension of the \pkg{xr} package. It was developed to support the
% extended label syntax of the \pkg{hyperref} package and to enable active links
% to the external documents.
% 
% In the \LaTeX{} release 2023-06-01 the label syntax of \pkg{hyperref}
% and the \LaTeX{} kernel were synchronized, and there is no longer
% a need for two packages. 
% 
% \pkg{xr-hyper} is therefore now deprecated. It simply loads the  
% \pkg{xr} package. 
% 
% \section{Usage}
% 
% See the documentation of the \pkg{xr} package. 
%
%    \begin{macrocode}
%<*package>
\RequirePackage{xr}
%</package>
%    \end{macrocode}
% \Finale