texlive[74757] Master/texmf-dist: collref (26mar25)
commits+karl at tug.org
commits+karl at tug.org
Wed Mar 26 21:03:52 CET 2025
Revision: 74757
https://tug.org/svn/texlive?view=revision&revision=74757
Author: karl
Date: 2025-03-26 21:03:52 +0100 (Wed, 26 Mar 2025)
Log Message:
-----------
collref (26mar25)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/latex/collref/README.txt
trunk/Master/texmf-dist/doc/latex/collref/collref.pdf
trunk/Master/texmf-dist/doc/latex/collref/collsamp.tex
trunk/Master/texmf-dist/source/latex/collref/collref.dtx
trunk/Master/texmf-dist/source/latex/collref/collref.ins
trunk/Master/texmf-dist/tex/latex/collref/collref.sty
Modified: trunk/Master/texmf-dist/doc/latex/collref/README.txt
===================================================================
--- trunk/Master/texmf-dist/doc/latex/collref/README.txt 2025-03-26 20:03:43 UTC (rev 74756)
+++ trunk/Master/texmf-dist/doc/latex/collref/README.txt 2025-03-26 20:03:52 UTC (rev 74757)
@@ -1,5 +1,5 @@
-collref v2.0c
-Copyright 2003-2018 Niklas Beisert
+collref v2.0.4
+Copyright 2003-2025 Niklas Beisert
collref is a LaTeX2e package to automatically collect
multiple \bibitem references which always appear in the same sequence
@@ -19,15 +19,15 @@
Run "(pdf)latex collref.dtx" to compile the manual collref.pdf.
-Run "tex collref.ins" to create the package collref.sty
+Run "latex collref.ins" to create the package collref.sty
and the sample collsamp.tex.
-Copy the file collref.sty to an appropriate directory of your LaTeX
-distribution, e.g. texmf-root/tex/latex/collref.
+Copy the file collref.sty to an appropriate directory
+of your LaTeX distribution, e.g. texmf-root/tex/latex/collref.
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.
+ https://www.latex-project.org/lppl.txt
+and version 1.3c or later is part of all distributions of LaTeX
+version 2008 or later.
Modified: trunk/Master/texmf-dist/doc/latex/collref/collref.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/collref/collsamp.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/collref/collsamp.tex 2025-03-26 20:03:43 UTC (rev 74756)
+++ trunk/Master/texmf-dist/doc/latex/collref/collsamp.tex 2025-03-26 20:03:52 UTC (rev 74757)
@@ -6,18 +6,18 @@
%%
%% collref.dtx (with options: `sample')
%%
-%% Copyright (C) 2003-2018 Niklas Beisert
+%% Copyright (C) 2003-2025 Niklas Beisert
%%
%% 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.
+%% https://www.latex-project.org/lppl.txt
+%% and version 1.3c or later is part of all distributions of LaTeX
+%% version 2008 or later.
%%
\NeedsTeXFormat{LaTeX2e}[1996/12/01]
-\ProvidesFile{collsamp.tex}[2018/01/17 v2.0c Sample for Collect References]
+\ProvidesFile{collsamp.tex}[2025/03/25 v2.0.4 Sample for Collect References]
\documentclass{article}
%%\usepackage{cite}
Modified: trunk/Master/texmf-dist/source/latex/collref/collref.dtx
===================================================================
--- trunk/Master/texmf-dist/source/latex/collref/collref.dtx 2025-03-26 20:03:43 UTC (rev 74756)
+++ trunk/Master/texmf-dist/source/latex/collref/collref.dtx 2025-03-26 20:03:52 UTC (rev 74757)
@@ -1,14 +1,15 @@
-% \iffalse
%
-% collref.dtx Copyright (C) 2003-2018 Niklas Beisert
+% \iffalse meta-comment
%
+% collref.dtx Copyright (C) 2003-2025 Niklas Beisert
+%
% 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.
+% https://www.latex-project.org/lppl.txt
+% and version 1.3c or later is part of all distributions of LaTeX
+% version 2008 or later.
%
% This work has the LPPL maintenance status `maintained'.
%
@@ -18,34 +19,52 @@
% and the derived files collref.sty and collsamp.tex
%
%<package|sample>\NeedsTeXFormat{LaTeX2e}[1996/12/01]
-%<package>\ProvidesPackage{collref}[2018/01/17 v2.0c Collect References]
-%<sample>\ProvidesFile{collsamp.tex}[2018/01/17 v2.0c Sample for Collect References]
+%<package>\ProvidesPackage{collref}[2025/03/25 v2.0.4 Collect References]
+%<sample>\ProvidesFile{collsamp.tex}[2025/03/25 v2.0.4 Sample for Collect References]
%<*driver>
-%\ProvidesFile{collref.drv}[2018/01/17 v2.0c Collect References Manual file]
+\def\thedate#1{2025/03/25}\def\theversion#1{v2.0.4}
+\ProvidesFile{collref.dtx}[\thedate{} \theversion{} collref reference manual file]
\PassOptionsToClass{10pt,a4paper}{article}
\documentclass{ltxdoc}
\usepackage[margin=35mm]{geometry}
-\usepackage{hyperref}
+\usepackage[hyperindex=false]{hyperref}
\usepackage{hyperxmp}
+\usepackage[usenames]{color}
-\hypersetup{colorlinks=true}
-\hypersetup{pdfstartview=FitH}
-\hypersetup{pdfpagemode=UseNone}
+\AddToHook{begindocument/before}{\hypersetup{colorlinks=false}}
+\hypersetup{urlbordercolor={.5 1 1}}
+\hypersetup{linkbordercolor={1 .7 .7}}
+\AddToHook{begindocument/before}{\hypersetup{pdfstartview=FitH}}
+\hypersetup{keeppdfinfo=true}
\hypersetup{pdfsource={}}
\hypersetup{pdflang={en-UK}}
-\hypersetup{pdfcopyright={Copyright 2003-2018 Niklas Beisert.
+\hypersetup{pdfurl={https://ctan.org/pkg/collref}}
+\hypersetup{pdfcopyright={Copyright 2003-2025 Niklas Beisert.
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.}}
-\hypersetup{pdflicenseurl={http://www.latex-project.org/lppl.txt}}
-\hypersetup{pdfcontactaddress={ETH Zurich, ITP, HIT K, Wolfgang-Pauli-Strasse 27}}
+\hypersetup{pdflicenseurl={https://www.latex-project.org/lppl.txt}}
+\hypersetup{pdfcontactaddress={ETH Zurich, ITP, HIT K,
+ Wolfgang-Pauli-Strasse 27}}
\hypersetup{pdfcontactpostcode={8093}}
\hypersetup{pdfcontactcity={Zurich}}
\hypersetup{pdfcontactcountry={Switzerland}}
\hypersetup{pdfcontactemail={nbeisert at itp.phys.ethz.ch}}
-\hypersetup{pdfcontacturl={http://people.phys.ethz.ch/\xmptilde nbeisert/}}
+\hypersetup{pdfcontacturl={https://people.phys.ethz.ch/\xmptilde nbeisert/}}
+\newcommand{\markpkg}[1]{\textsf{#1}}
+\newcommand{\secref}[1]{\hyperref[#1]{section \ref*{#1}}}
+\newcommand{\ctanref}[2]{\href{https://ctan.org/#1}{#2}}
+\newcommand{\ctanpkg}[1]{\ctanref{pkg/#1}{\markpkg{#1}}}
+
+\def\textvert{\texttt{\char"7C}}
+
+\parskip1ex
+\parindent0pt
+\let\olditemize\itemize
+\def\itemize{\olditemize\parskip0pt}
+
\newenvironment{thebib}
{\list{[\theenumi]}{\parsep0pt\usecounter{enumi}}}
{\endlist}
@@ -52,7 +71,7 @@
\begin{document}
-\title{The \textsf{collref} Package\thanks{%
+\title{The \markpkg{collref} Package\thanks{%
Earlier versions developed at: Max-Planck-Institut f\"ur Gravitationsphysik
(Albert-Einstein-Institut), Potsdam, Germany;
\texttt{AEI-2009-054}}}
@@ -65,16 +84,20 @@
{\texttt{nbeisert at itp.phys.ethz.ch}}}
\hypersetup{pdfauthor={Niklas Beisert}}
\hypersetup{pdfsubject={Manual for the LaTeX2e Package collref}}
-\date{17 January 2018, \textsf{v2.0c}}
+\date{\thedate{}, \theversion{}\\[1ex]
+\url{https://ctan.org/pkg/collref}}
\maketitle
\begin{abstract}\noindent
-\textsf{collref} is a \LaTeXe{} package to automatically collect
+\markpkg{collref} is a \LaTeXe{} package to automatically collect
multiple |\bibitem| references which always appear in the same sequence
in |\cite| into a single |\bibitem| block.
\end{abstract}
+\begingroup
+\parskip0ex
\tableofcontents
+\endgroup
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -103,13 +126,13 @@
\end{thebib}
%
and cite it by ``[\ldots, 2, \ldots]''.
-The package \textsf{collref} automates this process
+The package \ctanpkg{collref} automates this process
by analysing the |\cite| commands
and identifying blocks of references
which always appear in conjunction.
These blocks are collapsed to a single item
in the bibliography.
-Please note that \textsf{collref} requires the sequence
+Please note that \ctanpkg{collref} requires the sequence
of |\bibitem| entries to match with
the sequence of |\cite| blocks.
This is most easily achieved through the use of \BibTeX{}
@@ -123,7 +146,7 @@
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\paragraph{Inclusion.}
-To use \textsf{collref} simply add the command
+To use \ctanpkg{collref} simply add the command
\begin{center}|\usepackage{collref}|\end{center}
to the preamble of your \LaTeX{} document.
No further interaction is required.
@@ -131,7 +154,7 @@
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\paragraph{Punctuation.}
-\textsf{collref} provide basic punctuation between collected references.
+\ctanpkg{collref} provide basic punctuation between collected references.
This is specified through the package options
|\usepackage[|\textit{opt}|]{collref}|
where \textit{opt} is one of the following
@@ -196,12 +219,12 @@
but preserves the order in which they were |\cite|'d,
e.g.\ \texttt{unsrt.bst}.
-Also note that \textsf{collref} suppresses
+Also note that \ctanpkg{collref} suppresses
new paragraphs invoked by empty lines in the bibliography.
This allows to use standard \BibTeX{} styles
which commonly separate reference entries by empty lines.
If these empty lines would be expanded to new paragraphs,
-\textsf{collref} would not be able to join two references properly.
+\ctanpkg{collref} would not be able to join two references properly.
Therefore new paragraphs have to be invoked by the
command |\par|.
@@ -234,7 +257,7 @@
\paragraph{Control.}
-The package \textsf{collref} provides one command to control
+The package \ctanpkg{collref} provides one command to control
which references (not) to collect:
%
\begin{center}
@@ -250,7 +273,7 @@
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\paragraph{Labels for Blocks of References.}
-While \textsf{collref} aims to automatically
+While \ctanpkg{collref} aims to automatically
collect similar references into a single block, it is often
convenient for the author to refer to such blocks
with a single citation label.
@@ -269,19 +292,15 @@
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\subsection{Copyright}
-\begingroup
-\parskip1ex
-\parindent0pt
+Copyright \copyright{} 2003--2025 Niklas Beisert
-Copyright \copyright{} 2003--2018 Niklas Beisert
-
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
- \url{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.
+ \url{https://www.latex-project.org/lppl.txt}
+and version 1.3c or later is part of all distributions of \LaTeX{}
+version 2008 or later.
This work has the LPPL maintenance status `maintained'.
@@ -290,8 +309,6 @@
This work consists of the files |README.txt|, |collref.ins| and |collref.dtx|
as well as the derived files |collref.sty|, |collsamp.tex| and |collref.pdf|.
-\endgroup
-
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\subsection{Files and Installation}
@@ -299,12 +316,12 @@
%
\begin{center}
\begin{tabular}{ll}
- |README.txt| & readme file \\
- |collref.ins| & installation file \\
- |collref.dtx| & source file \\
- |collref.sty| & package file \\
- |collsamp.tex|& sample file \\
- |collref.pdf| & manual
+ |README.txt| & readme file \\
+ |collref.ins| & installation file \\
+ |collref.dtx| & source file \\
+ |collref.sty| & package file \\
+ |collsamp.tex| & sample file \\
+ |collref.pdf| & manual
\end{tabular}
\end{center}
%
@@ -320,8 +337,6 @@
and the sample |collsamp.tex|.
Copy the file |collref.sty| to an appropriate directory of your \LaTeX{}
distribution, e.g.\ \textit{texmf-root}|/tex/latex/collref|.
-Alternatively, you may copy |collref.sty| to the local directories of
-manuscripts for which you wish to use \textsf{collref}.
\end{itemize}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
@@ -328,53 +343,51 @@
\subsection{Related CTAN Packages}
The objective and some of the implementation
-of the \textsf{collref} package is similar to the CTAN packages
-\href{http://www.ctan.org/pkg/mcite}
-{\textsf{mcite}} by Thorsten Ohl
-and \href{http://www.ctan.org/pkg/mciteplus}
-{\textsf{mciteplus}} by Michael Shell,
+of the \ctanpkg{collref} package is similar to the CTAN packages
+\ctanpkg{mcite} by Thorsten Ohl
+and \ctanpkg{mciteplus} by Michael Shell,
but the functionality is different is several respects:
%
\begin{itemize}
\item
-\textsf{collref} is intended to work transparently:
-\LaTeX{} documents which compile with \textsf{collref}
-should also compile fine without invoking \textsf{collref}
+\ctanpkg{collref} is intended to work transparently:
+\LaTeX{} documents which compile with \ctanpkg{collref}
+should also compile fine without invoking \ctanpkg{collref}
(obviously without collected references).
The package decides automatically which references
can be collapsed,
no further interaction of the author is required.
-\textsf{mcite} and \textsf{mciteplus} leave the
+\ctanpkg{mcite} and \ctanpkg{mciteplus} leave the
decision/duty to collapse certain references
using the modified syntax |\cite{A,*B,*C}|.
\item
-\textsf{mcite} and \textsf{mciteplus} are intended to handle punctuations
+\ctanpkg{mcite} and \ctanpkg{mciteplus} are intended to handle punctuations
in collapsed references correctly.
This requires a specialised \BibTeX{} style.
-No effort is made in \textsf{collref} in this regard.
-Some minor modification in \texttt{collref.sty}
+No effort is made in \ctanpkg{collref} in this regard.
+Some minor modification in |collref.sty|
together with a modified \BibTeX{} style
-might achieve basic punctuation features similar to \textsf{mcite}.
+might achieve basic punctuation features similar to \ctanpkg{mcite}.
\end{itemize}
%
-The package \textsf{collref} has been tested with other
+The package \ctanpkg{collref} has been tested with other
CTAN packages concerned with citations and the bibliography:
%
\begin{itemize}
\item
-\textsf{collref} works in conjunction with
-\href{http://www.ctan.org/pkg/cite}{\textsf{cite}}.
-Note that you must load \textsf{cite} \emph{before} \textsf{collref}
+\ctanpkg{collref} works in conjunction with
+\ctanpkg{cite}.
+Note that you must load \ctanpkg{cite} \emph{before} \ctanpkg{collref}
so that the latter can pass the correctly reduced list of
-references down to \textsf{cite}.
+references down to \ctanpkg{cite}.
Tested with v5.1 and v5.3 (2010/09/10).
\item
-\textsf{collref} works in conjunction with
-\href{http://www.ctan.org/pkg/hyperref}{\textsf{hyperref}}.
+\ctanpkg{collref} works in conjunction with
+\ctanpkg{hyperref}.
The two packages can be loaded in any sequence.
Tested with v6.78s and v6.83m (2012/11/06).
@@ -387,6 +400,24 @@
\subsection{Revision History}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\iffalse
+\paragraph{vN.N.N+:} 20YY/MM/NN
+
+\begin{itemize}
+\item
+\ldots
+\end{itemize}
+\fi
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\paragraph{v2.0.4:} 2025/03/25
+
+\begin{itemize}
+\item
+maintenance and manual update
+\end{itemize}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\paragraph{v2.0c:} 2018/01/17
\begin{itemize}
@@ -427,7 +458,7 @@
\item
manual and installation package added
\item
-renamed package to \textsf{collref} due to name clash on CTAN
+renamed package to \ctanpkg{collref} due to name clash on CTAN
\item
first version published on CTAN
\end{itemize}
@@ -437,7 +468,7 @@
\begin{itemize}
\item
-package named \textsf{collect}; unpublished
+package named \markpkg{collect}; unpublished
\end{itemize}
@@ -447,8 +478,6 @@
\appendix
\settowidth\MacroIndent{\rmfamily\scriptsize 000\ }
-\parskip1ex
-\parindent0pt
\DocInput{collref.dtx}
@@ -645,7 +674,7 @@
% \end{macrocode}
% Get content of |\b@|\textit{label} entry to find out
% whether the |\bibitem{label}| entry exists.
-% We need to take special care of extended label definitions in \textsf{hyperref}.
+% We need to take special care of extended label definitions in \ctanpkg{hyperref}.
% \begin{macrocode}
{\def\hyper@@link[##1]##2##3##4{##4}%
\xdef\nc at citelabel{\nc at getcsname{b@\nc at citethis}}}%
@@ -710,7 +739,7 @@
% internals |\@lbibitem| and |\@bibitem|.
% Some other packages may also redefine |\bibitem|
% and this will inevitable cause compatibility issues.
-% This implementation is safe with current versions of \textsf{hyperref}.
+% This implementation is safe with current versions of \ctanpkg{hyperref}.
% \begin{macrocode}
\def\bibitem{\@ifnextchar[\nc at lbibitem\nc at bibitem}
% \end{macrocode}
Modified: trunk/Master/texmf-dist/source/latex/collref/collref.ins
===================================================================
--- trunk/Master/texmf-dist/source/latex/collref/collref.ins 2025-03-26 20:03:43 UTC (rev 74756)
+++ trunk/Master/texmf-dist/source/latex/collref/collref.ins 2025-03-26 20:03:52 UTC (rev 74757)
@@ -2,31 +2,20 @@
\input docstrip.tex
\keepsilent
-% collref.ins Copyright (C) 2003-2018 Niklas Beisert
-%
-% 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.
-
\preamble
-Copyright (C) 2003-2018 Niklas Beisert
+Copyright (C) 2003-2025 Niklas Beisert
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.
+ https://www.latex-project.org/lppl.txt
+and version 1.3c or later is part of all distributions of LaTeX
+version 2008 or later.
\endpreamble
-% the style and sample files
\generate{\askforoverwritefalse
\file{collref.sty}{\from{collref.dtx}{package}}
\file{collsamp.tex}{\from{collref.dtx}{sample}}
Modified: trunk/Master/texmf-dist/tex/latex/collref/collref.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/collref/collref.sty 2025-03-26 20:03:43 UTC (rev 74756)
+++ trunk/Master/texmf-dist/tex/latex/collref/collref.sty 2025-03-26 20:03:52 UTC (rev 74757)
@@ -6,18 +6,18 @@
%%
%% collref.dtx (with options: `package')
%%
-%% Copyright (C) 2003-2018 Niklas Beisert
+%% Copyright (C) 2003-2025 Niklas Beisert
%%
%% 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.
+%% https://www.latex-project.org/lppl.txt
+%% and version 1.3c or later is part of all distributions of LaTeX
+%% version 2008 or later.
%%
\NeedsTeXFormat{LaTeX2e}[1996/12/01]
-\ProvidesPackage{collref}[2018/01/17 v2.0c Collect References]
+\ProvidesPackage{collref}[2025/03/25 v2.0.4 Collect References]
\newcommand{\collectsep}[2][]{\def\nc at punct{#1}\def\nc at sep{#2}}
\newcommand{\nocollect}[1]{\nc at breakbefore{#1}\ignorespaces}
More information about the tex-live-commits
mailing list.