[latex3-commits] [git/LaTeX3-latex3-latex3] master: Various overful boxes in interface3 [ci skip] (ae8de21)
Joseph Wright
joseph.wright at morningstar2.co.uk
Thu Apr 26 16:31:23 CEST 2018
Repository : https://github.com/latex3/latex3
On branch : master
Link : https://github.com/latex3/latex3/commit/ae8de21c93b362f82c8fa709d28ffe0917e15788
>---------------------------------------------------------------
commit ae8de21c93b362f82c8fa709d28ffe0917e15788
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date: Thu Apr 26 14:44:15 2018 +0100
Various overful boxes in interface3 [ci skip]
>---------------------------------------------------------------
ae8de21c93b362f82c8fa709d28ffe0917e15788
l3kernel/l3candidates.dtx | 8 ++++----
l3kernel/l3drivers.dtx | 2 +-
l3kernel/l3expan.dtx | 16 +++++++++++-----
l3kernel/l3luatex.dtx | 8 ++++++--
l3kernel/l3regex.dtx | 5 +++--
l3kernel/l3token.dtx | 6 +++---
l3kernel/source3body.tex | 11 ++++++++---
7 files changed, 36 insertions(+), 20 deletions(-)
diff --git a/l3kernel/l3candidates.dtx b/l3kernel/l3candidates.dtx
index 88f98ad..9eb2fab 100644
--- a/l3kernel/l3candidates.dtx
+++ b/l3kernel/l3candidates.dtx
@@ -503,8 +503,8 @@
% \begin{syntax}
% \cs{prop_rand_key_value:N} \meta{prop~var}
% \end{syntax}
-% Selects a pseudo-random key--value pair in the \meta{property list}
-% and returns \Arg{key}\Arg{value}. If the \meta{property list} is
+% Selects a pseudo-random key--value pair from the \meta{property list}
+% and returns \Arg{key} and \Arg{value}. If the \meta{property list} is
% empty the result is empty. This is only available in \pdfTeX{} and
% \LuaTeX{}.
% \begin{texnote}
@@ -701,8 +701,8 @@
% \begin{syntax}
% \cs{sys_gset_rand_seed:n} \Arg{intexpr}
% \end{syntax}
-% Sets the seed for the engine's pseudo-random number generator to the
-% \meta{integer expression}. The assignment is global. This random
+% Globally sets the seed for the engine's pseudo-random number generator
+% to the \meta{integer expression}. This random
% seed affects all \cs[no-index]{\ldots{}_rand} functions (such as
% \cs{int_rand:nn} or \cs{clist_rand_item:n}) as well as other
% packages relying on the engine's random number generator. Currently
diff --git a/l3kernel/l3drivers.dtx b/l3kernel/l3drivers.dtx
index 2eb2c06..ecf7e21 100644
--- a/l3kernel/l3drivers.dtx
+++ b/l3kernel/l3drivers.dtx
@@ -267,7 +267,7 @@
% \meta{path construction}
% \cs{driver_draw_stroke:}
% \end{syntax}
-% Draws a line along the current path, which is also closed by
+% Draws a line along the current path, which is also closed in the case of
% \cs{driver_draw_closestroke:}. The nature of the line drawn
% is influenced by settings for
% \begin{itemize}
diff --git a/l3kernel/l3expan.dtx b/l3kernel/l3expan.dtx
index 6cadc05..0e3df67 100644
--- a/l3kernel/l3expan.dtx
+++ b/l3kernel/l3expan.dtx
@@ -246,8 +246,14 @@
% \begin{quote}
% |\example:f { \int_eval:n { 1 + 2 } , \int_eval:n { 3 + 4 } }|
% \end{quote}
-% results in the call |\example:n { 3 , \int_eval:n { 3 + 4 } }|
-% while using |\example:x| instead results in |\example:n { 3 , 7 }|
+% results in the call
+% \begin{quote}
+% |\example:n { 3 , \int_eval:n { 3 + 4 } }|
+% \end{quote}
+% while using |\example:x| instead results in
+% \begin{quote}
+% |\example:n { 3 , 7 }|
+% \end{quote}
% at the cost of being protected.
% If you use this type of expansion in conditional processing then
% you should stick to using |TF| type functions only as the expansion
@@ -707,12 +713,12 @@
% \exp_end:
% }
% \begin{syntax}
-% \cs{exp:w} \meta{expandable-tokens} \cs{exp_end:} \\
+% \cs{exp:w} \meta{expandable tokens} \cs{exp_end:} \\
% \end{syntax}
% Expands \meta{expandable-tokens} until reaching \cs{exp_end:} at
% which point expansion stops.
-% The full expansion of \meta{expandable-tokens} has to be empty.
-% If any token in \meta{expandable-tokens} or any token generated by
+% The full expansion of \meta{expandable tokens} has to be empty.
+% If any token in \meta{expandable tokens} or any token generated by
% expanding the tokens therein is not expandable the expansion will end
% prematurely and as a result \cs{exp_end:} will be misinterpreted
% later on.\footnotemark
diff --git a/l3kernel/l3luatex.dtx b/l3kernel/l3luatex.dtx
index 035156a..d9a4607 100644
--- a/l3kernel/l3luatex.dtx
+++ b/l3kernel/l3luatex.dtx
@@ -151,8 +151,12 @@
% |l3kernel.filemoddate||(|\meta{file}|)|
% \end{syntax}
% Returns the of the date/time of last modification of the \meta{file} in the
-% format |D:|\meta{year}\meta{month}\meta{day}\meta{hour}\meta{minute}^^A
-% \meta{second}\meta{offset}, where the latter may be |Z| (UTC) or
+% format
+% \begin{quote}
+% |D:|\meta{year}\meta{month}\meta{day}\meta{hour}\meta{minute}^^A
+% \meta{second}\meta{offset}
+% \end{quote}
+% where the latter may be |Z| (UTC) or
% \meta{plus-minus}\meta{hours}|'|\meta{minutes}|'|. If the \meta{file} is
% not found, nothing is returned with \emph{no error raised}.
% \end{function}
diff --git a/l3kernel/l3regex.dtx b/l3kernel/l3regex.dtx
index 07a45db..28540b6 100644
--- a/l3kernel/l3regex.dtx
+++ b/l3kernel/l3regex.dtx
@@ -203,7 +203,8 @@
% equivalent to |[\^^J\^^K\^^L\^^M]|. Note that |\^^K| is a vertical space,
% but not a space, for compatibility with Perl.
% \item[\\w] Any word character, \emph{i.e.},
-% alpha-numerics and underscore, equivalent to |[A-Za-z0-9\_]|.
+% alphanumerics and underscore, equivalent to the explicit
+% group |[A-Za-z0-9\_]|.
% \item[\\D] Any token not matched by |\d|.
% \item[\\H] Any token not matched by |\h|.
% \item[\\N] Any token other than the |\n| character (hex 0A).
@@ -716,7 +717,7 @@
% \item If possible, when a state is reused by the same thread, kill
% other subthreads.
% \item Use an array rather than \cs{l__regex_balance_tl}
-% to build \cs{__regex_replacement_balance_one_match:n}.
+% to build the function \cs{__regex_replacement_balance_one_match:n}.
% \item Reduce the number of epsilon-transitions in alternatives.
% \item Optimize simple strings: use less states (|abcade| should give
% two states, for |abc| and |ade|). [Does that really make sense?]
diff --git a/l3kernel/l3token.dtx b/l3kernel/l3token.dtx
index 439bd6b..8a2ab7b 100644
--- a/l3kernel/l3token.dtx
+++ b/l3kernel/l3token.dtx
@@ -1021,9 +1021,9 @@
% expandable) results in an internal token, displayed (temporarily)
% as \cs{notexpanded: \meta{token}}, whose shape coincides with the
% \meta{token} and whose meaning differs from \tn{relax}.
-% \item An |\outer endtemplate:| (expanding to another internal token,
-% |end of alignment template|) can be encountered when peeking ahead
-% at the next token.
+% \item An |\outer endtemplate:| can be encountered when peeking ahead
+% at the next token; this expands to another internal token,
+% |end of alignment template|.
% \item Tricky programming might access a frozen |\endwrite|.
% \item Some frozen tokens can only be accessed in interactive
% sessions: |\cr|, |\right|, |\endgroup|, |\fi|, |\inaccessible|.
diff --git a/l3kernel/source3body.tex b/l3kernel/source3body.tex
index 4489d03..25495d1 100644
--- a/l3kernel/source3body.tex
+++ b/l3kernel/source3body.tex
@@ -335,9 +335,14 @@ without repetition, this information is given in a shortened form:
\begin{syntax}
|\sys_if_engine_xetex:TF| \Arg{true code} \Arg{false code}
\end{syntax}
- The underlining and italic of \texttt{TF} indicates that
- |\sys_if_engine_xetex:T|, |\sys_if_engine_xetex:F| and
- |\sys_if_engine_xetex:TF| are all available. Usually, the illustration
+ The underlining and italic of \texttt{TF} indicates that three functions
+ are available:
+ \begin{itemize}
+ \item |\sys_if_engine_xetex:T|
+ \item |\sys_if_engine_xetex:F|
+ \item |\sys_if_engine_xetex:TF|
+ \end{itemize}
+ Usually, the illustration
will use the \texttt{TF} variant, and so both \meta{true code}
and \meta{false code} will be shown. The two variant forms \texttt{T} and
\texttt{F} take only \meta{true code} and \meta{false code}, respectively.
More information about the latex3-commits
mailing list