[latex3-commits] [latex3/xcolor] main: only warn with usenames, issue #31 (c74a17b)

[github at latex-project.org]

Repository : https://github.com/latex3/xcolor
On branch  : main
Link       : https://github.com/latex3/xcolor/commit/c74a17bfb178092afb3bd2bcdfbd0ddf474f2221

>---------------------------------------------------------------

commit c74a17bfb178092afb3bd2bcdfbd0ddf474f2221
Author: Ulrike Fischer <fischer at troubleshooting-tex.de>
Date:   Wed Nov 15 18:25:34 2023 +0100

    only warn with usenames, issue #31


>---------------------------------------------------------------

c74a17bfb178092afb3bd2bcdfbd0ddf474f2221
 ChangeLog  |  5 ++++-
 xcolor.dtx | 37 +++++++++++++++++++++++++------------
 2 files changed, 29 insertions(+), 13 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 7608690..a85977f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -3,12 +3,15 @@ https://github.com/latex3/xcolor/issues
 
 History
 =======
+2023/11/15 v3.01
+* only warn and not error if obsolete option usenames is used, issue #31
+
 2023/11/11 v3.00
 * If a LaTeX older than 2022-06-01 is detected a frozen version is used.
   All new features apply only if LaTeX 2022-06-01 or newer is detected.
   The frozen version can also be requested with \usepackage{xcolor}[=v2]. 
 * The new LaTeX key/val handler is used for the package options. That means there
-  will be less option clash errors, issue #29
+  will be fewer option clash errors, issue #29
 * The \rowcolors command has moved to the colortbl package
 * The fixpdftex option is obsolete and does nothing at all (issue #20)
 * Extended \normalcolor to set also the "dot" color, issue #19
diff --git a/xcolor.dtx b/xcolor.dtx
index 8e914bc..5af5459 100644
--- a/xcolor.dtx
+++ b/xcolor.dtx
@@ -18,8 +18,8 @@
 %%
 %</package>
 %<*extract|driver|test1|test2|test3|test4>
-\def\XCfileversion{v3.00}%
-\def\XCfiledate{2023/11/11}%
+\def\XCfileversion{v3.01}%
+\def\XCfiledate{2023/11/15}%
 %</extract|driver|test1|test2|test3|test4>
 %
 % This file may be distributed and/or modified under the
@@ -3143,6 +3143,10 @@
 %
 % \subsection*{History}
 % \addcontentsline{toc}{subsection}{History}
+% \subsubsection*{2023/11/15 v3.01}
+% \begin{itemize}
+% \item only warn and not error if obsolete option usenames is used (issue \#31)
+% \end{itemize}
 % \subsubsection*{2023/11/11 v3.00}
 % \begin{itemize}
 % \item if a \LaTeX{} older than 2022-06-01 is detected a frozen version is used.
@@ -4031,17 +4035,9 @@
  {
     table .code  ={\AddToHook{package/xcolor/after}{\RequirePackage{colortbl}}}
    ,table .usage = preamble
-%    \end{macrocode}
-%
-% These options are obsolete and only added for compatibility.
-%    \begin{macrocode}
-   ,hyperref  .code = {}
-   ,fixpdftex .code = {}
  }
 %    \end{macrocode}
 %
-%
-%
 % \subsubsection{Driver options}
 %
 % \begin{macro}{\Gin at driver}
@@ -4115,7 +4111,25 @@
   }
 %    \end{macrocode}
 %
-% All other options (including \LC's \oOption{usenames}, \oOption{nodvipsnames}) error.
+% \subsubsection{Obsolete options}
+% The following options are obsolete but perhaps still around in the wild,
+% so we generate a warning.
+%    \begin{macrocode}
+\DeclareKeys
+ {
+   ,usenames   .code    =
+     {\PackageWarning{xcolor}{Package option `usenames' is obsolete and ignored}}
+   ,usename    .usage   = preamble
+   ,hyperref   .code    =
+     {\PackageWarning{xcolor}{Package option `hyperref' is obsolete and ignored}}
+   ,hyperref   .usage   = preamble
+   ,fixpdftex  .code    =
+     {\PackageWarning{xcolor}{Package option `fixpdftex' is obsolete and ignored}}
+   ,fixpdftex  .usage   = preamble
+ }
+%    \end{macrocode}
+%
+% All other options (including \LC's \oOption{nodvipsnames}) error.
 %
 % Choose default options:
 %    \begin{macrocode}
@@ -4125,7 +4139,6 @@
 \SetKeys{natural,showerrors}
 %    \end{macrocode}
 %
-%
 % \subsubsection{Processing options}
 %
 % A local configuration file may declare more options.