summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2019-12-22 22:22:33 +0000
committerKarl Berry <karl@freefriends.org>2019-12-22 22:22:33 +0000
commit29ad0b23168602c8f159a884fe596b355dfd3658 (patch)
tree9703469b6fe3ce187a6885db27f6e05090910d44
parentbc6dd08a758dc59e855de67708aa4eab8a0e261a (diff)
doc: better describe config file special characters; plus other typos, url fixes, mention gpg, etc., from Takuto in texlive-en.tex
git-svn-id: svn://tug.org/texlive/trunk@53213 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Build/source/doc/ChangeLog4
-rw-r--r--Build/source/doc/build-tools.txt2
-rw-r--r--Build/source/doc/tlbuild.info696
-rw-r--r--Build/source/texk/kpathsea/ChangeLog8
-rw-r--r--Build/source/texk/kpathsea/doc/kpathsea.info193
-rw-r--r--Build/source/texk/kpathsea/doc/kpathsea.texi74
-rw-r--r--Master/texmf-dist/doc/texlive/texlive-en/.dict.pws1
-rw-r--r--Master/texmf-dist/doc/texlive/texlive-en/Makefile4
-rw-r--r--Master/texmf-dist/doc/texlive/texlive-en/tex-live.sty6
-rw-r--r--Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex159
-rwxr-xr-xMaster/texmf-dist/scripts/texlive/tlmgr.pl38
11 files changed, 639 insertions, 546 deletions
diff --git a/Build/source/doc/ChangeLog b/Build/source/doc/ChangeLog
index 7eb81910bf4..422a681dc16 100644
--- a/Build/source/doc/ChangeLog
+++ b/Build/source/doc/ChangeLog
@@ -1,3 +1,7 @@
+2019-12-22 Karl Berry <karl@freefriends.org>
+
+ * build-tools.txt: bison 3.5.
+
2019-08-11 Karl Berry <karl@freefriends.org>
* tlbuild.texi (Build one package): rm sources to build without C++11.
diff --git a/Build/source/doc/build-tools.txt b/Build/source/doc/build-tools.txt
index 3fde6a5901f..9de77a74943 100644
--- a/Build/source/doc/build-tools.txt
+++ b/Build/source/doc/build-tools.txt
@@ -1,6 +1,6 @@
autoconf (GNU Autoconf) 2.69
automake (GNU automake) 1.16.1
-bison (GNU Bison) 3.4.2
+bison (GNU Bison) 3.5
flex 2.6.0
ltmain.sh (GNU libtool) 2.4.6
m4 (GNU M4) 1.4.18
diff --git a/Build/source/doc/tlbuild.info b/Build/source/doc/tlbuild.info
index 1e6a5dbfb13..f547b21bb5a 100644
--- a/Build/source/doc/tlbuild.info
+++ b/Build/source/doc/tlbuild.info
@@ -747,7 +747,7 @@ many extra hassles, so don't do that, tempting as it may be.
autoconf (GNU Autoconf) 2.69
automake (GNU automake) 1.16.1
- bison (GNU Bison) 3.4.2
+ bison (GNU Bison) 3.5
flex 2.6.0
ltmain.sh (GNU libtool) 2.4.6
m4 (GNU M4) 1.4.18
@@ -5629,353 +5629,353 @@ Node: Linked scripts24924
Node: Distro builds26415
Node: Layout and infrastructure28791
Node: Build system tools29622
-Node: Top-level directories31839
-Node: Autoconf macros34075
-Node: General setup macros34837
-Node: Macros for programs35712
-Node: Macros for compilers36513
-Node: Macros for libraries37921
-Node: Macros for library and header flags38347
-Node: Macros for Windows40258
-Node: Library modules41845
-Node: png library42334
-Node: zlib library44682
-Node: freetype library45197
-Node: kpathsea library45893
-Node: Program modules47272
-Node: t1utils package47700
-Node: xindy package48245
-Node: xdvik package49359
-Node: asymptote50418
-Node: Extending TeX Live50914
-Node: Adding a new program module51697
-Node: Adding a new generic library module55036
-Node: Adding a new TeX-specific library module57265
-Node: Configure options57963
-Node: Global configure options59344
-Node: --disable-native-texlive-build59886
-Node: --prefix --bindir ...60848
-Node: --disable-largefile61388
-Node: --disable-missing62089
-Node: --enable-compiler-warnings=LEVEL62490
-Node: --enable-cxx-runtime-hack63146
-Node: --enable-maintainer-mode63566
-Node: --enable-multiplatform64095
-Node: --enable-shared64668
-Node: --enable-silent-rules65039
-Node: --without-ln-s65491
-Node: --without-x65838
-Node: Program-specific configure options66026
-Node: --enable-PROG --disable-PROG66669
-Node: --disable-all-pkgs66942
-Node: Configure options for texk/web2c67725
-Node: Configure options for texk/bibtex-x70263
-Node: Configure options for texk/dvipdfm-x70806
-Node: Configure options for texk/dvisvgm71582
-Node: Configure options for texk/texlive72463
-Node: Configure options for texk/xdvik72884
-Node: Configure options for utils/xindy73505
-Node: Library-specific configure options74395
-Node: Configure options for kpathsea75397
-Node: Configure options for system poppler76146
-Node: Variables for configure76910
-Node: Coding conventions78336
-Node: Declarations and definitions79051
-Node: Const81225
-Node: Continuous integration83089
-Node: Transfer from Subversion to Github83753
-Node: Automatic update of the Git mirror85915
-Node: CI testing on Travis-CI86497
-Node: Releases on Github87206
-Node: install-tl87646
-Node: install-tl NAME88015
-Node: install-tl SYNOPSIS88173
-Node: install-tl DESCRIPTION88431
-Node: install-tl REFERENCES89498
-Node: install-tl OPTIONS90024
-Ref: install-tl *-gui* [[=]_module_]90365
-Ref: install-tl text90575
-Ref: install-tl wizard90698
-Ref: install-tl perltk90852
-Ref: install-tl *-no-gui*91283
-Ref: install-tl *-lang* _llcode_91364
-Ref: install-tl *-repository* _url|path_92051
-Ref: install-tl *-select-repository*93931
-Ref: install-tl *-all-options*94367
-Ref: install-tl *-custom-bin* _path_94622
-Ref: install-tl *-debug-translation*95454
-Ref: install-tl *-force-platform* _platform_95673
-Ref: install-tl *-help*, *--help*, *-?*95917
-Ref: install-tl *-in-place*96324
-Ref: install-tl *-init-from-profile* _profile_file_96869
-Ref: install-tl *-logfile* _file_97089
-Ref: install-tl *-no-cls*97440
-Ref: install-tl *-non-admin*97574
-Ref: install-tl *-persistent-downloads*97679
-Ref: install-tl *-no-persistent-downloads*97707
-Ref: install-tl *-no-verify-downloads*98325
-Ref: install-tl *-portable*98686
-Ref: install-tl *-print-platform*98825
-Ref: install-tl *-profile* _profile_file_99023
-Ref: install-tl *-q*99203
-Ref: install-tl *-scheme* _scheme_99265
-Ref: install-tl *-v*99739
-Ref: install-tl *-version*, *--version*99894
-Node: install-tl PROFILES100025
-Ref: install-tl instopt_adjustpath (default 0 on Unix, 1 on Windows)102675
-Ref: install-tl instopt_adjustrepo (default 1)102751
-Ref: install-tl instopt_letter (default 0)102888
-Ref: install-tl instopt_portable (default 0)102979
-Ref: install-tl instopt_write18_restricted (default 1)103075
-Node: install-tl ENVIRONMENT VARIABLES104394
-Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK104785
-Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE104987
-Ref: install-tl TEXLIVE_INSTALL_NO_WELCOME105097
-Ref: install-tl TEXLIVE_INSTALL_PREFIX105218
-Ref: install-tl TEXLIVE_INSTALL_TEXDIR105244
-Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG105275
-Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR105303
-Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME105332
-Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL105362
-Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG105396
-Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR105427
-Ref: install-tl NOPERLDOC105798
-Node: install-tl AUTHORS AND COPYRIGHT105862
-Node: tlmgr106278
-Node: tlmgr NAME106731
-Node: tlmgr SYNOPSIS106863
-Node: tlmgr DESCRIPTION107053
-Node: tlmgr EXAMPLES108149
-Ref: tlmgr tlmgr option repository ctan108400
-Ref: tlmgr tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet108472
-Ref: tlmgr tlmgr update --list108924
-Ref: tlmgr tlmgr update --all109017
-Ref: tlmgr tlmgr info _what_109174
-Node: tlmgr OPTIONS109436
-Ref: tlmgr *--repository* _url|path_109956
-Ref: tlmgr *--gui* [_action_]110681
-Ref: tlmgr *--gui-lang* _llcode_111088
-Ref: tlmgr *--debug-translation*111771
-Ref: tlmgr *--machine-readable*111974
-Ref: tlmgr *--no-execute-actions*112242
-Ref: tlmgr *--package-logfile* _file_112435
-Ref: tlmgr *--pause*112689
-Ref: tlmgr *--persistent-downloads*112844
-Ref: tlmgr *--no-persistent-downloads*112872
-Ref: tlmgr *--pin-file*113366
-Ref: tlmgr *--usermode*113584
-Ref: tlmgr *--usertree* _dir_113704
-Ref: tlmgr *--verify-repo=[none|main|all]*113830
-Node: tlmgr ACTIONS114729
-Node: tlmgr help115581
-Node: tlmgr version116057
-Node: tlmgr backup116320
-Ref: tlmgr *backup [_option_...] --all*116491
-Ref: tlmgr *backup [_option_...] _pkg_...*116524
-Ref: tlmgr *--backupdir* _directory_117379
-Ref: tlmgr *--all*117596
-Ref: tlmgr *--clean*[=_N_]117848
-Ref: tlmgr *--dry-run*118175
-Node: tlmgr candidates _pkg_118305
-Node: tlmgr check [_option_...] [files|depends|executes|runfiles|all]118651
-Ref: tlmgr *files*119024
-Ref: tlmgr *depends*119159
-Ref: tlmgr *executes*119501
-Ref: tlmgr *runfiles*119619
-Ref: tlmgr *--use-svn*119740
-Node: tlmgr conf119857
-Ref: tlmgr *conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]*120136
-Ref: tlmgr *conf auxtrees [--conffile _file_] [show|add|delete] [_value_]*120200
-Node: tlmgr dump-tlpdb [_option_...] [--json]122545
-Ref: tlmgr *--local*122978
-Ref: tlmgr *--remote*123017
-Ref: tlmgr *--json*123055
-Node: tlmgr generate123626
-Ref: tlmgr *generate [_option_...] language*123822
-Ref: tlmgr *generate [_option_...] language.dat*123861
-Ref: tlmgr *generate [_option_...] language.def*123900
-Ref: tlmgr *generate [_option_...] language.dat.lua*123943
-Ref: tlmgr *--dest* _output_file_126269
-Ref: tlmgr *--localcfg* _local_conf_file_126845
-Ref: tlmgr *--rebuild-sys*126968
-Node: tlmgr gui127783
-Node: tlmgr info127961
-Ref: tlmgr *info [_option_...] _pkg_...*128123
-Ref: tlmgr *info [_option_...] collections*128157
-Ref: tlmgr *info [_option_...] schemes*128187
-Ref: tlmgr *--list*129717
-Ref: tlmgr *--only-installed*130031
-Ref: tlmgr *--data item1,item2,...*130230
-Ref: tlmgr *--json* 1130811
-Node: tlmgr init-usertree131194
-Node: tlmgr install [_option_...] _pkg_...131575
-Ref: tlmgr *--dry-run* 1132085
-Ref: tlmgr *--file*132202
-Ref: tlmgr *--force*132424
-Ref: tlmgr *--no-depends*132644
-Ref: tlmgr *--no-depends-at-all*132803
-Ref: tlmgr *--reinstall*133203
-Ref: tlmgr *--with-doc*133581
-Ref: tlmgr *--with-src*133594
-Node: tlmgr key134116
-Ref: tlmgr *key list*134274
-Ref: tlmgr *key add _file_*134292
-Ref: tlmgr *key remove _keyid_*134314
-Node: tlmgr list134909
-Node: tlmgr option135071
-Ref: tlmgr *option [--json] [show]*135226
-Ref: tlmgr *option [--json] showall*135252
-Ref: tlmgr *option _key_ [_value_]*135278
-Node: tlmgr paper139675
-Ref: tlmgr *paper [a4|letter]*139824
-Ref: tlmgr *[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*139898
-Ref: tlmgr *paper --json*139913
-Node: tlmgr path141128
-Ref: tlmgr *path [--w32mode=user|admin] add*141289
-Ref: tlmgr *path [--w32mode=user|admin] remove*141326
-Node: tlmgr pinning142666
-Ref: tlmgr pinning show142907
-Ref: tlmgr pinning add _repo_ _pkgglob_...142980
-Ref: tlmgr pinning remove _repo_ _pkgglob_...143099
-Ref: tlmgr pinning remove _repo_ --all143252
-Node: tlmgr platform143306
-Ref: tlmgr *platform list|add|remove _platform_...*143492
-Ref: tlmgr *platform set _platform_*143519
-Ref: tlmgr *platform set auto*143540
-Ref: tlmgr *--dry-run* 2144426
-Node: tlmgr postaction144545
-Ref: tlmgr *postaction [_option_...] install [shortcut|fileassoc|script] [_pkg_...]*144775
-Ref: tlmgr *postaction [_option_...] remove [shortcut|fileassoc|script] [_pkg_...]*144849
-Ref: tlmgr *--w32mode=[user|admin]*145164
-Ref: tlmgr *--fileassocmode=[1|2]*145580
-Ref: tlmgr *--all* 1145865
-Node: tlmgr print-platform145920
-Node: tlmgr print-platform-info146251
-Node: tlmgr remove [_option_...] _pkg_...146551
-Ref: tlmgr *--all* 2147035
-Ref: tlmgr *--backup*147145
-Ref: tlmgr *--backupdir* _directory_ 1147171
-Ref: tlmgr *--no-depends* 1147576
-Ref: tlmgr *--no-depends-at-all* 1147638
-Ref: tlmgr *--force* 1147741
-Ref: tlmgr *--dry-run* 3148214
-Node: tlmgr repository148321
-Ref: tlmgr *repository list*148509
-Ref: tlmgr *repository list _path|tag_*148539
-Ref: tlmgr *repository add _path_ [_tag_]*148572
-Ref: tlmgr *repository remove _path|tag_*148604
-Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*148658
-Node: tlmgr restore149711
-Ref: tlmgr *restore [_option_...] _pkg_ [_rev_]*149890
-Ref: tlmgr *restore [_option_...] --all*149920
-Ref: tlmgr *--all* 3150620
-Ref: tlmgr *--backupdir* _directory_ 2150834
-Ref: tlmgr *--dry-run* 4151015
-Ref: tlmgr *--force* 2151147
-Ref: tlmgr *--json* 2151193
-Node: tlmgr search151520
-Ref: tlmgr *search [_option_...] _what_*151684
-Ref: tlmgr *search [_option_...] --file _what_*151721
-Ref: tlmgr *search [_option_...] --all _what_*151757
-Ref: tlmgr *--file* 1151977
-Ref: tlmgr *--all* 4152039
-Ref: tlmgr *--global*152128
-Ref: tlmgr *--word*152255
-Node: tlmgr shell152570
-Ref: tlmgr protocol153305
-Ref: tlmgr help 1153369
-Ref: tlmgr version 1153422
-Ref: tlmgr quit, end, bye, byebye, EOF153490
-Ref: tlmgr restart153511
-Ref: tlmgr load [local|remote]153634
-Ref: tlmgr save153704
-Ref: tlmgr get [_var_] =item set [_var_ [_val_]]153827
-Node: tlmgr show154428
-Node: tlmgr uninstall154595
-Node: tlmgr update [_option_...] [_pkg_...]154825
-Ref: tlmgr *--all* 5155196
-Ref: tlmgr *--self*156937
-Ref: tlmgr *--dry-run* 5157701
-Ref: tlmgr *--list* [_pkg_]157878
-Ref: tlmgr *--exclude* _pkg_158567
-Ref: tlmgr *--no-auto-remove* [_pkg_...]159367
-Ref: tlmgr *--no-auto-install* [_pkg_...]159818
-Ref: tlmgr *--reinstall-forcibly-removed*160474
-Ref: tlmgr *--backup* 1161009
-Ref: tlmgr *--backupdir* _directory_ 3161035
-Ref: tlmgr *--no-depends* 2162201
-Ref: tlmgr *--no-depends-at-all* 2162404
-Ref: tlmgr *--force* 3162507
-Node: tlmgr CONFIGURATION FILE FOR TLMGR163322
-Ref: tlmgr auto-remove, value 0 or 1 (default 1), same as command-line option.164335
-Ref: tlmgr gui-expertmode, value 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings.164472
-Ref: tlmgr gui-lang _llcode_, with a language code value as with the command-line option.164554
-Ref: tlmgr no-checksums, value 0 or 1 (default 0, see below).164608
-Ref: tlmgr persistent-downloads, value 0 or 1 (default 1), same as command-line option.164688
-Ref: tlmgr require-verification, value 0 or 1 (default 0), same as command-line option.164768
-Ref: tlmgr update-exclude, value: comma-separated list of packages (no space allowed). Same as the command line option --exclude for the action update.164916
-Ref: tlmgr verify-downloads, value 0 or 1 (default 1), same as command-line option.164992
-Ref: tlmgr allowed-actions _action1_ [,_action_,...] The value is a comma-separated list of tlmgr actions which are allowed to be executed when tlmgr is invoked in system mode (that is, without --usermode).165261
-Node: tlmgr CRYPTOGRAPHIC VERIFICATION166347
-Node: tlmgr Configuration of GnuPG invocation168496
-Node: tlmgr USER MODE169134
-Node: tlmgr User mode install171980
-Node: tlmgr User mode backup, restore, remove, update173124
-Node: tlmgr User mode generate, option, paper173566
-Node: tlmgr MULTIPLE REPOSITORIES173942
-Node: tlmgr Pinning175671
-Node: tlmgr GUI FOR TLMGR177646
-Node: tlmgr Main display178986
-Node: tlmgr Display configuration area179238
-Ref: tlmgr Status179599
-Ref: tlmgr Category179763
-Ref: tlmgr Match179949
-Ref: tlmgr Selection180130
-Ref: tlmgr Display configuration buttons180334
-Node: tlmgr Package list area180517
-Ref: tlmgr a checkbox181101
-Ref: tlmgr package name181237
-Ref: tlmgr local revision (and version)181336
-Ref: tlmgr remote revision (and version)181711
-Ref: tlmgr short description182008
-Node: tlmgr Main display action buttons182053
-Ref: tlmgr Update all installed182319
-Ref: tlmgr Update182691
-Ref: tlmgr Install182741
-Ref: tlmgr Remove182927
-Ref: tlmgr Backup183105
-Node: tlmgr Menu bar183262
-Ref: tlmgr tlmgr menu183485
-Ref: tlmgr Options menu183793
-Ref: tlmgr Actions menu184876
-Ref: tlmgr Help menu185304
-Node: tlmgr GUI options185437
-Ref: tlmgr -background _color_185683
-Ref: tlmgr -font " _fontname_ _fontsize_ "185748
-Ref: tlmgr -foreground _color_185906
-Ref: tlmgr -geometry _geomspec_185958
-Ref: tlmgr -xrm _xresource_186150
-Node: tlmgr MACHINE-READABLE OUTPUT186418
-Node: tlmgr Machine-readable update and install output187228
-Ref: tlmgr location-url _location_188504
-Ref: tlmgr total-bytes _count_188720
-Ref: tlmgr _pkgname_189130
-Ref: tlmgr _status_189340
-Ref: tlmgr d189418
-Ref: tlmgr f189478
-Ref: tlmgr u189657
-Ref: tlmgr r189703
-Ref: tlmgr a189826
-Ref: tlmgr i190004
-Ref: tlmgr I190123
-Ref: tlmgr _localrev_190225
-Ref: tlmgr _serverrev_190332
-Ref: tlmgr _size_190444
-Ref: tlmgr _runtime_190613
-Ref: tlmgr _esttot_190683
-Node: tlmgr Machine-readable option output190716
-Node: tlmgr AUTHORS AND COPYRIGHT191228
-Node: Index191627
+Node: Top-level directories31837
+Node: Autoconf macros34073
+Node: General setup macros34835
+Node: Macros for programs35710
+Node: Macros for compilers36511
+Node: Macros for libraries37919
+Node: Macros for library and header flags38345
+Node: Macros for Windows40256
+Node: Library modules41843
+Node: png library42332
+Node: zlib library44680
+Node: freetype library45195
+Node: kpathsea library45891
+Node: Program modules47270
+Node: t1utils package47698
+Node: xindy package48243
+Node: xdvik package49357
+Node: asymptote50416
+Node: Extending TeX Live50912
+Node: Adding a new program module51695
+Node: Adding a new generic library module55034
+Node: Adding a new TeX-specific library module57263
+Node: Configure options57961
+Node: Global configure options59342
+Node: --disable-native-texlive-build59884
+Node: --prefix --bindir ...60846
+Node: --disable-largefile61386
+Node: --disable-missing62087
+Node: --enable-compiler-warnings=LEVEL62488
+Node: --enable-cxx-runtime-hack63144
+Node: --enable-maintainer-mode63564
+Node: --enable-multiplatform64093
+Node: --enable-shared64666
+Node: --enable-silent-rules65037
+Node: --without-ln-s65489
+Node: --without-x65836
+Node: Program-specific configure options66024
+Node: --enable-PROG --disable-PROG66667
+Node: --disable-all-pkgs66940
+Node: Configure options for texk/web2c67723
+Node: Configure options for texk/bibtex-x70261
+Node: Configure options for texk/dvipdfm-x70804
+Node: Configure options for texk/dvisvgm71580
+Node: Configure options for texk/texlive72461
+Node: Configure options for texk/xdvik72882
+Node: Configure options for utils/xindy73503
+Node: Library-specific configure options74393
+Node: Configure options for kpathsea75395
+Node: Configure options for system poppler76144
+Node: Variables for configure76908
+Node: Coding conventions78334
+Node: Declarations and definitions79049
+Node: Const81223
+Node: Continuous integration83087
+Node: Transfer from Subversion to Github83751
+Node: Automatic update of the Git mirror85913
+Node: CI testing on Travis-CI86495
+Node: Releases on Github87204
+Node: install-tl87644
+Node: install-tl NAME88013
+Node: install-tl SYNOPSIS88171
+Node: install-tl DESCRIPTION88429
+Node: install-tl REFERENCES89496
+Node: install-tl OPTIONS90022
+Ref: install-tl *-gui* [[=]_module_]90363
+Ref: install-tl text90573
+Ref: install-tl wizard90696
+Ref: install-tl perltk90850
+Ref: install-tl *-no-gui*91281
+Ref: install-tl *-lang* _llcode_91362
+Ref: install-tl *-repository* _url|path_92049
+Ref: install-tl *-select-repository*93929
+Ref: install-tl *-all-options*94365
+Ref: install-tl *-custom-bin* _path_94620
+Ref: install-tl *-debug-translation*95452
+Ref: install-tl *-force-platform* _platform_95671
+Ref: install-tl *-help*, *--help*, *-?*95915
+Ref: install-tl *-in-place*96322
+Ref: install-tl *-init-from-profile* _profile_file_96867
+Ref: install-tl *-logfile* _file_97087
+Ref: install-tl *-no-cls*97438
+Ref: install-tl *-non-admin*97572
+Ref: install-tl *-persistent-downloads*97677
+Ref: install-tl *-no-persistent-downloads*97705
+Ref: install-tl *-no-verify-downloads*98323
+Ref: install-tl *-portable*98684
+Ref: install-tl *-print-platform*98823
+Ref: install-tl *-profile* _profile_file_99021
+Ref: install-tl *-q*99201
+Ref: install-tl *-scheme* _scheme_99263
+Ref: install-tl *-v*99737
+Ref: install-tl *-version*, *--version*99892
+Node: install-tl PROFILES100023
+Ref: install-tl instopt_adjustpath (default 0 on Unix, 1 on Windows)102673
+Ref: install-tl instopt_adjustrepo (default 1)102749
+Ref: install-tl instopt_letter (default 0)102886
+Ref: install-tl instopt_portable (default 0)102977
+Ref: install-tl instopt_write18_restricted (default 1)103073
+Node: install-tl ENVIRONMENT VARIABLES104392
+Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK104783
+Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE104985
+Ref: install-tl TEXLIVE_INSTALL_NO_WELCOME105095
+Ref: install-tl TEXLIVE_INSTALL_PREFIX105216
+Ref: install-tl TEXLIVE_INSTALL_TEXDIR105242
+Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG105273
+Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR105301
+Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME105330
+Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL105360
+Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG105394
+Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR105425
+Ref: install-tl NOPERLDOC105796
+Node: install-tl AUTHORS AND COPYRIGHT105860
+Node: tlmgr106276
+Node: tlmgr NAME106729
+Node: tlmgr SYNOPSIS106861
+Node: tlmgr DESCRIPTION107051
+Node: tlmgr EXAMPLES108147
+Ref: tlmgr tlmgr option repository ctan108398
+Ref: tlmgr tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet108470
+Ref: tlmgr tlmgr update --list108922
+Ref: tlmgr tlmgr update --all109015
+Ref: tlmgr tlmgr info _what_109172
+Node: tlmgr OPTIONS109434
+Ref: tlmgr *--repository* _url|path_109954
+Ref: tlmgr *--gui* [_action_]110679
+Ref: tlmgr *--gui-lang* _llcode_111086
+Ref: tlmgr *--debug-translation*111769
+Ref: tlmgr *--machine-readable*111972
+Ref: tlmgr *--no-execute-actions*112240
+Ref: tlmgr *--package-logfile* _file_112433
+Ref: tlmgr *--pause*112687
+Ref: tlmgr *--persistent-downloads*112842
+Ref: tlmgr *--no-persistent-downloads*112870
+Ref: tlmgr *--pin-file*113364
+Ref: tlmgr *--usermode*113582
+Ref: tlmgr *--usertree* _dir_113702
+Ref: tlmgr *--verify-repo=[none|main|all]*113828
+Node: tlmgr ACTIONS114727
+Node: tlmgr help115579
+Node: tlmgr version116055
+Node: tlmgr backup116318
+Ref: tlmgr *backup [_option_...] --all*116489
+Ref: tlmgr *backup [_option_...] _pkg_...*116522
+Ref: tlmgr *--backupdir* _directory_117377
+Ref: tlmgr *--all*117594
+Ref: tlmgr *--clean*[=_N_]117846
+Ref: tlmgr *--dry-run*118173
+Node: tlmgr candidates _pkg_118303
+Node: tlmgr check [_option_...] [files|depends|executes|runfiles|all]118649
+Ref: tlmgr *files*119022
+Ref: tlmgr *depends*119157
+Ref: tlmgr *executes*119499
+Ref: tlmgr *runfiles*119617
+Ref: tlmgr *--use-svn*119738
+Node: tlmgr conf119855
+Ref: tlmgr *conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]*120134
+Ref: tlmgr *conf auxtrees [--conffile _file_] [show|add|delete] [_value_]*120198
+Node: tlmgr dump-tlpdb [_option_...] [--json]122543
+Ref: tlmgr *--local*122976
+Ref: tlmgr *--remote*123015
+Ref: tlmgr *--json*123053
+Node: tlmgr generate123624
+Ref: tlmgr *generate [_option_...] language*123820
+Ref: tlmgr *generate [_option_...] language.dat*123859
+Ref: tlmgr *generate [_option_...] language.def*123898
+Ref: tlmgr *generate [_option_...] language.dat.lua*123941
+Ref: tlmgr *--dest* _output_file_126267
+Ref: tlmgr *--localcfg* _local_conf_file_126843
+Ref: tlmgr *--rebuild-sys*126966
+Node: tlmgr gui127781
+Node: tlmgr info127959
+Ref: tlmgr *info [_option_...] _pkg_...*128121
+Ref: tlmgr *info [_option_...] collections*128155
+Ref: tlmgr *info [_option_...] schemes*128185
+Ref: tlmgr *--list*129715
+Ref: tlmgr *--only-installed*130029
+Ref: tlmgr *--data item1,item2,...*130228
+Ref: tlmgr *--json* 1130809
+Node: tlmgr init-usertree131192
+Node: tlmgr install [_option_...] _pkg_...131573
+Ref: tlmgr *--dry-run* 1132083
+Ref: tlmgr *--file*132200
+Ref: tlmgr *--force*132422
+Ref: tlmgr *--no-depends*132642
+Ref: tlmgr *--no-depends-at-all*132801
+Ref: tlmgr *--reinstall*133201
+Ref: tlmgr *--with-doc*133579
+Ref: tlmgr *--with-src*133592
+Node: tlmgr key134114
+Ref: tlmgr *key list*134272
+Ref: tlmgr *key add _file_*134290
+Ref: tlmgr *key remove _keyid_*134312
+Node: tlmgr list134907
+Node: tlmgr option135069
+Ref: tlmgr *option [--json] [show]*135224
+Ref: tlmgr *option [--json] showall*135250
+Ref: tlmgr *option _key_ [_value_]*135276
+Node: tlmgr paper139673
+Ref: tlmgr *paper [a4|letter]*139822
+Ref: tlmgr *[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*139896
+Ref: tlmgr *paper --json*139911
+Node: tlmgr path141126
+Ref: tlmgr *path [--w32mode=user|admin] add*141287
+Ref: tlmgr *path [--w32mode=user|admin] remove*141324
+Node: tlmgr pinning142664
+Ref: tlmgr pinning show142905
+Ref: tlmgr pinning add _repo_ _pkgglob_...142978
+Ref: tlmgr pinning remove _repo_ _pkgglob_...143097
+Ref: tlmgr pinning remove _repo_ --all143250
+Node: tlmgr platform143304
+Ref: tlmgr *platform list|add|remove _platform_...*143490
+Ref: tlmgr *platform set _platform_*143517
+Ref: tlmgr *platform set auto*143538
+Ref: tlmgr *--dry-run* 2144424
+Node: tlmgr postaction144543
+Ref: tlmgr *postaction [_option_...] install [shortcut|fileassoc|script] [_pkg_...]*144773
+Ref: tlmgr *postaction [_option_...] remove [shortcut|fileassoc|script] [_pkg_...]*144847
+Ref: tlmgr *--w32mode=[user|admin]*145162
+Ref: tlmgr *--fileassocmode=[1|2]*145578
+Ref: tlmgr *--all* 1145863
+Node: tlmgr print-platform145918
+Node: tlmgr print-platform-info146249
+Node: tlmgr remove [_option_...] _pkg_...146549
+Ref: tlmgr *--all* 2147033
+Ref: tlmgr *--backup*147143
+Ref: tlmgr *--backupdir* _directory_ 1147169
+Ref: tlmgr *--no-depends* 1147574
+Ref: tlmgr *--no-depends-at-all* 1147636
+Ref: tlmgr *--force* 1147739
+Ref: tlmgr *--dry-run* 3148212
+Node: tlmgr repository148319
+Ref: tlmgr *repository list*148507
+Ref: tlmgr *repository list _path|tag_*148537
+Ref: tlmgr *repository add _path_ [_tag_]*148570
+Ref: tlmgr *repository remove _path|tag_*148602
+Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*148656
+Node: tlmgr restore149709
+Ref: tlmgr *restore [_option_...] _pkg_ [_rev_]*149888
+Ref: tlmgr *restore [_option_...] --all*149918
+Ref: tlmgr *--all* 3150618
+Ref: tlmgr *--backupdir* _directory_ 2150832
+Ref: tlmgr *--dry-run* 4151013
+Ref: tlmgr *--force* 2151145
+Ref: tlmgr *--json* 2151191
+Node: tlmgr search151518
+Ref: tlmgr *search [_option_...] _what_*151682
+Ref: tlmgr *search [_option_...] --file _what_*151719
+Ref: tlmgr *search [_option_...] --all _what_*151755
+Ref: tlmgr *--file* 1151975
+Ref: tlmgr *--all* 4152037
+Ref: tlmgr *--global*152126
+Ref: tlmgr *--word*152253
+Node: tlmgr shell152568
+Ref: tlmgr protocol153303
+Ref: tlmgr help 1153367
+Ref: tlmgr version 1153420
+Ref: tlmgr quit, end, bye, byebye, EOF153488
+Ref: tlmgr restart153509
+Ref: tlmgr load [local|remote]153632
+Ref: tlmgr save153702
+Ref: tlmgr get [_var_] =item set [_var_ [_val_]]153825
+Node: tlmgr show154426
+Node: tlmgr uninstall154593
+Node: tlmgr update [_option_...] [_pkg_...]154823
+Ref: tlmgr *--all* 5155194
+Ref: tlmgr *--self*156935
+Ref: tlmgr *--dry-run* 5157699
+Ref: tlmgr *--list* [_pkg_]157876
+Ref: tlmgr *--exclude* _pkg_158565
+Ref: tlmgr *--no-auto-remove* [_pkg_...]159365
+Ref: tlmgr *--no-auto-install* [_pkg_...]159816
+Ref: tlmgr *--reinstall-forcibly-removed*160472
+Ref: tlmgr *--backup* 1161007
+Ref: tlmgr *--backupdir* _directory_ 3161033
+Ref: tlmgr *--no-depends* 2162199
+Ref: tlmgr *--no-depends-at-all* 2162402
+Ref: tlmgr *--force* 3162505
+Node: tlmgr CONFIGURATION FILE FOR TLMGR163320
+Ref: tlmgr auto-remove, value 0 or 1 (default 1), same as command-line option.164333
+Ref: tlmgr gui-expertmode, value 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings.164470
+Ref: tlmgr gui-lang _llcode_, with a language code value as with the command-line option.164552
+Ref: tlmgr no-checksums, value 0 or 1 (default 0, see below).164606
+Ref: tlmgr persistent-downloads, value 0 or 1 (default 1), same as command-line option.164686
+Ref: tlmgr require-verification, value 0 or 1 (default 0), same as command-line option.164766
+Ref: tlmgr update-exclude, value: comma-separated list of packages (no space allowed). Same as the command line option --exclude for the action update.164914
+Ref: tlmgr verify-downloads, value 0 or 1 (default 1), same as command-line option.164990
+Ref: tlmgr allowed-actions _action1_ [,_action_,...] The value is a comma-separated list of tlmgr actions which are allowed to be executed when tlmgr is invoked in system mode (that is, without --usermode).165259
+Node: tlmgr CRYPTOGRAPHIC VERIFICATION166345
+Node: tlmgr Configuration of GnuPG invocation168494
+Node: tlmgr USER MODE169132
+Node: tlmgr User mode install171978
+Node: tlmgr User mode backup, restore, remove, update173122
+Node: tlmgr User mode generate, option, paper173564
+Node: tlmgr MULTIPLE REPOSITORIES173940
+Node: tlmgr Pinning175669
+Node: tlmgr GUI FOR TLMGR177644
+Node: tlmgr Main display178984
+Node: tlmgr Display configuration area179236
+Ref: tlmgr Status179597
+Ref: tlmgr Category179761
+Ref: tlmgr Match179947
+Ref: tlmgr Selection180128
+Ref: tlmgr Display configuration buttons180332
+Node: tlmgr Package list area180515
+Ref: tlmgr a checkbox181099
+Ref: tlmgr package name181235
+Ref: tlmgr local revision (and version)181334
+Ref: tlmgr remote revision (and version)181709
+Ref: tlmgr short description182006
+Node: tlmgr Main display action buttons182051
+Ref: tlmgr Update all installed182317
+Ref: tlmgr Update182689
+Ref: tlmgr Install182739
+Ref: tlmgr Remove182925
+Ref: tlmgr Backup183103
+Node: tlmgr Menu bar183260
+Ref: tlmgr tlmgr menu183483
+Ref: tlmgr Options menu183791
+Ref: tlmgr Actions menu184874
+Ref: tlmgr Help menu185302
+Node: tlmgr GUI options185435
+Ref: tlmgr -background _color_185681
+Ref: tlmgr -font " _fontname_ _fontsize_ "185746
+Ref: tlmgr -foreground _color_185904
+Ref: tlmgr -geometry _geomspec_185956
+Ref: tlmgr -xrm _xresource_186148
+Node: tlmgr MACHINE-READABLE OUTPUT186416
+Node: tlmgr Machine-readable update and install output187226
+Ref: tlmgr location-url _location_188502
+Ref: tlmgr total-bytes _count_188718
+Ref: tlmgr _pkgname_189128
+Ref: tlmgr _status_189338
+Ref: tlmgr d189416
+Ref: tlmgr f189476
+Ref: tlmgr u189655
+Ref: tlmgr r189701
+Ref: tlmgr a189824
+Ref: tlmgr i190002
+Ref: tlmgr I190121
+Ref: tlmgr _localrev_190223
+Ref: tlmgr _serverrev_190330
+Ref: tlmgr _size_190442
+Ref: tlmgr _runtime_190611
+Ref: tlmgr _esttot_190681
+Node: tlmgr Machine-readable option output190714
+Node: tlmgr AUTHORS AND COPYRIGHT191226
+Node: Index191625

End Tag Table
diff --git a/Build/source/texk/kpathsea/ChangeLog b/Build/source/texk/kpathsea/ChangeLog
index dab9c798ccc..81c85b1c87f 100644
--- a/Build/source/texk/kpathsea/ChangeLog
+++ b/Build/source/texk/kpathsea/ChangeLog
@@ -1,7 +1,13 @@
+2019-12-22 Karl Berry <karl@freefriends.org>
+
+ * doc/kpathsea.texi (Path searching): mention translations for TL.
+ (Config files): distinguish special characters at different levels.
+ (Filename database): don't mention talking about 8.3 filenames.
+
2019-12-16 Karl Berry <karl@freefriends.org>
* texmf.cnf (glob_str_size): increase from 20,000 to 200,000
- for bibtex-bigauth.test (q.v.).
+ for web2c/tests/bibtex-bigauth.test (q.v.).
(ent_str_size, max_strings.bibtex*): increase these while we're here.
2019-11-03 Karl Berry <karl@tug.org>
diff --git a/Build/source/texk/kpathsea/doc/kpathsea.info b/Build/source/texk/kpathsea/doc/kpathsea.info
index 959873b6e8c..17f236f6646 100644
--- a/Build/source/texk/kpathsea/doc/kpathsea.info
+++ b/Build/source/texk/kpathsea/doc/kpathsea.info
@@ -1,4 +1,4 @@
-This is kpathsea.info, produced by makeinfo version 6.6 from
+This is kpathsea.info, produced by makeinfo version 6.7 from
kpathsea.texi.
This file documents the Kpathsea library for path searching.
@@ -37,7 +37,7 @@ Kpathsea library
****************
This manual documents the Kpathsea library for path searching. It
-corresponds to version 6.3.2, released in August 2019.
+corresponds to version 6.3.2, released in December 2019.
* Menu:
@@ -62,7 +62,7 @@ File: kpathsea.info, Node: Introduction, Next: unixtex.ftp, Prev: Top, Up: T
**************
This manual corresponds to version 6.3.2 of the Kpathsea library,
-released in August 2019.
+released in December 2019.
The library's fundamental purpose is to return a filename from a list
of directories specified by the user, similar to what shells do when
@@ -374,6 +374,11 @@ This chapter describes the generic path searching mechanism Kpathsea
provides. For information about searching for particular file types
(e.g., TeX fonts), see the next chapter.
+ This section, with minor differences, has been translated into
+several other languages (Chinese, Spanish, Russian, Japanese, French,
+German, ...) as part of the TeX Live guide; see
+<https://tug.org/texlive/doc.html> for links.
+
* Menu:
* Searching overview:: Basic scheme for searching.
@@ -526,7 +531,7 @@ mentions most features. The format of 'texmf.cnf' files follows:
not start a comment. Examples:
% this is a comment
- var = a%b % but the value of var will be "a%b".
+ var = a%b % but the value of var will be "a%b"
* Blank lines are ignored.
@@ -534,7 +539,7 @@ mentions most features. The format of 'texmf.cnf' files follows:
the next line is appended. Whitespace at the beginning of
continuation lines is not ignored.
- * Each remaining line must look like
+ * Each remaining line will look like:
VARIABLE [. PROGNAME] [=] VALUE
@@ -550,14 +555,20 @@ mentions most features. The format of 'texmf.cnf' files follows:
flavors of TeX to have different search paths. The PROGNAME value
is used literally, without variable or other expansions.
- * VALUE may contain any characters except '%' and '@'. (These
- restrictions are only necessary because of the processing done on
- 'texmf.cnf' at build time, so you can stick those characters in
- after installation if you have to.) The '$VAR.PROG' feature is not
- available on the right-hand side; instead, you must use an
- additional variable (see below for example). A ';' in VALUE is
- translated to ':' if running under Unix; this is useful to write a
- single 'texmf.cnf' which can be used under both Unix and Windows.
+ * Considered as strings, VALUE may contain any character. However,
+ in practice most 'texmf.cnf' values are related to path expansion,
+ and since various special characters are used in expansion, such as
+ braces and commas, they cannot be used in directory names.
+
+ The '$VAR.PROG' feature is not available on the right-hand side;
+ instead, you must use an additional variable (see below for
+ example).
+
+ A ';' in VALUE is translated to ':' if running under Unix, in order
+ to have a single 'texmf.cnf' that can support both Unix and Windows
+ systems. This translation happens with any value, not just search
+ paths, but fortunately in practice ';' is not needed in other
+ values.
* All definitions are read before anything is expanded, so you can
use variables before they are defined (like Make, unlike most other
@@ -573,12 +584,12 @@ Here is a configuration file fragment illustrating most of these points:
TEXINPUTS.latex2e = $latex2e_inputs
TEXINPUTS.latex = $latex2e_inputs
- This format has obvious similarities to Bourne shell scripts--change
-the comment character to '#', disallow spaces around the '=', and get
-rid of the '.NAME' convention, and it could be run through the shell.
-However, there seemed little advantage in this, since all the
-information would have to passed back to Kpathsea and parsed there
-anyway, since the 'sh' process couldn't affect its parent's environment.
+ This format has some similarity to Bourne shell scripts--change the
+comment character to '#', disallow spaces around the '=', and get rid of
+the '.NAME' convention, and it could be run through the shell. However,
+there seemed little advantage in this, since all the information would
+have to passed back to Kpathsea and parsed there anyway, since the 'sh'
+process couldn't affect its parent's environment.
The combination of spaces being ignored before the '.' of a program
name qualifer and the optional '=' for the assignment has an unexpected
@@ -590,6 +601,15 @@ Kpathsea warns if the program name contains a path separator or other
special character. The simplest way to avoid the problem is to use the
'='.
+ Exactly when a character will be considered special or act as itself
+depends on the context in which it is used. The rules are inherent in
+the multiple levels of interpretation of the configuration (parsing,
+expansion, search, ...) and so cannot be concisely stated,
+unfortunately. There is no general escape mechanism; in particular, '\'
+is not an "escape character" in 'texmf.cnf' files. When it comes
+choosing directory names for installation, it is safest to avoid them
+all.
+
The implementation of all this is in 'kpathsea/cnf.c'.

@@ -815,7 +835,7 @@ if the path specification is, say, '$TEXMF/fonts//pk//', then files in a
subdirectory '.../pk', even if it is a leaf, are checked. The reason
cannot be explained without reference to the implementation, so read
'kpathsea/elt-dirs.c' (search for 'may descend') if you are curious.
-And if you can find a way to _solve_ the problem, please let me know.
+And if you find a way to solve the problem, please let me know.
Subdirectory expansion is implemented in the source file
'kpathsea/elt-dirs.c'.
@@ -975,7 +995,7 @@ File: kpathsea.info, Node: Filename database, Next: Invoking kpsewhich, Prev:
Kpathsea goes to some lengths to minimize disk accesses for searches
(*note Subdirectory expansion::). Nevertheless, in practice searching
-each possible directory in typical TeX installations takes an
+every possible directory in typical TeX installations takes an
excessively long time.
Therefore, Kpathsea can use an externally-built "filename database"
@@ -983,8 +1003,7 @@ file named 'ls-R' that maps files to directories, thus avoiding the need
to exhaustively search the disk.
A second database file 'aliases' allows you to give additional names
-to the files listed in 'ls-R'. This can be helpful to adapt to "8.3"
-filename conventions in source files.
+to the files listed in 'ls-R'.
The 'ls-R' and 'aliases' features are implemented in the source file
'kpathsea/db.c'.
@@ -3154,6 +3173,7 @@ Index
(line 195)
* .pro: Supported file formats.
(line 169)
+* .PROGNAME qualifier in texmf.cnf: Config files. (line 50)
* .rhosts, writable by TeX: Security. (line 10)
* .ris: Supported file formats.
(line 173)
@@ -3191,6 +3211,8 @@ Index
* 8.3 filenames, using: mktex configuration. (line 68)
* : may not be :: Searching overview. (line 13)
* :: expansion: Default expansion. (line 6)
+* ; translated to : in texmf.cnf: Config files. (line 66)
+* = omitted in texmf.cnf and misparsing: Config files. (line 93)
* \, line continuation in texmf.cnf: Config files. (line 37)
* \openin: Searching overview. (line 31)
* \special, suppressing warnings about: Suppressing warnings.
@@ -3267,7 +3289,7 @@ Index
(line 46)
* cmr10, as fallback font: Fallback font. (line 15)
* cmr10.vf: Searching overview. (line 31)
-* cnf.c: Config files. (line 97)
+* cnf.c: Config files. (line 112)
* cnf.h: Programming with config files.
(line 27)
* comments, in fontmap files: Fontmap. (line 27)
@@ -3296,7 +3318,7 @@ Index
* config.status: Bug checklist. (line 27)
* configuration bugs: Bug checklist. (line 27)
* configuration file, source for path: Path sources. (line 20)
-* configuration files as shell scripts.: Config files. (line 80)
+* configuration files as shell scripts.: Config files. (line 86)
* configuration of mktex scripts: mktex configuration. (line 6)
* configure options for mktex scripts: mktex configuration. (line 12)
* context diff: Bug checklist. (line 52)
@@ -3711,7 +3733,7 @@ Index
* setgid scripts: Security. (line 40)
* SFDFONTS: Supported file formats.
(line 177)
-* shell scripts as configuration files: Config files. (line 80)
+* shell scripts as configuration files: Config files. (line 86)
* shell variables: Variable expansion. (line 17)
* shell_escape, example for code: Programming with config files.
(line 10)
@@ -3863,6 +3885,8 @@ Index
* tolerance for glyph lookup: Basic glyph lookup. (line 15)
* trailing / in home directory: Tilde expansion. (line 19)
* trailing colons: Default expansion. (line 6)
+* translations, of path searching description: Path searching.
+ (line 10)
* TRFONTS: Supported file formats.
(line 203)
* trick for detecting leaf directories: Subdirectory expansion.
@@ -3931,61 +3955,66 @@ Index

Tag Table:
Node: Top1480
-Node: Introduction2261
-Node: History4332
-Node: unixtex.ftp8928
-Node: Security10353
-Node: TeX directory structure12857
-Node: Path searching16905
-Node: Searching overview17632
-Node: Path sources21451
-Node: Config files22677
-Node: Path expansion27283
-Node: Default expansion28236
-Node: Variable expansion30306
-Node: Tilde expansion31707
-Node: Brace expansion32687
-Node: KPSE_DOT expansion33626
-Node: Subdirectory expansion34139
-Node: Casefolding search36493
-Node: Casefolding rationale37262
-Node: Casefolding examples38601
-Node: Filename database43651
-Node: ls-R44709
-Node: Filename aliases48385
-Node: Database format49563
-Node: Invoking kpsewhich50576
-Node: Path searching options51531
-Node: Specially-recognized files61129
-Node: Auxiliary tasks62484
-Node: Standard options66209
-Node: TeX support66565
-Node: Supported file formats67919
-Node: File lookup75584
-Node: Glyph lookup77333
-Node: Basic glyph lookup78457
-Node: Fontmap79337
-Node: Fallback font81866
-Node: Suppressing warnings82778
-Node: mktex scripts83905
-Node: mktex configuration85120
-Node: mktex script names90923
-Node: mktex script arguments92309
-Node: Programming93188
-Node: Programming overview93761
-Node: Calling sequence96622
-Node: Program-specific files103154
-Node: Programming with config files104177
-Node: Reporting bugs105764
-Node: Bug checklist106442
-Node: Mailing lists109914
-Node: Debugging110589
-Node: Logging115666
-Node: Common problems117533
-Node: Unable to find files118010
-Node: Slow path searching120420
-Node: Unable to generate fonts121795
-Node: TeX or Metafont failing124266
-Node: Index125468
+Node: Introduction2263
+Node: History4336
+Node: unixtex.ftp8932
+Node: Security10357
+Node: TeX directory structure12861
+Node: Path searching16909
+Node: Searching overview17867
+Node: Path sources21686
+Node: Config files22912
+Node: Path expansion28175
+Node: Default expansion29128
+Node: Variable expansion31198
+Node: Tilde expansion32599
+Node: Brace expansion33579
+Node: KPSE_DOT expansion34518
+Node: Subdirectory expansion35031
+Node: Casefolding search37379
+Node: Casefolding rationale38148
+Node: Casefolding examples39487
+Node: Filename database44537
+Node: ls-R45519
+Node: Filename aliases49195
+Node: Database format50373
+Node: Invoking kpsewhich51386
+Node: Path searching options52341
+Node: Specially-recognized files61939
+Node: Auxiliary tasks63294
+Node: Standard options67019
+Node: TeX support67375
+Node: Supported file formats68729
+Node: File lookup76394
+Node: Glyph lookup78143
+Node: Basic glyph lookup79267
+Node: Fontmap80147
+Node: Fallback font82676
+Node: Suppressing warnings83588
+Node: mktex scripts84715
+Node: mktex configuration85930
+Node: mktex script names91733
+Node: mktex script arguments93119
+Node: Programming93998
+Node: Programming overview94571
+Node: Calling sequence97432
+Node: Program-specific files103964
+Node: Programming with config files104987
+Node: Reporting bugs106574
+Node: Bug checklist107252
+Node: Mailing lists110724
+Node: Debugging111399
+Node: Logging116476
+Node: Common problems118343
+Node: Unable to find files118820
+Node: Slow path searching121230
+Node: Unable to generate fonts122605
+Node: TeX or Metafont failing125076
+Node: Index126278

End Tag Table
+
+
+Local Variables:
+coding: utf-8
+End:
diff --git a/Build/source/texk/kpathsea/doc/kpathsea.texi b/Build/source/texk/kpathsea/doc/kpathsea.texi
index db619f50129..8fdb387fff1 100644
--- a/Build/source/texk/kpathsea/doc/kpathsea.texi
+++ b/Build/source/texk/kpathsea/doc/kpathsea.texi
@@ -3,7 +3,7 @@
@settitle Kpathsea: A library for path searching
@set version 6.3.2
-@set month-year August 2019
+@set month-year December 2019
@copying
This file documents the Kpathsea library for path searching.
@@ -445,6 +445,12 @@ This chapter describes the generic path searching mechanism Kpathsea
provides. For information about searching for particular file types
(e.g., @TeX{} fonts), see the next chapter.
+@cindex translations, of path searching description
+This section, with minor differences, has been translated into several
+other languages (Chinese, Spanish, Russian, Japanese, French, German,
+@dots{}) as part of the @TeX{} Live guide; see
+@url{https://tug.org/texlive/doc.html} for links.
+
@menu
* Searching overview:: Basic scheme for searching.
* Path sources:: Where search paths can be defined.
@@ -652,7 +658,7 @@ start a comment. Examples:
@example
% this is a comment
-var = a%b % but the value of var will be "a%b".
+var = a%b % but the value of var will be "a%b"
@end example
@item
@@ -668,7 +674,7 @@ A @samp{\} at the end of a line acts as a continuation character, i.e.,
the next line is appended. Whitespace at the beginning of continuation
lines is not ignored.
-@item Each remaining line must look like
+@item Each remaining line will look like:
@example
@var{variable} @r{[}. @var{progname}@r{]} @r{[}=@r{]} @var{value}
@@ -681,6 +687,7 @@ lines is not ignored.
The @var{variable} name may contain any character other than whitespace,
@samp{=}, or @samp{.}, but sticking to @samp{A-Za-z_} is safest.
+@kindex .@var{progname} @r{qualifier in @file{texmf.cnf}}
@item If @samp{.@var{progname}} is present (preceding spaces are
ignored), the definition only applies if the program that is running
is named (i.e., the last component of @code{argv[0]} is)
@@ -691,15 +698,21 @@ variable or other expansions.
@item
@cindex right-hand side of variable assignments
-@var{value} may contain any characters except @samp{%} and @samp{@@}.
-(These restrictions are only necessary because of the processing done
-on @file{texmf.cnf} at build time, so you can stick those characters
-in after installation if you have to.) The
-@samp{$@var{var}.@var{prog}} feature is not available on the
+Considered as strings, @var{value} may contain any character.
+However, in practice most @file{texmf.cnf} values are related to path
+expansion, and since various special characters are used in expansion,
+such as braces and commas, they cannot be used in directory names.
+
+The @samp{$@var{var}.@var{prog}} feature is not available on the
right-hand side; instead, you must use an additional variable (see
-below for example). A @samp{;} in @var{value} is translated to
-@samp{:} if running under Unix; this is useful to write a single
-@file{texmf.cnf} which can be used under both Unix and Windows.
+below for example).
+
+@kindex ; @r{translated to @samp{:} in @file{texmf.cnf}}
+A @samp{;} in @var{value} is translated to @samp{:} if running under
+Unix, in order to have a single @file{texmf.cnf} that can support both
+Unix and Windows systems. This translation happens with any value, not
+just search paths, but fortunately in practice @samp{;} is not needed
+in other values.
@item All definitions are read before anything is expanded, so you can
use variables before they are defined (like Make, unlike most other
@@ -721,14 +734,15 @@ TEXINPUTS.latex = $latex2e_inputs
@cindex shell scripts as configuration files
@cindex configuration files as shell scripts.
-This format has obvious similarities to Bourne shell scripts---change
-the comment character to @code{#}, disallow spaces around the
-@code{=}, and get rid of the @code{.@var{name}} convention, and it
-could be run through the shell. However, there seemed little
-advantage in this, since all the information would have to passed back
-to Kpathsea and parsed there anyway, since the @code{sh} process
-couldn't affect its parent's environment.
-
+This format has some similarity to Bourne shell scripts---change the
+comment character to @code{#}, disallow spaces around the @code{=},
+and get rid of the @code{.@var{name}} convention, and it could be run
+through the shell. However, there seemed little advantage in this,
+since all the information would have to passed back to Kpathsea and
+parsed there anyway, since the @code{sh} process couldn't affect its
+parent's environment.
+
+@kindex = @r{omitted in @file{texmf.cnf} and misparsing}
The combination of spaces being ignored before the @code{.} of a
program name qualifer and the optional @samp{=} for the assignment has
an unexpected consequence: if the value begins with a literal @samp{.}
@@ -739,6 +753,15 @@ an empty value for @code{var} running under the program named
name contains a path separator or other special character. The
simplest way to avoid the problem is to use the @code{=}.
+Exactly when a character will be considered special or act as itself
+depends on the context in which it is used. The rules are inherent in
+the multiple levels of interpretation of the configuration (parsing,
+expansion, search, @dots{}) and so cannot be concisely stated,
+unfortunately. There is no general escape mechanism; in particular,
+@samp{\} is not an ``escape character'' in @file{texmf.cnf} files.
+When it comes choosing directory names for installation, it is safest to
+avoid them all.
+
@flindex cnf.c
The implementation of all this is in @file{kpathsea/cnf.c}.
@@ -1024,11 +1047,11 @@ You can disable the trick by undefining @code{ST_NLINK_TRICK} in
Unfortunately, in some cases files in leaf directories are
@code{stat}'d: if the path specification is, say,
@samp{$TEXMF/fonts//pk//}, then files in a subdirectory
-@samp{@dots{}/pk}, even if it is a leaf, are checked. The reason cannot
-be explained without reference to the implementation, so read
+@samp{@dots{}/pk}, even if it is a leaf, are checked. The reason
+cannot be explained without reference to the implementation, so read
@file{kpathsea/elt-dirs.c} (search for @samp{may descend}) if you are
-curious. And if you can find a way to @emph{solve} the problem, please
-let me know.
+curious. And if you find a way to solve the problem, please let me
+know.
@flindex elt-dirs.c
Subdirectory expansion is implemented in the source file
@@ -1217,7 +1240,7 @@ happens with the elements of the leaf directory.
Kpathsea goes to some lengths to minimize disk accesses for searches
(@pxref{Subdirectory expansion}). Nevertheless, in practice searching
-each possible directory in typical @TeX{} installations takes an
+every possible directory in typical @TeX{} installations takes an
excessively long time.
Therefore, Kpathsea can use an externally-built @dfn{filename
@@ -1225,8 +1248,7 @@ database} file named @file{ls-R} that maps files to directories, thus
avoiding the need to exhaustively search the disk.
A second database file @file{aliases} allows you to give additional
-names to the files listed in @file{ls-R}. This can be helpful to adapt
-to ``8.3'' filename conventions in source files.
+names to the files listed in @file{ls-R}.
The @file{ls-R} and @file{aliases} features are implemented in the
source file @file{kpathsea/db.c}.
diff --git a/Master/texmf-dist/doc/texlive/texlive-en/.dict.pws b/Master/texmf-dist/doc/texlive/texlive-en/.dict.pws
index 0ac94b3c6e9..232268ffde2 100644
--- a/Master/texmf-dist/doc/texlive/texlive-en/.dict.pws
+++ b/Master/texmf-dist/doc/texlive/texlive-en/.dict.pws
@@ -387,6 +387,7 @@ luajittex
luatex
lz
lzma
+macOS
macos
makeindex
manpages
diff --git a/Master/texmf-dist/doc/texlive/texlive-en/Makefile b/Master/texmf-dist/doc/texlive/texlive-en/Makefile
index b07bc2c26c0..346f3032d92 100644
--- a/Master/texmf-dist/doc/texlive/texlive-en/Makefile
+++ b/Master/texmf-dist/doc/texlive/texlive-en/Makefile
@@ -41,3 +41,7 @@ spell:
cat texlive-en.tex \
| aspell list --mode=tex --add-extra-dicts=`pwd`/.dict.pws \
| sort -f -u
+
+svr:
+ svn revert texlive-??.css texlive-??.html texlive-??.pdf
+ svn status
diff --git a/Master/texmf-dist/doc/texlive/texlive-en/tex-live.sty b/Master/texmf-dist/doc/texlive/texlive-en/tex-live.sty
index a8ebccf1694..2cdc0d34994 100644
--- a/Master/texmf-dist/doc/texlive/texlive-en/tex-live.sty
+++ b/Master/texmf-dist/doc/texlive/texlive-en/tex-live.sty
@@ -33,13 +33,13 @@
\RequirePackage{fancyvrb}
\DefineVerbatimEnvironment{verbatim}{Verbatim}{fontsize=\normalsize}
-\DefineVerbatimEnvironment{fverbatim}{Verbatim}{fontsize=\footnotesize}
\DefineVerbatimEnvironment{sverbatim}{Verbatim}{fontsize=\small}
+\DefineVerbatimEnvironment{fverbatim}{Verbatim}{fontsize=\footnotesize}
\DefineVerbatimEnvironment{boxedverbatim}
{Verbatim}{fontsize=\footnotesize,frame=single}
\DefineVerbatimEnvironment{Verbatim}{Verbatim}{fontsize=\normalsize}
-\def\verbatiminput#1{\VerbatimInput[fontsize=\scriptsize]{#1}}
-\def\boxedverbatiminput#1{\VerbatimInput[frame=single,fontsize=\scriptsize]{#1}}
+\def\verbatiminput#1{\VerbatimInput[fontsize=\small]{#1}}
+\def\boxedverbatiminput#1{\VerbatimInput[frame=single,fontsize=\footnotesize]{#1}}
\def\listinginput#1#2{\VerbatimInput[fontsize=\scriptsize,firstnumber=#1,numbers=left]{#2}}
\MakeShortVerb\|
%
diff --git a/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex b/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex
index fad2f54510e..8d5a148c825 100644
--- a/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex
+++ b/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex
@@ -17,7 +17,7 @@
\url{https://tug.org/texlive/}
}
-\date{August 2019}
+\date{December 2019}
\begin{document}
\maketitle
@@ -124,6 +124,13 @@ processing documents, a feature that can also be abused in a wide
variety of ways. Again, processing unknown documents in a new
subdirectory is the safest bet.
+Another aspect of security is ensuring that downloaded material has not
+been changed from what was created. The \prog{tlmgr} program
+(section~\ref{sec:tlmgr}) will automatically perform cryptographic
+verification on downloads if the \prog{gpg} (GNU Privacy Guard) program
+is available. It is not distributed as part of \TL, but see
+\url{https://texlive.info/tlgpg/} for information about \prog{gpg} if
+need be.
\subsection{Getting help}
\label{sec:help}
@@ -252,10 +259,6 @@ in various languages, in both \HTML{} and plain text.
installation, and special support for Windows.
\end{ttdescription}
-In addition to the directories above, the installation scripts and
-\filename{README} files (in various languages) are at the top level of
-the distribution.
-
For documentation, the comprehensive links in the top-level file
\OnCD{doc.html} may be helpful. The documentation for nearly everything
(packages, formats, fonts, program manuals, man pages, Info files) is in
@@ -312,10 +315,10 @@ earlier ones.
The expansion of this variable dynamically adjusts for each user to
their own individual directory.
\item [TEXMFVAR] The (personal) tree used by \verb+texconfig+,
- \verb+updmap+ and \verb+fmtutil+ to store (cached) runtime data such
+ \verb+updmap-user+ and \verb+fmtutil-usr+ to store (cached) runtime data such
as format files and generated map files.
\item [TEXMFCONFIG] The (personal) tree used by the utilities
- \verb+texconfig+, \verb+updmap+, and \verb+fmtutil+ to store modified
+ \verb+texconfig+, \verb+updmap-sys+, and \verb+fmtutil-sys+ to store modified
configuration data.
\item [TEXMFCACHE] The tree(s) used by \ConTeXt\ MkIV and Lua\LaTeX\
to store (cached) runtime data; defaults to \code{TEXMFSYSVAR},
@@ -385,7 +388,7 @@ extensions. This is the program invoked for most formats, e.g.,
\prog{etex}, \prog{latex}, \prog{pdflatex}. Its web site is
\url{http://www.pdftex.org/}. See
\OnCD{texmf-dist/doc/pdftex/manual/pdftex-a.pdf} for the manual, and
-\OnCD{texmf-dist/doc/pdftex/manual/samplepdf/samplepdf.tex} for example
+\OnCD{texmf-dist/doc/pdftex/samplepdf/samplepdf.tex} for example
usage of some of its features.
\item [Lua\TeX] is the designated successor of pdf\TeX,
@@ -874,12 +877,12 @@ More info on each:
short) list of allowed programs is given in the \filename{texmf.cnf}.
See the 2010 news (section~\ref{sec:2010news}) for more details.
-\item[create format files:] Although unnecessary format files
+\item[create all format files:] Although unnecessary format files
take time to generate and disk space to store, it is still recommended
to leave this option checked: if you don't, then format files will be
generated in people's private \dirname{TEXMFVAR} tree as they are
needed. In that location, they will not be updated automatically if
- (say) binaries or hyphenation patterns are updated in the
+ (for example) core packages or hyphenation patterns are updated in the
installation, and thus you could end up with incompatible format files.
\item[install font/macro \ldots\ tree:] Download/install the
@@ -897,7 +900,8 @@ More info on each:
your system with this option, e.g., by specifying system directories.
The safest and recommended approach is to leave the option unchecked.
-\item[after installation \ldots\ \CTAN:] When installing from \DVD, this
+\item[after install, set CTAN as source for package updates:]
+ When installing from \DVD, this
option is enabled by default, since usually one wants to take any
subsequent package updates from the \CTAN\ area that is updated
throughout the year. The only likely reason to disable it is if you
@@ -1038,7 +1042,7 @@ them. The man pages might be found automatically after the addition to
For Bourne-compatible shells such as \prog{bash}, and using Intel x86
GNU/Linux and a default directory setup as an example, the file to edit
might be \filename{$HOME/.profile} (or another file sourced by
-\filename{.profile}, and the lines to add would look like this:
+\filename{.profile}), and the lines to add would look like this:
\begin{sverbatim}
PATH=/usr/local/texlive/2019/bin/x86_64-linux:$PATH; export PATH
@@ -1240,7 +1244,7 @@ start creating beautiful documents and\slash or fonts.
One thing you may immediately be looking for is a front-end with which
to edit files. \TL{} installs \TeX{}works
(\url{http://tug.org/texworks}) on Windows (only), and Mac\TeX\ installs
-TeXShop (\url{http://pages.uoregon.edu/koch/texshop}. On other Unix
+TeXShop (\url{https://pages.uoregon.edu/koch/texshop)}. On other Unix
systems, it's left up to you to choose an editor. There are many
choices available, some of which are listed in the next section; see
also \url{http://tug.org/interest.html#editors}. Any plain text editor
@@ -1312,7 +1316,7 @@ incorrectly, you'll get an error \samp{Can't open display}.
Neither \cmdname{gv} nor \cmdname{xpdf} are included in \TL{}, so
you must install them separately. See
\url{http://www.gnu.org/software/gv} and
-\url{http://www.foolabs.com/xpdf}, respectively. There are plenty
+\url{http://www.xpdfreader.com}, respectively. There are plenty
of other PDF viewers, too. For Windows, we recommend trying Sumatra
PDF (\url{https://www.sumatrapdfreader.org/free-pdf-reader.html}).
@@ -1358,9 +1362,9 @@ Links for some other tools you may consider installing:
\item[Ghostscript] \url{https://ghostscript.com/}
\item[Perl] \url{http://www.perl.org/} with
supplementary packages from CPAN, \url{http://www.cpan.org/}
-\item[ImageMagick] \url{http://www.imagemagick.com}, for graphics
+\item[ImageMagick] \url{https://imagemagick.org}, for graphics
processing and conversion
-\item[NetPBM] \url{http://netpbm.sourceforge.net/}, also for graphics.
+\item[NetPBM] \url{http://netpbm.sourceforge.net}, also for graphics.
\item[\TeX-oriented editors] There is a wide choice, and it is a matter of the
user's taste. Here is a selection in alphabetical order (a few
@@ -1551,22 +1555,21 @@ program. We still distribute and maintain \prog{texconfig} for the sake
of anyone used to its interface, but we recommend using \prog{tlmgr}
nowadays.
-\subsection{Current \GUI{} interfaces for \cmdname{tlmgr}}
+\subsection{\GUI{} interfaces for \cmdname{tlmgr}}
-\TL{} contains several \GUI s for
-\prog{tlmgr}. Figure~\ref{fig:tlshell} shows \cmdname{tlshell},
-which is written in Tcl/Tk and works out of the box under Windows
-and \MacOSX. Figure~\ref{fig:tlcockpit} shows \prog{tlcockpit},
-which requires Java version~8 or higher and JavaFX. Both are
-separate packages.
+\TL{} contains several \GUI{} front-ends for \prog{tlmgr}. Two notable
+ones: (1)~Figure~\ref{fig:tlshell} shows \cmdname{tlshell}, which is
+written in Tcl/Tk and runs out of the box under Windows and \MacOSX;
+(2)~Figure~\ref{fig:tlcockpit} shows \prog{tlcockpit}, which requires
+Java version~8 or higher and JavaFX. Both are separate packages.
-\prog{tlmgr} itself can also be run in \GUI{} mode
-(figure~\ref{fig:tlmgr-gui}) with
+\prog{tlmgr} also has a native \GUI{} mode (shown in
+figure~\ref{fig:tlmgr-gui}), which is started with:
\begin{alltt}
> \Ucom{tlmgr -gui}
\end{alltt}
-This \GUI\ extension requires Perl/Tk, which module is no longer
-included in \TL's Perl distribution for Windows.
+However, this \GUI\ extension requires Perl/Tk, which module is no
+longer included in \TL's Perl distribution for Windows.
\subsection{Sample \cmdname{tlmgr} command-line invocations}
@@ -1865,10 +1868,14 @@ programs will help you take advantage of your \Webc{} installation.
All programs honor these standard \GNU options:
\begin{ttdescription}
\item[-{}-help] print basic usage summary.
-\item[-{}-verbose] print detailed progress report.
\item[-{}-version] print version information, then exit.
\end{ttdescription}
+And most also honor:
+\begin{ttdescription}
+\item[-{}-verbose] print detailed progress report.
+\end{ttdescription}
+
For locating files the \Webc{} programs use the path searching library
\KPS{} (\url{http://tug.org/kpathsea}). This library uses a combination
of environment variables and configuration files to optimize searching
@@ -1984,7 +1991,8 @@ example, with a search path of \verb|.:$TEXMF|, values from
\begin{itemize*}
\item
- Comments start with \code{\%} and continue to the end of the line.
+ Comments start with \code{\%}, either at the beginning of a line or
+ preceded by whitespace, and continue to the end of the line.
\item
Blank lines are ignored.
\item
@@ -1992,10 +2000,8 @@ example, with a search path of \verb|.:$TEXMF|, values from
i.e., the next line is appended. Whitespace at the beginning of
continuation lines is not ignored.
\item
- Each remaining line has the form:
-\begin{alltt}
- \var{variable}[.\var{progname}] [=] \var{value}
-\end{alltt}%
+ Each remaining line has the form:\\
+ \hspace*{2em}\texttt{\var{variable}[.\var{progname}] [=] \var{value}}\\[1pt]
where the \samp{=} and surrounding whitespace are optional.
(But if \var{value} begins with \samp{.}, it is simplest to use the
\samp{=} to avoid the period being interpreted as the program name
@@ -2010,13 +2016,21 @@ example, with a search path of \verb|.:$TEXMF|, values from
\texttt{\var{progname}} or \texttt{\var{progname}.exe}. This allows
different flavors of \TeX{} to have different search paths, for
example.
-\item \var{value} may contain any characters except
- \code{\%} and \samp{@}. The
- \code{\$\var{var}.\var{prog}} feature is not available on the
- right-hand side; instead, you must use an additional variable. A
- \samp{;}\ in \var{value} is translated to \samp{:}\ if
- running under Unix; this is useful to be able to have a single
- \file{texmf.cnf} for Unix, MS-DOS and Windows systems.
+\item Considered as strings, \var{value} may contain any character.
+ However, in practice most \file{texmf.cnf} values are related to path
+ expansion, and since various special characters are used in expansion
+ (see section~\ref{sec:cnf-special-chars}), such as braces and commas,
+ they cannot be used in directory names.
+
+ A \samp{;} in \var{value} is translated to \samp{:} if running under
+ Unix, in order to have a single \file{texmf.cnf} that can support both
+ Unix and Windows systems. This translation happens with any value, not
+ just search paths, but fortunately in practice \samp{;} is not needed
+ in other values.
+
+ The \code{\$\var{var}.\var{prog}} feature is not available on the
+ right-hand side; instead, you must use an additional variable.
+
\item
All definitions are read before anything is expanded, so
variables can be referenced before they are defined.
@@ -2033,10 +2047,9 @@ shown in figure~\ref{fig:config-sample}.
\subsubsection{Path expansion}
\label{sec:path-expansion}
-
\KPS{} recognizes certain special characters and constructions in
search paths, similar to those available in Unix shells. As a
-general example, the complex path,
+general example, the path
\verb+~$USER/{foo,bar}//baz+, expands to all subdirectories under
directories \file{foo} and \file{bar} in \texttt{\$USER}'s home
directory that contain a directory or file \file{baz}. These
@@ -2078,31 +2091,26 @@ A useful feature is brace expansion, which means that, for instance,
\verb+v{a,b}w+ expands to \verb+vaw:vbw+. Nesting is allowed.
This is used to implement multiple \TeX{} hierarchies, by
assigning a brace list to \code{\$TEXMF}.
-For example, in \file{texmf.cnf}, a definition like this
+In the distributed \file{texmf.cnf}, a definition like this
(simplified for this example) is made:
\begin{verbatim}
TEXMF = {$TEXMFVAR,$TEXMFHOME,!!$TEXMFLOCAL,!!$TEXMFDIST}
\end{verbatim}
-We can then use this to define, for example, the \TeX\ input path:
+We then use this to define, for example, the \TeX\ input path:
\begin{verbatim}
TEXINPUTS = .;$TEXMF/tex//
\end{verbatim}
%$
which means that, after looking in the current directory, the
\code{\$TEXMFVAR/tex}, \code{\$TEXMFHOME/tex}, \code{\$TEXMFLOCAL/tex}
-and \code{\$TEXMFDIST/tex} trees \emph{only}) will be searched (the
-last two using \file{ls-R} data base files). It is a convenient
-way for running two parallel \TeX{} structures, one ``frozen'' (on a
-\CD, for instance) and the other being continuously updated with new
-versions as they become available. By using the \code{\$TEXMF}
-variable in all definitions, one is sure to always search the
-up-to-date tree first.
+and \code{\$TEXMFDIST/tex} trees will be searched (the
+last two using \file{ls-R} data base files).
\subsubsection{Subdirectory expansion}
\label{sec:subdirectory-expansion}
Two or more consecutive slashes in a path element following a directory
-\var{d} is replaced by all subdirectories of \var{d}: first those
+\var{d} is replaced by all subdirectories of \var{d\/}: first those
subdirectories directly under \var{d}, then the subsubdirectories under
those, and so on. At each level, the order in which the directories are
searched is \emph{unspecified}.
@@ -2115,43 +2123,55 @@ subdirectories with matching components are included. For example,
Multiple \samp{//} constructs in a path are possible, but
\samp{//} at the beginning of a path is ignored.
-\subsubsection{List of special characters and their meaning: a summary}
+\subsubsection{Summary of special characters in \file{texmf.cnf} files}
+\label{sec:cnf-special-chars}
-The following list summarizes the special characters in \KPS{}
-configuration files.
+The following list summarizes the special characters and constructs in
+\KPS{} configuration files.
% need a wider space for the item labels here.
\newcommand{\CODE}[1]{\makebox[3em][l]{\code{#1}}}
\begin{ttdescription}
\item[\CODE{:}] Separator in path specification; at the beginning or
- the end of a path it substitutes the default path expansion.\par
+ the end of a path, or doubled in the middle, it substitutes the
+ default path expansion.\par
\item[\CODE{;}] Separator on non-Unix systems (acts like \code{:}).
\item[\CODE{\$}] Variable expansion.
\item[\CODE{\string~}] Represents the user's home directory.
\item[\CODE{\char`\{...\char`\}}] Brace expansion.
+\item[\CODE{,}] Separates items in brace expansion.
\item[\CODE{//}] Subdirectory expansion (can occur anywhere in
a path, except at its beginning).
\item[\CODE{\%}] Start of comment.
-\item[\CODE{\bs}] Continuation character (allows multi-line entries).
+\item[\CODE{\bs}] At the end of a line, continuation character to allow
+ multi-line entries.
\item[\CODE{!!}] Search \emph{only} database to locate file, \emph{do
not} search the disk.
\end{ttdescription}
+Exactly when a character will be considered special or act as itself
+depends on the context in which it is used. The rules are inherent in
+the multiple levels of interpretation of the configuration (parsing,
+expansion, search, \ldots)\ and so cannot be concisely stated,
+unfortunately. There is no general escape mechanism; in particular,
+\samp{\bs} is not an ``escape character'' in \file{texmf.cnf} files.
+
+When it comes choosing directory names for installation, it is safest to
+avoid them all.
\subsection{Filename databases}
\label{sec:filename-database}
\KPS{} goes to some lengths to minimize disk accesses for searches.
-Nevertheless, at installations with enough directories, searching each
-possible directory for a given file can take an excessively long time
-(this is especially true if many hundreds of font directories have to
-be traversed.) Therefore, \KPS{} can use an externally-built plain text
-``database'' file named \file{ls-R} that maps files to directories,
-thus avoiding the need to exhaustively search the disk.
+Nevertheless, in the standard \TL, or at any installation with enough
+directories, searching every possible directory for a given file will
+take an excessively long time. Therefore, \KPS{} can use an
+externally-built plain text ``database'' file named \file{ls-R} that
+maps files to directories, thus avoiding the need to exhaustively search
+the disk.
A second database file \file{aliases} allows you to give additional
-names to the files listed in \file{ls-R}. This can be helpful to
-confirm to DOS 8.3 filename conventions in source files.
+names to the files listed in \file{ls-R}.
\subsubsection{The filename database}
\label{sec:ls-R}
@@ -3234,8 +3254,9 @@ all cases, the metrics remain unchanged. The AMS fonts home page is
The new \GUI{} front end \TeX{}works is included for Windows, and also in
Mac\TeX. For other platforms, and more information, see the \TeX{}works
-home page, \url{http://tug.org/texworks}. It is a cross-platform front
-end inspired by the \MacOSX\ TeXShop editor, aiming at ease-of-use.
+home page, \url{http://tug.org/texworks}. It is a cross-platform
+front-end inspired by the \MacOSX\ TeXShop editor, aiming at
+ease-of-use.
The graphics program Asymptote is included for several platforms. This
implements a text-based graphics description language vaguely akin to
@@ -3605,7 +3626,7 @@ to incorporate various CJK fonts into Ghostscript.
Infrastructure: System-level \code{tlmgr} configuration file supported;
verify package checksums; if GPG is available, verify signature of
network updates. These checks happen with both the installer and
-\code{tlmgr}. (If GPG is not available, updates proceed as usual.)
+\code{tlmgr}. If GPG is not available, updates proceed as usual.
Platforms: \code{alpha-linux} and \code{mipsel-linux} removed.
@@ -3664,7 +3685,7 @@ accepted).
Sync\TeX: the name of the temporary file now looks like
\code{foo.synctex(busy)}, instead of \code{foo.synctex.gz(busy)}
-(no~\code{.gz}). Front ends and build systems that want to remove temp
+(no~\code{.gz}). Front-ends and build systems that want to remove temp
files may need adjusting.
Other utilities: \code{texosquery-jre8} is a new cross-platform program
diff --git a/Master/texmf-dist/scripts/texlive/tlmgr.pl b/Master/texmf-dist/scripts/texlive/tlmgr.pl
index 38d239410aa..0e1d3de88eb 100755
--- a/Master/texmf-dist/scripts/texlive/tlmgr.pl
+++ b/Master/texmf-dist/scripts/texlive/tlmgr.pl
@@ -7738,18 +7738,23 @@ trailing C</tlpkg> and/or C</archive> components are ignored.
=item B<--gui> [I<action>]
-C<tlmgr> has a graphical interface as well as the command line
-interface. You can give this option, C<--gui>, together with an action
-to be brought directly into the respective screen of the GUI. For
-example, running
+Two notable GUI front-ends for C<tlmgr>, C<tlshell> and C<tlcockpit>,
+are started up as separate programs; see their own documentation.
+
+C<tlmgr> itself has a graphical interface as well as the command line
+interface. You can give the option to invoke it, C<--gui>, together with
+an action to be brought directly into the respective screen of the GUI.
+For example, running
tlmgr --gui update
starts you directly at the update screen. If no action is given, the
-GUI will be started at the main screen.
+GUI will be started at the main screen. See L<GUI FOR TLMGR>.
+
+However, the native GUI requires Perl/TK, which is no longer included in
+TeX Live's Perl distribution for Windows. You may find C<tlshell> or
+C<tlcockpit> easier to work with.
-Note that the new GUIs, tlshell and tlcockpit, are started up as
-separate programs.
=for comment Keep language list in sync with install-tl.
@@ -7758,14 +7763,15 @@ separate programs.
By default, the GUI tries to deduce your language from the environment
(on Windows via the registry, on Unix via C<LC_MESSAGES>). If that fails
you can select a different language by giving this option with a
-language code (based on ISO 639-1). Currently supported (but not
-necessarily completely translated) are: English (en, default), Czech
-(cs), German (de), French (fr), Italian (it), Japanese (ja), Dutch (nl),
-Polish (pl), Brazilian Portuguese (pt_BR), Russian (ru), Slovak (sk),
-Slovenian (sl), Serbian (sr), Ukrainian (uk), Vietnamese (vi),
-simplified Chinese (zh_CN), and traditional Chinese (zh_TW).
+language code (based on ISO 639-1). Currently supported (but not
+necessarily completely translated) are: S<English (en, default)>,
+S<Czech (cs)>, S<German (de)>, S<French (fr)>, S<Italian (it)>,
+S<Japanese (ja)>, S<Dutch (nl)>, S<Polish (pl)>, S<Brazilian Portuguese
+(pt_BR)>, S<Russian (ru)>, S<Slovak (sk)>, S<Slovenian (sl)>, S<Serbian
+(sr)>, S<Ukrainian (uk)>, S<Vietnamese (vi)>, S<simplified Chinese
+(zh_CN)>, and S<traditional Chinese (zh_TW)>.
-Tlshell shares its message catalog with tlmgr.
+tlshell shares its message catalog with tlmgr.
=item B<--debug-translation>
@@ -8481,7 +8487,7 @@ instead of only the current user. All three options are on by default.
=item B<paper [a4|letter]>
-=item B<S<[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [I<papersize>|--list]>>
+=item B<<[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [I<papersize>|--list]>>
=item B<paper --json>
@@ -9478,7 +9484,7 @@ from a given repository:
$ tlmgr pinning remove tlcontrib classico # remove just classico
$ tlmgr pinning remove tlcontrib --all # take nothing from tlcontrib
-A summary of the C<tlmgr pinning> actions is given above.
+A summary of C<tlmgr pinning> actions is given above.
=head1 GUI FOR TLMGR