[latex3-commits] [git/LaTeX3-latex3-latex3] master: Move fparray to stable (62b060b32)

[Joseph Wright]

Repository : https://github.com/latex3/latex3
On branch  : master
Link       : https://github.com/latex3/latex3/commit/62b060b32c8ecc7a4650e586b48eff4fff0d43c7

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

commit 62b060b32c8ecc7a4650e586b48eff4fff0d43c7
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Sat Sep 21 07:57:41 2019 +0100

    Move fparray to stable
    
    The concept is clearly going to be useful:
    one can imagine for example implementing
    pgfplots data structures as fparrays.


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

62b060b32c8ecc7a4650e586b48eff4fff0d43c7
 l3kernel/CHANGELOG.md     |  1 +
 l3kernel/l3candidates.dtx | 51 -----------------------------------------------
 l3kernel/l3fparray.dtx    | 51 +++++++++++++++++++++++++++++++++++++++++++++--
 3 files changed, 50 insertions(+), 53 deletions(-)

diff --git a/l3kernel/CHANGELOG.md b/l3kernel/CHANGELOG.md
index 4619da018..59e667dfb 100644
--- a/l3kernel/CHANGELOG.md
+++ b/l3kernel/CHANGELOG.md
@@ -16,6 +16,7 @@ this project uses date-based 'snapshot' version identifiers.
   - `\file_compare_timestamp:nNn(TF)`
   - FP `logb` operator
   - `\fp_sign:n`
+  - `fparray` module
   - `\int_sign:n`
   - `\intarray_const_from_clist:Nn`
   - `\intarray_show:N`
diff --git a/l3kernel/l3candidates.dtx b/l3kernel/l3candidates.dtx
index 2c008b6c1..497f92843 100644
--- a/l3kernel/l3candidates.dtx
+++ b/l3kernel/l3candidates.dtx
@@ -214,57 +214,6 @@
 %   a tuple containing \nan{}.
 % \end{function}
 %
-% \section{Additions to \pkg{l3fparray}}
-%
-% \begin{function}[added = 2018-05-05]{\fparray_new:Nn}
-%   \begin{syntax}
-%     \cs{fparray_new:Nn} \meta{fparray~var} \Arg{size}
-%   \end{syntax}
-%   Evaluates the integer expression \meta{size} and allocates an
-%   \meta{floating point array variable} with that number of (zero)
-%   entries.  The variable name should start with |\g_| because
-%   assignments are always global.
-% \end{function}
-%
-% \begin{function}[EXP, added = 2018-05-05]{\fparray_count:N}
-%   \begin{syntax}
-%     \cs{fparray_count:N} \meta{fparray~var}
-%   \end{syntax}
-%   Expands to the number of entries in the \meta{floating point array
-%   variable}.  This is performed in constant time.
-% \end{function}
-%
-% \begin{function}[added = 2018-05-05]{\fparray_gset:Nnn}
-%   \begin{syntax}
-%     \cs{fparray_gset:Nnn} \meta{fparray~var} \Arg{position} \Arg{value}
-%   \end{syntax}
-%   Stores the result of evaluating the floating point expression
-%   \meta{value} into the \meta{floating point array variable} at the
-%   (integer expression) \meta{position}.  If the \meta{position} is not
-%   between $1$ and the \cs{fparray_count:N}, an error occurs.
-%   Assignments are always global.
-% \end{function}
-%
-% \begin{function}[added = 2018-05-05]{\fparray_gzero:N}
-%   \begin{syntax}
-%     \cs{fparray_gzero:N} \meta{fparray~var}
-%   \end{syntax}
-%   Sets all entries of the \meta{floating point array variable} to
-%   $+0$.  Assignments are always global.
-% \end{function}
-%
-% \begin{function}[EXP, added = 2018-05-05]
-%   {\fparray_item:Nn, \fparray_item_to_tl:Nn}
-%   \begin{syntax}
-%     \cs{fparray_item:Nn} \meta{fparray~var} \Arg{position}
-%   \end{syntax}
-%   Applies \cs{fp_use:N} or \cs{fp_to_tl:N} (respectively) to the
-%   floating point entry stored at the (integer expression)
-%   \meta{position} in the \meta{floating point array variable}.  If the
-%   \meta{position} is not between $1$ and the \cs{fparray_count:N}, an
-%   error occurs.
-% \end{function}
-%
 % \section{Additions to \pkg{l3file}}
 %
 % \begin{function}[added = 2018-12-29]{\iow_allow_break:}
diff --git a/l3kernel/l3fparray.dtx b/l3kernel/l3fparray.dtx
index 42b0a671e..b238fabb7 100644
--- a/l3kernel/l3fparray.dtx
+++ b/l3kernel/l3fparray.dtx
@@ -58,8 +58,55 @@
 % close to that of \pkg{l3intarray}.  The size of the array is fixed and
 % must be given at point of initialisation
 %
-% Currently \emph{all} functions in this module are candidates.  Their
-% documentation can be found in \pkg{l3candidates}.
+% \begin{function}[added = 2018-05-05]{\fparray_new:Nn}
+%   \begin{syntax}
+%     \cs{fparray_new:Nn} \meta{fparray~var} \Arg{size}
+%   \end{syntax}
+%   Evaluates the integer expression \meta{size} and allocates an
+%   \meta{floating point array variable} with that number of (zero)
+%   entries.  The variable name should start with |\g_| because
+%   assignments are always global.
+% \end{function}
+%
+% \begin{function}[EXP, added = 2018-05-05]{\fparray_count:N}
+%   \begin{syntax}
+%     \cs{fparray_count:N} \meta{fparray~var}
+%   \end{syntax}
+%   Expands to the number of entries in the \meta{floating point array
+%   variable}.  This is performed in constant time.
+% \end{function}
+%
+% \begin{function}[added = 2018-05-05]{\fparray_gset:Nnn}
+%   \begin{syntax}
+%     \cs{fparray_gset:Nnn} \meta{fparray~var} \Arg{position} \Arg{value}
+%   \end{syntax}
+%   Stores the result of evaluating the floating point expression
+%   \meta{value} into the \meta{floating point array variable} at the
+%   (integer expression) \meta{position}.  If the \meta{position} is not
+%   between $1$ and the \cs{fparray_count:N}, an error occurs.
+%   Assignments are always global.
+% \end{function}
+%
+% \begin{function}[added = 2018-05-05]{\fparray_gzero:N}
+%   \begin{syntax}
+%     \cs{fparray_gzero:N} \meta{fparray~var}
+%   \end{syntax}
+%   Sets all entries of the \meta{floating point array variable} to
+%   $+0$.  Assignments are always global.
+% \end{function}
+%
+% \begin{function}[EXP, added = 2018-05-05]
+%   {\fparray_item:Nn, \fparray_item_to_tl:Nn}
+%   \begin{syntax}
+%     \cs{fparray_item:Nn} \meta{fparray~var} \Arg{position}
+%   \end{syntax}
+%   Applies \cs{fp_use:N} or \cs{fp_to_tl:N} (respectively) to the
+%   floating point entry stored at the (integer expression)
+%   \meta{position} in the \meta{floating point array variable}.  If the
+%   \meta{position} is not between $1$ and the \cs{fparray_count:N}, an
+%   error occurs.
+% \end{function}
+
 %
 % \end{documentation}
 %