[latexrefman-commits] [SCM] latexrefman updated: r1161 - trunk
Karl Berry
INVALID.NOREPLY at gnu.org.ua
Mon Oct 2 16:40:39 CEST 2023
Author: karl
Date: 2023-10-02 14:40:39 +0000 (Mon, 02 Oct 2023)
New Revision: 1161
Modified:
trunk/ChangeLog
trunk/Makefile
trunk/NEWS
trunk/latex2e.texi
Log:
doc: mention hitex; makefile: simplify web update
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2023-10-01 16:00:37 UTC (rev 1160)
+++ trunk/ChangeLog 2023-10-02 14:40:39 UTC (rev 1161)
@@ -1,3 +1,14 @@
+2023-10-02 Karl Berry <karl at freefriends.org>
+
+ * latex2e.texi (@TeX{} engines): add hilatex.
+
+ * Makefile (disttree): new variable for brevity; use it.
+ (postwebclean): new target to automate cleanup after a web update.
+ (commitready): depend on easyurls so that this is the only target
+ that need be run for a web update.
+ Add @echo commands to help trace what's happening.
+ Remove trailing whitespace.
+
2023-09-30 Karl Berry <karl at freefriends.org>
* latex2e.texi (Overview): give mailing list url.
Modified: trunk/Makefile
===================================================================
--- trunk/Makefile 2023-10-01 16:00:37 UTC (rev 1160)
+++ trunk/Makefile 2023-10-02 14:40:39 UTC (rev 1161)
@@ -93,7 +93,7 @@
# Sort of following the GNU sequence of clean targets.
distclean clean mostlyclean:
- rm -rf latex2e*.t2* latex2e-help-texinfo-tree*
+ rm -rf latex2e*.t2* $(distname)-tree*
realclean maintainer-clean: distclean
rm -f $(addprefix latex2e*., pdf dvi $(mi_suffixes) $(xref_suffixes))
@@ -108,12 +108,14 @@
figure_files = list.eps list.pdf list.png list.txt
figure_source_files = asy/list.asy
distname = latex2e-help-texinfo
+disttree = $(distname)-tree
distzip = $(distname).zip
#
-htmlsplit = $(distname)-tree
+htmlsplit = $(disttree)
htmlsplitzip = $(htmlsplit).zip
#
dist: en es
+ @echo Making $@ ...
rm -rf $(distname)
mkdir $(distname) && cd $(distname) && ln -s ../* .
mkdir $(distname)/spanish && cd $(distname)/spanish && ln -s ../../* .
@@ -125,17 +127,18 @@
$(addprefix $(distname)/latex2e-figures/, $(figure_files)) \
$(addprefix $(distname)/graphics/, README $(figure_source_files))
rm -f $(htmlsplitzip)
- cd $(htmlsplit) && zip -qr ../$(htmlsplitzip) latex2e
+ cd $(htmlsplit) && zip -qr ../$(htmlsplitzip) latex2e
zip -q $(distzip) $(distname)
@ls -l $(distzip); unzip -l $(distzip)
easyurls: htmlsplit dist
+ @echo Making $@ ...
cd src \
&& rm -rf testdist && mkdir -p testdist \
- && cp ../latex2e-help-texinfo-tree.zip testdist \
- && rm -rf latex2e && unzip -q testdist/latex2e-help-texinfo-tree \
+ && cp ../$(disttree).zip testdist \
+ && rm -rf latex2e && unzip -q testdist/$distname)-tree \
&& $(easyurls_python) ./easyurls.py $(easyurls_opt) \
- && zip -rq ../latex2e-help-texinfo-tree-easyurls.zip latex2e
+ && zip -rq ../$(disttree)-easyurls.zip latex2e
easyurls_python = python3.6 # depends on bs4 (beautifulsoup4)
easyurls_debug = # --debug
@@ -147,14 +150,16 @@
# make svrsplit # revert generated split html
# then update ChangeLog, etc.,
# then svn commit the modified source files,
-# then:
-webprepare:
- $(MAKE)
+# then make commitready, which runs:
+#
+# $(MAKE)
# $(MAKE) htmlsplit
# $(MAKE) dist
- $(MAKE) easyurls # depends on htmlsplit and dist
- $(MAKE) commitready # many files will have status !
-# svn commit # to commit regenerated files
+# $(MAKE) easyurls # depends on htmlsplit and dist
+# $(MAKE) commitready # depends on easyurls;
+# # many files will have status !
+# and then:
+# svn commit # to commit regenerated files
# then:
# svn -q update # restore easy url stubs
# make svrsplit # restore generated split html
@@ -164,11 +169,13 @@
# upload latex2e-help-texinfo.zip
#
# Clean up:
-# rm -rf src/testdist src/latex2e
-# rm -rf latex2e-help-texinfo
-# rm latex2e-help-texinfo-tree{,-easyurls}.zip
-# rm latex2e-help-texinfo.zip
-# make svri
+postwebclean:
+ rm -rf src/testdist src/latex2e
+ rm -rf $(distname)
+ rm $(disttree).zip $(distname)-easyurls.zip
+ rm $(distname).zip
+ make svri
+ svn status
# In Texinfo 7.0, the default output directory changed to foo_html.
# Change it back.
@@ -176,14 +183,16 @@
# Get many small .html files.
htmlsplit: en
+ @echo Making $@ ...
rm -rf $(htmlsplit)
- mkdir $(htmlsplit) && cd $(htmlsplit) && ln -s ../* .
+ mkdir $(htmlsplit) && cd $(htmlsplit) && ln -s ../* .
cd $(htmlsplit) && $(makeinfo) $(html_split_opts) latex2e.texi
cd $(htmlsplit)/latex2e && ln -s ../../latex2e-figures .
# Right before a commit, delete html files that are gone and add new ones.
htmlsplitstatus = cd $(htmlsplit)/latex2e && svn status *.html
-commitready: htmlsplit
+commitready: easyurls
+ @echo Making $@ ...
$(htmlsplitstatus) | sed -n 's/^\!//p' | xargs -r svn rm
$(htmlsplitstatus) | sed -n 's/^\?//p' | xargs -r svn add
# we linked everything above, remove the unused upper-level links.
Modified: trunk/NEWS
===================================================================
--- trunk/NEWS 2023-10-01 16:00:37 UTC (rev 1160)
+++ trunk/NEWS 2023-10-02 14:40:39 UTC (rev 1161)
@@ -11,6 +11,7 @@
* \thepage for page number representation.
* \nobreakspace and U+00A0 synonyms for ties.
* The (simple) \slash command.
+* Briefly mention hilatex and the hitex engine (https://ctan.org/pkg/hitex).
Changes:
* The lengthy list of commands for class and package writers, from
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2023-10-01 16:00:37 UTC (rev 1160)
+++ trunk/latex2e.texi 2023-10-02 14:40:39 UTC (rev 1161)
@@ -2,7 +2,7 @@
@c $Id$
@comment %**start of header (This is for running Texinfo on a region.)
@setfilename latex2e.info
- at set UPDATED September 2023
+ at set UPDATED October 2023
@include common.texi
@settitle @LaTeX{}2e unofficial reference manual (@value{UPDATED})
@comment %**end of header (This is for running Texinfo on a region.)
@@ -10,7 +10,7 @@
@c latex 2.09 commands should all be present now,
@c xx but latex2e stuff is missing.
@c xx random list of a few of the missing items is at the end of this file
- at c xx read through latex2e news for things to update.
+ at c xx read through ltnews and l3news for (lots of) things to update.
@c
@c xx ctan, distributions, components of TeX
@c xx classes and packages: required, additional, useful; oberdiek; fonts
@@ -18,10 +18,8 @@
@c xx merge latex-manual from savannah
@c xx merge display style math
@c xx systematically check stated math atom type vs. fontdef.dtx etc.
- at c xx check recent ltnews for (lots of) changes
@c xx \write of non-ASCII chars (vincent mail of 14 Mar 2020 21:39:41)
@c xx \nonstopmode etc., if they are officially supported by LaTeX?
- at c xx LaTeX defines \do at \begin{document} even though it is not documented
@c xx JH explain nfss somewhere
@c xx JH expand BiBTeX
@c xx JH expand theorem, AMS math
@@ -100,8 +98,8 @@
<div class='intro'> <p>This is an unofficial reference manual for
LaTeX. See below for the <a href='#SEC_Overview'>Table of Contents</a>.
If you want a tutorial then please instead visit <a
-href="https://www.learnlatex.org/"><code>learnlatex.org</code></a> or <a
-href='https://ctan.org/topic/tut-latex'>this list</a>.</p>
+href="https://www.learnlatex.org/"><code>learnlatex.org</code></a> or
+see <a href='https://ctan.org/topic/tut-latex'>this long list</a>.</p>
<p>This manual has two versions. One has <a
href="https://latexref.xyz/">separate web pages for each section or
@@ -466,8 +464,8 @@
@cindex @LaTeX{} format (@code{.fmt}) files
@cindex format files, @TeX{}
@findex .fmt @r{file}
- at LaTeX{} is a large set of commands that is executed by a @TeX{}
-program (@pxref{Overview}). Such a set of commands is called a
+ at LaTeX{} is a large set of commands (macros) that is executed by a
+ at TeX{} program (@pxref{Overview}). Such a set of commands is called a
@dfn{format}, and is embodied in a binary @code{.fmt} file, which can
be read much more quickly than the corresponding @TeX{} source.
@@ -496,7 +494,8 @@
In other @TeX{} distributions, @command{latex} may invoke e- at TeX{}
rather than pdf at TeX{}. In any case, the e- at TeX{} extensions can be
-assumed to be available in @LaTeX{}.
+assumed to be available in @LaTeX{}, and a few extensions beyond
+e- at TeX{}, particularly for file manipulation.
@item lualatex
@cindex Lua at TeX{}
@@ -526,6 +525,15 @@
program, but this process is automatic. The @code{.xdv} file is only
useful for debugging.
+ at item hilatex
+ at cindex Hi at TeX{}
+ at cindex HINT format
+ at cindex mobile output
+If @LaTeX{} is invoked via the system command @command{hilatex}, the
+Hi at TeX{} engine is run (@url{https://ctan.org/pkg/hitex}). This
+program produces its own format, named HINT, designed especially for
+high-quality typesetting on mobile devices.
+
@item platex
@itemx uplatex
These commands provide significant additional support for Japanese and
@@ -534,7 +542,7 @@
@end ftable
As of 2019, there is a companion @code{-dev} command and format for
-all of the above:
+all of the above except @code{hitex}.
@ftable @code
@item dvilualatex-dev
@@ -567,6 +575,7 @@
@end ftable
+
@node @LaTeX{} command syntax
@section @LaTeX{} command syntax
More information about the latexrefman-commits
mailing list.