summaryrefslogtreecommitdiff
path: root/Build/source
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 /Build/source
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
Diffstat (limited to 'Build/source')
-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
6 files changed, 519 insertions, 458 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}.