From fb86552bbda96c8dc252a08c2cfee23497f8b81d Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 17 Nov 2019 17:05:39 +0000 Subject: split luahbtex to its own package; update man pages git-svn-id: svn://tug.org/texlive/trunk@52830 c570f23f-e606-0410-a88d-b1316a301751 --- Build/source/texk/web2c/man/ChangeLog | 5 +++++ Build/source/texk/web2c/man/Makefile.am | 14 ++++++++++++-- Build/source/texk/web2c/man/Makefile.in | 11 +++++++++-- Build/source/texk/web2c/man/latex-dev.man | 28 ++++++++++++++++++++++++++++ Build/source/texk/web2c/man/luatex.man | 31 ++++++++++++++++++------------- 5 files changed, 72 insertions(+), 17 deletions(-) create mode 100644 Build/source/texk/web2c/man/latex-dev.man (limited to 'Build/source') diff --git a/Build/source/texk/web2c/man/ChangeLog b/Build/source/texk/web2c/man/ChangeLog index ad90435ff0f..e5bc56e9a01 100644 --- a/Build/source/texk/web2c/man/ChangeLog +++ b/Build/source/texk/web2c/man/ChangeLog @@ -1,3 +1,8 @@ +2019-11-17 Karl Berry + + * latex-dev.man: new man page. + * Makefile.am (man1_links): add several links for latex-dev and luatex. + 2019-08-06 Karl Berry * aleph.man, diff --git a/Build/source/texk/web2c/man/Makefile.am b/Build/source/texk/web2c/man/Makefile.am index 97f80eba479..9be66048d7f 100644 --- a/Build/source/texk/web2c/man/Makefile.am +++ b/Build/source/texk/web2c/man/Makefile.am @@ -1,6 +1,6 @@ ## $Id$ ## Makefile.am for the TeX Live subdirectory texk/web2c/man/ -## Copyright 2018 Karl Berry +## Copyright 2015-2019 Karl Berry ## Copyright 2009-2015 Peter Breitenlohner ## You may freely use, modify and/or distribute this file. ## @@ -62,7 +62,9 @@ EXTRA_DIST += ptex.man ppltotf.man ptftopl.man if LUATEX man_sources += luatex.man -man1_links += luatex:texlua luatex:texluac +man1_links += luatex:texlua luatex:texluac \ + luatex:luahbtex luatex:luajittex \ + luatex:dviluatex endif LUATEX EXTRA_DIST += luatex.man @@ -89,8 +91,16 @@ EXTRA_DIST += $(misc_man_sources) misc_man_sources = \ amstex.man \ latex.man \ + latex-dev.man \ pdfetex.man +man1_links += latex-dev:pdflatex-dev \ + latex-dev:xelatex-dev \ + latex-dev:lualatex-dev \ + latex-dev:dvilualatex-dev \ + latex-dev:platex-dev \ + latex-dev:uplatex-dev + include $(top_srcdir)/../../am/man.am include $(top_srcdir)/../../am/man1_links.am diff --git a/Build/source/texk/web2c/man/Makefile.in b/Build/source/texk/web2c/man/Makefile.in index 9505be77709..df5623a7940 100644 --- a/Build/source/texk/web2c/man/Makefile.in +++ b/Build/source/texk/web2c/man/Makefile.in @@ -101,7 +101,10 @@ host_triplet = @host@ @PTEX_TRUE@am__append_12 = ptex:eptex ptex:euptex ptex:uptex \ @PTEX_TRUE@ ppltotf:uppltotf ptftopl:uptftopl @LUATEX_TRUE@am__append_13 = luatex.man -@LUATEX_TRUE@am__append_14 = luatex:texlua luatex:texluac +@LUATEX_TRUE@am__append_14 = luatex:texlua luatex:texluac \ +@LUATEX_TRUE@ luatex:luahbtex luatex:luajittex \ +@LUATEX_TRUE@ luatex:dviluatex + @XETEX_TRUE@am__append_15 = xetex.man @OTANGLE_TRUE@am__append_16 = $(otangle_man_sources) @OTANGLE_TRUE@am__append_17 = dvicopy:odvicopy dvitype:odvitype tangle:otangle @@ -455,7 +458,10 @@ bootstrap_man_sources = ctie.man cweb.man ctwill.man tangle.man tie.man man1_links = cweb:ctangle cweb:cweave ctwill:ctwill-refsort \ ctwill:ctwill-twinx $(am__append_3) $(am__append_5) \ $(am__append_6) $(am__append_10) $(am__append_12) \ - $(am__append_14) $(am__append_17) $(am__append_19) + $(am__append_14) $(am__append_17) $(am__append_19) \ + latex-dev:pdflatex-dev latex-dev:xelatex-dev \ + latex-dev:lualatex-dev latex-dev:dvilualatex-dev \ + latex-dev:platex-dev latex-dev:uplatex-dev web_man_sources = bibtex.man dvicopy.man dvitomp.man dvitype.man gftodvi.man \ gftopk.man gftype.man mft.man patgen.man pktogf.man pktype.man \ pltotf.man pooltype.man tftopl.man vftovp.man vptovf.man weave.man @@ -465,6 +471,7 @@ otangle_man_sources = ofm2opl.man opl2ofm.man ovf2ovp.man ovp2ovf.man misc_man_sources = \ amstex.man \ latex.man \ + latex-dev.man \ pdfetex.man SUFFIXES = .1 .man .ps .dvi diff --git a/Build/source/texk/web2c/man/latex-dev.man b/Build/source/texk/web2c/man/latex-dev.man new file mode 100644 index 00000000000..9edace40f40 --- /dev/null +++ b/Build/source/texk/web2c/man/latex-dev.man @@ -0,0 +1,28 @@ +.TH LATEX-DEV 1 "17 November 2019" "Web2C @VERSION@" +.SH NAME +latex-dev, pdflatex-dev, xelatex-dev, lualatex-dev, dvilualatex-dev, platex-dev, uplatex-dev \- release candidate LaTeX testing +.SH SYNOPSIS +.B latex-dev +.RI [ first-line ] +.\"===================================================================== +.SH DESCRIPTION +.PP +These -dev executables are intended for testing upcoming LaTeX2e kernel +changes. They correspond to new formats which have been tested by the +LaTeX team for stability and usability. Thus, they are not arbitrary +development snapshots; more like release candidates. +.PP +Wider testing by knowledgeable users is desired, indeed, is the main +purpose for these executables to exist. Simply replacing the regular +engine (e.g., pdflatex) with the -dev engine name (pdflatex-dev) is all +that should be needed. +.PP +The lualatex-dev format is based on luahbtex, the luatex variant with +harfbuzz enabled for glyph shaping. +.PP +Please report bugs in these -dev versions, like all LaTeX releases, +following the procedure at https://www.latex-project.org/bugs. +.SH "SEE ALSO" +.BR latex (1). +.PP +The LaTeX home page is https://latex-project.org. diff --git a/Build/source/texk/web2c/man/luatex.man b/Build/source/texk/web2c/man/luatex.man index 6f33f5e6690..d9525552896 100644 --- a/Build/source/texk/web2c/man/luatex.man +++ b/Build/source/texk/web2c/man/luatex.man @@ -1,4 +1,4 @@ -.TH LUATEX 1 "27 May 2018" "Web2C @VERSION@" +.TH LUATEX 1 "17 November 2019" "Web2C @VERSION@" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont @@ -8,8 +8,7 @@ .if t .ds WB W\s-2EB\s0 .\"===================================================================== .SH NAME -luatex, dviluatex, luajittex, texlua, texluac \- An extended version of pdfTeX using Lua as -an embedded scripting language +luatex, dviluatex, luahbtex, luajittex, texlua, texluac \- An extended version of TeX using Lua as an embedded scripting language .\"===================================================================== .SH SYNOPSIS .B luatex @@ -50,26 +49,32 @@ remaining arguments are processed as above. If no arguments or options are specified, prompt for input. -If called as \fBtexlua\fR it acts as lua interpreter. -If called as \fBtexluac\fR it acts as lua bytecode compiler. +If called as \fBtexlua\fR it acts as a Lua interpreter. +If called as \fBtexluac\fR it acts as a Lua bytecode compiler. -Lua\*(TX is an extended version of pdf\*(TX with Unicode and OpenType +Lua\*(TX began as an extended version of pdf\*(TX with Unicode and OpenType font support, embedded \fBLua\fR scripting language, the \fBe-\*(TX\fR -and \fBOmega\fR extensions, as well as integrated MetaPost engine, that +and \fBOmega\fR extensions, as well as an integrated MetaPost engine, that can create \fIPDF\fR files as well as \fIDVI\fR files. -For more information about luatex, see http://www.luatex.org, you can -read Lua\*(TX manual using texdoc utility (\fBtexdoc luatex\fR). +For more information about luatex, see http://www.luatex.org; and you can +read the Lua\*(TX manual using the texdoc utility (\fBtexdoc luatex\fR). -All Lua\*(TX text input and output is considered to be Unicode text. +All Lua\*(TX text input and output is considered to be Unicode text, +although various filters make it possible to support any encoding. -In \fIDVI\fR mode, lua\*(TX can be used as a complete replacement for +In \fIDVI\fR mode, Lua\*(TX can be used as a complete replacement for the \*(TX engine. -In \fIPDF\fR mode, lua\*(TX can natively handle the \fIPDF\fR, \fIJPG\fR, -\fIJBIG2\fR, and \fIPNG\fR graphics formats. lua\*(TX cannot include +In \fIPDF\fR mode, Lua\*(TX can natively handle the \fIPDF\fR, \fIJPG\fR, +\fIJBIG2\fR, and \fIPNG\fR graphics formats. Lua\*(TX cannot include PostScript or Encapsulated PostScript (EPS) graphics files; first convert them to PDF using \fBepstopdf\fR (1). +The luajittex variant includes the Lua just-in-time compiler. + +The luahbtex variant can use the HarfBuzz engine for glyph shaping, +instead of Lua\*(TX's built-in shaper. + .\"===================================================================== .SH "OPTIONS" When the Lua\*(TX executable starts, it looks for the \fB\-\-lua\fR -- cgit v1.2.3