CTAN sync 202312090303

1 files changed, 10 insertions, 24 deletions

diff --git a/macros/latex/contrib/l3kernel/l3file.dtx b/macros/latex/contrib/l3kernel/l3file.dtx
index 6af1bc4c00..8545a83947 100644
--- a/macros/latex/contrib/l3kernel/l3file.dtx
+++ b/macros/latex/contrib/l3kernel/l3file.dtx
@@ -44,7 +44,7 @@
 %    }^^A
 % }
 %
-% \date{Released 2023-11-09}
+% \date{Released 2023-12-08}
 %
 % \maketitle
 %
@@ -716,7 +716,8 @@
 %     \cs{file_if_exist_p:n} \Arg{file name}
 %     \cs{file_if_exist:nTF} \Arg{file name} \Arg{true code} \Arg{false code}
 %   \end{syntax}
-%   Searches for \meta{file name} using the current \TeX{} search
+%   Expands the argument of the \cs{file name} to give a string, then
+%   searches for this string using the current \TeX{} search
 %   path and the additional paths controlled by
 %   \cs{l_file_search_path_seq}.
 % \end{function}
@@ -724,10 +725,10 @@
 % \begin{function}[noTF, added = 2019-01-16, updated = 2019-02-16]
 %   {\file_get:nnN, \file_get:VnN}
 %   \begin{syntax}
-%     \cs{file_get:nnN} \Arg{filename} \Arg{setup} \meta{tl}
-%     \cs{file_get:nnNTF} \Arg{filename} \Arg{setup} \meta{tl} \Arg{true code} \Arg{false code}
+%     \cs{file_get:nnN} \Arg{file name} \Arg{setup} \meta{tl}
+%     \cs{file_get:nnNTF} \Arg{file name} \Arg{setup} \meta{tl} \Arg{true code} \Arg{false code}
 %   \end{syntax}
-%   Defines \meta{tl} to the contents of \meta{filename}.
+%   Defines \meta{tl} to the contents of \meta{file name}.
 %   Category codes may need to be set appropriately via the \meta{setup}
 %   argument.
 %   The non-branching version sets the \meta{tl} to \cs{q_no_value} if the file is
@@ -2546,21 +2547,6 @@
 %    \end{macrocode}
 % \end{macro}
 %
-% \subsection{Deprecated functions}
-%
-% \begin{macro}
-%   {
-%     \iow_shipout_x:Nn, \iow_shipout_x:Nx,
-%     \iow_shipout_x:cn, \iow_shipout_x:cx
-%   }
-%   Previously described as \texttt{x}-type, but the hash behaviour is really
-%   \texttt{e}-type.
-%    \begin{macrocode}
-\cs_new_eq:NN \iow_shipout_x:Nn \iow_shipout_e:Nn
-\cs_generate_variant:Nn \iow_shipout_x:Nn { Nx , c, cx }
-%    \end{macrocode}
-% \end{macro}
-%
 %    \begin{macrocode}
 %<@@=file>
 %    \end{macrocode}
@@ -3359,7 +3345,7 @@
 %   {
 %     \file_compare_timestamp:nNn,
 %     \file_compare_timestamp:nNV,
-%     \file_compare_timestamp:VNn
+%     \file_compare_timestamp:VNn,
 %     \file_compare_timestamp:VNV
 %   }
 % \begin{macro}[EXP]{\@@_compare_timestamp:nnN}
@@ -3415,7 +3401,7 @@
 % \end{macro}
 % \end{macro}
 %
-% \begin{macro}[TF]{\file_if_exist:n, \file_if_exist:V}
+% \begin{macro}[pTF]{\file_if_exist:n, \file_if_exist:V}
 %   The test for the existence of a file is a wrapper around the function to
 %   add a path to a file. If the file was found, the path contains
 %   something, whereas if the file was not located then the return value
@@ -3569,8 +3555,8 @@
 %    \end{macrocode}
 % \end{macro}
 %
-% \begin{macro}{\file_parse_full_name:n, \file_parse_full_name:nV}
-% \begin{macro}{\file_parse_full_name_apply:nN \file_parse_full_name_apply:VN}
+% \begin{macro}{\file_parse_full_name:n, \file_parse_full_name:V}
+% \begin{macro}{\file_parse_full_name_apply:nN, \file_parse_full_name_apply:VN}
 %   The main parsing macro \cs{file_parse_full_name_apply:nN} passes the
 %   file name |#1| through \cs{__kernel_file_name_sanitize:n} so that we
 %   have a single normalised way to treat files internally.