Debian Codegraph @

texmf-dist/doc/latex/l3kernel/l3prefixes.tex

raw
1 \iffalse meta-comment
2
3 File:l3prefixes.tex
4
5 Copyright (C) 2019,2021 The LaTeX Project
6
7 It may be distributed and/or modified under the conditions of the
8 LaTeX Project Public License (LPPL), either version 1.3c of this
9 license or (at your option) any later version. The latest version
10 of this license is in the file
11
12 https://www.latex-project.org/lppl.txt
13
14 This file is part of the "l3kernel bundle" (The Work in LPPL)
15 and all files in that bundle must be distributed together.
16
17 The released version of this bundle is available from CTAN.
18
19 -----------------------------------------------------------------------
20
21 The development version of the bundle can be found at
22
23 https://github.com/latex3/latex3
24
25 for those people who are interested.
26
27 \fi
28
29 \documentclass{article}
30 \usepackage{array}
31 \usepackage{booktabs}
32 \usepackage{longtable}
33 \ExplSyntaxOn
34 \tl_new:N \l__prefix_table_tl
35 \tl_new:N \l__prefix_tmp_tl
36 \ior_new:N \g__prefix_ior
37 \cs_new_protected:Npn \__prefix_readi:w #1 " #2 " #3 \q_stop
38 {
39 \quark_if_nil:nTF {#2}
40 { \__prefix_readii:w #1 \q_stop }
41 { \__prefix_readi:w #1 {#2} #3 \q_stop }
42 }
43 \cs_new_protected:Npn \__prefix_readii:w #1 , #2 , #3 , #4 \q_stop
44 { \__prefix_readiii:nnw {#1} {#3} #2 , \q_stop }
45 \cs_new_protected:Npn \__prefix_readiii:nnw #1 #2 #3 , #4 \q_stop
46 {
47 \tl_put_right:Nn \l__prefix_table_tl { #1 & #3 & #2 \\ }
48 \tl_if_blank:nF {#4}
49 { \clist_map_inline:nn {#4} { \tl_put_right:Nn \l__prefix_table_tl { & ##1 \\ } } }
50 }
51 \ior_open:Nn \g__prefix_ior { l3prefixes.csv }
52 \ior_get:NN \g__prefix_ior \l__prefix_tmp_tl % Throw away
53 \cs_new_protected:Npn \PrintTable
54 {
55 \tl_set:Nn \l__prefix_table_tl
56 {
57 \begin { longtable } { @{} *{2}{>{\ttfamily}l} l @{} }
58 \toprule
59 \multicolumn{1}{@{}l}{Prefix}
60 & \multicolumn{1}{l@{}}{Module}
61 & Registrant \\
62 \midrule
63 \endhead
64 \bottomrule
65 \endfoot
66 }
67 \ior_map_inline:Nn \g__prefix_ior
68 { \__prefix_readi:w ##1 " \q_nil " \q_stop }
69 \tl_put_right:Nn \l__prefix_table_tl { \end { longtable } }
70 \tl_replace_all:Nnn \l__prefix_table_tl { LaTeX3 } { \LaTeX3 }
71 \tl_use:N \l__prefix_table_tl
72 }
73 \ExplSyntaxOff
74 \begin{document}
75
76 This file lists the prefixes which have been registered with the \LaTeX{}
77 team for use in \textsf{expl3} code. Programmers are invited to register their
78 (public) prefix use by contacting the team at
79 \begin{quote}
80 \texttt{[email protected]}
81 \end{quote}
82 with the relevant information for the \texttt{.csv} file, i.e.,
83 \textit{Prefix, Module or package, Registrant, Homepage, Source repository, Issue tracker}.
84
85
86 We recommend that short prefixes are avoided as there are a limited
87 number of these very general names available. The
88 file \texttt{l3prefixes.csv} contains more details on each module, for
89 example any information on source repository or issue tracker.
90
91 \PrintTable
92 \end{document}