[latex3-commits] [latex3/latex3] main: Document `\bitset_show_named_index:N` (closes #1372) (d40b7ae8b)

[github at latex-project.org]

Repository : https://github.com/latex3/latex3
On branch  : main
Link       : https://github.com/latex3/latex3/commit/d40b7ae8b3975cec5ae85d1d32cb8ee1a604a1de

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

commit d40b7ae8b3975cec5ae85d1d32cb8ee1a604a1de
Author: Yukai Chou <muzimuzhi at gmail.com>
Date:   Tue Dec 12 00:01:41 2023 +0800

    Document `\bitset_show_named_index:N` (closes #1372)


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

d40b7ae8b3975cec5ae85d1d32cb8ee1a604a1de
 l3kernel/CHANGELOG.md |  3 +++
 l3kernel/l3bitset.dtx | 24 ++++++++++++++++++++++--
 2 files changed, 25 insertions(+), 2 deletions(-)

diff --git a/l3kernel/CHANGELOG.md b/l3kernel/CHANGELOG.md
index f3ac42762..b48d30f31 100644
--- a/l3kernel/CHANGELOG.md
+++ b/l3kernel/CHANGELOG.md
@@ -7,6 +7,9 @@ this project uses date-based 'snapshot' version identifiers.
 
 ## [Unreleased]
 
+### Added
+- Documentation for `\bitset_show_named_index:N`
+
 ### Changed
 - Improved method to suppress `l3bitset` where required
 
diff --git a/l3kernel/l3bitset.dtx b/l3kernel/l3bitset.dtx
index 013e9b40d..3bbe7dc2a 100644
--- a/l3kernel/l3bitset.dtx
+++ b/l3kernel/l3bitset.dtx
@@ -258,6 +258,17 @@
 %   in the log file.
 % \end{function}
 %
+% \begin{function}[added = 2023-11-15]
+%  {
+%     \bitset_show_named_index:N, \bitset_show_named_index:c
+%  }
+%   \begin{syntax}
+%     \cs{bitset_show_named_index:N} \meta{bitset var}
+%   \end{syntax}
+%   Displays declared name--index pairs of the \meta{bitset var}
+%   on the terminal.
+% \end{function}
+%
 % \end{documentation}
 %
 % \begin{implementation}
@@ -551,8 +562,6 @@
 \cs_generate_variant:Nn \bitset_show:N { c }
 \cs_new_protected:Npn   \bitset_log:N  { \@@_show:NN \msg_log:nneeee }
 \cs_generate_variant:Nn \bitset_log:N  { c }
-\cs_new_protected:Npn   \bitset_show_named_index:N { \@@_show_named_index:NN \msg_show:nneeee }
-\cs_generate_variant:Nn \bitset_show_named_index:N { c }
 \cs_new_protected:Npn \@@_show:NN #1#2
   {
     \__kernel_chk_defined:NT #2
@@ -564,6 +573,17 @@
            { }
       }
   }
+%    \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}
+%  {
+%     \bitset_show_named_index:N, \bitset_show_named_index:c,
+%  }
+%    \begin{macrocode}
+\cs_new_protected:Npn \bitset_show_named_index:N
+  { \@@_show_named_index:NN \msg_show:nneeee }
+\cs_generate_variant:Nn \bitset_show_named_index:N { c }
 \cs_new_protected:Npn \@@_show_named_index:NN #1#2
   {
     \__kernel_chk_defined:NT #2