From 29ad0b23168602c8f159a884fe596b355dfd3658 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 22 Dec 2019 22:22:33 +0000 Subject: 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 --- Build/source/doc/ChangeLog | 4 + Build/source/doc/build-tools.txt | 2 +- Build/source/doc/tlbuild.info | 696 +++++++++++++-------------- Build/source/texk/kpathsea/ChangeLog | 8 +- Build/source/texk/kpathsea/doc/kpathsea.info | 193 ++++---- Build/source/texk/kpathsea/doc/kpathsea.texi | 74 ++- 6 files changed, 519 insertions(+), 458 deletions(-) (limited to 'Build') 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 + + * build-tools.txt: bison 3.5. + 2019-08-11 Karl Berry * 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 + + * 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 * 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 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 + 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}. -- cgit v1.2.3