Debian Codegraph @

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

raw
1 % Copyright 2011 The LaTeX Project
2 \documentclass{ltnews}
3 \PassOptionsToPackage{colorlinks}{hyperref}
4
5 \usepackage{metalogo,ragged2e}
6
7 \AtBeginDocument{
8 \renewcommand{\LaTeXNews}{\LaTeX3~News}
9 \RaggedRight
10 }
11
12 \usepackage{hologo}
13
14 \publicationmonth{June}
15 \publicationyear{2011}
16 \publicationissue{6}
17
18 \begin{document}
19 \maketitle
20
21 \noindent
22 A key aim of releasing `stable' \LaTeX3 material to CTAN is to allow users to
23 benefit from new ideas \emph{now}, and also to raise the profile of usable
24 \LaTeX3 ideas. This is clearly being successful, with \pkg{xparse} being of
25 particular utility to end users. This increase in interest has been
26 particularly notable on the new
27 \href{http://tex.stackexchange.com/}{TeX.SX Q\&A site}.
28
29 \section{The \LaTeX3 Team expands}
30
31 Raising interest in \LaTeX3 developments has inevitably led to feedback on
32 cases where the code base has required attention. It has also attracted new
33 programmers to using \LaTeX3 ideas, some more than others! Bruno Le Floch has
34 over the past few months made many useful contributions to \LaTeX3, and we are
35 very pleased that he has recently joined The \LaTeX{} Project.
36
37 Bruno has taken a particular interest in improving the performance and
38 reliability of the \pkg{expl3} language. This has already resulted in new
39 implementations for the \texttt{prop} and \texttt{seq} data types. At the same
40 time, he has identified and fixed several edge-case issues in core \pkg{expl3}
41 macros.
42
43 \section{The `Big Bang'}
44
45 In parallel to Bruno's improvements, Joseph Wright initiated a series of `Big
46 Bang' improvements to \LaTeX3. The aim of the Big Bang was to address a number
47 of long-standing issues with the \LaTeX3 code base. Development has taken place
48 over many years, with the status of some of the resulting code being less
49 than clear, even to members of The \LaTeX{} Project! At the same time, different
50 conventions had been applied to different parts of the code, which made reading
51 some of the code rather `interesting'. A key part of the Big Bang has been to
52 address these issues, cleaning up the existing code and ensuring that the
53 status of each part is clear.
54
55 The arrangement of \LaTeX3 code is now the same in the development
56 repository and on CTAN, and splits the code into three parts.
57 \begin{description}
58 \item[\pkg{l3kernel}] The core of \LaTeX3, code which
59 is expected to be used in a \LaTeX3 kernel in more or less the
60 current form. Currently, this part is made up of the \LaTeX3
61 programming layer, \pkg{expl3}.
62 \item[\pkg{l3packages}] \LaTeXe{} packages making use of \LaTeX3
63 concepts and with stable interfaces. The \pkg{xparse} and
64 \pkg{xtemplate} packages are the core of this area. While many of
65 the \emph{ideas} explored here may eventually appear in a \LaTeX3
66 kernel, the interfaces here are tied to \LaTeXe{}.
67 \item[\pkg{l3experimental}] \LaTeXe{} packages which explore more
68 experimental \LaTeX3 ideas, and which may see interface changes as
69 development continues. Over time, we expect code to move from this area
70 to either \pkg{l3kernel} or \pkg{l3packages}, as appropriate.
71 \end{description}
72
73 In addition to these release areas, the development code also features a
74 \pkg{l3trial} section for exploring code ideas. Code in \pkg{l3trial} may be
75 used to improve or replace other parts of \LaTeX3, or may simply be dropped!
76
77 As well as these improvements to the \emph{code} used in \LaTeX3, much of the
78 documentation for \pkg{expl3} has been made more precise as part of the Big
79 Bang. This means that \texttt{source3.pdf} is now rather longer than it was
80 previously, but also should mean that many of the inaccuracies in earlier
81 versions have been removed. Of course, we are very pleased to receive
82 suggestions for further improvement.
83
84 \section{\LaTeX3 on GitHub}
85
86 The core development repository for \LaTeX3 is held in an SVN repository, which
87 is \href{http://www.latex-project.org/code.html}{publicly viewable \emph{via}
88 the Project website}. However, this interface misses out on some of the `bells
89 and whistles' of newer code-hosting sites such as
90 \href{http://gitbug.com/}{GitHub} and \href{http://bitbucket.org/}{BitBucket}.
91 We have therefore established a mirror of the master repository on GitHub%
92 \footnote{\url{http://github.com/latex3/svn-mirror}}. This is kept in
93 synchronisation with the main SVN repository by Will Robertson (or at least
94 by his laptop!).
95
96 The GitHub mirror offers several useful features for people who wish to
97 follow the \LaTeX3 code changes. GitHub offers facilities such as highlighted
98 differences and notification of changes. It also makes it possible for
99 non-Team members to submit patches for \LaTeX3 as `pull requests' on
100 GitHub.
101
102 As well as offering a convenient interface to the \LaTeX3 code, the GitHub
103 site also includes an issue database\footnote{%
104 \url{http://github.com/latex3/svn-mirror/issues}}. Given the very
105 active nature of \LaTeX3 development, and the transitory nature of many
106 of the issues, this provides a better approach to tracking issues than
107 the main \LaTeX{} bug database\footnote{\url{http://www.latex-project.org/bugs.html}}.
108 Developers and users are
109 therefore asked to report any issues with \LaTeX3 code \emph{via} the GitHub
110 database, rather than on the main Project homepage.
111 Discussion on the \href{http://www.latex-project.org/code.html}{\mbox{LaTeX-L} mailing list}
112 is also encouraged.
113
114 \section{Next steps}
115
116 The `Big Bang' involves making a number of changes to \pkg{expl3} function
117 names, and is likely to break at least some third-party code. As a result,
118 the updates will not appear on the \TeX{} Live 2011 DVD release, but will
119 instead be added to \TeX{} Live once regular updates restart (probably
120 August).
121
122 Bruno is working on a significant overhaul of the \pkg{l3fp} floating-point
123 unit for \LaTeX3. He has developed an approach which allows expandable
124 parsing of floating-point expressions, which will eventually allow syntax
125 such as
126 \begin{verbatim}
127 \fp_parse:n { 3 * 4 ( ln(5) + 1 ) }
128 \end{verbatim}
129 This will result in some changes in the interface for floating-point numbers, but
130 we feel that the long-term benefit is worth a small amount of recoding in other
131 areas.
132
133 Joseph has completed documentation of the \pkg{xgalley} module, and this is
134 currently being discussed. Joseph is hoping to move on to implement other
135 more visible ideas based on the \pkg{xtemplate} concept over the next few
136 months.
137
138 \end{document}
139
140
141