[latex3-commits] [git/LaTeX3-latex3-latex3] master: Rearrange where some internals are documents [ci skip] (e8b6636)
Joseph Wright
joseph.wright at morningstar2.co.uk
Mon Apr 2 19:08:15 CEST 2018
Repository : https://github.com/latex3/latex3
On branch : master
Link : https://github.com/latex3/latex3/commit/e8b66368594a16a2a15339bb3d3e2b13f84bec04
>---------------------------------------------------------------
commit e8b66368594a16a2a15339bb3d3e2b13f84bec04
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date: Mon Apr 2 18:08:15 2018 +0100
Rearrange where some internals are documents [ci skip]
>---------------------------------------------------------------
e8b66368594a16a2a15339bb3d3e2b13f84bec04
l3kernel/l3basics.dtx | 110 ++++++++++++++++++++++++-------------------------
l3kernel/l3prop.dtx | 54 ++++++++++++------------
2 files changed, 80 insertions(+), 84 deletions(-)
diff --git a/l3kernel/l3basics.dtx b/l3kernel/l3basics.dtx
index 3d93b65..b8c82ec 100644
--- a/l3kernel/l3basics.dtx
+++ b/l3kernel/l3basics.dtx
@@ -1148,62 +1148,6 @@
% execute <false code>. Similar for the other functions.
% \end{function}
%
-% \section{Internal kernel functions}
-%
-% \begin{function}{\__cs_count_signature:N}
-% \begin{syntax}
-% \cs{__cs_count_signature:N} \meta{function}
-% \end{syntax}
-% Splits the \meta{function} into the \meta{name} (\emph{i.e.}~the part
-% before the colon) and the \meta{signature} (\emph{i.e.}~after the colon).
-% The \meta{number} of tokens in the \meta{signature} is then left in
-% the input stream. If there was no \meta{signature} then the result is
-% the marker value $-1$.
-% \end{function}
-%
-% \begin{function}[EXP]{\__cs_split_function:NN}
-% \begin{syntax}
-% \cs{__cs_split_function:NN} \meta{function} \meta{processor}
-% \end{syntax}
-% Splits the \meta{function} into the \meta{name} (\emph{i.e.}~the part
-% before the colon) and the \meta{signature} (\emph{i.e.}~after the colon).
-% This information is then placed in the input stream after the
-% \meta{processor} function in three parts: the \meta{name}, the
-% \meta{signature} and a logic token indicating if a colon was found
-% (to differentiate variables from function names). The \meta{name}
-% does not include the escape character, and both the \meta{name} and
-% \meta{signature} are made up of tokens with category code $12$
-% (other). The \meta{processor} should be a function with argument
-% specification \texttt{:nnN} (plus any trailing arguments needed).
-% \end{function}
-%
-% \begin{function}[EXP]{\__cs_get_function_name:N}
-% \begin{syntax}
-% \cs{__cs_get_function_name:N} \meta{function}
-% \end{syntax}
-% Splits the \meta{function} into the \meta{name} (\emph{i.e.}~the part
-% before the colon) and the \meta{signature} (\emph{i.e.}~after the colon).
-% The \meta{name} is then left in the input stream without the escape
-% character present made up of tokens with category code $12$
-% (other).
-% \end{function}
-%
-% \begin{function}[EXP]{\__cs_get_function_signature:N}
-% \begin{syntax}
-% \cs{__cs_get_function_signature:N} \meta{function}
-% \end{syntax}
-% Splits the \meta{function} into the \meta{name} (\emph{i.e.}~the part
-% before the colon) and the \meta{signature} (\emph{i.e.}~after the colon).
-% The \meta{signature} is then left in the input stream made up of
-% tokens with category code $12$ (other).
-% \end{function}
-%
-% \begin{function}{\__cs_tmp:w}
-% Function used for various short-term usages, for instance defining
-% functions whose definition involves tokens which are hard to insert
-% normally (spaces, characters with category other).
-% \end{function}
-%
% \end{documentation}
%
% \begin{implementation}
@@ -2466,6 +2410,60 @@
%<@@=cs>
% \end{macrocode}
%
+% \begin{function}{\__cs_count_signature:N}
+% \begin{syntax}
+% \cs{__cs_count_signature:N} \meta{function}
+% \end{syntax}
+% Splits the \meta{function} into the \meta{name} (\emph{i.e.}~the part
+% before the colon) and the \meta{signature} (\emph{i.e.}~after the colon).
+% The \meta{number} of tokens in the \meta{signature} is then left in
+% the input stream. If there was no \meta{signature} then the result is
+% the marker value $-1$.
+% \end{function}
+%
+% \begin{function}[EXP]{\__cs_split_function:NN}
+% \begin{syntax}
+% \cs{__cs_split_function:NN} \meta{function} \meta{processor}
+% \end{syntax}
+% Splits the \meta{function} into the \meta{name} (\emph{i.e.}~the part
+% before the colon) and the \meta{signature} (\emph{i.e.}~after the colon).
+% This information is then placed in the input stream after the
+% \meta{processor} function in three parts: the \meta{name}, the
+% \meta{signature} and a logic token indicating if a colon was found
+% (to differentiate variables from function names). The \meta{name}
+% does not include the escape character, and both the \meta{name} and
+% \meta{signature} are made up of tokens with category code $12$
+% (other). The \meta{processor} should be a function with argument
+% specification \texttt{:nnN} (plus any trailing arguments needed).
+% \end{function}
+%
+% \begin{function}[EXP]{\__cs_get_function_name:N}
+% \begin{syntax}
+% \cs{__cs_get_function_name:N} \meta{function}
+% \end{syntax}
+% Splits the \meta{function} into the \meta{name} (\emph{i.e.}~the part
+% before the colon) and the \meta{signature} (\emph{i.e.}~after the colon).
+% The \meta{name} is then left in the input stream without the escape
+% character present made up of tokens with category code $12$
+% (other).
+% \end{function}
+%
+% \begin{function}[EXP]{\__cs_get_function_signature:N}
+% \begin{syntax}
+% \cs{__cs_get_function_signature:N} \meta{function}
+% \end{syntax}
+% Splits the \meta{function} into the \meta{name} (\emph{i.e.}~the part
+% before the colon) and the \meta{signature} (\emph{i.e.}~after the colon).
+% The \meta{signature} is then left in the input stream made up of
+% tokens with category code $12$ (other).
+% \end{function}
+%
+% \begin{function}{\__cs_tmp:w}
+% Function used for various short-term usages, for instance defining
+% functions whose definition involves tokens which are hard to insert
+% normally (spaces, characters with category other).
+% \end{function}
+%
% \begin{macro}[EXP]{\cs_to_str:N}
% \begin{macro}[EXP]{\@@_to_str:N, \@@_to_str:w}
% This converts a control sequence into the character string of its
diff --git a/l3kernel/l3prop.dtx b/l3kernel/l3prop.dtx
index 00b9872..1e772b9 100644
--- a/l3kernel/l3prop.dtx
+++ b/l3kernel/l3prop.dtx
@@ -447,7 +447,32 @@
% A permanently-empty property list used for internal comparisons.
% \end{variable}
%
-% \section{Internal property list functions}
+% \end{documentation}
+%
+% \begin{implementation}
+%
+% \section{\pkg{l3prop} implementation}
+%
+% \TestFiles{m3prop001, m3prop002, m3prop003, m3prop004, m3show001}
+%
+% \begin{macrocode}
+%<*initex|package>
+% \end{macrocode}
+%
+% \begin{macrocode}
+%<@@=prop>
+% \end{macrocode}
+%
+% A property list is a macro whose top-level expansion is of the form
+% \begin{quote}
+% \cs{s_@@}
+% \cs{@@_pair:wn} \meta{key_1} \cs{s_@@} \Arg{value_1} \\
+% \ldots{} \\
+% \cs{@@_pair:wn} \meta{key_n} \cs{s_@@} \Arg{value_n} \\
+% \end{quote}
+% where \cs{s_@@} is a scan mark
+% (equal to \cs{scan_stop:}), and \cs{@@_pair:wn} can be used to map
+% through the property list.
%
% \begin{variable}{\s__prop}
% The internal token used at the beginning of property lists. This is
@@ -495,33 +520,6 @@
% The \meta{key} comparison takes place as described for \cs{str_if_eq:nn}.
% \end{function}
%
-% \end{documentation}
-%
-% \begin{implementation}
-%
-% \section{\pkg{l3prop} implementation}
-%
-% \TestFiles{m3prop001, m3prop002, m3prop003, m3prop004, m3show001}
-%
-% \begin{macrocode}
-%<*initex|package>
-% \end{macrocode}
-%
-% \begin{macrocode}
-%<@@=prop>
-% \end{macrocode}
-%
-% A property list is a macro whose top-level expansion is of the form
-% \begin{quote}
-% \cs{s_@@}
-% \cs{@@_pair:wn} \meta{key_1} \cs{s_@@} \Arg{value_1} \\
-% \ldots{} \\
-% \cs{@@_pair:wn} \meta{key_n} \cs{s_@@} \Arg{value_n} \\
-% \end{quote}
-% where \cs{s_@@} is a scan mark
-% (equal to \cs{scan_stop:}), and \cs{@@_pair:wn} can be used to map
-% through the property list.
-%
% \begin{macro}{\s_@@}
% A private scan mark is used as a marker after each key, and at the
% very beginning of the property list.
More information about the latex3-commits
mailing list