Added option suppress-backend-headers

latex3 · Feb 20, 2020 · d9355f3 · d9355f3
1 parent 337c082
commit d9355f3
Show file tree

Hide file tree

Showing 5 changed files with 25 additions and 1 deletion.
diff --git a/l3backend/CHANGELOG.md b/l3backend/CHANGELOG.md
@@ -6,6 +6,10 @@ this project uses date-based 'snapshot' version identifiers.
 
 ## [Unreleased]
 
+### Added
+- Support for suppressing backend headers (see matching change in
+  `l3kernel`)
+
 ## [2020-02-03]
 
 ### Fixed

diff --git a/l3backend/l3backend-basics.dtx b/l3backend/l3backend-basics.dtx
@@ -158,7 +158,10 @@
 \cs_if_exist:NTF \AtBeginDvi
   { \exp_not:N \AtBeginDvi }
   { \use:n }
-    { \__kernel_backend_literal:n { header = l3backend-dvips.pro } }
+    {
+      \bool_if:NT \g__kernel_backend_header_bool
+        { \__kernel_backend_literal:n { header = l3backend-dvips.pro } }
+    }
 %    \end{macrocode}
 %
 % \begin{macro}

diff --git a/l3kernel/CHANGELOG.md b/l3kernel/CHANGELOG.md
@@ -7,6 +7,10 @@ this project uses date-based 'snapshot' version identifiers.
 
 ## [Unreleased]
 
+### Added
+- Option `suppress-backend-headers` (see matching change in
+  `l3backend`)
+
 ### Changed
 - Allow `dvisvgm` driver with XeTeX (issue #677)
 

diff --git a/l3kernel/expl3.dtx b/l3kernel/expl3.dtx
@@ -922,6 +922,12 @@
 %   \item[xdvipdfmx] Use the \texttt{xdvipdfmx} driver (\XeTeX{} only).
 % \end{itemize}
 %
+% \DescribeOption{suppress-backend-headers}
+% The \texttt{suppress-backend-headers} option suppresses loading of
+% backend-specific header files; currently this only affects \texttt{dvips}.
+% This option is available to support DVI-based routes that do not
+% support the |header| line used by \texttt{dvips}.
+%
 % \section{Using \pkg{expl3} with formats other than \LaTeXe{}}
 %
 % As well as the \LaTeXe{} package \pkg{expl3}, there is also a
@@ -1273,6 +1279,9 @@
         \sys_load_debug:
         \debug_on:n { log-functions }
       } ,
+    suppress-backend-headers .bool_set_inverse:N
+      = \g__kernel_backend_header_bool ,
+    suppress-backend-headers .initial:n = false ,
     undo-recent-deprecations .code:n =
       {
         \bool_gset_true:N \g__kernel_deprecation_undo_recent_bool

diff --git a/l3kernel/l3kernel-functions.dtx b/l3kernel/l3kernel-functions.dtx
@@ -504,6 +504,10 @@
 %   Applies the \meta{matrix} to the current transformation matrix.
 % \end{function}
 %
+% \begin{function}{\g__kernel_backend_header_bool}
+%   Specifies whether to write headers for the backend.
+% \end{function}
+%
 % \begin{function}{\l__kernel_color_stack_int}
 %   The color stack used in \pdfTeX{} and \LuaTeX{} for the main color.
 % \end{function}