summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html')
-rw-r--r--Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html2223
1 files changed, 1385 insertions, 838 deletions
diff --git a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html
index 235be54d030..223cee7a568 100644
--- a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html
+++ b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html
@@ -88,9 +88,8 @@ ul.no-bullet {list-style: none}
<li><a name="stoc-Installing-1" href="#toc-Installing-1">5 Installing</a></li>
<li><a name="stoc-Layout-and-infrastructure-1" href="#toc-Layout-and-infrastructure-1">6 Layout and infrastructure</a></li>
<li><a name="stoc-Configure-options-1" href="#toc-Configure-options-1">7 Configure options</a></li>
-<li><a name="stoc-Cross-compilation-1" href="#toc-Cross-compilation-1">8 Cross compilation</a></li>
-<li><a name="stoc-Coding-conventions-1" href="#toc-Coding-conventions-1">9 Coding conventions</a></li>
-<li><a name="stoc-Continuous-integration-1" href="#toc-Continuous-integration-1">10 Continuous integration</a></li>
+<li><a name="stoc-Coding-conventions-1" href="#toc-Coding-conventions-1">8 Coding conventions</a></li>
+<li><a name="stoc-Continuous-integration-1" href="#toc-Continuous-integration-1">9 Continuous integration</a></li>
<li><a name="stoc-install_002dtl-1" href="#toc-install_002dtl-1">Appendix A install-tl</a></li>
<li><a name="stoc-tlmgr-1" href="#toc-tlmgr-1">Appendix B tlmgr</a></li>
<li><a name="stoc-Index-1" href="#toc-Index-1">Index</a></li>
@@ -113,6 +112,11 @@ ul.no-bullet {list-style: none}
<li><a name="toc-Build-in-parallel-1" href="#Build-in-parallel">4.3 Build in parallel</a></li>
<li><a name="toc-Build-distribution-1" href="#Build-distribution">4.4 Build distribution</a></li>
<li><a name="toc-Build-one-package-1" href="#Build-one-package">4.5 Build one package</a></li>
+ <li><a name="toc-Cross-compilation-1" href="#Cross-compilation">4.6 Cross compilation</a>
+ <ul class="no-bullet">
+ <li><a name="toc-Cross-configuring-1" href="#Cross-configuring">4.6.1 Cross configuring</a></li>
+ <li><a name="toc-Cross-problems-1" href="#Cross-problems">4.6.2 Cross problems</a></li>
+ </ul></li>
</ul></li>
<li><a name="toc-Installing-1" href="#Installing">5 Installing</a>
<ul class="no-bullet">
@@ -190,17 +194,17 @@ ul.no-bullet {list-style: none}
</ul></li>
<li><a name="toc-Variables-for-configure-1" href="#Variables-for-configure">7.4 Variables for configure</a></li>
</ul></li>
- <li><a name="toc-Cross-compilation-1" href="#Cross-compilation">8 Cross compilation</a>
+ <li><a name="toc-Coding-conventions-1" href="#Coding-conventions">8 Coding conventions</a>
<ul class="no-bullet">
- <li><a name="toc-Cross-configuring-1" href="#Cross-configuring">8.1 Cross configuring</a></li>
- <li><a name="toc-Cross-problems-1" href="#Cross-problems">8.2 Cross problems</a></li>
+ <li><a name="toc-Declarations-and-definitions-1" href="#Declarations-and-definitions">8.1 Declarations and definitions</a></li>
+ <li><a name="toc-Const-1" href="#Const">8.2 Const</a></li>
</ul></li>
- <li><a name="toc-Coding-conventions-1" href="#Coding-conventions">9 Coding conventions</a>
+ <li><a name="toc-Continuous-integration-1" href="#Continuous-integration">9 Continuous integration</a>
<ul class="no-bullet">
- <li><a name="toc-Declarations-and-definitions-1" href="#Declarations-and-definitions">9.1 Declarations and definitions</a></li>
- <li><a name="toc-Const-1" href="#Const">9.2 Const</a></li>
+ <li><a name="toc-Transfer-from-Subversion-to-Github-1" href="#Transfer-from-Subversion-to-Github">9.1 Transfer from Subversion to Github</a></li>
+ <li><a name="toc-Automatic-update-of-the-Git-mirror-1" href="#Automatic-update-of-the-Git-mirror">9.2 Automatic update of the Git mirror</a></li>
+ <li><a name="toc-CI-testing-on-Travis_002dCI-1" href="#CI-testing-on-Travis_002dCI">9.3 CI testing on Travis-CI</a></li>
</ul></li>
- <li><a name="toc-Continuous-integration-1" href="#Continuous-integration">10 Continuous integration</a></li>
<li><a name="toc-install_002dtl-1" href="#install_002dtl">Appendix A install-tl</a>
<ul class="no-bullet">
<li><a name="toc-NAME" href="#install_002dtl-NAME">A.1 NAME</a></li>
@@ -208,8 +212,9 @@ ul.no-bullet {list-style: none}
<li><a name="toc-DESCRIPTION" href="#install_002dtl-DESCRIPTION">A.3 DESCRIPTION</a></li>
<li><a name="toc-REFERENCES" href="#install_002dtl-REFERENCES">A.4 REFERENCES</a></li>
<li><a name="toc-OPTIONS" href="#install_002dtl-OPTIONS">A.5 OPTIONS</a></li>
- <li><a name="toc-ENVIRONMENT-VARIABLES" href="#install_002dtl-ENVIRONMENT-VARIABLES">A.6 ENVIRONMENT VARIABLES</a></li>
- <li><a name="toc-AUTHORS-AND-COPYRIGHT" href="#install_002dtl-AUTHORS-AND-COPYRIGHT">A.7 AUTHORS AND COPYRIGHT</a></li>
+ <li><a name="toc-PROFILES" href="#install_002dtl-PROFILES">A.6 PROFILES</a></li>
+ <li><a name="toc-ENVIRONMENT-VARIABLES" href="#install_002dtl-ENVIRONMENT-VARIABLES">A.7 ENVIRONMENT VARIABLES</a></li>
+ <li><a name="toc-AUTHORS-AND-COPYRIGHT" href="#install_002dtl-AUTHORS-AND-COPYRIGHT">A.8 AUTHORS AND COPYRIGHT</a></li>
</ul></li>
<li><a name="toc-tlmgr-1" href="#tlmgr">Appendix B tlmgr</a>
<ul class="no-bullet">
@@ -222,48 +227,46 @@ ul.no-bullet {list-style: none}
<ul class="no-bullet">
<li><a name="toc-help" href="#tlmgr-help">B.6.1 help</a></li>
<li><a name="toc-version" href="#tlmgr-version">B.6.2 version</a></li>
- <li><a name="toc-backup-_005b_002d_002dclean_005b_003dN_005d_005d-_005b_002d_002dbackupdir-dir_005d-_005b_002d_002dall-_007c-pkg_005d_002e_002e_002e" href="#tlmgr-backup-_005b_002d_002dclean_005b_003dN_005d_005d-_005b_002d_002dbackupdir-dir_005d-_005b_002d_002dall-_007c-pkg_005d_002e_002e_002e">B.6.3 backup [&ndash;clean[=<em>N</em>]] [&ndash;backupdir <em>dir</em>] [&ndash;all | <em>pkg</em>]...</a></li>
+ <li><a name="toc-backup" href="#tlmgr-backup">B.6.3 backup</a></li>
<li><a name="toc-candidates-pkg" href="#tlmgr-candidates-pkg">B.6.4 candidates <em>pkg</em></a></li>
- <li><a name="toc-check-_005boption_005d_002e_002e_002e-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d" href="#tlmgr-check-_005boption_005d_002e_002e_002e-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d">B.6.5 check [<em>option</em>]... [files|depends|executes|runfiles|all]</a></li>
- <li><a name="toc-conf-_005btexmf_007ctlmgr_007cupdmap-_005b_002d_002dconffile-file_005d-_005b_002d_002ddelete_005d-_005bkey-_005bvalue_005d_005d_005d" href="#tlmgr-conf-_005btexmf_007ctlmgr_007cupdmap-_005b_002d_002dconffile-file_005d-_005b_002d_002ddelete_005d-_005bkey-_005bvalue_005d_005d_005d">B.6.6 conf [texmf|tlmgr|updmap [&ndash;conffile <em>file</em>] [&ndash;delete] [<em>key</em> [<em>value</em>]]]</a></li>
- <li><a name="toc-dump_002dtlpdb-_005b_002d_002dlocal_007c_002d_002dremote_005d" href="#tlmgr-dump_002dtlpdb-_005b_002d_002dlocal_007c_002d_002dremote_005d">B.6.7 dump-tlpdb [&ndash;local|&ndash;remote]</a></li>
- <li><a name="toc-generate-_005boption_005d_002e_002e_002e-what" href="#tlmgr-generate-_005boption_005d_002e_002e_002e-what">B.6.8 generate [<em>option</em>]... <em>what</em></a></li>
+ <li><a name="toc-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d" href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d">B.6.5 check [<em>option</em>...] [files|depends|executes|runfiles|all]</a></li>
+ <li><a name="toc-conf" href="#tlmgr-conf">B.6.6 conf</a></li>
+ <li><a name="toc-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d">B.6.7 dump-tlpdb [<em>option</em>...] [&ndash;json]</a></li>
+ <li><a name="toc-generate" href="#tlmgr-generate">B.6.8 generate</a></li>
<li><a name="toc-gui" href="#tlmgr-gui">B.6.9 gui</a></li>
- <li><a name="toc-info-_005boption_002e_002e_002e_005d-_005bcollections_007cschemes_007cpkg_002e_002e_002e_005d" href="#tlmgr-info-_005boption_002e_002e_002e_005d-_005bcollections_007cschemes_007cpkg_002e_002e_002e_005d">B.6.10 info [<em>option</em>...] [collections|schemes|<em>pkg</em>...]</a></li>
+ <li><a name="toc-info" href="#tlmgr-info">B.6.10 info</a></li>
<li><a name="toc-init_002dusertree" href="#tlmgr-init_002dusertree">B.6.11 init-usertree</a></li>
- <li><a name="toc-install-_005boption_005d_002e_002e_002e-pkg_002e_002e_002e" href="#tlmgr-install-_005boption_005d_002e_002e_002e-pkg_002e_002e_002e">B.6.12 install [<em>option</em>]... <em>pkg</em>...</a></li>
- <li><a name="toc-option" href="#tlmgr-option">B.6.13 option</a></li>
- <li><a name="toc-paper" href="#tlmgr-paper">B.6.14 paper</a></li>
- <li><a name="toc-path-_005b_002d_002dw32mode_003duser_007cadmin_005d-_005badd_007cremove_005d" href="#tlmgr-path-_005b_002d_002dw32mode_003duser_007cadmin_005d-_005badd_007cremove_005d">B.6.15 path [&ndash;w32mode=user|admin] [add|remove]</a></li>
- <li><a name="toc-pinning" href="#tlmgr-pinning">B.6.16 pinning</a></li>
- <li><a name="toc-platform-list_007cadd_007cremove-platform_002e_002e_002e" href="#tlmgr-platform-list_007cadd_007cremove-platform_002e_002e_002e">B.6.17 platform list|add|remove <em>platform</em>...</a></li>
- <li><a name="toc-platform-set-platform" href="#tlmgr-platform-set-platform">B.6.18 platform set <em>platform</em></a></li>
- <li><a name="toc-platform-set-auto" href="#tlmgr-platform-set-auto">B.6.19 platform set auto</a></li>
- <li><a name="toc-postaction-_005b_002d_002dw32mode_003duser_007cadmin_005d-_005b_002d_002dfileassocmode_003d1_007c2_005d-_005b_002d_002dall_005d-_005binstall_007cremove_005d-_005bshortcut_007cfileassoc_007cscript_005d-_005bpkg_005d_002e_002e_002e" href="#tlmgr-postaction-_005b_002d_002dw32mode_003duser_007cadmin_005d-_005b_002d_002dfileassocmode_003d1_007c2_005d-_005b_002d_002dall_005d-_005binstall_007cremove_005d-_005bshortcut_007cfileassoc_007cscript_005d-_005bpkg_005d_002e_002e_002e">B.6.20 postaction [&ndash;w32mode=user|admin] [&ndash;fileassocmode=1|2] [&ndash;all] [install|remove] [shortcut|fileassoc|script] [<em>pkg</em>]...</a></li>
+ <li><a name="toc-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">B.6.12 install [<em>option</em>...] <em>pkg</em>...</a></li>
+ <li><a name="toc-key" href="#tlmgr-key">B.6.13 key</a></li>
+ <li><a name="toc-list" href="#tlmgr-list">B.6.14 list</a></li>
+ <li><a name="toc-option" href="#tlmgr-option">B.6.15 option</a></li>
+ <li><a name="toc-paper" href="#tlmgr-paper">B.6.16 paper</a></li>
+ <li><a name="toc-path" href="#tlmgr-path">B.6.17 path</a></li>
+ <li><a name="toc-pinning" href="#tlmgr-pinning">B.6.18 pinning</a></li>
+ <li><a name="toc-platform" href="#tlmgr-platform">B.6.19 platform</a></li>
+ <li><a name="toc-postaction" href="#tlmgr-postaction">B.6.20 postaction</a></li>
<li><a name="toc-print_002dplatform" href="#tlmgr-print_002dplatform">B.6.21 print-platform</a></li>
- <li><a name="toc-restore-_005b_002d_002dbackupdir-dir_005d-_005b_002d_002dall-_007c-pkg-_005brev_005d_005d" href="#tlmgr-restore-_005b_002d_002dbackupdir-dir_005d-_005b_002d_002dall-_007c-pkg-_005brev_005d_005d">B.6.22 restore [&ndash;backupdir <em>dir</em>] [&ndash;all | <em>pkg</em> [<em>rev</em>]]</a></li>
- <li><a name="toc-remove-_005boption_005d_002e_002e_002e-pkg_002e_002e_002e" href="#tlmgr-remove-_005boption_005d_002e_002e_002e-pkg_002e_002e_002e">B.6.23 remove [<em>option</em>]... <em>pkg</em>...</a></li>
+ <li><a name="toc-print_002dplatform_002dinfo" href="#tlmgr-print_002dplatform_002dinfo">B.6.22 print-platform-info</a></li>
+ <li><a name="toc-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">B.6.23 remove [<em>option</em>...] <em>pkg</em>...</a></li>
<li><a name="toc-repository" href="#tlmgr-repository">B.6.24 repository</a></li>
- <li><a name="toc-search-_005boption_002e_002e_002e_005d-what" href="#tlmgr-search-_005boption_002e_002e_002e_005d-what">B.6.25 search [<em>option</em>...] <em>what</em></a>
- <ul class="no-bullet">
- <li><a name="toc-search-_005boption_002e_002e_002e_005d-_002d_002dfile-what" href="#tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dfile-what">B.6.25.1 search [<em>option</em>...] &ndash;file <em>what</em></a></li>
- <li><a name="toc-search-_005boption_002e_002e_002e_005d-_002d_002dtaxonomy-what" href="#tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dtaxonomy-what">B.6.25.2 search [<em>option</em>...] &ndash;taxonomy <em>what</em></a></li>
- <li><a name="toc-search-_005boption_002e_002e_002e_005d-_002d_002dkeyword-what" href="#tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dkeyword-what">B.6.25.3 search [<em>option</em>...] &ndash;keyword <em>what</em></a></li>
- <li><a name="toc-search-_005boption_002e_002e_002e_005d-_002d_002dfunctionality-what" href="#tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dfunctionality-what">B.6.25.4 search [<em>option</em>...] &ndash;functionality <em>what</em></a></li>
- <li><a name="toc-search-_005boption_002e_002e_002e_005d-_002d_002dcharacterization-what" href="#tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dcharacterization-what">B.6.25.5 search [<em>option</em>...] &ndash;characterization <em>what</em></a></li>
- <li><a name="toc-search-_005boption_002e_002e_002e_005d-_002d_002dall-what" href="#tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dall-what">B.6.25.6 search [<em>option</em>...] &ndash;all <em>what</em></a></li>
- </ul></li>
- <li><a name="toc-uninstall" href="#tlmgr-uninstall">B.6.26 uninstall</a></li>
- <li><a name="toc-update-_005boption_005d_002e_002e_002e-_005bpkg_005d_002e_002e_002e" href="#tlmgr-update-_005boption_005d_002e_002e_002e-_005bpkg_005d_002e_002e_002e">B.6.27 update [<em>option</em>]... [<em>pkg</em>]...</a></li>
+ <li><a name="toc-restore" href="#tlmgr-restore">B.6.25 restore</a></li>
+ <li><a name="toc-search" href="#tlmgr-search">B.6.26 search</a></li>
+ <li><a name="toc-shell" href="#tlmgr-shell">B.6.27 shell</a></li>
+ <li><a name="toc-show" href="#tlmgr-show">B.6.28 show</a></li>
+ <li><a name="toc-uninstall" href="#tlmgr-uninstall">B.6.29 uninstall</a></li>
+ <li><a name="toc-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d" href="#tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d">B.6.30 update [<em>option</em>...] [<em>pkg</em>...]</a></li>
</ul></li>
- <li><a name="toc-USER-MODE" href="#tlmgr-USER-MODE">B.7 USER MODE</a>
+ <li><a name="toc-CONFIGURATION-FILE-FOR-TLMGR" href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR">B.7 CONFIGURATION FILE FOR TLMGR</a></li>
+ <li><a name="toc-CRYPTOGRAPHIC-VERIFICATION" href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION">B.8 CRYPTOGRAPHIC VERIFICATION</a>
<ul class="no-bullet">
- <li><a name="toc-user-mode-install" href="#tlmgr-user-mode-install">B.7.1 user mode install</a></li>
- <li><a name="toc-user-mode-backup_003b-restore_003b-remove_003b-update" href="#tlmgr-user-mode-backup_003b-restore_003b-remove_003b-update">B.7.2 user mode backup; restore; remove; update</a></li>
- <li><a name="toc-user-mode-generate_003b-option_003b-paper" href="#tlmgr-user-mode-generate_003b-option_003b-paper">B.7.3 user mode generate; option; paper</a></li>
+ <li><a name="toc-Configuration-of-GnuPG-invocation" href="#tlmgr-Configuration-of-GnuPG-invocation">B.8.1 Configuration of GnuPG invocation</a></li>
+ </ul></li>
+ <li><a name="toc-USER-MODE" href="#tlmgr-USER-MODE">B.9 USER MODE</a>
+ <ul class="no-bullet">
+ <li><a name="toc-User-mode-install" href="#tlmgr-User-mode-install">B.9.1 User mode install</a></li>
+ <li><a name="toc-User-mode-backup_002c-restore_002c-remove_002c-update" href="#tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update">B.9.2 User mode backup, restore, remove, update</a></li>
+ <li><a name="toc-User-mode-generate_002c-option_002c-paper" href="#tlmgr-User-mode-generate_002c-option_002c-paper">B.9.3 User mode generate, option, paper</a></li>
</ul></li>
- <li><a name="toc-CONFIGURATION-FILE-FOR-TLMGR" href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR">B.8 CONFIGURATION FILE FOR TLMGR</a></li>
- <li><a name="toc-TAXONOMIES" href="#tlmgr-TAXONOMIES">B.9 TAXONOMIES</a></li>
<li><a name="toc-MULTIPLE-REPOSITORIES" href="#tlmgr-MULTIPLE-REPOSITORIES">B.10 MULTIPLE REPOSITORIES</a>
<ul class="no-bullet">
<li><a name="toc-Pinning" href="#tlmgr-Pinning">B.10.1 Pinning</a></li>
@@ -277,6 +280,7 @@ ul.no-bullet {list-style: none}
<li><a name="toc-Main-display-action-buttons" href="#tlmgr-Main-display-action-buttons">B.11.1.3 Main display action buttons</a></li>
</ul></li>
<li><a name="toc-Menu-bar" href="#tlmgr-Menu-bar">B.11.2 Menu bar</a></li>
+ <li><a name="toc-GUI-options" href="#tlmgr-GUI-options">B.11.3 GUI options</a></li>
</ul></li>
<li><a name="toc-MACHINE_002dREADABLE-OUTPUT" href="#tlmgr-MACHINE_002dREADABLE-OUTPUT">B.12 MACHINE-READABLE OUTPUT</a>
<ul class="no-bullet">
@@ -315,11 +319,9 @@ Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Configure-options" accesskey="7">Configure options</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">List of all configure options.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Cross-compilation" accesskey="8">Cross compilation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Building on host X for target Y.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Coding-conventions" accesskey="9">Coding conventions</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Conventions to follow.
+<tr><td align="left" valign="top">&bull; <a href="#Coding-conventions" accesskey="8">Coding conventions</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Conventions to follow.
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Continuous-integration">Continuous integration</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Automated build testing.
+<tr><td align="left" valign="top">&bull; <a href="#Continuous-integration" accesskey="9">Continuous integration</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Automated build testing.
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#install_002dtl">install-tl</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">The TeX&nbsp;Live installer.
</td></tr>
@@ -341,7 +343,7 @@ Next: <a href="#Overview-of-build-system" accesskey="n" rel="next">Overview of b
<a name="index-introduction"></a>
-<p>This manual (dated February 2018) corresponds to the TeX&nbsp;Live
+<p>This manual (dated April 2018) corresponds to the TeX&nbsp;Live
2018 release.
</p>
<p>This manual is aimed at system installers and programmers, and focuses
@@ -600,6 +602,8 @@ supported (sorry).
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Build-one-package" accesskey="5">Build one package</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Example of working on just one program.
</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#Cross-compilation" accesskey="6">Cross compilation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Building on host X for target Y.
+</td></tr>
</table>
@@ -714,7 +718,7 @@ system, since all the support files are lacking; see <a href="#Installing">Insta
<a name="Build-one-package"></a>
<div class="header">
<p>
-Previous: <a href="#Build-distribution" accesskey="p" rel="prev">Build distribution</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Cross-compilation" accesskey="n" rel="next">Cross compilation</a>, Previous: <a href="#Build-distribution" accesskey="p" rel="prev">Build distribution</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Build-one-package-1"></a>
<h3 class="section">4.5 Build one package</h3>
@@ -806,8 +810,175 @@ otherwise, individual packages may use something different. You can
explicitly specify the compilers to be used with the environment
variables <code>CC</code>, <code>CXX</code>, and <code>OBJCXX</code>.
</p>
+<hr>
+<a name="Cross-compilation"></a>
+<div class="header">
+<p>
+Previous: <a href="#Build-one-package" accesskey="p" rel="prev">Build one package</a>, Up: <a href="#Building" accesskey="u" rel="up">Building</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="Cross-compilation-1"></a>
+<h3 class="section">4.6 Cross compilation</h3>
+
+<a name="index-cross-compilation"></a>
+<p>In a cross compilation a <em>build</em> system is used to create
+binaries to be executed on a <em>host</em> system with different
+hardware and/or operating system.
+</p>
+<a name="index-native-cross-compilation"></a>
+<p>In simple cases, the build system can execute binaries for the host
+system. This typically occurs for bi-arch systems where, e.g.,
+<code>i386-linux</code> binaries can run on <code>x86_64-linux</code> systems and
+<code>win32</code> binaries can run on <code>win64</code> systems. Although
+sometimes called &ldquo;native cross&rdquo;, technically this is not cross
+compilation at all. In most such cases it suffices to specify
+suitable compiler flags. It might be useful to add the configure
+option <code>--build=<var>host</var></code> to get the correct canonical host
+name, but note that this should <em>not</em> be <code>--host=<var>host</var></code>
+(see <a href="http://www.gnu.org/software/autoconf/manual/autoconf.html#Hosts-and-Cross_002dCompilation">Hosts and Cross-Compilation</a> in <cite>GNU Autoconf</cite>).
+</p>
+<p>In order to build, e.g., 32-bit binaries with <code>clang</code> on a 64-bit
+MacOSX system one could use:
+</p>
+<div class="example">
+<pre class="example">TL_BUILD_ENV=&quot;CC='clang -arch i386' \
+ CXX='clang++ -arch i386' \
+ OBJCXX='clang++ -arch i386'&quot; \
+ ./Build --build=i386-apple-darwin
+</pre></div>
+
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">&bull; <a href="#Cross-configuring" accesskey="1">Cross configuring</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Configuring for cross compilation.
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#Cross-problems" accesskey="2">Cross problems</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Cross compilation problems.
+</td></tr>
+</table>
<hr>
+<a name="Cross-configuring"></a>
+<div class="header">
+<p>
+Next: <a href="#Cross-problems" accesskey="n" rel="next">Cross problems</a>, Up: <a href="#Cross-compilation" accesskey="u" rel="up">Cross compilation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="Cross-configuring-1"></a>
+<h4 class="subsection">4.6.1 Cross configuring</h4>
+
+<a name="index-cross-compilation-configuring"></a>
+<a name="index-configuring_002c-for-cross-compilation"></a>
+
+<a name="index-_002d_002dhost_003dhost"></a>
+<a name="index-_002d_002dbuild_003dhost"></a>
+<p>In a standard cross compilation, binaries for the host system cannot
+execute on the build system and it is necessary to specify the
+configure options <code>--host=<var>host</var></code> and
+<code>--build=<var>build</var></code> with two different values.
+</p>
+<p>Building binaries requires suitable &ldquo;cross&rdquo; tools, e.g., compiler,
+linker, and archiver, and perhaps a &ldquo;cross&rdquo; version of
+<code>pkg-config</code> and similar to locate host system libraries.
+Autoconf expects that these cross tools are given by their usual
+variables or found under their usual name prefixed with
+<code><var>host</var>-</code>. Here a list of such tools and corresponding
+variables:
+</p>
+<div class="example">
+<pre class="example"><code>ar</code> AR
+<code>freetype-config</code> FT2_CONFIG
+<code>g++</code> CXX
+<code>gcc</code> CC
+<code>icu-config</code> ICU_CONFIG
+<code>objdump</code> OBJDUMP
+<code>pkg-config</code> PKG_CONFIG
+<code>ranlib</code> RANLIB
+<code>strip</code> STRIP
+</pre></div>
+
+<a name="index-mingw32"></a>
+<p>In order to, e.g., build <code>mingw32</code> binaries on
+<code>x86_64-linux</code> with a cross compiler found as
+<samp>i386-pc-mingw32-gcc</samp> one would specify
+</p>
+<div class="example">
+<pre class="example">--host=i386-pc-mingw32 --build=x86_64-linux-gnu
+</pre></div>
+
+<p>or perhaps
+</p>
+<div class="example">
+<pre class="example">--host=mingw32 --build=x86_64-linux CC=i386-pc-mingw32-gcc
+</pre></div>
+
+<p>but this latter, especially, might require adding <code>CXX</code> and others.
+</p>
+<p>Configure arguments such as <code>CFLAGS=&hellip;</code> refer to the cross
+compiler. If necessary, you can specify compilers and flags for the
+few auxiliary C and C++ programs required for the build process as
+configure arguments
+</p>
+<a name="index-BUILDCC_002c-BUILDCFLAGS_002c-_2026"></a>
+<div class="example">
+<pre class="example">BUILDCC=&hellip;
+BUILDCPPFLAGS=&hellip;
+BUILDCFLAGS=&hellip;
+BUILDCXX=&hellip;
+BUILDCXXFLAGS=&hellip;
+BUILDLDFLAGS=&hellip;
+</pre></div>
+
+<hr>
+<a name="Cross-problems"></a>
+<div class="header">
+<p>
+Previous: <a href="#Cross-configuring" accesskey="p" rel="prev">Cross configuring</a>, Up: <a href="#Cross-compilation" accesskey="u" rel="up">Cross compilation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="Cross-problems-1"></a>
+<h4 class="subsection">4.6.2 Cross problems</h4>
+
+<a name="index-cross-compilation-problems"></a>
+
+<p>The fact that binaries for the host system cannot be executed on the
+build system causes some problems.
+</p>
+<p>One problem is that configure tests using <code>AC_RUN_IFELSE</code> can
+compile and link the test program but cannot execute it. Such tests
+should be avoided if possible and otherwise must supply a pessimistic
+test result.
+</p>
+<a name="index-squeeze"></a>
+<a name="index-web2c-program"></a>
+<a name="index-freetype-cross-compiling"></a>
+<a name="index-CC_005fBUILD"></a>
+<p>Another problem arises if the build process must execute some
+(auxiliary or installable) programs. Auxiliary programs can be placed
+into a subdirectory that is configured natively as is done for
+<samp>texk/web2c/web2c</samp>, <samp>texk/dvipsk/squeeze</samp>, and
+<samp>texk/xdvik/squeeze</samp>. The module <samp>libs/freetype2</samp> uses the
+value of <code>CC_BUILD</code>, <samp><var>build</var>-gcc</samp>, <samp>gcc</samp>, or
+<samp>cc</samp> as the compiler for the auxiliary program.
+</p>
+<a name="index-ICU-cross-compiling"></a>
+<p>The situation for installable programs needed by the build process is
+somewhat different. A rather expensive possibility, chosen for the ICU
+libraries in module <samp>libs/icu</samp>, is to first compile natively for
+the build system and in a second step to use these (uninstalled)
+programs during the cross compilation.
+</p>
+<a name="index-tangle"></a>
+<a name="index-ctangle"></a>
+<a name="index-otangle"></a>
+<a name="index-tie"></a>
+<p>This approach would also be possible for the tools such as
+<samp>tangle</samp> used in the module <samp>texk/web2c</samp> to build the WEB
+programs, but that would require first building a native
+<code>kpathsea</code> library. To avoid this complication, cross
+compilation of the WEB or CWEB programs requires sufficiently recent
+installed versions of <samp>tangle</samp>, <samp>ctangle</samp>, <samp>otangle</samp>,
+and <samp>tie</samp>.
+</p>
+<a name="index-xindy-cross-compiling-impossible"></a>
+<p>Building <code>xindy</code> requires running the host system <samp>clisp</samp>
+binary, thus cross compilation is not possible.
+</p>
+<hr>
<a name="Installing"></a>
<div class="header">
<p>
@@ -2072,7 +2243,7 @@ The fragment <code>ac/withenable.ac</code> must use <code>KPSE_WITH_TEXLIB</code
<a name="Configure-options"></a>
<div class="header">
<p>
-Next: <a href="#Cross-compilation" accesskey="n" rel="next">Cross compilation</a>, Previous: <a href="#Layout-and-infrastructure" accesskey="p" rel="prev">Layout and infrastructure</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Coding-conventions" accesskey="n" rel="next">Coding conventions</a>, Previous: <a href="#Layout-and-infrastructure" accesskey="p" rel="prev">Layout and infrastructure</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Configure-options-1"></a>
<h2 class="chapter">7 Configure options</h2>
@@ -2920,184 +3091,13 @@ commands used, e.g., to build the <code>xindy</code> documentation.
<hr>
-<a name="Cross-compilation"></a>
-<div class="header">
-<p>
-Next: <a href="#Coding-conventions" accesskey="n" rel="next">Coding conventions</a>, Previous: <a href="#Configure-options" accesskey="p" rel="prev">Configure options</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<a name="Cross-compilation-1"></a>
-<h2 class="chapter">8 Cross compilation</h2>
-
-<a name="index-cross-compilation"></a>
-<p>In a cross compilation a <em>build</em> system is used to create
-binaries to be executed on a <em>host</em> system with different
-hardware and/or operating system.
-</p>
-<a name="index-native-cross-compilation"></a>
-<p>In simple cases, the build system can execute binaries for the host
-system. This typically occurs for bi-arch systems where, e.g.,
-<code>i386-linux</code> binaries can run on <code>x86_64-linux</code> systems and
-<code>win32</code> binaries can run on <code>win64</code> systems. Although
-sometimes called &ldquo;native cross&rdquo;, technically this is not cross
-compilation at all. In most such cases it suffices to specify
-suitable compiler flags. It might be useful to add the configure
-option <code>--build=<var>host</var></code> to get the correct canonical host
-name, but note that this should <em>not</em> be <code>--host=<var>host</var></code>
-(see <a href="http://www.gnu.org/software/autoconf/manual/autoconf.html#Hosts-and-Cross_002dCompilation">Hosts and Cross-Compilation</a> in <cite>GNU Autoconf</cite>).
-</p>
-<p>In order to build, e.g., 32-bit binaries with <code>clang</code> on a 64-bit
-MacOSX system one could use:
-</p>
-<div class="example">
-<pre class="example">TL_BUILD_ENV=&quot;CC='clang -arch i386' \
- CXX='clang++ -arch i386' \
- OBJCXX='clang++ -arch i386'&quot; \
- ./Build --build=i386-apple-darwin
-</pre></div>
-
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#Cross-configuring" accesskey="1">Cross configuring</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Configuring for cross compilation.
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#Cross-problems" accesskey="2">Cross problems</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Cross compilation problems.
-</td></tr>
-</table>
-
-
-<hr>
-<a name="Cross-configuring"></a>
-<div class="header">
-<p>
-Next: <a href="#Cross-problems" accesskey="n" rel="next">Cross problems</a>, Up: <a href="#Cross-compilation" accesskey="u" rel="up">Cross compilation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<a name="Cross-configuring-1"></a>
-<h3 class="section">8.1 Cross configuring</h3>
-
-<a name="index-cross-compilation-configuring"></a>
-<a name="index-configuring_002c-for-cross-compilation"></a>
-
-<a name="index-_002d_002dhost_003dhost"></a>
-<a name="index-_002d_002dbuild_003dhost"></a>
-<p>In a standard cross compilation, binaries for the host system cannot
-execute on the build system and it is necessary to specify the
-configure options <code>--host=<var>host</var></code> and
-<code>--build=<var>build</var></code> with two different values.
-</p>
-<p>Building binaries requires suitable &ldquo;cross&rdquo; tools, e.g., compiler,
-linker, and archiver, and perhaps a &ldquo;cross&rdquo; version of
-<code>pkg-config</code> and similar to locate host system libraries.
-Autoconf expects that these cross tools are given by their usual
-variables or found under their usual name prefixed with
-<code><var>host</var>-</code>. Here a list of such tools and corresponding
-variables:
-</p>
-<div class="example">
-<pre class="example"><code>ar</code> AR
-<code>freetype-config</code> FT2_CONFIG
-<code>g++</code> CXX
-<code>gcc</code> CC
-<code>icu-config</code> ICU_CONFIG
-<code>objdump</code> OBJDUMP
-<code>pkg-config</code> PKG_CONFIG
-<code>ranlib</code> RANLIB
-<code>strip</code> STRIP
-</pre></div>
-
-<a name="index-mingw32"></a>
-<p>In order to, e.g., build <code>mingw32</code> binaries on
-<code>x86_64-linux</code> with a cross compiler found as
-<samp>i386-pc-mingw32-gcc</samp> one would specify
-</p>
-<div class="example">
-<pre class="example">--host=i386-pc-mingw32 --build=x86_64-linux-gnu
-</pre></div>
-
-<p>or perhaps
-</p>
-<div class="example">
-<pre class="example">--host=mingw32 --build=x86_64-linux CC=i386-pc-mingw32-gcc
-</pre></div>
-
-<p>but this latter, especially, might require adding <code>CXX</code> and others.
-</p>
-<p>Configure arguments such as <code>CFLAGS=&hellip;</code> refer to the cross
-compiler. If necessary, you can specify compilers and flags for the
-few auxiliary C and C++ programs required for the build process as
-configure arguments
-</p>
-<a name="index-BUILDCC_002c-BUILDCFLAGS_002c-_2026"></a>
-<div class="example">
-<pre class="example">BUILDCC=&hellip;
-BUILDCPPFLAGS=&hellip;
-BUILDCFLAGS=&hellip;
-BUILDCXX=&hellip;
-BUILDCXXFLAGS=&hellip;
-BUILDLDFLAGS=&hellip;
-</pre></div>
-
-
-<hr>
-<a name="Cross-problems"></a>
-<div class="header">
-<p>
-Previous: <a href="#Cross-configuring" accesskey="p" rel="prev">Cross configuring</a>, Up: <a href="#Cross-compilation" accesskey="u" rel="up">Cross compilation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<a name="Cross-problems-1"></a>
-<h3 class="section">8.2 Cross problems</h3>
-
-<a name="index-cross-compilation-problems"></a>
-
-<p>The fact that binaries for the host system cannot be executed on the
-build system causes some problems.
-</p>
-<p>One problem is that configure tests using <code>AC_RUN_IFELSE</code> can
-compile and link the test program but cannot execute it. Such tests
-should be avoided if possible and otherwise must supply a pessimistic
-test result.
-</p>
-<a name="index-squeeze"></a>
-<a name="index-web2c-program"></a>
-<a name="index-freetype-cross-compiling"></a>
-<a name="index-CC_005fBUILD"></a>
-<p>Another problem arises if the build process must execute some
-(auxiliary or installable) programs. Auxiliary programs can be placed
-into a subdirectory that is configured natively as is done for
-<samp>texk/web2c/web2c</samp>, <samp>texk/dvipsk/squeeze</samp>, and
-<samp>texk/xdvik/squeeze</samp>. The module <samp>libs/freetype2</samp> uses the
-value of <code>CC_BUILD</code>, <samp><var>build</var>-gcc</samp>, <samp>gcc</samp>, or
-<samp>cc</samp> as the compiler for the auxiliary program.
-</p>
-<a name="index-ICU-cross-compiling"></a>
-<p>The situation for installable programs needed by the build process is
-somewhat different. A rather expensive possibility, chosen for the ICU
-libraries in module <samp>libs/icu</samp>, is to first compile natively for
-the build system and in a second step to use these (uninstalled)
-programs during the cross compilation.
-</p>
-<a name="index-tangle"></a>
-<a name="index-ctangle"></a>
-<a name="index-otangle"></a>
-<a name="index-tie"></a>
-<p>This approach would also be possible for the tools such as
-<samp>tangle</samp> used in the module <samp>texk/web2c</samp> to build the WEB
-programs, but that would require first building a native
-<code>kpathsea</code> library. To avoid this complication, cross
-compilation of the WEB or CWEB programs requires sufficiently recent
-installed versions of <samp>tangle</samp>, <samp>ctangle</samp>, <samp>otangle</samp>,
-and <samp>tie</samp>.
-</p>
-<a name="index-xindy-cross-compiling-impossible"></a>
-<p>Building <code>xindy</code> requires running the host system <samp>clisp</samp>
-binary, thus cross compilation is not possible.
-</p>
-
-<hr>
<a name="Coding-conventions"></a>
<div class="header">
<p>
-Next: <a href="#Continuous-integration" accesskey="n" rel="next">Continuous integration</a>, Previous: <a href="#Cross-compilation" accesskey="p" rel="prev">Cross compilation</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#Continuous-integration" accesskey="n" rel="next">Continuous integration</a>, Previous: <a href="#Configure-options" accesskey="p" rel="prev">Configure options</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Coding-conventions-1"></a>
-<h2 class="chapter">9 Coding conventions</h2>
+<h2 class="chapter">8 Coding conventions</h2>
<a name="index-coding-conventions"></a>
<a name="index-conventions_002c-coding"></a>
@@ -3126,7 +3126,7 @@ don&rsquo;t want to accept patches.
Next: <a href="#Const" accesskey="n" rel="next">Const</a>, Up: <a href="#Coding-conventions" accesskey="u" rel="up">Coding conventions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Declarations-and-definitions-1"></a>
-<h3 class="section">9.1 Declarations and definitions</h3>
+<h3 class="section">8.1 Declarations and definitions</h3>
<a name="index-declarations-and-definitions_002c-in-source-code"></a>
<a name="index-source-code-declarations"></a>
@@ -3203,7 +3203,7 @@ file.
Previous: <a href="#Declarations-and-definitions" accesskey="p" rel="prev">Declarations and definitions</a>, Up: <a href="#Coding-conventions" accesskey="u" rel="up">Coding conventions</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Const-1"></a>
-<h3 class="section">9.2 Const</h3>
+<h3 class="section">8.2 Const</h3>
<a name="index-const"></a>
@@ -3260,7 +3260,7 @@ cause the modification of quantities supposed to be constant.
Next: <a href="#install_002dtl" accesskey="n" rel="next">install-tl</a>, Previous: <a href="#Coding-conventions" accesskey="p" rel="prev">Coding conventions</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Continuous-integration-1"></a>
-<h2 class="chapter">10 Continuous integration</h2>
+<h2 class="chapter">9 Continuous integration</h2>
<a name="index-ci"></a>
<a name="index-continuous-integration"></a>
@@ -3274,8 +3274,23 @@ mirror of the sources that is pushed to Github
is updated (currently) at 30 minute intervals, and only the last
commit pushed is tested on Travis-CI.
</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">&bull; <a href="#Transfer-from-Subversion-to-Github" accesskey="1">Transfer from Subversion to Github</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#Automatic-update-of-the-Git-mirror" accesskey="2">Automatic update of the Git mirror</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#CI-testing-on-Travis_002dCI" accesskey="3">CI testing on Travis-CI</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+</td></tr>
+</table>
+
+<hr>
<a name="Transfer-from-Subversion-to-Github"></a>
-<h4 class="subheading">Transfer from Subversion to Github</h4>
+<div class="header">
+<p>
+Next: <a href="#Automatic-update-of-the-Git-mirror" accesskey="n" rel="next">Automatic update of the Git mirror</a>, Up: <a href="#Continuous-integration" accesskey="u" rel="up">Continuous integration</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="Transfer-from-Subversion-to-Github-1"></a>
+<h3 class="section">9.1 Transfer from Subversion to Github</h3>
<p>git-svn (<a href="https://git-scm.com/docs/git-svn">https://git-scm.com/docs/git-svn</a>) is used to check out
the subtree <code>Build/source</code> of the Subversion repository. The
@@ -3324,8 +3339,14 @@ come from the local <code>master</code> (not the one on Github) to
Subversion, back to <code>master</code> on <code>texlive.info</code>, and from
there to Github.
</p>
+<hr>
<a name="Automatic-update-of-the-Git-mirror"></a>
-<h4 class="subheading">Automatic update of the Git mirror</h4>
+<div class="header">
+<p>
+Next: <a href="#CI-testing-on-Travis_002dCI" accesskey="n" rel="next">CI testing on Travis-CI</a>, Previous: <a href="#Transfer-from-Subversion-to-Github" accesskey="p" rel="prev">Transfer from Subversion to Github</a>, Up: <a href="#Continuous-integration" accesskey="u" rel="up">Continuous integration</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="Automatic-update-of-the-Git-mirror-1"></a>
+<h3 class="section">9.2 Automatic update of the Git mirror</h3>
<p><em>admin</em> has installed a cron job on <code>texlive.info</code> running
every 30 minute which essentially runs <code>git svn rebase</code> and
@@ -3334,8 +3355,14 @@ command fetches the changes from the Subversion repository and updates
the <code>master</code> branch with them, the second one pushes changes (if
available) to Github.
</p>
+<hr>
<a name="CI-testing-on-Travis_002dCI"></a>
-<h4 class="subheading">CI testing on Travis-CI</h4>
+<div class="header">
+<p>
+Previous: <a href="#Automatic-update-of-the-Git-mirror" accesskey="p" rel="prev">Automatic update of the Git mirror</a>, Up: <a href="#Continuous-integration" accesskey="u" rel="up">Continuous integration</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="CI-testing-on-Travis_002dCI-1"></a>
+<h3 class="section">9.3 CI testing on Travis-CI</h3>
<a name="index-_002etravis_002eyml"></a>
<p>The <code>source</code> tree of TeX&nbsp;Live contains a top-level file
@@ -3368,9 +3395,11 @@ Next: <a href="#tlmgr" accesskey="n" rel="next">tlmgr</a>, Previous: <a href="#C
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#install_002dtl-OPTIONS" accesskey="5">install-tl OPTIONS</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="6">install-tl ENVIRONMENT VARIABLES</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#install_002dtl-PROFILES" accesskey="6">install-tl PROFILES</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="7">install-tl ENVIRONMENT VARIABLES</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#install_002dtl-AUTHORS-AND-COPYRIGHT" accesskey="7">install-tl AUTHORS AND COPYRIGHT</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#install_002dtl-AUTHORS-AND-COPYRIGHT" accesskey="8">install-tl AUTHORS AND COPYRIGHT</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>
@@ -3396,7 +3425,9 @@ Next: <a href="#install_002dtl-DESCRIPTION" accesskey="n" rel="next">install-tl
<p>install-tl [<em>option</em>]...
</p>
-<p>install-tl.bat [<em>option</em>]...
+<p>install-tl-windows.bat [<em>option</em>]...
+</p>
+<p>install-tl-advanced.bat [<em>option</em>]...
</p>
<hr>
<a name="install_002dtl-DESCRIPTION"></a>
@@ -3408,22 +3439,23 @@ Next: <a href="#install_002dtl-REFERENCES" accesskey="n" rel="next">install-tl R
<h3 class="appendixsec">A.3 DESCRIPTION</h3>
<p>This installer creates a runnable TeX Live installation from various
-media, including over the network. The installer works across all
-platforms supported by TeX Live. For information on initially
-downloading the TeX Live, see <a href="http://tug.org/texlive/acquire.html">http://tug.org/texlive/acquire.html</a>.
+media, including over the network, from local hard disk, a DVD, etc.
+The installer works across all platforms supported by TeX Live. For
+information on initially downloading the TeX Live, see
+<a href="http://tug.org/texlive/acquire.html">http://tug.org/texlive/acquire.html</a>.
</p>
-<p>The basic idea of TeX Live installation is to choose one of the
+<p>The basic idea of TeX Live installation is for you to choose one of the
top-level <em>schemes</em>, each of which is defined as a different set of
<em>collections</em> and <em>packages</em>, where a collection is a set of packages,
and a package is what contains actual files.
</p>
<p>Within the installer, you can choose a scheme, and further customize the
-set of collections to install, but not the set of the packages. To do
-that, use <code>tlmgr</code> (reference below) after the initial installation is
-completely.
+set of collections to install, but not the set of the packages. To work
+at the package level, use <code>tlmgr</code> (reference just below) after the
+initial installation is complete.
</p>
-<p>The default is <code>scheme-full</code>, to install everything, and this is highly
-recommended.
+<p>The default is <code>scheme-full</code>, which installs everything, and this is
+highly recommended.
</p>
<hr>
<a name="install_002dtl-REFERENCES"></a>
@@ -3438,8 +3470,8 @@ Next: <a href="#install_002dtl-OPTIONS" accesskey="n" rel="next">install-tl OPTI
handled through <strong>tlmgr</strong>(1), the TeX Live Manager
(<a href="http://tug.org/texlive/tlmgr.html">http://tug.org/texlive/tlmgr.html</a>).
</p>
-<p>The most up-to-date version of this documentation is on the Internet at
-<a href="http://tug.org/texlive/doc/install-tl.html">http://tug.org/texlive/doc/install-tl.html</a>.
+<p>The most up-to-date version of this installer documentation is on the
+Internet at <a href="http://tug.org/texlive/doc/install-tl.html">http://tug.org/texlive/doc/install-tl.html</a>.
</p>
<p>For the full documentation of TeX Live, see
<a href="http://tug.org/texlive/doc">http://tug.org/texlive/doc</a>.
@@ -3448,7 +3480,7 @@ handled through <strong>tlmgr</strong>(1), the TeX Live Manager
<a name="install_002dtl-OPTIONS"></a>
<div class="header">
<p>
-Next: <a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="n" rel="next">install-tl ENVIRONMENT VARIABLES</a>, Previous: <a href="#install_002dtl-REFERENCES" accesskey="p" rel="prev">install-tl REFERENCES</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#install_002dtl-PROFILES" accesskey="n" rel="next">install-tl PROFILES</a>, Previous: <a href="#install_002dtl-REFERENCES" accesskey="p" rel="prev">install-tl REFERENCES</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="OPTIONS"></a>
<h3 class="appendixsec">A.5 OPTIONS</h3>
@@ -3460,7 +3492,7 @@ option by either a space or <code>=</code>.
<dl compact="compact">
<dt><strong>-gui</strong> [[=]<em>module</em>]</dt>
<dd><a name="install_002dtl-_002dgui-_005b_005b_003d_005dmodule_005d"></a>
-<p>If no <em>module</em> is given starts the <code>perltk</code> (see below) GUI installer.
+<p>If no <em>module</em> is given, starts the <code>perltk</code> (see below) GUI installer.
</p>
<p>If <em>module</em> is given loads the given installer module. Currently the
following modules are supported:
@@ -3486,8 +3518,8 @@ Can also be invoked on Windows by running <code>install-tl-advanced.bat</code>.
</dd>
</dl>
-<p>The <code>perltk</code> and <code>wizard</code> modules, and thus also when calling with a
-bare <code>-gui</code> (without <em>module</em>), requires the Perl/Tk module
+<p>The <code>perltk</code> and <code>wizard</code> modules, and thus also when calling with
+bare <code>-gui</code> (with no <em>module</em>), require the Perl/Tk module
(<a href="http://tug.org/texlive/distro.html#perltk">http://tug.org/texlive/distro.html#perltk</a>); if Perl/Tk is not
available, installation continues in text mode.
</p>
@@ -3514,8 +3546,9 @@ simplified Chinese (zh_CN), and traditional Chinese (zh_TW).
<dd><a name="install_002dtl-_002drepository-url_007cpath"></a>
<p>Specify the package repository to be used as the source of the
installation, either a local directory via <code>/path/to/directory</code> or a
-<code>file:/</code> url, or a network location via a <code>http://</code> or <code>ftp://</code> url.
-(No other protocols are supported.)
+<code>file:/</code> url, or a network location via a <code>http://</code>, <code>https://</code>, or
+<code>ftp://</code> url. (No other protocols are supported, and <code>https://</code> may
+not work on all platforms.)
</p>
<p>The default is to pick a mirror automatically, using
<a href="http://mirror.ctan.org/systems/texlive/tlnet">http://mirror.ctan.org/systems/texlive/tlnet</a>; the chosen mirror is
@@ -3529,7 +3562,7 @@ you could choose a particular CTAN mirror with something like this:
</p>
<pre class="verbatim"> -repository http://ctan.example.org/its/ctan/dir/systems/texlive/tlnet
</pre>
-<p>Of course a real hostname and its particular top-level CTAN path
+<p>Of course a real hostname and its particular top-level CTAN directory
have to be specified. The list of CTAN mirrors is available at
<a href="http://ctan.org/mirrors">http://ctan.org/mirrors</a>.
</p>
@@ -3563,9 +3596,9 @@ choose a good host for you.
<dt><strong>-all-options</strong></dt>
<dd><a name="install_002dtl-_002dall_002doptions"></a>
<p>Normally options not relevant to the current platform are not shown
-(i.e., when running on Unix, Windows-specific options are omitted).
-Giving this command line option allows configuring settings in the
-final <code>texlive.tlpdb</code> that do not have any immediate effect.
+(e.g., when running on Unix, Windows-specific options are omitted).
+Giving this command line option allows configuring such &quot;foreign&quot;
+settings.
</p>
</dd>
<dt><strong>-custom-bin</strong> <em>path</em></dt>
@@ -3577,8 +3610,12 @@ the current system are present. The installation will continue as
usual, but at the end all files from <em>path</em> are copied over to
<code>bin/custom/</code> under your installation directory and this <code>bin/custom/</code>
directory is what will be added to the path for the post-install
-actions. (By the way, for information on building TeX Live, see
-<a href="http://tug.org/texlive/build.html">http://tug.org/texlive/build.html</a>).
+actions. To install multiple custom binary sets, manully rename
+<code>custom</code> before doing each.
+</p>
+<p>For more information on custom binaries, see
+<a href="http://tug.org/texlive/custom-bin.html">http://tug.org/texlive/custom-bin.html</a>. For general information on
+building TeX Live, see <a href="http://tug.org/texlive/build.html">http://tug.org/texlive/build.html</a>.
</p>
</dd>
<dt><strong>-debug-translation</strong></dt>
@@ -3597,7 +3634,7 @@ runnable, or installation will fail. <code>-force-arch</code> is a synonym.
</dd>
<dt><strong>-help</strong>, <strong>&ndash;help</strong>, <strong>-?</strong></dt>
<dd><a name="install_002dtl-_002dhelp_002c-_002d_002dhelp_002c-_002d_003f"></a>
-<p>Display this help and exit (on the web via
+<p>Display this help and exit. (This help is on the web at
<a href="http://tug.org/texlive/doc/install-tl.html">http://tug.org/texlive/doc/install-tl.html</a>). Sometimes the
<code>perldoc</code> and/or <code>PAGER</code> programs on the system have problems,
possibly resulting in control characters being literally output. This
@@ -3616,6 +3653,13 @@ is to redo it from time to time. This option is not available via the
installer interfaces. USE AT YOUR OWN RISK.
</p>
</dd>
+<dt><strong>-init-from-profile</strong> <em>profile_file</em></dt>
+<dd><a name="install_002dtl-_002dinit_002dfrom_002dprofile-profile_005ffile"></a>
+<p>Similar to <strong>-profile</strong> (see <a href="#install_002dtl-PROFILES">PROFILES</a> below), but only initializes the
+installation configuration from <em>profile_file</em> and then starts the
+interactive session.
+</p>
+</dd>
<dt><strong>-logfile</strong> <em>file</em></dt>
<dd><a name="install_002dtl-_002dlogfile-file"></a>
<p>Write both all messages (informational, debugging, warnings) to <em>file</em>,
@@ -3629,7 +3673,7 @@ release.
</dd>
<dt><strong>-no-cls</strong></dt>
<dd><a name="install_002dtl-_002dno_002dcls"></a>
-<p>(only for text mode installer) do not clear the screen when entering
+<p>For the text mode installer only: do not clear the screen when entering
a new menu (for debugging purposes).
</p>
</dd>
@@ -3638,11 +3682,11 @@ a new menu (for debugging purposes).
<p>For Windows only: configure for the current user, not for all users.
</p>
</dd>
-<dt><strong>&ndash;persistent-downloads</strong></dt>
-<dd><a name="install_002dtl-_002d_002dpersistent_002ddownloads"></a>
+<dt><strong>-persistent-downloads</strong></dt>
+<dd><a name="install_002dtl-_002dpersistent_002ddownloads"></a>
</dd>
-<dt><strong>&ndash;no-persistent-downloads</strong></dt>
-<dd><a name="install_002dtl-_002d_002dno_002dpersistent_002ddownloads"></a>
+<dt><strong>-no-persistent-downloads</strong></dt>
+<dd><a name="install_002dtl-_002dno_002dpersistent_002ddownloads"></a>
<p>For network installs, activating this option makes the installer try to
set up a persistent connection using the <code>Net::LWP</code> Perl module. This
opens only one connection between your computer and the server per
@@ -3651,7 +3695,16 @@ package, which typically yields a significant speed-up.
</p>
<p>This option is turned on by default, and the installation program will
fall back to using <code>wget</code> if this is not possible. To disable usage of
-LWP and persistent connections, use <code>--no-persistent-downloads</code>.
+LWP and persistent connections, use <code>-no-persistent-downloads</code>.
+</p>
+</dd>
+<dt><strong>-no-verify-downloads</strong></dt>
+<dd><a name="install_002dtl-_002dno_002dverify_002ddownloads"></a>
+<p>By default, if a GnuPG <code>gpg</code> binary is found in PATH, downloads are
+verified against a cryptographic signature. This option disables such
+verification. The full description is in the Crytographic Verification
+section of the <code>tlmgr</code> documentation, e.g.,
+<a href="http://tug.org/texlive/doc/tlmgr.html#CRYPTOGRAPHIC-VERIFICATION">http://tug.org/texlive/doc/tlmgr.html#CRYPTOGRAPHIC-VERIFICATION</a>
</p>
</dd>
<dt><strong>-portable</strong></dt>
@@ -3667,33 +3720,10 @@ within the perltk and text installers.
<code>-print-arch</code> is a synonym.
</p>
</dd>
-<dt><strong>-profile</strong> <em>profile</em></dt>
-<dd><a name="install_002dtl-_002dprofile-profile"></a>
-<p>Load the file <em>profile</em> and do the installation with no user
-interaction, that is, a batch (unattended) install.
-</p>
-<p>A <em>profile</em> file contains all the values needed to perform an
-installation. After a normal installation has finished, a profile for
-that exact installation is written to the file
-DEST/tlpkg/texlive.profile. That file can be given as the argument to
-<code>-profile</code> to redo the exact same installation on a different system,
-for example. Alternatively, you can use a custom profile, most easily
-created by starting from a generated one and changing values, or an
-empty file, which will take all the defaults.
-</p>
-<p>Normally a profile has to specify the value <code>1</code> for each collection to
-be installed, even if the scheme is specified. This follows from the
-logic of the installer in that you can first select a scheme and then
-change the collections being installed. But for convenience there is an
-exception to this within profiles: If the profile contains a variable
-for <code>selected_scheme</code> and <em>no</em> collection variables at all are defined
-in the profile, then the collections which the specified scheme requires
-are installed.
-</p>
-<p>Thus, a line <code>selected_scheme scheme-medium</code> together with the
-definitions of the installation directories (<code>TEXDIR</code>, <code>TEXMFHOME</code>,
-<code>TEXMFLOCAL</code>, <code>TEXMFSYSCONFIG</code>, <code>TEXMFSYSVAR</code>) suffices to install
-the medium scheme with all default options.
+<dt><strong>-profile</strong> <em>profile_file</em></dt>
+<dd><a name="install_002dtl-_002dprofile-profile_005ffile"></a>
+<p>Load <em>profile_file</em> and do the installation with no user interaction,
+that is, a batch (unattended) install. See <a href="#install_002dtl-PROFILES">PROFILES</a> below.
</p>
</dd>
<dt><strong>-q</strong></dt>
@@ -3714,8 +3744,8 @@ menu list.
</dd>
<dt><strong>-v</strong></dt>
<dd><a name="install_002dtl-_002dv"></a>
-<p>Include verbose debugging messages; repeat for maximum debugging, as in
-<code>-v -v</code>. (Further repeats are accepted but ignored.)
+<p>Include verbose debugging messages; repeat for maximum debugging: <code>-v
+-v</code>. (Further repeats are accepted but ignored.)
</p>
</dd>
<dt><strong>-version</strong>, <strong>&ndash;version</strong></dt>
@@ -3727,16 +3757,157 @@ revisions of the used modules are reported, too.
</dl>
<hr>
+<a name="install_002dtl-PROFILES"></a>
+<div class="header">
+<p>
+Next: <a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="n" rel="next">install-tl ENVIRONMENT VARIABLES</a>, Previous: <a href="#install_002dtl-OPTIONS" accesskey="p" rel="prev">install-tl OPTIONS</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="PROFILES"></a>
+<h3 class="appendixsec">A.6 PROFILES</h3>
+
+<p>A <em>profile</em> file contains all the values needed to perform an
+installation. After a normal installation has finished, a profile for
+that exact installation is written to the file <code>tlpkg/texlive.profile</code>.
+In addition, from the text menu one can select <code>P</code> to save the current
+setup as a profile at any time. Such a profile file can be given as the
+argument to <code>-profile</code>, for example to redo the exact same installation
+on a different system. Alternatively, you can use a custom profile,
+most easily created by starting from a generated one and changing
+values, or an empty file, which will take all the defaults.
+</p>
+<p>Within a profile file, each line consists of
+</p>
+<p><em>variable</em> [<em>value</em>]
+</p>
+<p>except for comment lines starting with <code>#</code>. The possible variable
+names are listed below. Values, when present, are either <code>0</code> or <code>1</code>
+for booleans, or strings (which must be specified without any quote
+characters). Leading whitespace is ignored.
+</p>
+<p>If the variable <code>selected_scheme</code> is defined and <em>no</em> collection
+variables at all are defined, then the collections required by the
+specified scheme (which might change over time) are installed, without
+explicitly listing them. This eases maintenance of profile files. If
+any collections are specified in a profile, though, then all desired
+collections must be given explicitly.
+</p>
+<p>For example, a line
+</p>
+<pre class="verbatim"> selected_scheme scheme-small
+</pre>
+<p>along with definitions for the installation directories (given below
+under &quot;path options&quot;) suffices to install the &quot;small&quot; scheme with all
+default options. The schemes are described in the <code>S</code> menu in the
+text installer, or equivalent.
+</p>
+<p>Besides <code>selected_scheme</code>, here is the list of variable names supported
+in a profile:
+</p>
+<p><strong>collection options</strong> (prefix <code>collection-</code>)
+</p>
+<p>Collections are specified with a variable name with the prefix
+<code>collection-</code> followed by a collection name; there is no value. For
+instance, <code>collection-basic</code>. The collections are described in the
+<code>C</code> menu.
+</p>
+<p>Schemes and collections (and packages) are ultimately defined by the
+files in the <code>tlpkg/tlpsrc/</code> source directory.
+</p>
+<p><strong>path options</strong>
+</p>
+<p>It is best to define all of these, even though they may not be used in
+the installation, so as to avoid unintentionally getting a default value
+that could cause problems later.
+</p>
+<pre class="verbatim"> TEXDIR
+ TEXMFCONFIG
+ TEXMFVAR
+ TEXMFHOME
+ TEXMFLOCAL
+ TEXMFSYSCONFIG
+ TEXMFSYSVAR
+</pre>
+<p><strong>installer options</strong> (prefix <code>instopt_</code>)
+</p>
+<dl compact="compact">
+<dt><code>instopt_adjustpath</code> (default 0 on Unix, 1 on Windows)</dt>
+<dd><a name="install_002dtl-instopt_005fadjustpath-_0028default-0-on-Unix_002c-1-on-Windows_0029"></a>
+<p>Adjust <code>PATH</code> environment variable.
+</p>
+</dd>
+<dt><code>instopt_adjustrepo</code> (default 1)</dt>
+<dd><a name="install_002dtl-instopt_005fadjustrepo-_0028default-1_0029"></a>
+<p>Set remote repository to a multiplexed CTAN mirror after installation;
+see <code>-repository</code> above.
+</p>
+</dd>
+<dt><code>instopt_letter</code> (default 0)</dt>
+<dd><a name="install_002dtl-instopt_005fletter-_0028default-0_0029"></a>
+<p>Set letter size paper as the default, instead of a4.
+</p>
+</dd>
+<dt><code>instopt_portable</code> (default 0)</dt>
+<dd><a name="install_002dtl-instopt_005fportable-_0028default-0_0029"></a>
+<p>Install for portable use, e.g., on a USB stick.
+</p>
+</dd>
+<dt><code>instopt_write18_restricted</code> (default 1)</dt>
+<dd><a name="install_002dtl-instopt_005fwrite18_005frestricted-_0028default-1_0029"></a>
+<p>Enable <code>\write18</code> for a restricted set of programs.
+</p>
+</dd>
+</dl>
+
+<p><strong>tlpdb options</strong> (prefix <code>tlpdbopt_</code>)
+</p>
+<p>The definitive list is given in <code>tlpkg/TeXLive/TLConfig.pm</code>, in
+<code>%TeXLive::TLConfig::TLPDBOptions</code>, together with explanations. All
+items given there <em>except</em> for <code>tlpdbopt_location</code> can be specified.
+Here is the current list:
+</p>
+<pre class="verbatim"> tlpdbopt_autobackup
+ tlpdbopt_backupdir
+ tlpdbopt_create_formats
+ tlpdbopt_desktop_integration
+ tlpdbopt_file_assocs
+ tlpdbopt_generate_updmap
+ tlpdbopt_install_docfiles
+ tlpdbopt_install_srcfiles
+ tlpdbopt_post_code
+ tlpdbopt_sys_bin
+ tlpdbopt_sys_info
+ tlpdbopt_sys_man
+ tlpdbopt_w32_multi_user
+</pre>
+<p><strong>platform options</strong> (prefix <code>binary_</code>)
+</p>
+<p>For each supported platform in TeX Live (directories under <code>bin/</code>), the
+variable <code>binary_</code><em>PLATFORM</em> can be set. For example:
+</p>
+<pre class="verbatim"> binary_x86_64-linux
+</pre>
+<p>If no <code>binary_</code> variable is specified, the default is whatever the
+current machine is running.
+</p>
+<p>In releases before 2017, many profile variables had different
+names (not documented here; see the <code>install-tl</code> source). They are
+accepted and transformed to the names given above. When a profile is
+written, the names above are always used.
+</p>
+<p>For more details on all of the above options, consult the TeX Live
+installation manual, linked from <a href="http://tug.org/texlive/doc">http://tug.org/texlive/doc</a>.
+</p>
+<hr>
<a name="install_002dtl-ENVIRONMENT-VARIABLES"></a>
<div class="header">
<p>
-Next: <a href="#install_002dtl-AUTHORS-AND-COPYRIGHT" accesskey="n" rel="next">install-tl AUTHORS AND COPYRIGHT</a>, Previous: <a href="#install_002dtl-OPTIONS" accesskey="p" rel="prev">install-tl OPTIONS</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#install_002dtl-AUTHORS-AND-COPYRIGHT" accesskey="n" rel="next">install-tl AUTHORS AND COPYRIGHT</a>, Previous: <a href="#install_002dtl-PROFILES" accesskey="p" rel="prev">install-tl PROFILES</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="ENVIRONMENT-VARIABLES"></a>
-<h3 class="appendixsec">A.6 ENVIRONMENT VARIABLES</h3>
+<h3 class="appendixsec">A.7 ENVIRONMENT VARIABLES</h3>
<p>For ease in scripting and debugging, <code>install-tl</code> will look for the
-following environment variables. They are not of interest in normal
+following environment variables. They are not of interest for normal
user installations.
</p>
<dl compact="compact">
@@ -3752,12 +3923,24 @@ variables.
<p>Omit creating the ConTeXt cache. This is useful for redistributors.
</p>
</dd>
+<dt><code>TEXLIVE_INSTALL_NO_WELCOME</code></dt>
+<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fNO_005fWELCOME"></a>
+<p>Omit printing the welcome message after successful installation, e.g.,
+for testing.
+</p>
+</dd>
<dt><code>TEXLIVE_INSTALL_PREFIX</code></dt>
<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fPREFIX"></a>
</dd>
+<dt><code>TEXLIVE_INSTALL_TEXDIR</code></dt>
+<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fTEXDIR"></a>
+</dd>
<dt><code>TEXLIVE_INSTALL_TEXMFCONFIG</code></dt>
<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFCONFIG"></a>
</dd>
+<dt><code>TEXLIVE_INSTALL_TEXMFVAR</code></dt>
+<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFVAR"></a>
+</dd>
<dt><code>TEXLIVE_INSTALL_TEXMFHOME</code></dt>
<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFHOME"></a>
</dd>
@@ -3769,10 +3952,11 @@ variables.
</dd>
<dt><code>TEXLIVE_INSTALL_TEXMFSYSVAR</code></dt>
<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFSYSVAR"></a>
-</dd>
-<dt><code>TEXLIVE_INSTALL_TEXMFVAR</code></dt>
-<dd><a name="install_002dtl-TEXLIVE_005fINSTALL_005fTEXMFVAR"></a>
-<p>Specify the respective directories.
+<p>Specify the respective directories. <code>TEXLIVE_INSTALL_PREFIX</code> defaults
+to <code>/usr/local/texlive</code>, while <code>TEXLIVE_INSTALL_TEXDIR</code> defaults to
+the release directory within that prefix, e.g.,
+<code>/usr/local/texlive/2016</code>. All the defaults can be seen by running the
+installer interactively and then typing <code>D</code> for the directory menu.
</p>
</dd>
<dt><code>NOPERLDOC</code></dt>
@@ -3789,12 +3973,14 @@ variables.
Previous: <a href="#install_002dtl-ENVIRONMENT-VARIABLES" accesskey="p" rel="prev">install-tl ENVIRONMENT VARIABLES</a>, Up: <a href="#install_002dtl" accesskey="u" rel="up">install-tl</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="AUTHORS-AND-COPYRIGHT"></a>
-<h3 class="appendixsec">A.7 AUTHORS AND COPYRIGHT</h3>
+<h3 class="appendixsec">A.8 AUTHORS AND COPYRIGHT</h3>
<p>This script and its documentation were written for the TeX Live
distribution (<a href="http://tug.org/texlive">http://tug.org/texlive</a>) and both are licensed under the
GNU General Public License Version 2 or later.
</p>
+<p>$Id: install-tl 46908 2018-03-10 00:46:28Z preining $
+</p>
<hr>
<a name="tlmgr"></a>
<div class="header">
@@ -3817,11 +4003,11 @@ Next: <a href="#Index" accesskey="n" rel="next">Index</a>, Previous: <a href="#i
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#tlmgr-ACTIONS" accesskey="6">tlmgr ACTIONS</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-USER-MODE" accesskey="7">tlmgr USER MODE</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR" accesskey="7">tlmgr CONFIGURATION FILE FOR TLMGR</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR" accesskey="8">tlmgr CONFIGURATION FILE FOR TLMGR</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="8">tlmgr CRYPTOGRAPHIC VERIFICATION</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-TAXONOMIES" accesskey="9">tlmgr TAXONOMIES</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-USER-MODE" accesskey="9">tlmgr USER MODE</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#tlmgr-MULTIPLE-REPOSITORIES">tlmgr MULTIPLE REPOSITORIES</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
@@ -3842,7 +4028,7 @@ Next: <a href="#tlmgr-SYNOPSIS" accesskey="n" rel="next">tlmgr SYNOPSIS</a>, Up:
<a name="NAME-1"></a>
<h3 class="appendixsec">B.1 NAME</h3>
-<p>tlmgr - the TeX Live Manager
+<p>tlmgr - the native TeX Live Manager
</p>
<hr>
<a name="tlmgr-SYNOPSIS"></a>
@@ -3853,7 +4039,7 @@ Next: <a href="#tlmgr-DESCRIPTION" accesskey="n" rel="next">tlmgr DESCRIPTION</a
<a name="SYNOPSIS-1"></a>
<h3 class="appendixsec">B.2 SYNOPSIS</h3>
-<p>tlmgr [<em>option</em>]... <em>action</em> [<em>option</em>]... [<em>operand</em>]...
+<p>tlmgr [<em>option</em>...] <em>action</em> [<em>option</em>...] [<em>operand</em>...]
</p>
<hr>
<a name="tlmgr-DESCRIPTION"></a>
@@ -3896,10 +4082,17 @@ Next: <a href="#tlmgr-OPTIONS" accesskey="n" rel="next">tlmgr OPTIONS</a>, Previ
with <code>tlmgr</code>:
</p>
<dl compact="compact">
+<dt><code>tlmgr option repository ctan</code></dt>
+<dd><a name="tlmgr-tlmgr-option-repository-ctan"></a>
+</dd>
<dt><code>tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet</code></dt>
<dd><a name="tlmgr-tlmgr-option-repository-http_003a_002f_002fmirror_002ectan_002eorg_002fsystems_002ftexlive_002ftlnet"></a>
<p>Tell <code>tlmgr</code> to use a nearby CTAN mirror for future updates; useful if
-you installed TeX Live from the DVD image and want continuing updates.
+you installed TeX Live from the DVD image and want to have continuing
+updates. The two commands are equivalent; <code>ctan</code> is just an alias for
+the given url. Caveat: <code>mirror.ctan.org</code> resolves to many different
+hosts, and they are not perfectly synchronized; we recommend updating
+only daily (at most), and not more often.
</p>
</dd>
<dt><code>tlmgr update --list</code></dt>
@@ -3913,10 +4106,10 @@ you installed TeX Live from the DVD image and want continuing updates.
repository (typically useful when updating from CTAN).
</p>
</dd>
-<dt><code>tlmgr info</code> <em>pkg</em></dt>
-<dd><a name="tlmgr-tlmgr-info-pkg"></a>
-<p>Display detailed information about <em>pkg</em>, such as the installation
-status and description.
+<dt><code>tlmgr info</code> <em>what</em></dt>
+<dd><a name="tlmgr-tlmgr-info-what"></a>
+<p>Display detailed information about a package <em>what</em>, such as the installation
+status and description, of searches for <em>what</em> in all packages.
</p>
</dd>
</dl>
@@ -4009,7 +4202,7 @@ debugging.
<dd><a name="tlmgr-_002d_002dpackage_002dlogfile-file"></a>
<p><code>tlmgr</code> logs all package actions (install, remove, update, failed
updates, failed restores) to a separate log file, by default
-<code>TEXMFSYSVAR/web2c/tlmgr.log</code>. This option allows you to specific a
+<code>TEXMFSYSVAR/web2c/tlmgr.log</code>. This option allows you to specify a
different file for the log.
</p>
</dd>
@@ -4051,6 +4244,16 @@ only useful in debugging.
<p>Uses <em>dir</em> for the tree in user mode; see <a href="#tlmgr-USER-MODE">USER MODE</a> below.
</p>
</dd>
+<dt><strong>&ndash;verify-repo=[none|main|all]</strong></dt>
+<dd><a name="tlmgr-_002d_002dverify_002drepo_003d_005bnone_007cmain_007call_005d"></a>
+<p>Defines the level of verification done: If <code>none</code> is specified, no
+verification whatsoever is done. If <code>main</code> is given and a working GnuPG
+(<code>gpg</code>) binary is available, all repositories are checked, but only the
+main repository is required to be signed. If <code>all</code> is given, then all
+repositories need to be signed. See <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION">CRYPTOGRAPHIC VERIFICATION</a> below
+for details.
+</p>
+</dd>
</dl>
<p>The standard options for TeX Live programs are also accepted:
@@ -4066,7 +4269,7 @@ revision number for the loaded TeX Live Perl modules are shown, too.
<a name="tlmgr-ACTIONS"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-USER-MODE" accesskey="n" rel="next">tlmgr USER MODE</a>, Previous: <a href="#tlmgr-OPTIONS" accesskey="p" rel="prev">tlmgr OPTIONS</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR" accesskey="n" rel="next">tlmgr CONFIGURATION FILE FOR TLMGR</a>, Previous: <a href="#tlmgr-OPTIONS" accesskey="p" rel="prev">tlmgr OPTIONS</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="ACTIONS"></a>
<h3 class="appendixsec">B.6 ACTIONS</h3>
@@ -4076,55 +4279,61 @@ Next: <a href="#tlmgr-USER-MODE" accesskey="n" rel="next">tlmgr USER MODE</a>, P
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#tlmgr-version" accesskey="2">tlmgr version</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-backup-_005b_002d_002dclean_005b_003dN_005d_005d-_005b_002d_002dbackupdir-dir_005d-_005b_002d_002dall-_007c-pkg_005d_002e_002e_002e" accesskey="3">tlmgr backup [--clean[=<em>N</em>]] [--backupdir <em>dir</em>] [--all | <em>pkg</em>]...</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-backup" accesskey="3">tlmgr backup</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#tlmgr-candidates-pkg" accesskey="4">tlmgr candidates <em>pkg</em></a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-check-_005boption_005d_002e_002e_002e-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d" accesskey="5">tlmgr check [<em>option</em>]... [files|depends|executes|runfiles|all]</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d" accesskey="5">tlmgr check [<em>option</em>...] [files|depends|executes|runfiles|all]</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-conf-_005btexmf_007ctlmgr_007cupdmap-_005b_002d_002dconffile-file_005d-_005b_002d_002ddelete_005d-_005bkey-_005bvalue_005d_005d_005d" accesskey="6">tlmgr conf [texmf|tlmgr|updmap [--conffile <em>file</em>] [--delete] [<em>key</em> [<em>value</em>]]]</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-conf" accesskey="6">tlmgr conf</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-dump_002dtlpdb-_005b_002d_002dlocal_007c_002d_002dremote_005d" accesskey="7">tlmgr dump-tlpdb [--local|--remote]</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" accesskey="7">tlmgr dump-tlpdb [<em>option</em>...] [--json]</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-generate-_005boption_005d_002e_002e_002e-what" accesskey="8">tlmgr generate [<em>option</em>]... <em>what</em></a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-generate" accesskey="8">tlmgr generate</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#tlmgr-gui" accesskey="9">tlmgr gui</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-info-_005boption_002e_002e_002e_005d-_005bcollections_007cschemes_007cpkg_002e_002e_002e_005d">tlmgr info [<em>option</em>...] [collections|schemes|<em>pkg</em>...]</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-info">tlmgr info</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#tlmgr-init_002dusertree">tlmgr init-usertree</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-install-_005boption_005d_002e_002e_002e-pkg_002e_002e_002e">tlmgr install [<em>option</em>]... <em>pkg</em>...</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">tlmgr install [<em>option</em>...] <em>pkg</em>...</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-key">tlmgr key</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-list">tlmgr list</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#tlmgr-option">tlmgr option</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#tlmgr-paper">tlmgr paper</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-path-_005b_002d_002dw32mode_003duser_007cadmin_005d-_005badd_007cremove_005d">tlmgr path [--w32mode=user|admin] [add|remove]</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-path">tlmgr path</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#tlmgr-pinning">tlmgr pinning</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-platform-list_007cadd_007cremove-platform_002e_002e_002e">tlmgr platform list|add|remove <em>platform</em>...</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-platform-set-platform">tlmgr platform set <em>platform</em></a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-platform-set-auto">tlmgr platform set auto</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-platform">tlmgr platform</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-postaction-_005b_002d_002dw32mode_003duser_007cadmin_005d-_005b_002d_002dfileassocmode_003d1_007c2_005d-_005b_002d_002dall_005d-_005binstall_007cremove_005d-_005bshortcut_007cfileassoc_007cscript_005d-_005bpkg_005d_002e_002e_002e">tlmgr postaction [--w32mode=user|admin] [--fileassocmode=1|2] [--all] [install|remove] [shortcut|fileassoc|script] [<em>pkg</em>]...</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-postaction">tlmgr postaction</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#tlmgr-print_002dplatform">tlmgr print-platform</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-restore-_005b_002d_002dbackupdir-dir_005d-_005b_002d_002dall-_007c-pkg-_005brev_005d_005d">tlmgr restore [--backupdir <em>dir</em>] [--all | <em>pkg</em> [<em>rev</em>]]</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-print_002dplatform_002dinfo">tlmgr print-platform-info</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-remove-_005boption_005d_002e_002e_002e-pkg_002e_002e_002e">tlmgr remove [<em>option</em>]... <em>pkg</em>...</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">tlmgr remove [<em>option</em>...] <em>pkg</em>...</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#tlmgr-repository">tlmgr repository</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-what">tlmgr search [<em>option</em>...] <em>what</em></a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-restore">tlmgr restore</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-search">tlmgr search</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-shell">tlmgr shell</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-show">tlmgr show</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#tlmgr-uninstall">tlmgr uninstall</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-update-_005boption_005d_002e_002e_002e-_005bpkg_005d_002e_002e_002e">tlmgr update [<em>option</em>]... [<em>pkg</em>]...</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d">tlmgr update [<em>option</em>...] [<em>pkg</em>...]</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>
@@ -4148,7 +4357,7 @@ variable and <code>perldoc</code> will not be used.
<a name="tlmgr-version"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-backup-_005b_002d_002dclean_005b_003dN_005d_005d-_005b_002d_002dbackupdir-dir_005d-_005b_002d_002dall-_007c-pkg_005d_002e_002e_002e" accesskey="n" rel="next">tlmgr backup [--clean[=<em>N</em>]] [--backupdir <em>dir</em>] [--all | <em>pkg</em>]...</a>, Previous: <a href="#tlmgr-help" accesskey="p" rel="prev">tlmgr help</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-backup" accesskey="n" rel="next">tlmgr backup</a>, Previous: <a href="#tlmgr-help" accesskey="p" rel="prev">tlmgr help</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="version"></a>
<h4 class="appendixsubsec">B.6.2 version</h4>
@@ -4158,14 +4367,20 @@ Next: <a href="#tlmgr-backup-_005b_002d_002dclean_005b_003dN_005d_005d-_005b_002
<p>If <code>-v</code> has been given the revisions of the used modules are reported, too.
</p>
<hr>
-<a name="tlmgr-backup-_005b_002d_002dclean_005b_003dN_005d_005d-_005b_002d_002dbackupdir-dir_005d-_005b_002d_002dall-_007c-pkg_005d_002e_002e_002e"></a>
+<a name="tlmgr-backup"></a>
<div class="header">
<p>
Next: <a href="#tlmgr-candidates-pkg" accesskey="n" rel="next">tlmgr candidates <em>pkg</em></a>, Previous: <a href="#tlmgr-version" accesskey="p" rel="prev">tlmgr version</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="backup-_005b_002d_002dclean_005b_003dN_005d_005d-_005b_002d_002dbackupdir-dir_005d-_005b_002d_002dall-_007c-pkg_005d_002e_002e_002e"></a>
-<h4 class="appendixsubsec">B.6.3 backup [&ndash;clean[=<em>N</em>]] [&ndash;backupdir <em>dir</em>] [&ndash;all | <em>pkg</em>]...</h4>
+<a name="backup"></a>
+<h4 class="appendixsubsec">B.6.3 backup</h4>
+<dl compact="compact">
+<dt><strong>backup [<em>option</em>...] &ndash;all</strong></dt>
+<dd><a name="tlmgr-backup-_005boption_002e_002e_002e_005d-_002d_002dall"></a>
+</dd>
+<dt><strong>backup [<em>option</em>...] <em>pkg</em>...</strong></dt>
+<dd><a name="tlmgr-backup-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></a>
<p>If the <code>--clean</code> option is not specified, this action makes a backup of
the given packages, or all packages given <code>--all</code>. These backups are
saved to the value of the <code>--backupdir</code> option, if that is an existing and
@@ -4213,32 +4428,29 @@ performed are written to the terminal.
</dd>
</dl>
+</dd>
+</dl>
+
<hr>
<a name="tlmgr-candidates-pkg"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-check-_005boption_005d_002e_002e_002e-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d" accesskey="n" rel="next">tlmgr check [<em>option</em>]... [files|depends|executes|runfiles|all]</a>, Previous: <a href="#tlmgr-backup-_005b_002d_002dclean_005b_003dN_005d_005d-_005b_002d_002dbackupdir-dir_005d-_005b_002d_002dall-_007c-pkg_005d_002e_002e_002e" accesskey="p" rel="prev">tlmgr backup [--clean[=<em>N</em>]] [--backupdir <em>dir</em>] [--all | <em>pkg</em>]...</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d" accesskey="n" rel="next">tlmgr check [<em>option</em>...] [files|depends|executes|runfiles|all]</a>, Previous: <a href="#tlmgr-backup" accesskey="p" rel="prev">tlmgr backup</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="candidates-pkg"></a>
<h4 class="appendixsubsec">B.6.4 candidates <em>pkg</em></h4>
-<dl compact="compact">
-<dt><strong>candidates <em>pkg</em></strong></dt>
-<dd><a name="tlmgr-candidates-pkg-1"></a>
<p>Shows the available candidate repositories for package <em>pkg</em>.
See <a href="#tlmgr-MULTIPLE-REPOSITORIES">MULTIPLE REPOSITORIES</a> below.
</p>
-</dd>
-</dl>
-
<hr>
-<a name="tlmgr-check-_005boption_005d_002e_002e_002e-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d"></a>
+<a name="tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-conf-_005btexmf_007ctlmgr_007cupdmap-_005b_002d_002dconffile-file_005d-_005b_002d_002ddelete_005d-_005bkey-_005bvalue_005d_005d_005d" accesskey="n" rel="next">tlmgr conf [texmf|tlmgr|updmap [--conffile <em>file</em>] [--delete] [<em>key</em> [<em>value</em>]]]</a>, Previous: <a href="#tlmgr-candidates-pkg" accesskey="p" rel="prev">tlmgr candidates <em>pkg</em></a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-conf" accesskey="n" rel="next">tlmgr conf</a>, Previous: <a href="#tlmgr-candidates-pkg" accesskey="p" rel="prev">tlmgr candidates <em>pkg</em></a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="check-_005boption_005d_002e_002e_002e-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d"></a>
-<h4 class="appendixsubsec">B.6.5 check [<em>option</em>]... [files|depends|executes|runfiles|all]</h4>
+<a name="check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d"></a>
+<h4 class="appendixsubsec">B.6.5 check [<em>option</em>...] [files|depends|executes|runfiles|all]</h4>
<p>Executes one (or all) check(s) on the consistency of the installation.
</p>
@@ -4251,8 +4463,8 @@ actually present, and lists those missing.
</dd>
<dt><strong>depends</strong></dt>
<dd><a name="tlmgr-depends"></a>
-<p>Lists those packages which occur as dependencies in an installed collections,
-but are themselves not installed, and those packages that are not
+<p>Lists those packages which occur as dependencies in an installed collection,
+but are themselves not installed, and those packages which are not
contained in any collection.
</p>
<p>If you call <code>tlmgr check collections</code> this test will be carried out
@@ -4267,7 +4479,8 @@ Live Database are present.
</dd>
<dt><strong>runfiles</strong></dt>
<dd><a name="tlmgr-runfiles"></a>
-<p>List those filenames that are occurring more than one time in the runfiles.
+<p>List those filenames that are occurring more than one time in the
+runfiles sections.
</p>
</dd>
</dl>
@@ -4284,58 +4497,78 @@ checking the TL development repository.
</dl>
<hr>
-<a name="tlmgr-conf-_005btexmf_007ctlmgr_007cupdmap-_005b_002d_002dconffile-file_005d-_005b_002d_002ddelete_005d-_005bkey-_005bvalue_005d_005d_005d"></a>
+<a name="tlmgr-conf"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-dump_002dtlpdb-_005b_002d_002dlocal_007c_002d_002dremote_005d" accesskey="n" rel="next">tlmgr dump-tlpdb [--local|--remote]</a>, Previous: <a href="#tlmgr-check-_005boption_005d_002e_002e_002e-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d" accesskey="p" rel="prev">tlmgr check [<em>option</em>]... [files|depends|executes|runfiles|all]</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" accesskey="n" rel="next">tlmgr dump-tlpdb [<em>option</em>...] [--json]</a>, Previous: <a href="#tlmgr-check-_005boption_002e_002e_002e_005d-_005bfiles_007cdepends_007cexecutes_007crunfiles_007call_005d" accesskey="p" rel="prev">tlmgr check [<em>option</em>...] [files|depends|executes|runfiles|all]</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="conf-_005btexmf_007ctlmgr_007cupdmap-_005b_002d_002dconffile-file_005d-_005b_002d_002ddelete_005d-_005bkey-_005bvalue_005d_005d_005d"></a>
-<h4 class="appendixsubsec">B.6.6 conf [texmf|tlmgr|updmap [&ndash;conffile <em>file</em>] [&ndash;delete] [<em>key</em> [<em>value</em>]]]</h4>
+<a name="conf"></a>
+<h4 class="appendixsubsec">B.6.6 conf</h4>
+<dl compact="compact">
+<dt><strong>conf [texmf|tlmgr|updmap [&ndash;conffile <em>file</em>] [&ndash;delete] [<em>key</em> [<em>value</em>]]]</strong></dt>
+<dd><a name="tlmgr-conf-_005btexmf_007ctlmgr_007cupdmap-_005b_002d_002dconffile-file_005d-_005b_002d_002ddelete_005d-_005bkey-_005bvalue_005d_005d_005d"></a>
+</dd>
+<dt><strong>conf auxtrees [&ndash;conffile <em>file</em>] [show|add|delete] [<em>value</em>]</strong></dt>
+<dd><a name="tlmgr-conf-auxtrees-_005b_002d_002dconffile-file_005d-_005bshow_007cadd_007cdelete_005d-_005bvalue_005d"></a>
<p>With only <code>conf</code>, show general configuration information for TeX Live,
including active configuration files, path settings, and more. This is
-like the <code>texconfig conf</code> call, but works on all supported platforms.
+like running <code>texconfig conf</code>, but works on all supported platforms.
</p>
-<p>With either <code>conf texmf</code>, <code>conf tlmgr</code>, or <code>conf updmap</code> given in
-addition, shows all key/value pairs (i.e., all settings) as saved in
-<code>ROOT/texmf.cnf</code>, the tlmgr configuration file (see below), or the
-first found (via kpsewhich) <code>updmap.cfg</code> file, respectively.
+<p>With one of <code>conf texmf</code>, <code>conf tlmgr</code>, or <code>conf updmap</code>, shows all
+key/value pairs (i.e., all settings) as saved in <code>ROOT/texmf.cnf</code>, the
+user-specific <code>tlmgr</code> configuration file (see below), or the first
+found (via <code>kpsewhich</code>) <code>updmap.cfg</code> file, respectively.
</p>
<p>If <em>key</em> is given in addition, shows the value of only that <em>key</em> in
-the respective file. If option <em>&ndash;delete</em> is also given, the
-configuration file &ndash; it is removed, not just commented out!
+the respective file. If option <em>&ndash;delete</em> is also given, the value in
+the given configuration file is entirely removed (not just commented
+out).
</p>
<p>If <em>value</em> is given in addition, <em>key</em> is set to <em>value</em> in the
respective file. <em>No error checking is done!</em>
</p>
-<p>In all cases the file used can be explicitly specified via the option
-<code>--conffile <em>file</em></code>, in case one wants to operate on a different file.
+<p>The <code>PATH</code> value shown by <code>conf</code> is as used by <code>tlmgr</code>. The
+directory in which the <code>tlmgr</code> executable is found is automatically
+prepended to the PATH value inherited from the environment.
</p>
-<p>Practical application: if the execution of (some or all) system commands
-via <code>\write18</code> was left enabled during installation, you can disable
-it afterwards:
+<p>Here is a practical example of changing configuration values. If the
+execution of (some or all) system commands via <code>\write18</code> was left
+enabled during installation, you can disable it afterwards:
</p>
<pre class="verbatim"> tlmgr conf texmf shell_escape 0
</pre>
-<p>A more complicated example: the <code>TEXMFHOME</code> tree (see the main TeX Live
-guide, <a href="http://tug.org/texlive/doc.html">http://tug.org/texlive/doc.html</a>) can be set to multiple
-directories, but they must be enclosed in braces and separated by
-commas, so quoting the value to the shell is a good idea. Thus:
-</p>
-<pre class="verbatim"> tlmgr conf texmf TEXMFHOME &quot;{~/texmf,~/texmfbis}&quot;
+<p>The subcommand <code>auxtrees</code> allows adding and removing arbitrary
+additional texmf trees, completely under user control. <code>auxtrees show</code>
+shows the list of additional trees, <code>auxtrees add</code> <em>tree</em> adds a tree
+to the list, and <code>auxtrees remove</code> <em>tree</em> removes a tree from the list
+(if present). The trees should not contain an <code>ls-R</code> file (or files
+might not be found if the <code>ls-R</code> becomes stale). This works by
+manipulating the Kpathsea variable <code>TEXMFAUXTREES</code>, in
+<code>ROOT/texmf.cnf</code>. Example:
+</p>
+<pre class="verbatim"> tlmgr conf auxtrees add /quick/test/tree
+ tlmgr conf auxtrees remove /quick/test/tree
</pre>
-<p>Warning: The general facility is here, but tinkering with settings in
-this way is very strongly discouraged. Again, no error checking on
-either keys or values is done, so any sort of breakage is possible.
+<p>In all cases the configuration file can be explicitly specified via the
+option <code>--conffile</code> <em>file</em>, if desired.
+</p>
+<p>Warning: The general facility for changing configuration values is here,
+but tinkering with settings in this way is strongly discouraged. Again,
+no error checking on either keys or values is done, so any sort of
+breakage is possible.
</p>
+</dd>
+</dl>
+
<hr>
-<a name="tlmgr-dump_002dtlpdb-_005b_002d_002dlocal_007c_002d_002dremote_005d"></a>
+<a name="tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-generate-_005boption_005d_002e_002e_002e-what" accesskey="n" rel="next">tlmgr generate [<em>option</em>]... <em>what</em></a>, Previous: <a href="#tlmgr-conf-_005btexmf_007ctlmgr_007cupdmap-_005b_002d_002dconffile-file_005d-_005b_002d_002ddelete_005d-_005bkey-_005bvalue_005d_005d_005d" accesskey="p" rel="prev">tlmgr conf [texmf|tlmgr|updmap [--conffile <em>file</em>] [--delete] [<em>key</em> [<em>value</em>]]]</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-generate" accesskey="n" rel="next">tlmgr generate</a>, Previous: <a href="#tlmgr-conf" accesskey="p" rel="prev">tlmgr conf</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="dump_002dtlpdb-_005b_002d_002dlocal_007c_002d_002dremote_005d"></a>
-<h4 class="appendixsubsec">B.6.7 dump-tlpdb [&ndash;local|&ndash;remote]</h4>
+<a name="dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d"></a>
+<h4 class="appendixsubsec">B.6.7 dump-tlpdb [<em>option</em>...] [&ndash;json]</h4>
<p>Dump complete local or remote TLPDB to standard output, as-is. The
output is analogous to the <code>--machine-readable</code> output; see
@@ -4346,12 +4579,19 @@ output is analogous to the <code>--machine-readable</code> output; see
<dl compact="compact">
<dt><strong>&ndash;local</strong></dt>
<dd><a name="tlmgr-_002d_002dlocal"></a>
-<p>Dump the local tlpdb.
+<p>Dump the local TLPDB.
</p>
</dd>
<dt><strong>&ndash;remote</strong></dt>
<dd><a name="tlmgr-_002d_002dremote"></a>
-<p>Dump the remote tlpdb.
+<p>Dump the remote TLPDB.
+</p>
+</dd>
+<dt><strong>&ndash;json</strong></dt>
+<dd><a name="tlmgr-_002d_002djson"></a>
+<p>Instead of dumping the actual content, the database is dumped as
+JSON. For the format of JSON output see <code>tlpkg/doc/JSON-formats.txt</code>,
+format definition <code>TLPDB</code>.
</p>
</dd>
</dl>
@@ -4369,29 +4609,26 @@ location, in this format:
<p>Line endings may be either LF or CRLF depending on the current platform.
</p>
<hr>
-<a name="tlmgr-generate-_005boption_005d_002e_002e_002e-what"></a>
+<a name="tlmgr-generate"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-gui" accesskey="n" rel="next">tlmgr gui</a>, Previous: <a href="#tlmgr-dump_002dtlpdb-_005b_002d_002dlocal_007c_002d_002dremote_005d" accesskey="p" rel="prev">tlmgr dump-tlpdb [--local|--remote]</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-gui" accesskey="n" rel="next">tlmgr gui</a>, Previous: <a href="#tlmgr-dump_002dtlpdb-_005boption_002e_002e_002e_005d-_005b_002d_002djson_005d" accesskey="p" rel="prev">tlmgr dump-tlpdb [<em>option</em>...] [--json]</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="generate-_005boption_005d_002e_002e_002e-what"></a>
-<h4 class="appendixsubsec">B.6.8 generate [<em>option</em>]... <em>what</em></h4>
+<a name="generate"></a>
+<h4 class="appendixsubsec">B.6.8 generate</h4>
<dl compact="compact">
-<dt><strong>generate language</strong></dt>
-<dd><a name="tlmgr-generate-language"></a>
-</dd>
-<dt><strong>generate language.dat</strong></dt>
-<dd><a name="tlmgr-generate-language_002edat"></a>
+<dt><strong>generate [<em>option</em>...] language</strong></dt>
+<dd><a name="tlmgr-generate-_005boption_002e_002e_002e_005d-language"></a>
</dd>
-<dt><strong>generate language.def</strong></dt>
-<dd><a name="tlmgr-generate-language_002edef"></a>
+<dt><strong>generate [<em>option</em>...] language.dat</strong></dt>
+<dd><a name="tlmgr-generate-_005boption_002e_002e_002e_005d-language_002edat"></a>
</dd>
-<dt><strong>generate language.dat.lua</strong></dt>
-<dd><a name="tlmgr-generate-language_002edat_002elua"></a>
+<dt><strong>generate [<em>option</em>...] language.def</strong></dt>
+<dd><a name="tlmgr-generate-_005boption_002e_002e_002e_005d-language_002edef"></a>
</dd>
-<dt><strong>generate fmtutil</strong></dt>
-<dd><a name="tlmgr-generate-fmtutil"></a>
+<dt><strong>generate [<em>option</em>...] language.dat.lua</strong></dt>
+<dd><a name="tlmgr-generate-_005boption_002e_002e_002e_005d-language_002edat_002elua"></a>
</dd>
</dl>
@@ -4404,37 +4641,40 @@ all of these files.
<p>For managing your own fonts, please read the <code>updmap --help</code>
information and/or <a href="http://tug.org/fonts/fontinstall.html">http://tug.org/fonts/fontinstall.html</a>.
</p>
+<p>For managing your own formats, please read the <code>fmtutil --help</code>
+information.
+</p>
<p>In more detail: <code>generate</code> remakes any of the configuration files
-<code>language.dat</code>, <code>language.def</code>, <code>language.dat.lua</code>, and
-<code>fmtutil.cnf</code>, from the information present in the local TLPDB, plus
+<code>language.dat</code>, <code>language.def</code>, and <code>language.dat.lua</code>
+from the information present in the local TLPDB, plus
locally-maintained files.
</p>
<p>The locally-maintained files are <code>language-local.dat</code>,
-<code>language-local.def</code>, <code>language-local.dat.lua</code>, or
-<code>fmtutil-local.cnf</code>, searched for in <code>TEXMFLOCAL</code> in the respective
+<code>language-local.def</code>, or <code>language-local.dat.lua</code>,
+searched for in <code>TEXMFLOCAL</code> in the respective
directories. If local additions are present, the final file is made by
starting with the main file, omitting any entries that the local file
specifies to be disabled, and finally appending the local file.
</p>
-<p>(Historical note: The formerly supported <code>updmap-local.cfg</code> is no longer
-read, since <code>updmap</code> now supports multiple <code>updmap.cfg</code> files. Thus,
-local additions can and should be put into an <code>updmap.cfg</code> file in
-<code>TEXMFLOCAL</code>. The <code>generate updmap</code> action no longer exists.)
+<p>(Historical note: The formerly supported <code>updmap-local.cfg</code> and
+<code>fmtutil-local.cnf</code> are no longer read, since <code>updmap</code> and <code>fmtutil</code>
+now reads and supports multiple configuration files. Thus,
+local additions can and should be put into an <code>updmap.cfg</code> of <code>fmtutil.cnf</code>
+file in <code>TEXMFLOCAL</code>. The <code>generate updmap</code> and <code>generate fmtutil</code> actions
+no longer exist.)
</p>
<p>Local files specify entries to be disabled with a comment line, namely
one of these:
</p>
-<pre class="verbatim"> #!NAME
- %!NAME
+<pre class="verbatim"> %!NAME
--!NAME
</pre>
-<p>where <code>fmtutil.cnf</code> uses <code>#</code>, <code>language.dat</code> and <code>language.def</code> use
-<code>%</code>, and <code>language.dat.lua</code> use <code>--</code>. In all cases, the <em>name</em> is
+<p>where <code>language.dat</code> and <code>language.def</code> use <code>%</code>,
+and <code>language.dat.lua</code> use <code>--</code>. In all cases, the <em>name</em> is
the respective format name or hyphenation pattern identifier.
Examples:
</p>
-<pre class="verbatim"> #!pdflatex
- %!german
+<pre class="verbatim"> %!german
--!usenglishmax
</pre>
<p>(Of course, you&rsquo;re not likely to actually want to disable those
@@ -4472,7 +4712,7 @@ location in <code>TEXMFLOCAL</code>).
</dd>
<dt><strong>&ndash;rebuild-sys</strong></dt>
<dd><a name="tlmgr-_002d_002drebuild_002dsys"></a>
-<p>tells tlmgr to run necessary programs after config files have been
+<p>tells <code>tlmgr</code> to run necessary programs after config files have been
regenerated. These are:
<code>fmtutil-sys --all</code> after <code>generate fmtutil</code>,
<code>fmtutil-sys --byhyphen .../language.dat</code> after <code>generate language.dat</code>,
@@ -4489,16 +4729,15 @@ succession before invoking these programs.
<p>The respective locations are as follows:
</p>
-<pre class="verbatim"> tex/generic/config/language.dat (and language-local.dat);
- tex/generic/config/language.def (and language-local.def);
- tex/generic/config/language.dat.lua (and language-local.dat.lua);
- web2c/fmtutil.cnf (and fmtutil-local.cnf);
+<pre class="verbatim"> tex/generic/config/language.dat (and language-local.dat)
+ tex/generic/config/language.def (and language-local.def)
+ tex/generic/config/language.dat.lua (and language-local.dat.lua)
</pre>
<hr>
<a name="tlmgr-gui"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-info-_005boption_002e_002e_002e_005d-_005bcollections_007cschemes_007cpkg_002e_002e_002e_005d" accesskey="n" rel="next">tlmgr info [<em>option</em>...] [collections|schemes|<em>pkg</em>...]</a>, Previous: <a href="#tlmgr-generate-_005boption_005d_002e_002e_002e-what" accesskey="p" rel="prev">tlmgr generate [<em>option</em>]... <em>what</em></a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-info" accesskey="n" rel="next">tlmgr info</a>, Previous: <a href="#tlmgr-generate" accesskey="p" rel="prev">tlmgr generate</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="gui"></a>
<h4 class="appendixsubsec">B.6.9 gui</h4>
@@ -4506,14 +4745,23 @@ Next: <a href="#tlmgr-info-_005boption_002e_002e_002e_005d-_005bcollections_007c
<p>Start the graphical user interface. See <strong>GUI</strong> below.
</p>
<hr>
-<a name="tlmgr-info-_005boption_002e_002e_002e_005d-_005bcollections_007cschemes_007cpkg_002e_002e_002e_005d"></a>
+<a name="tlmgr-info"></a>
<div class="header">
<p>
Next: <a href="#tlmgr-init_002dusertree" accesskey="n" rel="next">tlmgr init-usertree</a>, Previous: <a href="#tlmgr-gui" accesskey="p" rel="prev">tlmgr gui</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="info-_005boption_002e_002e_002e_005d-_005bcollections_007cschemes_007cpkg_002e_002e_002e_005d"></a>
-<h4 class="appendixsubsec">B.6.10 info [<em>option</em>...] [collections|schemes|<em>pkg</em>...]</h4>
+<a name="info"></a>
+<h4 class="appendixsubsec">B.6.10 info</h4>
+<dl compact="compact">
+<dt><strong>info [<em>option</em>...] <em>pkg</em>...</strong></dt>
+<dd><a name="tlmgr-info-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></a>
+</dd>
+<dt><strong>info [<em>option</em>...] collections</strong></dt>
+<dd><a name="tlmgr-info-_005boption_002e_002e_002e_005d-collections"></a>
+</dd>
+<dt><strong>info [<em>option</em>...] schemes</strong></dt>
+<dd><a name="tlmgr-info-_005boption_002e_002e_002e_005d-schemes"></a>
<p>With no argument, lists all packages available at the package
repository, prefixing those already installed with <code>i</code>.
</p>
@@ -4521,10 +4769,20 @@ repository, prefixing those already installed with <code>i</code>.
the request type instead of all packages.
</p>
<p>With any other arguments, display information about <em>pkg</em>: the name,
-category, short and long description, installation status, and TeX Live
+category, short and long description, sizes, installation status, and TeX Live
revision number. If <em>pkg</em> is not locally installed, searches in the
remote installation source.
</p>
+<p>For normal packages (not collections or schemes), the sizes of the four
+groups of files (run/src/doc/bin files) are shown separately. For
+collections, the cumulative size is shown, including all
+directly-dependent packages (but not dependent collections). For
+schemes, the cumulative size is also shown, including all
+directly-dependent collections and packages.
+</p>
+<p>If <em>pkg</em> is not found locally or remotely, the search action is used
+and lists matching packages and files.
+</p>
<p>It also displays information taken from the TeX Catalogue, namely the
package version, date, and license. Consider these, especially the
package version, as approximations only, due to timing skew of the
@@ -4547,35 +4805,40 @@ dependencies in a similar way.
</dd>
<dt><strong>&ndash;only-installed</strong></dt>
<dd><a name="tlmgr-_002d_002donly_002dinstalled"></a>
-<p>If this options is given, the installation source will
-not be used; only locally installed packages, collections, or schemes
-are listed.
-(Does not work for listing of packages for now)
+<p>If this option is given, the installation source will not be used; only
+locally installed packages, collections, or schemes are listed.
</p>
</dd>
-<dt><strong>&ndash;taxonomy</strong></dt>
-<dd><a name="tlmgr-_002d_002dtaxonomy"></a>
-</dd>
-<dt><strong>&ndash;keyword</strong></dt>
-<dd><a name="tlmgr-_002d_002dkeyword"></a>
-</dd>
-<dt><strong>&ndash;functionality</strong></dt>
-<dd><a name="tlmgr-_002d_002dfunctionality"></a>
+<dt><strong>&ndash;data <code>item1,item2,...</code></strong></dt>
+<dd><a name="tlmgr-_002d_002ddata-item1_002citem2_002c_002e_002e_002e"></a>
+<p>If the option <code>--data</code> is given, its argument must be a comma separated
+list of field names from: <code>name</code>, <code>category</code>, <code>localrev</code>, <code>remoterev</code>,
+<code>shortdesc</code>, <code>longdesc</code>, <code>installed</code>, <code>size</code>, <code>relocatable</code>, <code>depends</code>,
+<code>cat-version</code>, <code>cat-date</code>, or <code>cat-license</code>. In this case the requested
+packages&rsquo; information is listed in CSV format one package per line, and the
+column information is given by the <code>itemN</code>. The <code>depends</code> column contains
+the name of all dependencies separated by <code>:</code>.
+</p>
</dd>
-<dt><strong>&ndash;characterization</strong></dt>
-<dd><a name="tlmgr-_002d_002dcharacterization"></a>
-<p>In addition to the normal data displayed, also display information for
-given packages from the corresponding taxonomy (or all of them). See
-<a href="#tlmgr-TAXONOMIES">TAXONOMIES</a> below for details.
+<dt><strong>&ndash;json</strong></dt>
+<dd><a name="tlmgr-_002d_002djson-1"></a>
+<p>In case <code>--json</code> is specified, the output is a
+JSON encoded array where each array element is the JSON representation of
+a single <code>TLPOBJ</code> but with additional information. For details see
+<code>tlpkg/doc/JSON-formats.txt</code>, format definition: <code>TLPOBJINFO</code>.
+If both <code>--json</code> and <code>--data</code> are given, <code>--json</code> takes precedence.
</p>
</dd>
</dl>
+</dd>
+</dl>
+
<hr>
<a name="tlmgr-init_002dusertree"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-install-_005boption_005d_002e_002e_002e-pkg_002e_002e_002e" accesskey="n" rel="next">tlmgr install [<em>option</em>]... <em>pkg</em>...</a>, Previous: <a href="#tlmgr-info-_005boption_002e_002e_002e_005d-_005bcollections_007cschemes_007cpkg_002e_002e_002e_005d" accesskey="p" rel="prev">tlmgr info [<em>option</em>...] [collections|schemes|<em>pkg</em>...]</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" accesskey="n" rel="next">tlmgr install [<em>option</em>...] <em>pkg</em>...</a>, Previous: <a href="#tlmgr-info" accesskey="p" rel="prev">tlmgr info</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="init_002dusertree"></a>
<h4 class="appendixsubsec">B.6.11 init-usertree</h4>
@@ -4585,18 +4848,28 @@ default user tree (<code>TEXMFHOME</code>), or one specified on the command line
with <code>--usertree</code>. See <a href="#tlmgr-USER-MODE">USER MODE</a> below.
</p>
<hr>
-<a name="tlmgr-install-_005boption_005d_002e_002e_002e-pkg_002e_002e_002e"></a>
+<a name="tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-option" accesskey="n" rel="next">tlmgr option</a>, Previous: <a href="#tlmgr-init_002dusertree" accesskey="p" rel="prev">tlmgr init-usertree</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-key" accesskey="n" rel="next">tlmgr key</a>, Previous: <a href="#tlmgr-init_002dusertree" accesskey="p" rel="prev">tlmgr init-usertree</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="install-_005boption_005d_002e_002e_002e-pkg_002e_002e_002e"></a>
-<h4 class="appendixsubsec">B.6.12 install [<em>option</em>]... <em>pkg</em>...</h4>
+<a name="install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></a>
+<h4 class="appendixsubsec">B.6.12 install [<em>option</em>...] <em>pkg</em>...</h4>
-<p>Install each <em>pkg</em> given on the command line. By default this installs
-all packages on which the given <em>pkg</em>s are dependent, also. Options:
+<p>Install each <em>pkg</em> given on the command line, if it is not already
+installed. (It does not touch existing packages; see the <code>update</code>
+action for how to get the latest version of a package.)
+</p>
+<p>By default this also installs all packages on which the given <em>pkg</em>s are
+dependent. Options:
</p>
<dl compact="compact">
+<dt><strong>&ndash;dry-run</strong></dt>
+<dd><a name="tlmgr-_002d_002ddry_002drun-1"></a>
+<p>Nothing is actually installed; instead, the actions to be performed are
+written to the terminal.
+</p>
+</dd>
<dt><strong>&ndash;file</strong></dt>
<dd><a name="tlmgr-_002d_002dfile"></a>
<p>Instead of fetching a package from the installation repository, use
@@ -4604,14 +4877,11 @@ the package files given on the command line. These files must
be standard TeX Live package files (with contained tlpobj file).
</p>
</dd>
-<dt><strong>&ndash;reinstall</strong></dt>
-<dd><a name="tlmgr-_002d_002dreinstall"></a>
-<p>Reinstall a package (including dependencies for collections) even if it
-already seems to be installed (i.e, is present in the TLPDB). This is
-useful to recover from accidental removal of files in the hierarchy.
-</p>
-<p>When re-installing, only dependencies on normal packages are followed
-(i.e., not those of category Scheme or Collection).
+<dt><strong>&ndash;force</strong></dt>
+<dd><a name="tlmgr-_002d_002dforce"></a>
+<p>If updates to <code>tlmgr</code> itself (or other parts of the basic
+infrastructure) are present, <code>tlmgr</code> will bail out and not perform the
+installation unless this option is given. Not recommended.
</p>
</dd>
<dt><strong>&ndash;no-depends</strong></dt>
@@ -4630,51 +4900,115 @@ implies <code>--no-depends</code>. Don&rsquo;t use it unless you are sure of wh
are doing.
</p>
</dd>
-<dt><strong>&ndash;dry-run</strong></dt>
-<dd><a name="tlmgr-_002d_002ddry_002drun-1"></a>
-<p>Nothing is actually installed; instead, the actions to be performed are
-written to the terminal.
+<dt><strong>&ndash;reinstall</strong></dt>
+<dd><a name="tlmgr-_002d_002dreinstall"></a>
+<p>Reinstall a package (including dependencies for collections) even if it
+already seems to be installed (i.e, is present in the TLPDB). This is
+useful to recover from accidental removal of files in the hierarchy.
+</p>
+<p>When re-installing, only dependencies on normal packages are followed
+(i.e., not those of category Scheme or Collection).
</p>
</dd>
-<dt><strong>&ndash;force</strong></dt>
-<dd><a name="tlmgr-_002d_002dforce"></a>
-<p>If updates to <code>tlmgr</code> itself (or other parts of the basic
-infrastructure) are present, <code>tlmgr</code> will bail out and not perform the
-installation unless this option is given. Not recommended.
+<dt><strong>&ndash;with-doc</strong></dt>
+<dd><a name="tlmgr-_002d_002dwith_002ddoc"></a>
+</dd>
+<dt><strong>&ndash;with-src</strong></dt>
+<dd><a name="tlmgr-_002d_002dwith_002dsrc"></a>
+<p>While not recommended, the <code>install-tl</code> program provides an option to
+omit installation of all documentation and/or source files. (By
+default, everything is installed.) After such an installation, you may
+find that you want the documentation or source files for a given package
+after all. You can get them by using these options in conjunction with
+<code>--reinstall</code>, as in (using the <code>fontspec</code> package as the example):
+</p>
+<pre class="verbatim"> tlmgr install --reinstall --with-doc --with-src fontspec
+</pre>
+</dd>
+</dl>
+
+<hr>
+<a name="tlmgr-key"></a>
+<div class="header">
+<p>
+Next: <a href="#tlmgr-list" accesskey="n" rel="next">tlmgr list</a>, Previous: <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" accesskey="p" rel="prev">tlmgr install [<em>option</em>...] <em>pkg</em>...</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="key"></a>
+<h4 class="appendixsubsec">B.6.13 key</h4>
+
+<dl compact="compact">
+<dt><strong>key list</strong></dt>
+<dd><a name="tlmgr-key-list"></a>
+</dd>
+<dt><strong>key add <em>file</em></strong></dt>
+<dd><a name="tlmgr-key-add-file"></a>
+</dd>
+<dt><strong>key remove <em>keyid</em></strong></dt>
+<dd><a name="tlmgr-key-remove-keyid"></a>
+<p>The action <code>key</code> allows listing, adding and removing additional GPG
+keys to the set of trusted keys, that is, those that are used to verify
+the TeX Live databases.
+</p>
+<p>With the <code>list</code> argument, <code>key</code> lists all keys.
+</p>
+<p>The <code>add</code> argument requires another argument, either a filename or
+<code>-</code> for stdin, from which the key is added. The key is added to the
+local keyring <code>GNUPGHOME/repository-keys.gpg</code>, which is normally)
+<code>tlpkg/gpg/repository-keys.gpg</code>.
+</p>
+<p>The <code>remove</code> argument requires a key id and removes the requested id
+from the local keyring.
</p>
</dd>
</dl>
<hr>
+<a name="tlmgr-list"></a>
+<div class="header">
+<p>
+Next: <a href="#tlmgr-option" accesskey="n" rel="next">tlmgr option</a>, Previous: <a href="#tlmgr-key" accesskey="p" rel="prev">tlmgr key</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="list"></a>
+<h4 class="appendixsubsec">B.6.14 list</h4>
+
+<p>Synonym for <a href="#tlmgr-info">info</a>.
+</p>
+<hr>
<a name="tlmgr-option"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-paper" accesskey="n" rel="next">tlmgr paper</a>, Previous: <a href="#tlmgr-install-_005boption_005d_002e_002e_002e-pkg_002e_002e_002e" accesskey="p" rel="prev">tlmgr install [<em>option</em>]... <em>pkg</em>...</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-paper" accesskey="n" rel="next">tlmgr paper</a>, Previous: <a href="#tlmgr-list" accesskey="p" rel="prev">tlmgr list</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="option"></a>
-<h4 class="appendixsubsec">B.6.13 option</h4>
+<h4 class="appendixsubsec">B.6.15 option</h4>
<dl compact="compact">
-<dt><strong>option [show]</strong></dt>
-<dd><a name="tlmgr-option-_005bshow_005d"></a>
+<dt><strong>option [&ndash;json] [show]</strong></dt>
+<dd><a name="tlmgr-option-_005b_002d_002djson_005d-_005bshow_005d"></a>
</dd>
-<dt><strong>option showall</strong></dt>
-<dd><a name="tlmgr-option-showall"></a>
+<dt><strong>option [&ndash;json] showall</strong></dt>
+<dd><a name="tlmgr-option-_005b_002d_002djson_005d-showall"></a>
</dd>
<dt><strong>option <em>key</em> [<em>value</em>]</strong></dt>
<dd><a name="tlmgr-option-key-_005bvalue_005d"></a>
</dd>
</dl>
-<p>The first form shows the global TeX Live settings currently saved in the
-TLPDB with a short description and the <code>key</code> used for changing it in
-parentheses.
+<p>The first form, <code>show</code>, shows the global TeX Live settings currently
+saved in the TLPDB with a short description and the <code>key</code> used for
+changing it in parentheses.
+</p>
+<p>The second form, <code>showall</code>, is similar, but also shows options which
+can be defined but are not currently set to any value.
</p>
-<p>The second form is similar, but also shows options which can be defined
-but are not currently set to any value.
+<p>Both <code>show...</code> forms take an option <code>--json</code>, which dumps the option
+information in JSON format. In this case, both forms dump the same
+data. For the format of the JSON output see
+<code>tlpkg/doc/JSON-formats.txt</code>, format definition <code>TLOPTION</code>.
</p>
-<p>In the third form, if <em>value</em> is not given, the setting for <em>key</em> is
-displayed. If <em>value</em> is present, <em>key</em> is set to <em>value</em>.
+<p>In the third form, with <em>key</em>, if <em>value</em> is not given, the setting
+for <em>key</em> is displayed. If <em>value</em> is present, <em>key</em> is set to
+<em>value</em>.
</p>
<p>Possible values for <em>key</em> are (run <code>tlmgr option showall</code> for
the definitive list):
@@ -4701,19 +5035,22 @@ DVD. To do this, you can run
</pre>
<p>The <code>install-tl</code> documentation has more information about the possible
values for <code>repository</code>. (For backward compatibility, <code>location</code> can
-be used as alternative name for <code>repository</code>.)
+be used as a synonym for <code>repository</code>.)
</p>
<p>If <code>formats</code> is set (this is the default), then formats are regenerated
when either the engine or the format files have changed. Disable this
-only when you know what you are doing.
+only when you know how and want to regenerate formats yourself.
</p>
<p>The <code>postcode</code> option controls execution of per-package
postinstallation action code. It is set by default, and again disabling
-is not likely to be of interest except perhaps to developers.
+is not likely to be of interest except to developers doing debugging.
</p>
<p>The <code>docfiles</code> and <code>srcfiles</code> options control the installation of
-their respective files of a package. By default both are enabled (1).
-This can be disabled (set to 0) if disk space is (very) limited.
+their respective file groups (documentation, sources; grouping is
+approximate) per package. By default both are enabled (1). Either or
+both can be disabled (set to 0) if disk space is limited or for minimal
+testing installations, etc. When disabled, the respective files are not
+downloaded at all.
</p>
<p>The options <code>autobackup</code> and <code>backupdir</code> determine the defaults for
the actions <code>update</code>, <code>backup</code> and <code>restore</code>. These three actions
@@ -4726,21 +5063,22 @@ Its value is an integer. If the <code>autobackup</code> value is <code>-1</code
backups are removed. If <code>autobackup</code> is 0 or more, it specifies the
number of backups to keep. Thus, backups are disabled if the value is
0. In the <code>--clean</code> mode of the <code>backup</code> action this option also
-specifies the number to be kept.
+specifies the number to be kept. The default value is 1, so that
+backups are made, but only one backup is kept.
</p>
<p>To setup <code>autobackup</code> to <code>-1</code> on the command line, use:
</p>
<pre class="verbatim"> tlmgr option -- autobackup -1
</pre>
-<p>The <code>--</code> avoids having the <code>-1</code> treated as an option. (<code>--</code> stops
-parsing for options at the point where it appears; this is a general
-feature across most Unix programs.)
+<p>The <code>--</code> avoids having the <code>-1</code> treated as an option. (The <code>--</code>
+stops parsing for options at the point where it appears; this is a
+general feature across most Unix programs.)
</p>
-<p>The <code>sys_bin</code>, <code>sys_man</code>, and <code>sys_info</code> options are used on
-Unix-like systems to control the generation of links for executables,
-info files and man pages. See the <code>path</code> action for details.
+<p>The <code>sys_bin</code>, <code>sys_man</code>, and <code>sys_info</code> options are used on Unix
+systems to control the generation of links for executables, Info files
+and man pages. See the <code>path</code> action for details.
</p>
-<p>The last three options control behaviour on Windows installations. If
+<p>The last three options affect behavior on Windows installations. If
<code>desktop_integration</code> is set, then some packages will install items in
a sub-folder of the Start menu for <code>tlmgr gui</code>, documentation, etc. If
<code>fileassocs</code> is set, Windows file associations are made (see also the
@@ -4752,10 +5090,10 @@ instead of only the current user. All three options are on by default.
<a name="tlmgr-paper"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-path-_005b_002d_002dw32mode_003duser_007cadmin_005d-_005badd_007cremove_005d" accesskey="n" rel="next">tlmgr path [--w32mode=user|admin] [add|remove]</a>, Previous: <a href="#tlmgr-option" accesskey="p" rel="prev">tlmgr option</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-path" accesskey="n" rel="next">tlmgr path</a>, Previous: <a href="#tlmgr-option" accesskey="p" rel="prev">tlmgr option</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="paper"></a>
-<h4 class="appendixsubsec">B.6.14 paper</h4>
+<h4 class="appendixsubsec">B.6.16 paper</h4>
<dl compact="compact">
<dt><strong>paper [a4|letter]</strong></dt>
@@ -4764,6 +5102,9 @@ Next: <a href="#tlmgr-path-_005b_002d_002dw32mode_003duser_007cadmin_005d-_005ba
<dt><strong>[xdvi|pdftex|dvips|dvipdfmx|context|psutils]&nbsp;paper&nbsp;[<em>papersize</em>|&ndash;list]<!-- /@w --></strong></dt>
<dd><a name="tlmgr-_005bxdvi_007cpdftex_007cdvips_007cdvipdfmx_007ccontext_007cpsutils_005d-paper-_005bpapersize_007c_002d_002dlist_005d"></a>
</dd>
+<dt><strong>paper &ndash;json</strong></dt>
+<dd><a name="tlmgr-paper-_002d_002djson"></a>
+</dd>
</dl>
<p>With no arguments (<code>tlmgr paper</code>), shows the default paper size setting
@@ -4784,6 +5125,10 @@ program to that paper size.
last argument (e.g., <code>tlmgr dvips paper --list</code>), shows all valid paper
sizes for that program. The first size shown is the default.
</p>
+<p>If <code>--json</code> is specified without other options, the paper setup is
+dumped in JSON format. For the format of JSON output see
+<code>tlpkg/doc/JSON-formats.txt</code>, format definition <code>TLPAPER</code>.
+</p>
<p>Incidentally, this syntax of having a specific program name before the
<code>paper</code> keyword is unusual. It is inherited from the longstanding
<code>texconfig</code> script, which supports other configuration settings for
@@ -4791,14 +5136,20 @@ some programs, notably <code>dvips</code>. <code>tlmgr</code> does not support
settings.
</p>
<hr>
-<a name="tlmgr-path-_005b_002d_002dw32mode_003duser_007cadmin_005d-_005badd_007cremove_005d"></a>
+<a name="tlmgr-path"></a>
<div class="header">
<p>
Next: <a href="#tlmgr-pinning" accesskey="n" rel="next">tlmgr pinning</a>, Previous: <a href="#tlmgr-paper" accesskey="p" rel="prev">tlmgr paper</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="path-_005b_002d_002dw32mode_003duser_007cadmin_005d-_005badd_007cremove_005d"></a>
-<h4 class="appendixsubsec">B.6.15 path [&ndash;w32mode=user|admin] [add|remove]</h4>
+<a name="path"></a>
+<h4 class="appendixsubsec">B.6.17 path</h4>
+<dl compact="compact">
+<dt><strong>path [&ndash;w32mode=user|admin] add</strong></dt>
+<dd><a name="tlmgr-path-_005b_002d_002dw32mode_003duser_007cadmin_005d-add"></a>
+</dd>
+<dt><strong>path [&ndash;w32mode=user|admin] remove</strong></dt>
+<dd><a name="tlmgr-path-_005b_002d_002dw32mode_003duser_007cadmin_005d-remove"></a>
<p>On Unix, merely adds or removes symlinks for binaries, man pages, and
info pages in the system directories specified by the respective options
(see the <a href="#tlmgr-option">option</a> description above). Does not change any
@@ -4820,18 +5171,21 @@ is changed, while if the setting <em>w32_multi_user</em> is on, a warning is
issued that the caller does not have enough privileges.
</p>
<p>If the user does not have admin rights, and the option <code>--w32mode</code>
-is given, it must be <strong>user</strong> and the user path will be adjusted. If a
+is given, it must be <code>user</code> and the user path will be adjusted. If a
user without admin rights uses the option <code>--w32mode admin</code> a warning
is issued that the caller does not have enough privileges.
</p>
+</dd>
+</dl>
+
<hr>
<a name="tlmgr-pinning"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-platform-list_007cadd_007cremove-platform_002e_002e_002e" accesskey="n" rel="next">tlmgr platform list|add|remove <em>platform</em>...</a>, Previous: <a href="#tlmgr-path-_005b_002d_002dw32mode_003duser_007cadmin_005d-_005badd_007cremove_005d" accesskey="p" rel="prev">tlmgr path [--w32mode=user|admin] [add|remove]</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-platform" accesskey="n" rel="next">tlmgr platform</a>, Previous: <a href="#tlmgr-path" accesskey="p" rel="prev">tlmgr path</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="pinning"></a>
-<h4 class="appendixsubsec">B.6.16 pinning</h4>
+<h4 class="appendixsubsec">B.6.18 pinning</h4>
<p>The <code>pinning</code> action manages the pinning file, see <a href="#tlmgr-Pinning">Pinning</a> below.
</p>
@@ -4861,32 +5215,23 @@ the given repository <em>repo</em> are removed.
</dl>
<hr>
-<a name="tlmgr-platform-list_007cadd_007cremove-platform_002e_002e_002e"></a>
-<div class="header">
-<p>
-Next: <a href="#tlmgr-platform-set-platform" accesskey="n" rel="next">tlmgr platform set <em>platform</em></a>, Previous: <a href="#tlmgr-pinning" accesskey="p" rel="prev">tlmgr pinning</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<a name="platform-list_007cadd_007cremove-platform_002e_002e_002e"></a>
-<h4 class="appendixsubsec">B.6.17 platform list|add|remove <em>platform</em>...</h4>
-
-<hr>
-<a name="tlmgr-platform-set-platform"></a>
-<div class="header">
-<p>
-Next: <a href="#tlmgr-platform-set-auto" accesskey="n" rel="next">tlmgr platform set auto</a>, Previous: <a href="#tlmgr-platform-list_007cadd_007cremove-platform_002e_002e_002e" accesskey="p" rel="prev">tlmgr platform list|add|remove <em>platform</em>...</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<a name="platform-set-platform"></a>
-<h4 class="appendixsubsec">B.6.18 platform set <em>platform</em></h4>
-
-<hr>
-<a name="tlmgr-platform-set-auto"></a>
+<a name="tlmgr-platform"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-postaction-_005b_002d_002dw32mode_003duser_007cadmin_005d-_005b_002d_002dfileassocmode_003d1_007c2_005d-_005b_002d_002dall_005d-_005binstall_007cremove_005d-_005bshortcut_007cfileassoc_007cscript_005d-_005bpkg_005d_002e_002e_002e" accesskey="n" rel="next">tlmgr postaction [--w32mode=user|admin] [--fileassocmode=1|2] [--all] [install|remove] [shortcut|fileassoc|script] [<em>pkg</em>]...</a>, Previous: <a href="#tlmgr-platform-set-platform" accesskey="p" rel="prev">tlmgr platform set <em>platform</em></a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-postaction" accesskey="n" rel="next">tlmgr postaction</a>, Previous: <a href="#tlmgr-pinning" accesskey="p" rel="prev">tlmgr pinning</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="platform-set-auto"></a>
-<h4 class="appendixsubsec">B.6.19 platform set auto</h4>
+<a name="platform"></a>
+<h4 class="appendixsubsec">B.6.19 platform</h4>
+<dl compact="compact">
+<dt><strong>platform list|add|remove <em>platform</em>...</strong></dt>
+<dd><a name="tlmgr-platform-list_007cadd_007cremove-platform_002e_002e_002e"></a>
+</dd>
+<dt><strong>platform set <em>platform</em></strong></dt>
+<dd><a name="tlmgr-platform-set-platform"></a>
+</dd>
+<dt><strong>platform set auto</strong></dt>
+<dd><a name="tlmgr-platform-set-auto"></a>
<p><code>platform list</code> lists the TeX Live names of all the platforms
(a.k.a. architectures), (<code>i386-linux</code>, ...) available at the package
repository.
@@ -4919,36 +5264,64 @@ written to the terminal.
</dd>
</dl>
+</dd>
+</dl>
+
<hr>
-<a name="tlmgr-postaction-_005b_002d_002dw32mode_003duser_007cadmin_005d-_005b_002d_002dfileassocmode_003d1_007c2_005d-_005b_002d_002dall_005d-_005binstall_007cremove_005d-_005bshortcut_007cfileassoc_007cscript_005d-_005bpkg_005d_002e_002e_002e"></a>
+<a name="tlmgr-postaction"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-print_002dplatform" accesskey="n" rel="next">tlmgr print-platform</a>, Previous: <a href="#tlmgr-platform-set-auto" accesskey="p" rel="prev">tlmgr platform set auto</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-print_002dplatform" accesskey="n" rel="next">tlmgr print-platform</a>, Previous: <a href="#tlmgr-platform" accesskey="p" rel="prev">tlmgr platform</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="postaction-_005b_002d_002dw32mode_003duser_007cadmin_005d-_005b_002d_002dfileassocmode_003d1_007c2_005d-_005b_002d_002dall_005d-_005binstall_007cremove_005d-_005bshortcut_007cfileassoc_007cscript_005d-_005bpkg_005d_002e_002e_002e"></a>
-<h4 class="appendixsubsec">B.6.20 postaction [&ndash;w32mode=user|admin] [&ndash;fileassocmode=1|2] [&ndash;all] [install|remove] [shortcut|fileassoc|script] [<em>pkg</em>]...</h4>
+<a name="postaction"></a>
+<h4 class="appendixsubsec">B.6.20 postaction</h4>
+<dl compact="compact">
+<dt><strong>postaction [<em>option</em>...] install [shortcut|fileassoc|script] [<em>pkg</em>...]</strong></dt>
+<dd><a name="tlmgr-postaction-_005boption_002e_002e_002e_005d-install-_005bshortcut_007cfileassoc_007cscript_005d-_005bpkg_002e_002e_002e_005d"></a>
+</dd>
+<dt><strong>postaction [<em>option</em>...] remove [shortcut|fileassoc|script] [<em>pkg</em>...]</strong></dt>
+<dd><a name="tlmgr-postaction-_005boption_002e_002e_002e_005d-remove-_005bshortcut_007cfileassoc_007cscript_005d-_005bpkg_002e_002e_002e_005d"></a>
<p>Carry out the postaction <code>shortcut</code>, <code>fileassoc</code>, or <code>script</code> given
as the second required argument in install or remove mode (which is the
first required argument), for either the packages given on the command
line, or for all if <code>--all</code> is given.
</p>
+<p>Options:
+</p>
+<dl compact="compact">
+<dt><strong>&ndash;w32mode=[user|admin]</strong></dt>
+<dd><a name="tlmgr-_002d_002dw32mode_003d_005buser_007cadmin_005d"></a>
<p>If the option <code>--w32mode</code> is given the value <code>user</code>, all actions will
only be carried out in the user-accessible parts of the
registry/filesystem, while the value <code>admin</code> selects the system-wide
parts of the registry for the file associations. If you do not have
enough permissions, using <code>--w32mode=admin</code> will not succeed.
</p>
+</dd>
+<dt><strong>&ndash;fileassocmode=[1|2]</strong></dt>
+<dd><a name="tlmgr-_002d_002dfileassocmode_003d_005b1_007c2_005d"></a>
<p><code>--fileassocmode</code> specifies the action for file associations. If it is
set to 1 (the default), only new associations are added; if it is set to
2, all associations are set to the TeX Live programs. (See also
<code>option fileassocs</code>.)
</p>
+</dd>
+<dt><strong>&ndash;all</strong></dt>
+<dd><a name="tlmgr-_002d_002dall-1"></a>
+<p>Carry out the postactions for all packages
+</p>
+</dd>
+</dl>
+
+</dd>
+</dl>
+
<hr>
<a name="tlmgr-print_002dplatform"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-restore-_005b_002d_002dbackupdir-dir_005d-_005b_002d_002dall-_007c-pkg-_005brev_005d_005d" accesskey="n" rel="next">tlmgr restore [--backupdir <em>dir</em>] [--all | <em>pkg</em> [<em>rev</em>]]</a>, Previous: <a href="#tlmgr-postaction-_005b_002d_002dw32mode_003duser_007cadmin_005d-_005b_002d_002dfileassocmode_003d1_007c2_005d-_005b_002d_002dall_005d-_005binstall_007cremove_005d-_005bshortcut_007cfileassoc_007cscript_005d-_005bpkg_005d_002e_002e_002e" accesskey="p" rel="prev">tlmgr postaction [--w32mode=user|admin] [--fileassocmode=1|2] [--all] [install|remove] [shortcut|fileassoc|script] [<em>pkg</em>]...</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-print_002dplatform_002dinfo" accesskey="n" rel="next">tlmgr print-platform-info</a>, Previous: <a href="#tlmgr-postaction" accesskey="p" rel="prev">tlmgr postaction</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="print_002dplatform"></a>
<h4 class="appendixsubsec">B.6.21 print-platform</h4>
@@ -4958,68 +5331,25 @@ Next: <a href="#tlmgr-restore-_005b_002d_002dbackupdir-dir_005d-_005b_002d_002da
<code>--print-arch</code> is a synonym.
</p>
<hr>
-<a name="tlmgr-restore-_005b_002d_002dbackupdir-dir_005d-_005b_002d_002dall-_007c-pkg-_005brev_005d_005d"></a>
+<a name="tlmgr-print_002dplatform_002dinfo"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-remove-_005boption_005d_002e_002e_002e-pkg_002e_002e_002e" accesskey="n" rel="next">tlmgr remove [<em>option</em>]... <em>pkg</em>...</a>, Previous: <a href="#tlmgr-print_002dplatform" accesskey="p" rel="prev">tlmgr print-platform</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" accesskey="n" rel="next">tlmgr remove [<em>option</em>...] <em>pkg</em>...</a>, Previous: <a href="#tlmgr-print_002dplatform" accesskey="p" rel="prev">tlmgr print-platform</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="restore-_005b_002d_002dbackupdir-dir_005d-_005b_002d_002dall-_007c-pkg-_005brev_005d_005d"></a>
-<h4 class="appendixsubsec">B.6.22 restore [&ndash;backupdir <em>dir</em>] [&ndash;all | <em>pkg</em> [<em>rev</em>]]</h4>
+<a name="print_002dplatform_002dinfo"></a>
+<h4 class="appendixsubsec">B.6.22 print-platform-info</h4>
-<p>Restore a package from a previously-made backup.
-</p>
-<p>If <code>--all</code> is given, try to restore the latest revision of all
-package backups found in the backup directory.
+<p>Print the TeX Live platform identifier, TL platform long name, and
+original output from guess.
</p>
-<p>Otherwise, if neither <em>pkg</em> nor <em>rev</em> are given, list the available backup
-revisions for all packages.
-</p>
-<p>With <em>pkg</em> given but no <em>rev</em>, list all available backup revisions of
-<em>pkg</em>.
-</p>
-<p>When listing available packages tlmgr shows the revision and in
-parenthesis the creation time if available (in format yyyy-mm-dd hh:mm).
-</p>
-<p>With both <em>pkg</em> and <em>rev</em>, tries to restore the package from the
-specified backup.
-</p>
-<p>Options:
-</p>
-<dl compact="compact">
-<dt><strong>&ndash;all</strong></dt>
-<dd><a name="tlmgr-_002d_002dall-1"></a>
-<p>Try to restore the latest revision of all package backups found in the
-backup directory. Additional non-option arguments (like <em>pkg</em>) are not
-allowed.
-</p>
-</dd>
-<dt><strong>&ndash;backupdir</strong> <em>directory</em></dt>
-<dd><a name="tlmgr-_002d_002dbackupdir-directory-1"></a>
-<p>Specify the directory where the backups are to be found. If not given it
-will be taken from the configuration setting in the TLPDB.
-</p>
-</dd>
-<dt><strong>&ndash;dry-run</strong></dt>
-<dd><a name="tlmgr-_002d_002ddry_002drun-3"></a>
-<p>Nothing is actually restored; instead, the actions to be performed are
-written to the terminal.
-</p>
-</dd>
-<dt><strong>&ndash;force</strong></dt>
-<dd><a name="tlmgr-_002d_002dforce-1"></a>
-<p>Don&rsquo;t ask questions.
-</p>
-</dd>
-</dl>
-
<hr>
-<a name="tlmgr-remove-_005boption_005d_002e_002e_002e-pkg_002e_002e_002e"></a>
+<a name="tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-repository" accesskey="n" rel="next">tlmgr repository</a>, Previous: <a href="#tlmgr-restore-_005b_002d_002dbackupdir-dir_005d-_005b_002d_002dall-_007c-pkg-_005brev_005d_005d" accesskey="p" rel="prev">tlmgr restore [--backupdir <em>dir</em>] [--all | <em>pkg</em> [<em>rev</em>]]</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-repository" accesskey="n" rel="next">tlmgr repository</a>, Previous: <a href="#tlmgr-print_002dplatform_002dinfo" accesskey="p" rel="prev">tlmgr print-platform-info</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="remove-_005boption_005d_002e_002e_002e-pkg_002e_002e_002e"></a>
-<h4 class="appendixsubsec">B.6.23 remove [<em>option</em>]... <em>pkg</em>...</h4>
+<a name="remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e"></a>
+<h4 class="appendixsubsec">B.6.23 remove [<em>option</em>...] <em>pkg</em>...</h4>
<p>Remove each <em>pkg</em> specified. Removing a collection removes all package
dependencies (unless <code>--no-depends</code> is specified), but not any
@@ -5027,6 +5357,24 @@ collection dependencies of that collection. However, when removing a
package, dependencies are never removed. Options:
</p>
<dl compact="compact">
+<dt><strong>&ndash;all</strong></dt>
+<dd><a name="tlmgr-_002d_002dall-2"></a>
+<p>Uninstalls all of TeX Live, asking for confirmation unless <code>--force</code> is
+also specified.
+</p>
+</dd>
+<dt><strong>&ndash;backup</strong></dt>
+<dd><a name="tlmgr-_002d_002dbackup"></a>
+</dd>
+<dt><strong>&ndash;backupdir</strong> <em>directory</em></dt>
+<dd><a name="tlmgr-_002d_002dbackupdir-directory-1"></a>
+<p>These options behave just as with the <a href="update.html#tlmgr-update-_005boption_002e_002e_002e_005d-_005b_002e_002e_002e_005d">(update)update</a> action (q.v.), except they apply to making
+backups of packages before they are removed. The default is to make
+such a backup, that is, to save a copy of packages before removal.
+</p>
+<p>The <a href="#tlmgr-restore">restore</a> action explains how to restore from a backup.
+</p>
+</dd>
<dt><strong>&ndash;no-depends</strong></dt>
<dd><a name="tlmgr-_002d_002dno_002ddepends-1"></a>
<p>Do not remove dependent packages.
@@ -5034,23 +5382,23 @@ package, dependencies are never removed. Options:
</dd>
<dt><strong>&ndash;no-depends-at-all</strong></dt>
<dd><a name="tlmgr-_002d_002dno_002ddepends_002dat_002dall-1"></a>
-<p>See above under <strong>install</strong> (and beware).
+<p>See above under <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">install</a> (and beware).
</p>
</dd>
<dt><strong>&ndash;force</strong></dt>
-<dd><a name="tlmgr-_002d_002dforce-2"></a>
+<dd><a name="tlmgr-_002d_002dforce-1"></a>
<p>By default, removal of a package or collection that is a dependency of
another collection or scheme is not allowed. With this option, the
package will be removed unconditionally. Use with care.
</p>
<p>A package that has been removed using the <code>--force</code> option because it
is still listed in an installed collection or scheme will not be
-updated, and will be mentioned as <strong>forcibly removed</strong> in the output of
-<strong>tlmgr update &ndash;list</strong>.
+updated, and will be mentioned as <code>forcibly removed</code> in the output of
+<code>tlmgr update --list</code>.
</p>
</dd>
<dt><strong>&ndash;dry-run</strong></dt>
-<dd><a name="tlmgr-_002d_002ddry_002drun-4"></a>
+<dd><a name="tlmgr-_002d_002ddry_002drun-3"></a>
<p>Nothing is actually removed; instead, the actions to be performed are
written to the terminal.
</p>
@@ -5061,7 +5409,7 @@ written to the terminal.
<a name="tlmgr-repository"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-what" accesskey="n" rel="next">tlmgr search [<em>option</em>...] <em>what</em></a>, Previous: <a href="#tlmgr-remove-_005boption_005d_002e_002e_002e-pkg_002e_002e_002e" accesskey="p" rel="prev">tlmgr remove [<em>option</em>]... <em>pkg</em>...</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-restore" accesskey="n" rel="next">tlmgr restore</a>, Previous: <a href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e" accesskey="p" rel="prev">tlmgr remove [<em>option</em>...] <em>pkg</em>...</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="repository"></a>
<h4 class="appendixsubsec">B.6.24 repository</h4>
@@ -5081,8 +5429,7 @@ Next: <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-what" accesskey="n"
</dd>
<dt><strong>repository set <em>path</em>[#<em>tag</em>] [<em>path</em>[#<em>tag</em>] ...]</strong></dt>
<dd><a name="tlmgr-repository-set-path_005b_0023tag_005d-_005bpath_005b_0023tag_005d-_002e_002e_002e_005d"></a>
-<p>This action manages the list of repositories. See <a href="#tlmgr-MULTIPLE-REPOSITORIES">MULTIPLE
-REPOSITORIES</a> below for detailed explanations.
+<p>This action manages the list of repositories. See <a href="MULTIPLE_REPOSITORIES.html#Top">(MULTIPLE_REPOSITORIES)</a> below for detailed explanations.
</p>
<p>The first form (<code>list</code>) lists all configured repositories and the
respective tags if set. If a path, url, or tag is given after the
@@ -5105,90 +5452,110 @@ otherwise, all operations will fail!
</dl>
<hr>
-<a name="tlmgr-search-_005boption_002e_002e_002e_005d-what"></a>
-<div class="header">
-<p>
-Next: <a href="#tlmgr-uninstall" accesskey="n" rel="next">tlmgr uninstall</a>, Previous: <a href="#tlmgr-repository" accesskey="p" rel="prev">tlmgr repository</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<a name="search-_005boption_002e_002e_002e_005d-what"></a>
-<h4 class="appendixsubsec">B.6.25 search [<em>option</em>...] <em>what</em></h4>
-
-<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dfile-what" accesskey="1">tlmgr search [<em>option</em>...] --file <em>what</em></a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dtaxonomy-what" accesskey="2">tlmgr search [<em>option</em>...] --taxonomy <em>what</em></a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dkeyword-what" accesskey="3">tlmgr search [<em>option</em>...] --keyword <em>what</em></a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dfunctionality-what" accesskey="4">tlmgr search [<em>option</em>...] --functionality <em>what</em></a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dcharacterization-what" accesskey="5">tlmgr search [<em>option</em>...] --characterization <em>what</em></a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dall-what" accesskey="6">tlmgr search [<em>option</em>...] --all <em>what</em></a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
-</td></tr>
-</table>
-
-<hr>
-<a name="tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dfile-what"></a>
-<div class="header">
-<p>
-Next: <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dtaxonomy-what" accesskey="n" rel="next">tlmgr search [<em>option</em>...] --taxonomy <em>what</em></a>, Up: <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-what" accesskey="u" rel="up">tlmgr search [<em>option</em>...] <em>what</em></a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<a name="search-_005boption_002e_002e_002e_005d-_002d_002dfile-what"></a>
-<h4 class="appendixsubsubsec">B.6.25.1 search [<em>option</em>...] &ndash;file <em>what</em></h4>
-
-<hr>
-<a name="tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dtaxonomy-what"></a>
-<div class="header">
-<p>
-Next: <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dkeyword-what" accesskey="n" rel="next">tlmgr search [<em>option</em>...] --keyword <em>what</em></a>, Previous: <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dfile-what" accesskey="p" rel="prev">tlmgr search [<em>option</em>...] --file <em>what</em></a>, Up: <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-what" accesskey="u" rel="up">tlmgr search [<em>option</em>...] <em>what</em></a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<a name="search-_005boption_002e_002e_002e_005d-_002d_002dtaxonomy-what"></a>
-<h4 class="appendixsubsubsec">B.6.25.2 search [<em>option</em>...] &ndash;taxonomy <em>what</em></h4>
-
-<hr>
-<a name="tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dkeyword-what"></a>
+<a name="tlmgr-restore"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dfunctionality-what" accesskey="n" rel="next">tlmgr search [<em>option</em>...] --functionality <em>what</em></a>, Previous: <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dtaxonomy-what" accesskey="p" rel="prev">tlmgr search [<em>option</em>...] --taxonomy <em>what</em></a>, Up: <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-what" accesskey="u" rel="up">tlmgr search [<em>option</em>...] <em>what</em></a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-search" accesskey="n" rel="next">tlmgr search</a>, Previous: <a href="#tlmgr-repository" accesskey="p" rel="prev">tlmgr repository</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="search-_005boption_002e_002e_002e_005d-_002d_002dkeyword-what"></a>
-<h4 class="appendixsubsubsec">B.6.25.3 search [<em>option</em>...] &ndash;keyword <em>what</em></h4>
+<a name="restore"></a>
+<h4 class="appendixsubsec">B.6.25 restore</h4>
-<hr>
-<a name="tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dfunctionality-what"></a>
-<div class="header">
-<p>
-Next: <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dcharacterization-what" accesskey="n" rel="next">tlmgr search [<em>option</em>...] --characterization <em>what</em></a>, Previous: <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dkeyword-what" accesskey="p" rel="prev">tlmgr search [<em>option</em>...] --keyword <em>what</em></a>, Up: <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-what" accesskey="u" rel="up">tlmgr search [<em>option</em>...] <em>what</em></a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<a name="search-_005boption_002e_002e_002e_005d-_002d_002dfunctionality-what"></a>
-<h4 class="appendixsubsubsec">B.6.25.4 search [<em>option</em>...] &ndash;functionality <em>what</em></h4>
+<dl compact="compact">
+<dt><strong>restore [<em>option</em>...] <em>pkg</em> [<em>rev</em>]</strong></dt>
+<dd><a name="tlmgr-restore-_005boption_002e_002e_002e_005d-pkg-_005brev_005d"></a>
+</dd>
+<dt><strong>restore [<em>option</em>...] &ndash;all</strong></dt>
+<dd><a name="tlmgr-restore-_005boption_002e_002e_002e_005d-_002d_002dall"></a>
+<p>Restore a package from a previously-made backup.
+</p>
+<p>If <code>--all</code> is given, try to restore the latest revision of all
+package backups found in the backup directory.
+</p>
+<p>Otherwise, if neither <em>pkg</em> nor <em>rev</em> are given, list the available
+backup revisions for all packages. With <em>pkg</em> given but no <em>rev</em>,
+list all available backup revisions of <em>pkg</em>.
+</p>
+<p>When listing available packages, <code>tlmgr</code> shows the revision, and in
+parenthesis the creation time if available (in format yyyy-mm-dd hh:mm).
+</p>
+<p>If (and only if) both <em>pkg</em> and a valid revision number <em>rev</em> are
+specified, try to restore the package from the specified backup.
+</p>
+<p>Options:
+</p>
+<dl compact="compact">
+<dt><strong>&ndash;all</strong></dt>
+<dd><a name="tlmgr-_002d_002dall-3"></a>
+<p>Try to restore the latest revision of all package backups found in the
+backup directory. Additional non-option arguments (like <em>pkg</em>) are not
+allowed.
+</p>
+</dd>
+<dt><strong>&ndash;backupdir</strong> <em>directory</em></dt>
+<dd><a name="tlmgr-_002d_002dbackupdir-directory-2"></a>
+<p>Specify the directory where the backups are to be found. If not given it
+will be taken from the configuration setting in the TLPDB.
+</p>
+</dd>
+<dt><strong>&ndash;dry-run</strong></dt>
+<dd><a name="tlmgr-_002d_002ddry_002drun-4"></a>
+<p>Nothing is actually restored; instead, the actions to be performed are
+written to the terminal.
+</p>
+</dd>
+<dt><strong>&ndash;force</strong></dt>
+<dd><a name="tlmgr-_002d_002dforce-2"></a>
+<p>Don&rsquo;t ask questions.
+</p>
+</dd>
+<dt><strong>&ndash;json</strong></dt>
+<dd><a name="tlmgr-_002d_002djson-2"></a>
+<p>When listing backups, the option <code>--json</code> turn on JSON output.
+The format is an array of JSON objects (<code>name</code>, <code>rev</code>, <code>date</code>).
+For details see <code>tlpkg/doc/JSON-formats.txt</code>, format definition: <code>TLBACKUPS</code>.
+If both <code>--json</code> and <code>--data</code> are given, <code>--json</code> takes precedence.
+</p>
+</dd>
+</dl>
-<hr>
-<a name="tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dcharacterization-what"></a>
-<div class="header">
-<p>
-Next: <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dall-what" accesskey="n" rel="next">tlmgr search [<em>option</em>...] --all <em>what</em></a>, Previous: <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dfunctionality-what" accesskey="p" rel="prev">tlmgr search [<em>option</em>...] --functionality <em>what</em></a>, Up: <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-what" accesskey="u" rel="up">tlmgr search [<em>option</em>...] <em>what</em></a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<a name="search-_005boption_002e_002e_002e_005d-_002d_002dcharacterization-what"></a>
-<h4 class="appendixsubsubsec">B.6.25.5 search [<em>option</em>...] &ndash;characterization <em>what</em></h4>
+</dd>
+</dl>
<hr>
-<a name="tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dall-what"></a>
+<a name="tlmgr-search"></a>
<div class="header">
<p>
-Previous: <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dcharacterization-what" accesskey="p" rel="prev">tlmgr search [<em>option</em>...] --characterization <em>what</em></a>, Up: <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-what" accesskey="u" rel="up">tlmgr search [<em>option</em>...] <em>what</em></a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-shell" accesskey="n" rel="next">tlmgr shell</a>, Previous: <a href="#tlmgr-restore" accesskey="p" rel="prev">tlmgr restore</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="search-_005boption_002e_002e_002e_005d-_002d_002dall-what"></a>
-<h4 class="appendixsubsubsec">B.6.25.6 search [<em>option</em>...] &ndash;all <em>what</em></h4>
+<a name="search"></a>
+<h4 class="appendixsubsec">B.6.26 search</h4>
+<dl compact="compact">
+<dt><strong>search [<em>option</em>...] <em>what</em></strong></dt>
+<dd><a name="tlmgr-search-_005boption_002e_002e_002e_005d-what"></a>
+</dd>
+<dt><strong>search [<em>option</em>...] &ndash;file <em>what</em></strong></dt>
+<dd><a name="tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dfile-what"></a>
+</dd>
+<dt><strong>search [<em>option</em>...] &ndash;all <em>what</em></strong></dt>
+<dd><a name="tlmgr-search-_005boption_002e_002e_002e_005d-_002d_002dall-what"></a>
<p>By default, search the names, short descriptions, and long descriptions
of all locally installed packages for the argument <em>what</em>, interpreted
-as a regular expression.
+as a (Perl) regular expression.
</p>
<p>Options:
</p>
<dl compact="compact">
+<dt><strong>&ndash;file</strong></dt>
+<dd><a name="tlmgr-_002d_002dfile-1"></a>
+<p>List all filenames containing <em>what</em>.
+</p>
+</dd>
+<dt><strong>&ndash;all</strong></dt>
+<dd><a name="tlmgr-_002d_002dall-4"></a>
+<p>Search everything: package names, descriptions and filenames.
+</p>
+</dd>
<dt><strong>&ndash;global</strong></dt>
<dd><a name="tlmgr-_002d_002dglobal"></a>
<p>Search the TeX Live Database of the installation medium, instead of the
@@ -5197,78 +5564,122 @@ local installation.
</dd>
<dt><strong>&ndash;word</strong></dt>
<dd><a name="tlmgr-_002d_002dword"></a>
-<p>Restrict the search to match only full words. For example, searching for
-<code>table</code> with this option will not output packages containing the
-word <code>tables</code> (unless they also contain the word <code>table</code> on its own).
+<p>Restrict the search of package names and descriptions (but not
+filenames) to match only full words. For example, searching for
+<code>table</code> with this option will not output packages containing the word
+<code>tables</code> (unless they also contain the word <code>table</code> on its own).
</p>
</dd>
-<dt><strong>&ndash;list</strong></dt>
-<dd><a name="tlmgr-_002d_002dlist-1"></a>
-<p>If a search for any (or all) taxonomies is done, by specifying one of
-the taxonomy options below, then instead of searching for packages, list
-the entire corresponding taxonomy (or all of them). See
-<a href="#tlmgr-TAXONOMIES">TAXONOMIES</a> below.
-</p>
+</dl>
+
</dd>
</dl>
-<p>Other search options are selected by specifying one of the following:
+<hr>
+<a name="tlmgr-shell"></a>
+<div class="header">
+<p>
+Next: <a href="#tlmgr-show" accesskey="n" rel="next">tlmgr show</a>, Previous: <a href="#tlmgr-search" accesskey="p" rel="prev">tlmgr search</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="shell"></a>
+<h4 class="appendixsubsec">B.6.27 shell</h4>
+
+<p>Starts an interactive mode, where tlmgr prompts for commands. This can
+be used directly, or for scripting. The first line of output is
+<code>protocol</code> <em>n</em>, where <em>n</em> is an unsigned number identifying the
+protocol version (currently 1).
+</p>
+<p>In general, tlmgr actions that can be given on the command line
+translate to commands in this shell mode. For example, you can say
+<code>update --list</code> to see what would be updated. The TLPDB is loaded the
+first time it is needed (not at the beginning), and used for the rest of
+the session.
+</p>
+<p>Besides these actions, a few commands are specific to shell mode:
</p>
<dl compact="compact">
-<dt><strong>&ndash;file</strong></dt>
-<dd><a name="tlmgr-_002d_002dfile-1"></a>
-<p>List all filenames containing <em>what</em>.
+<dt>protocol</dt>
+<dd><a name="tlmgr-protocol"></a>
+<p>Print <code>protocol <em>n</em></code>, the current protocol version.
</p>
</dd>
-<dt><strong>&ndash;taxonomy</strong></dt>
-<dd><a name="tlmgr-_002d_002dtaxonomy-1"></a>
+<dt>help</dt>
+<dd><a name="tlmgr-help-1"></a>
+<p>Print pointers to this documentation.
+</p>
</dd>
-<dt><strong>&ndash;keyword</strong></dt>
-<dd><a name="tlmgr-_002d_002dkeyword-1"></a>
+<dt>version</dt>
+<dd><a name="tlmgr-version-1"></a>
+<p>Print tlmgr version information.
+</p>
</dd>
-<dt><strong>&ndash;functionality</strong></dt>
-<dd><a name="tlmgr-_002d_002dfunctionality-1"></a>
+<dt>quit, end, bye, byebye, EOF</dt>
+<dd><a name="tlmgr-quit_002c-end_002c-bye_002c-byebye_002c-EOF"></a>
+<p>Exit.
+</p>
</dd>
-<dt><strong>&ndash;characterization</strong></dt>
-<dd><a name="tlmgr-_002d_002dcharacterization-1"></a>
-<p>Search in the corresponding taxonomy (or all) instead of the package
-descriptions. See <a href="#tlmgr-TAXONOMIES">TAXONOMIES</a> below.
+<dt>restart</dt>
+<dd><a name="tlmgr-restart"></a>
+<p>Restart <code>tlmgr shell</code> with the original command line; most useful when
+developing <code>tlmgr</code>.
</p>
</dd>
-<dt><strong>&ndash;all</strong></dt>
-<dd><a name="tlmgr-_002d_002dall-2"></a>
-<p>Search for package names, descriptions, and taxonomies, but not files.
+<dt>load [local|remote]</dt>
+<dd><a name="tlmgr-load-_005blocal_007cremote_005d"></a>
+<p>Explicitly load the local or remote, respectively, TLPDB.
+</p>
+</dd>
+<dt>save</dt>
+<dd><a name="tlmgr-save"></a>
+<p>Save the local TLPDB, presumably after other operations have changed it.
+</p>
+</dd>
+<dt>get [<em>var</em>] =item set [<em>var</em> [<em>val</em>]]</dt>
+<dd><a name="tlmgr-get-_005bvar_005d-_003ditem-set-_005bvar-_005bval_005d_005d"></a>
+<p>Get the value of <em>var</em>, or set it to <em>val</em>. Possible <em>var</em> names:
+<code>debug-translation</code>, <code>machine-readable</code>, <code>no-execute-actions</code>,
+<code>require-verification</code>, <code>verify-downloads</code>, <code>repository</code>, and
+<code>prompt</code>. All except <code>repository</code> and <code>prompt</code> are booleans, taking
+values 0 and 1, and behave like the corresponding command line option.
+The <code>repository</code> variable takes a string, and sets the remote
+repository location. The <code>prompt</code> variable takes a string, and sets the
+current default prompt.
+</p>
+<p>If <em>var</em> or then <em>val</em> is not specified, it is prompted for.
</p>
</dd>
</dl>
<hr>
+<a name="tlmgr-show"></a>
+<div class="header">
+<p>
+Next: <a href="#tlmgr-uninstall" accesskey="n" rel="next">tlmgr uninstall</a>, Previous: <a href="#tlmgr-shell" accesskey="p" rel="prev">tlmgr shell</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="show"></a>
+<h4 class="appendixsubsec">B.6.28 show</h4>
+
+<p>Synonym for <a href="#tlmgr-info">info</a>.
+</p>
+<hr>
<a name="tlmgr-uninstall"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-update-_005boption_005d_002e_002e_002e-_005bpkg_005d_002e_002e_002e" accesskey="n" rel="next">tlmgr update [<em>option</em>]... [<em>pkg</em>]...</a>, Previous: <a href="#tlmgr-search-_005boption_002e_002e_002e_005d-what" accesskey="p" rel="prev">tlmgr search [<em>option</em>...] <em>what</em></a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d" accesskey="n" rel="next">tlmgr update [<em>option</em>...] [<em>pkg</em>...]</a>, Previous: <a href="#tlmgr-show" accesskey="p" rel="prev">tlmgr show</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="uninstall"></a>
-<h4 class="appendixsubsec">B.6.26 uninstall</h4>
+<h4 class="appendixsubsec">B.6.29 uninstall</h4>
-<p>Uninstalls the entire TeX Live installation. Options:
+<p>Synonym for <a href="#tlmgr-remove-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">remove</a>.
</p>
-<dl compact="compact">
-<dt><strong>&ndash;force</strong></dt>
-<dd><a name="tlmgr-_002d_002dforce-3"></a>
-<p>Do not ask for confirmation, remove immediately.
-</p>
-</dd>
-</dl>
-
<hr>
-<a name="tlmgr-update-_005boption_005d_002e_002e_002e-_005bpkg_005d_002e_002e_002e"></a>
+<a name="tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d"></a>
<div class="header">
<p>
Previous: <a href="#tlmgr-uninstall" accesskey="p" rel="prev">tlmgr uninstall</a>, Up: <a href="#tlmgr-ACTIONS" accesskey="u" rel="up">tlmgr ACTIONS</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="update-_005boption_005d_002e_002e_002e-_005bpkg_005d_002e_002e_002e"></a>
-<h4 class="appendixsubsec">B.6.27 update [<em>option</em>]... [<em>pkg</em>]...</h4>
+<a name="update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d"></a>
+<h4 class="appendixsubsec">B.6.30 update [<em>option</em>...] [<em>pkg</em>...]</h4>
<p>Updates the packages given as arguments to the latest version available
at the installation source. Either <code>--all</code> or at least one <em>pkg</em> name
@@ -5276,7 +5687,7 @@ must be specified. Options:
</p>
<dl compact="compact">
<dt><strong>&ndash;all</strong></dt>
-<dd><a name="tlmgr-_002d_002dall-3"></a>
+<dd><a name="tlmgr-_002d_002dall-5"></a>
<p>Update all installed packages except for <code>tlmgr</code> itself. Thus, if
updates to <code>tlmgr</code> itself are present, this will simply give an error,
unless also the option <code>--force</code> or <code>--self</code> is given. (See below.)
@@ -5366,9 +5777,12 @@ for auto-installation, auto-removal, or reinstallation of a forcibly
removed package, <code>tlmgr</code> quits with an error message. Excludes are not
supported in these circumstances.
</p>
+<p>This option can also be set permanently in the tlmgr config file with
+the key <code>update-exclude</code>.
+</p>
</dd>
-<dt><strong>&ndash;no-auto-remove</strong> [<em>pkg</em>]...</dt>
-<dd><a name="tlmgr-_002d_002dno_002dauto_002dremove-_005bpkg_005d_002e_002e_002e"></a>
+<dt><strong>&ndash;no-auto-remove</strong> [<em>pkg</em>...]</dt>
+<dd><a name="tlmgr-_002d_002dno_002dauto_002dremove-_005bpkg_002e_002e_002e_005d"></a>
<p>By default, <code>tlmgr</code> tries to remove packages which have disappeared on
the server, as described above under <code>--all</code>. This option prevents
such removals, either for all packages (with <code>--all</code>), or for just the
@@ -5377,8 +5791,8 @@ since packages are not infrequently renamed or replaced by their
authors. Therefore this is not recommend.
</p>
</dd>
-<dt><strong>&ndash;no-auto-install</strong> [<em>pkg</em>]...</dt>
-<dd><a name="tlmgr-_002d_002dno_002dauto_002dinstall-_005bpkg_005d_002e_002e_002e"></a>
+<dt><strong>&ndash;no-auto-install</strong> [<em>pkg</em>...]</dt>
+<dd><a name="tlmgr-_002d_002dno_002dauto_002dinstall-_005bpkg_002e_002e_002e_005d"></a>
<p>Under normal circumstances <code>tlmgr</code> will install packages which are new
on the server, as described above under <code>--all</code>. This option prevents
any such automatic installation, either for all packages (with
@@ -5411,28 +5825,30 @@ installation with the server&rsquo;s idea of what is available:
<pre class="verbatim"> tlmgr update --reinstall-forcibly-removed --all
</pre>
</dd>
-<dt><strong>&ndash;backup</strong> and <strong>&ndash;backupdir</strong> <em>directory</em></dt>
-<dd><a name="tlmgr-_002d_002dbackup-and-_002d_002dbackupdir-directory"></a>
+<dt><strong>&ndash;backup</strong></dt>
+<dd><a name="tlmgr-_002d_002dbackup-1"></a>
+</dd>
+<dt><strong>&ndash;backupdir</strong> <em>directory</em></dt>
+<dd><a name="tlmgr-_002d_002dbackupdir-directory-3"></a>
<p>These two options control the creation of backups of packages <em>before</em>
updating; that is, backup of packages as currently installed. If
-neither of these options are given, no backup package will be saved. If
-<code>--backupdir</code> is given and specifies a writable directory then a backup
-will be made in that location. If only <code>--backup</code> is given, then a
-backup will be made to the directory previously set via the <code>option</code>
-action (see below). If both are given then a backup will be made to the
-specified <em>directory</em>.
+neither options is given, no backup will made. If <code>--backupdir</code> is
+given and specifies a writable directory then a backup will be made in
+that location. If only <code>--backup</code> is given, then a backup will be made
+to the directory previously set via the <a href="#tlmgr-option">option</a> action (see
+below). If both are given then a backup will be made to the specified
+<em>directory</em>.
</p>
-<p>You can set options via the <code>option</code> action to automatically create
-backups for all packages, and/or keep only a certain number of
-backups. Please see the <code>option</code> action for details.
+<p>You can also set options via the <a href="#tlmgr-option">option</a> action to automatically make
+backups for all packages, and/or keep only a certain number of backups.
</p>
<p><code>tlmgr</code> always makes a temporary backup when updating packages, in case
of download or other failure during an update. In contrast, the purpose
-of this <code>--backup</code> option is to allow you to save a persistent backup
-in case the actual <em>content</em> of the update causes problems, e.g.,
-introduces an incompatibility.
+of this <code>--backup</code> option is to save a persistent backup in case the
+actual <em>content</em> of the update causes problems, e.g., introduces an TeX
+incompatibility.
</p>
-<p>The <code>restore</code> action explains how to restore from a backup.
+<p>The <a href="#tlmgr-restore">restore</a> action explains how to restore from a backup.
</p>
</dd>
<dt><strong>&ndash;no-depends</strong></dt>
@@ -5444,11 +5860,11 @@ suppresses this behavior.
</dd>
<dt><strong>&ndash;no-depends-at-all</strong></dt>
<dd><a name="tlmgr-_002d_002dno_002ddepends_002dat_002dall-2"></a>
-<p>See above under <strong>install</strong> (and beware).
+<p>See above under <a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">install</a> (and beware).
</p>
</dd>
<dt><strong>&ndash;force</strong></dt>
-<dd><a name="tlmgr-_002d_002dforce-4"></a>
+<dd><a name="tlmgr-_002d_002dforce-3"></a>
<p>Force update of normal packages, without updating <code>tlmgr</code> itself
(unless the <code>--self</code> option is also given). Not recommended.
</p>
@@ -5461,14 +5877,172 @@ suppresses this behavior.
(e.g., if the selected mirror is out of date), <code>tlmgr</code> does not
downgrade. Also, packages for uninstalled platforms are not installed.
</p>
+<p><code>tlmgr</code> saves a copy of the <code>texlive.tlpdb</code> file used for an update
+with a suffix representing the repository url, as in
+<code>tlpkg/texlive.tlpdb.</code><em>long-hash-string</em>. These can be useful for
+fallback information, but if you don&rsquo;t like them accumulating (e.g.,
+<code>mirror.ctan.org</code> resolves to many different hosts, each resulting in
+a possibly different hash), it&rsquo;s harmless to delete them.
+</p>
+<hr>
+<a name="tlmgr-CONFIGURATION-FILE-FOR-TLMGR"></a>
+<div class="header">
+<p>
+Next: <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="n" rel="next">tlmgr CRYPTOGRAPHIC VERIFICATION</a>, Previous: <a href="#tlmgr-ACTIONS" accesskey="p" rel="prev">tlmgr ACTIONS</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="CONFIGURATION-FILE-FOR-TLMGR"></a>
+<h3 class="appendixsec">B.7 CONFIGURATION FILE FOR TLMGR</h3>
+
+<p>There are two configuration files for <code>tlmgr</code>: One is system-wide in
+<code>TEXMFSYSCONFIG/tlmgr/config</code>, and the other is user-specific in
+<code>TEXMFCONFIG/tlmgr/config</code>. The user-specific one is the default for
+the <code>conf tlmgr</code> action. (Run <code>kpsewhich
+-var-value=TEXMFSYSCONFIG</code> or <code>... TEXMFCONFIG ...</code> to see the actual
+directory names.)
+</p>
+<p>A few defaults corresponding to command-line options can be set in these
+configuration files. In addition, the system-wide file can contain a
+directive to restrict the allowed actions.
+</p>
+<p>In these config files, empty lines and lines starting with # are
+ignored. All other lines must look like:
+</p>
+<pre class="verbatim"> key = value
+</pre>
+<p>where the spaces are optional but the <code>=</code> is required.
+</p>
+<p>The allowed keys are:
+</p>
+<dl compact="compact">
+<dt><code>auto-remove</code>, value 0 or 1 (default 1), same as command-line option.</dt>
+<dd><a name="tlmgr-auto_002dremove_002c-value-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></a>
+</dd>
+<dt><code>gui-expertmode</code>, value 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings.</dt>
+<dd><a name="tlmgr-gui_002dexpertmode_002c-value-0-or-1-_0028default-1_0029_002e-This-switches-between-the-full-GUI-and-a-simplified-GUI-with-only-the-most-common-settings_002e"></a>
+</dd>
+<dt><code>gui-lang</code> <em>llcode</em>, with a language code value as with the command-line option.</dt>
+<dd><a name="tlmgr-gui_002dlang-llcode_002c-with-a-language-code-value-as-with-the-command_002dline-option_002e"></a>
+</dd>
+<dt><code>no-checksums</code>, value 0 or 1 (default 0, see below).</dt>
+<dd><a name="tlmgr-no_002dchecksums_002c-value-0-or-1-_0028default-0_002c-see-below_0029_002e"></a>
+</dd>
+<dt><code>persistent-downloads</code>, value 0 or 1 (default 1), same as command-line option.</dt>
+<dd><a name="tlmgr-persistent_002ddownloads_002c-value-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></a>
+</dd>
+<dt><code>require-verification</code>, value 0 or 1 (default 0), same as command-line option.</dt>
+<dd><a name="tlmgr-require_002dverification_002c-value-0-or-1-_0028default-0_0029_002c-same-as-command_002dline-option_002e"></a>
+</dd>
+<dt><code>update-exclude</code>, value: comma-separated list of packages (no space allowed). Same as the command line option <code>--exclude</code> for the action <code>update</code>.</dt>
+<dd><a name="tlmgr-update_002dexclude_002c-value_003a-comma_002dseparated-list-of-packages-_0028no-space-allowed_0029_002e-Same-as-the-command-line-option-_002d_002dexclude-for-the-action-update_002e"></a>
+</dd>
+<dt><code>verify-downloads</code>, value 0 or 1 (default 1), same as command-line option.</dt>
+<dd><a name="tlmgr-verify_002ddownloads_002c-value-0-or-1-_0028default-1_0029_002c-same-as-command_002dline-option_002e"></a>
+</dd>
+</dl>
+
+<p>The system-wide config file can contain one additional key:
+</p>
+<dl compact="compact">
+<dt><code>allowed-actions</code> <em>action1</em> [,<em>action</em>,...] The value is a comma-separated list of <code>tlmgr</code> actions which are allowed to be executed when <code>tlmgr</code> is invoked in system mode (that is, without <code>--usermode</code>).</dt>
+<dd><a name="tlmgr-allowed_002dactions-action1-_005b_002caction_002c_002e_002e_002e_005d-The-value-is-a-comma_002dseparated-list-of-tlmgr-actions-which-are-allowed-to-be-executed-when-tlmgr-is-invoked-in-system-mode-_0028that-is_002c-without-_002d_002dusermode_0029_002e"></a>
+<p>This allows distributors to include the <code>tlmgr</code> in their packaging, but
+allow only a restricted set of actions that do not interfere with their
+distro package manager. For native TeX Live installations, it doesn&rsquo;t
+make sense to set this.
+</p>
+</dd>
+</dl>
+
+<p>The <code>no-checksums</code> key needs more explanation. By default, package
+checksums computed and stored on the server (in the TLPDB) are compared
+to checksums computed locally after downloading. <code>no-checksums</code>
+disables this process.
+</p>
+<p>The checksum algorithm is SHA-512. Your system must have one of (looked
+for in this order) the Perl <code>Digest::SHA</code> module, the <code>openssl</code>
+program (<a href="http://openssl.org">http://openssl.org</a>), the <code>sha512sum</code> program (from GNU
+Coreutils, <a href="http://www.gnu.org/software/coreutils">http://www.gnu.org/software/coreutils</a>), or finally the
+<code>shasum</code> program (just to support old Macs). If none of these are
+available, a warning is issued and <code>tlmgr</code> proceeds without checking
+checksums. (Incidentally, other SHA implementations, such as the pure
+Perl and pure Lua modules, are much too slow to be usable in our
+context.) <code>no-checksums</code> avoids the warning.
+</p>
+<hr>
+<a name="tlmgr-CRYPTOGRAPHIC-VERIFICATION"></a>
+<div class="header">
+<p>
+Next: <a href="#tlmgr-USER-MODE" accesskey="n" rel="next">tlmgr USER MODE</a>, Previous: <a href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR" accesskey="p" rel="prev">tlmgr CONFIGURATION FILE FOR TLMGR</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="CRYPTOGRAPHIC-VERIFICATION"></a>
+<h3 class="appendixsec">B.8 CRYPTOGRAPHIC VERIFICATION</h3>
+
+<p><code>tlmgr</code> and <code>install-tl</code> perform cryptographic verification if
+possible. If verification is performed and successful, the programs
+report <code>(verified)</code> after loading the TLPDB; otherwise, they report
+<code>(not verified)</code>. But either way, by default the installation and/or
+updates proceed normally.
+</p>
+<p>If a program named <code>gpg</code> is available (that is, found in <code>PATH</code>), by
+default cryptographic signatures will be checked: we require the main
+repository be signed, but not any additional repositories. If <code>gpg</code> is
+not available, by default signatures are not checked and no verification
+is carried out, but <code>tlmgr</code> still proceeds normally.
+</p>
+<p>The behavior of the verification can be controlled by the command line
+and config file option <code>verify-repo</code> which takes one of the following
+values: <code>none</code>, <code>main</code>, or <code>all</code>. With <code>none</code>, no verification
+whatsoever is attempted. With <code>main</code> (the default) verification is
+required only for the main repository, and only if <code>gpg</code> is available;
+though attempted for all, missing signatures of subsidiary repositories
+will not result in an error. Finally, in the case of <code>all</code>, <code>gpg</code>
+must be available and all repositories need to be signed.
+</p>
+<p>In all cases, if a signature is checked and fails to verify, an error
+is raised.
+</p>
+<p>Cryptographic verification requires checksum checking (described just
+above) to succeed, and a working GnuPG (<code>gpg</code>) program (see below for
+search method). Then, unless cryptographic verification has been
+disabled, a signature file (<code>texlive.tlpdb.*.asc</code>) of the checksum file
+is downloaded and the signature verified. The signature is created by
+the TeX Live Distribution GPG key 0x06BAB6BC, which in turn is signed by
+Karl Berry&rsquo;s key 0x30D155AD and Norbert Preining&rsquo;s key 0x6CACA448. All
+of these keys are obtainable from the standard key servers.
+</p>
+<p>Additional trusted keys can be added using the <code>key</code> action.
+</p>
+<table class="menu" border="0" cellspacing="0">
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-Configuration-of-GnuPG-invocation" accesskey="1">tlmgr Configuration of GnuPG invocation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+</td></tr>
+</table>
+
+<hr>
+<a name="tlmgr-Configuration-of-GnuPG-invocation"></a>
+<div class="header">
+<p>
+Up: <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="u" rel="up">tlmgr CRYPTOGRAPHIC VERIFICATION</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="Configuration-of-GnuPG-invocation"></a>
+<h4 class="appendixsubsec">B.8.1 Configuration of GnuPG invocation</h4>
+
+<p>The executable used for GnuPG is searched as follows: If the environment
+variable <code>TL_GNUPG</code> is set, it is tested and used; otherwise <code>gpg</code> is
+checked; finally <code>gpg2</code> is checked.
+</p>
+<p>Further adaptation of the <code>gpg</code> invocation can be made using the two
+environment variables <code>TL_GNUPGHOME</code>, which is passed to <code>gpg</code> as the
+value for <code>--homedir</code>, and <code>TL_GNUPGARGS</code>, which replaces the default
+options <code>--no-secmem-warning --no-permission-warning</code>.
+</p>
<hr>
<a name="tlmgr-USER-MODE"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR" accesskey="n" rel="next">tlmgr CONFIGURATION FILE FOR TLMGR</a>, Previous: <a href="#tlmgr-ACTIONS" accesskey="p" rel="prev">tlmgr ACTIONS</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-MULTIPLE-REPOSITORIES" accesskey="n" rel="next">tlmgr MULTIPLE REPOSITORIES</a>, Previous: <a href="#tlmgr-CRYPTOGRAPHIC-VERIFICATION" accesskey="p" rel="prev">tlmgr CRYPTOGRAPHIC VERIFICATION</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="USER-MODE"></a>
-<h3 class="appendixsec">B.7 USER MODE</h3>
+<h3 class="appendixsec">B.9 USER MODE</h3>
<p><code>tlmgr</code> provides a restricted way, called &ldquo;user mode&rdquo;, to manage
arbitrary texmf trees in the same way as the main installation. For
@@ -5493,7 +6067,8 @@ currently not supported, but may be in a future release.
</p>
<p>Some <code>tlmgr</code> actions don&rsquo;t need any write permissions and thus work the
same in user mode and normal mode. Currently these are: <code>check</code>,
-<code>help</code>, <code>list</code>, <code>print-platform</code>, <code>search</code>, <code>show</code>, <code>version</code>.
+<code>help</code>, <code>list</code>, <code>print-platform</code>, <code>print-platform-info</code>, <code>search</code>,
+<code>show</code>, <code>version</code>.
</p>
<p>On the other hand, most of the actions dealing with package management
do need write permissions, and thus behave differently in user mode, as
@@ -5522,22 +6097,22 @@ installed into a user tree.
<p>Description of changes of actions in user mode:
</p>
<table class="menu" border="0" cellspacing="0">
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-user-mode-install" accesskey="1">tlmgr user mode install</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-User-mode-install" accesskey="1">tlmgr User mode install</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-user-mode-backup_003b-restore_003b-remove_003b-update" accesskey="2">tlmgr user mode backup; restore; remove; update</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update" accesskey="2">tlmgr User mode backup, restore, remove, update</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
-<tr><td align="left" valign="top">&bull; <a href="#tlmgr-user-mode-generate_003b-option_003b-paper" accesskey="3">tlmgr user mode generate; option; paper</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-User-mode-generate_002c-option_002c-paper" accesskey="3">tlmgr User mode generate, option, paper</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>
<hr>
-<a name="tlmgr-user-mode-install"></a>
+<a name="tlmgr-User-mode-install"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-user-mode-backup_003b-restore_003b-remove_003b-update" accesskey="n" rel="next">tlmgr user mode backup; restore; remove; update</a>, Up: <a href="#tlmgr-USER-MODE" accesskey="u" rel="up">tlmgr USER MODE</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update" accesskey="n" rel="next">tlmgr User mode backup, restore, remove, update</a>, Up: <a href="#tlmgr-USER-MODE" accesskey="u" rel="up">tlmgr USER MODE</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="user-mode-install"></a>
-<h4 class="appendixsubsec">B.7.1 user mode install</h4>
+<a name="User-mode-install"></a>
+<h4 class="appendixsubsec">B.9.1 User mode install</h4>
<p>In user mode, the <code>install</code> action checks that the package and all
dependencies are all either relocated or already installed in the system
@@ -5553,121 +6128,41 @@ collection-context</code> would install <code>collection-basic</code> and other
collections, while in user mode, <em>only</em> the packages mentioned in
<code>collection-context</code> are installed.
</p>
+<p>If a package shipping map files is installed in user mode, a backup of
+the user&rsquo;s <code>updmap.cfg</code> in <code>USERTREE/web2c/</code> is made, and then this file
+regenerated from the list of installed packages.
+</p>
<hr>
-<a name="tlmgr-user-mode-backup_003b-restore_003b-remove_003b-update"></a>
+<a name="tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-user-mode-generate_003b-option_003b-paper" accesskey="n" rel="next">tlmgr user mode generate; option; paper</a>, Previous: <a href="#tlmgr-user-mode-install" accesskey="p" rel="prev">tlmgr user mode install</a>, Up: <a href="#tlmgr-USER-MODE" accesskey="u" rel="up">tlmgr USER MODE</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-User-mode-generate_002c-option_002c-paper" accesskey="n" rel="next">tlmgr User mode generate, option, paper</a>, Previous: <a href="#tlmgr-User-mode-install" accesskey="p" rel="prev">tlmgr User mode install</a>, Up: <a href="#tlmgr-USER-MODE" accesskey="u" rel="up">tlmgr USER MODE</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="user-mode-backup_003b-restore_003b-remove_003b-update"></a>
-<h4 class="appendixsubsec">B.7.2 user mode backup; restore; remove; update</h4>
+<a name="User-mode-backup_002c-restore_002c-remove_002c-update"></a>
+<h4 class="appendixsubsec">B.9.2 User mode backup, restore, remove, update</h4>
<p>In user mode, these actions check that all packages to be acted on are
installed in the user tree before proceeding; otherwise, they behave
just as in normal mode.
</p>
<hr>
-<a name="tlmgr-user-mode-generate_003b-option_003b-paper"></a>
+<a name="tlmgr-User-mode-generate_002c-option_002c-paper"></a>
<div class="header">
<p>
-Previous: <a href="#tlmgr-user-mode-backup_003b-restore_003b-remove_003b-update" accesskey="p" rel="prev">tlmgr user mode backup; restore; remove; update</a>, Up: <a href="#tlmgr-USER-MODE" accesskey="u" rel="up">tlmgr USER MODE</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Previous: <a href="#tlmgr-User-mode-backup_002c-restore_002c-remove_002c-update" accesskey="p" rel="prev">tlmgr User mode backup, restore, remove, update</a>, Up: <a href="#tlmgr-USER-MODE" accesskey="u" rel="up">tlmgr USER MODE</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
-<a name="user-mode-generate_003b-option_003b-paper"></a>
-<h4 class="appendixsubsec">B.7.3 user mode generate; option; paper</h4>
+<a name="User-mode-generate_002c-option_002c-paper"></a>
+<h4 class="appendixsubsec">B.9.3 User mode generate, option, paper</h4>
<p>In user mode, these actions operate only on the user tree&rsquo;s
configuration files and/or <code>texlive.tlpdb</code>.
creates configuration files in user tree
</p>
<hr>
-<a name="tlmgr-CONFIGURATION-FILE-FOR-TLMGR"></a>
-<div class="header">
-<p>
-Next: <a href="#tlmgr-TAXONOMIES" accesskey="n" rel="next">tlmgr TAXONOMIES</a>, Previous: <a href="#tlmgr-USER-MODE" accesskey="p" rel="prev">tlmgr USER MODE</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<a name="CONFIGURATION-FILE-FOR-TLMGR"></a>
-<h3 class="appendixsec">B.8 CONFIGURATION FILE FOR TLMGR</h3>
-
-<p>A small subset of the command line options can be set in a config file
-for <code>tlmgr</code> which resides in <code>TEXMFCONFIG/tlmgr/config</code>. By default, the
-config file is in <code>~/.texliveYYYY/texmf-config/tlmgr/config</code> (replacing
-<code>YYYY</code> with the year of your TeX Live installation). This is <em>not</em>
-<code>TEXMFSYSVAR</code>, so that the file is specific to a single user.
-</p>
-<p>In this file, empty lines and lines starting with # are ignored. All
-other lines must look like
-</p>
-<pre class="verbatim"> key = value
-</pre>
-<p>where the allowed keys are <code>gui-expertmode</code> (value 0 or 1),
-<code>persistent-downloads</code> (value 0 or 1), <code>auto-remove</code> (value 0 or 1),
-and <code>gui-lang</code> (value like in the command line option).
-</p>
-<p><code>persistent-downloads</code>, <code>gui-lang</code>, and <code>auto-remove</code> correspond to
-the respective command line options of the same name. <code>gui-expertmode</code>
-switches between the full GUI and a simplified GUI with only the
-important and mostly used settings.
-</p>
-<hr>
-<a name="tlmgr-TAXONOMIES"></a>
-<div class="header">
-<p>
-Next: <a href="#tlmgr-MULTIPLE-REPOSITORIES" accesskey="n" rel="next">tlmgr MULTIPLE REPOSITORIES</a>, Previous: <a href="#tlmgr-CONFIGURATION-FILE-FOR-TLMGR" accesskey="p" rel="prev">tlmgr CONFIGURATION FILE FOR TLMGR</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
-</div>
-<a name="TAXONOMIES"></a>
-<h3 class="appendixsec">B.9 TAXONOMIES</h3>
-
-<p>tlmgr allows searching and listing of various categorizations, which we
-call <em>taxonomies</em>, as provided by an enhanced TeX Catalogue (available
-for testing at <a href="http://az.ctan.org">http://az.ctan.org</a>). This is useful when, for
-example, you don&rsquo;t know a specific package name but have an idea of the
-functionality you need; or when you want to see all packages relating to
-a given area.
-</p>
-<p>There are three different taxonomies, specified by the following
-options:
-</p>
-<dl compact="compact">
-<dt><code>--keyword</code></dt>
-<dd><a name="tlmgr-_002d_002dkeyword-2"></a>
-<p>The keywords, as specified at <a href="http://az.ctan.org/keyword">http://az.ctan.org/keyword</a>.
-</p>
-</dd>
-<dt><code>--functionality</code></dt>
-<dd><a name="tlmgr-_002d_002dfunctionality-2"></a>
-<p>The &ldquo;by-topic&rdquo; categorization created by J\&quot;urgen Fenn, as specified
-at <a href="http://az.ctan.org/characterization/by-function">http://az.ctan.org/characterization/by-function</a>.
-</p>
-</dd>
-<dt><code>--characterization</code></dt>
-<dd><a name="tlmgr-_002d_002dcharacterization-2"></a>
-<p>Both the primary and secondary functionalities, as specified at
-<a href="http://az.ctan.org/characterization/choose_dimen">http://az.ctan.org/characterization/choose_dimen</a>.
-</p>
-</dd>
-<dt><code>--taxonomy</code></dt>
-<dd><a name="tlmgr-_002d_002dtaxonomy-2"></a>
-<p>Operate on all the taxonomies.
-</p>
-</dd>
-</dl>
-
-<p>The taxonomies are updated nightly and stored within TeX Live, so
-Internet access is not required to search them.
-</p>
-<p>Examples:
-</p>
-<pre class="verbatim"> tlmgr search --taxonomy exercise # check all taxonomies for &quot;exercise&quot;
- tlmgr search --taxonomy --word table # check for &quot;table&quot; on its own
- tlmgr search --list --keyword # dump entire keyword taxonomy
- tlmgr show --taxonomy pdftex # show pdftex package information,
- # including all taxonomy entries
-</pre>
-<hr>
<a name="tlmgr-MULTIPLE-REPOSITORIES"></a>
<div class="header">
<p>
-Next: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="n" rel="next">tlmgr GUI FOR TLMGR</a>, Previous: <a href="#tlmgr-TAXONOMIES" accesskey="p" rel="prev">tlmgr TAXONOMIES</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="n" rel="next">tlmgr GUI FOR TLMGR</a>, Previous: <a href="#tlmgr-USER-MODE" accesskey="p" rel="prev">tlmgr USER MODE</a>, Up: <a href="#tlmgr" accesskey="u" rel="up">tlmgr</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="MULTIPLE-REPOSITORIES"></a>
<h3 class="appendixsec">B.10 MULTIPLE REPOSITORIES</h3>
@@ -5682,11 +6177,11 @@ or should not be included in TeX Live, for whatever reason.
installation source to any repository (with the <code>-repository</code> or
<code>option repository</code> command line options), and perform your operations.
</p>
-<p>When you are using multiple repositories over a sustained time, however,
-explicitly switching between them becomes inconvenient. Thus, it&rsquo;s
-possible to tell <code>tlmgr</code> about additional repositories you want to use.
-The basic command is <code>tlmgr repository add</code>. The rest of this section
-explains further.
+<p>When you are using multiple repositories over a sustained length of
+time, however, explicitly switching between them becomes inconvenient.
+Thus, it&rsquo;s possible to tell <code>tlmgr</code> about additional repositories you
+want to use. The basic command is <code>tlmgr repository add</code>. The rest of
+this section explains further.
</p>
<p>When using multiple repositories, one of them has to be set as the main
repository, which distributes most of the installed packages. When you
@@ -5784,15 +6279,17 @@ Next: <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="n" rel="next">tlmg
<a name="GUI-FOR-TLMGR"></a>
<h3 class="appendixsec">B.11 GUI FOR TLMGR</h3>
-<p>The graphical user interface for <code>tlmgr</code> needs Perl/Tk to be installed.
-For Windows the necessary modules are shipped within TeX Live, for all
-other (i.e., Unix-based) systems Perl/Tk (as well as Perl of course) has
-to be installed. <a href="http://tug.org/texlive/distro.html#perltk">http://tug.org/texlive/distro.html#perltk</a> has a
-list of invocations for some distros.
+<p>The graphical user interface for <code>tlmgr</code> requires Perl/Tk
+<a href="http://search.cpan.org/search?query=perl%2Ftk">http://search.cpan.org/search?query=perl%2Ftk</a>. For Windows the
+necessary modules are shipped within TeX Live, for all other (i.e.,
+Unix-based) systems Perl/Tk (as well as Perl of course) has to be
+installed outside of TL. <a href="http://tug.org/texlive/distro.html#perltk">http://tug.org/texlive/distro.html#perltk</a>
+has a list of invocations for some distros.
</p>
-<p>When started with <code>tlmgr gui</code> the graphical user interface will be
-shown. The main window contains a menu bar, the main display, and a
-status area where messages normally shown on the console are displayed.
+<p>The GUI is started with the invocation <code>tlmgr gui</code>; assuming Tk is
+loadable, the graphical user interface will be shown. The main window
+contains a menu bar, the main display, and a status area where messages
+normally shown on the console are displayed.
</p>
<p>Within the main display there are three main parts: the <code>Display
configuration</code> area, the list of packages, and the action buttons.
@@ -5809,6 +6306,8 @@ information about what is going on.
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#tlmgr-Menu-bar" accesskey="2">tlmgr Menu bar</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
+<tr><td align="left" valign="top">&bull; <a href="#tlmgr-GUI-options" accesskey="3">tlmgr GUI options</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
+</td></tr>
</table>
<hr>
@@ -5858,10 +6357,9 @@ above.
</dd>
<dt>Match</dt>
<dd><a name="tlmgr-Match"></a>
-<p>Select packages matching for a specific pattern. By default, this uses
-the same algorithm as <code>tlmgr search</code>, i.e., searches everything:
-descriptions, taxonomies, and/or filenames. You can also select any
-subset for searching.
+<p>Select packages matching for a specific pattern. By default, this
+searches both descriptions and filenames. You can also select a subset
+for searching.
</p>
</dd>
<dt>Selection</dt>
@@ -5987,7 +6485,7 @@ action needs the option <code>backupdir</code> set (see <code>Options -</code> G
<a name="tlmgr-Menu-bar"></a>
<div class="header">
<p>
-Previous: <a href="#tlmgr-Main-display" accesskey="p" rel="prev">tlmgr Main display</a>, Up: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="u" rel="up">tlmgr GUI FOR TLMGR</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#tlmgr-GUI-options" accesskey="n" rel="next">tlmgr GUI options</a>, Previous: <a href="#tlmgr-Main-display" accesskey="p" rel="prev">tlmgr Main display</a>, Up: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="u" rel="up">tlmgr GUI FOR TLMGR</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Menu-bar"></a>
<h4 class="appendixsubsec">B.11.2 Menu bar</h4>
@@ -6044,6 +6542,53 @@ on Windows).
</dl>
<hr>
+<a name="tlmgr-GUI-options"></a>
+<div class="header">
+<p>
+Previous: <a href="#tlmgr-Menu-bar" accesskey="p" rel="prev">tlmgr Menu bar</a>, Up: <a href="#tlmgr-GUI-FOR-TLMGR" accesskey="u" rel="up">tlmgr GUI FOR TLMGR</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<a name="GUI-options"></a>
+<h4 class="appendixsubsec">B.11.3 GUI options</h4>
+
+<p>Some generic Perl/Tk options can be specified with <code>tlmgr gui</code> to
+control the display:
+</p>
+<dl compact="compact">
+<dt><code>-background</code> <em>color</em></dt>
+<dd><a name="tlmgr-_002dbackground-color"></a>
+<p>Set background color.
+</p>
+</dd>
+<dt><code>-font &quot;</code> <em>fontname</em> <em>fontsize</em> <code>&quot;</code></dt>
+<dd><a name="tlmgr-_002dfont-_0022-fontname-fontsize-_0022"></a>
+<p>Set font, e.g., <code>tlmgr gui -font &quot;helvetica 18&quot;</code>. The argument to
+<code>-font</code> must be quoted, i.e., passed as a single string.
+</p>
+</dd>
+<dt><code>-foreground</code> <em>color</em></dt>
+<dd><a name="tlmgr-_002dforeground-color"></a>
+<p>Set foreground color.
+</p>
+</dd>
+<dt><code>-geometry</code> <em>geomspec</em></dt>
+<dd><a name="tlmgr-_002dgeometry-geomspec"></a>
+<p>Set the X geometry, e.g., <code>tlmgr gui -geometry 1024x512-0+0</code> creates
+the window of (approximately) the given size in the upper-right corner
+of the display.
+</p>
+</dd>
+<dt><code>-xrm</code> <em>xresource</em></dt>
+<dd><a name="tlmgr-_002dxrm-xresource"></a>
+<p>Pass the arbitrary X resource string <em>xresource</em>.
+</p>
+</dd>
+</dl>
+
+<p>A few other obscure options are recognized but not mentioned here. See
+the Perl/Tk documentation (<a href="http://search.cpan.org/perldoc?Tk">http://search.cpan.org/perldoc?Tk</a>) for the
+complete list, and any X documentation for general information.
+</p>
+<hr>
<a name="tlmgr-MACHINE_002dREADABLE-OUTPUT"></a>
<div class="header">
<p>
@@ -6059,9 +6604,9 @@ written to stdout). The idea is that a program can get all the
information it needs by reading stdout.
</p>
<p>Currently this option only applies to the
-<a href="#tlmgr-update-_005boption_005d_002e_002e_002e-_005bpkg_005d_002e_002e_002e">update</a>,
-<a href="#tlmgr-install-_005boption_005d_002e_002e_002e-pkg_002e_002e_002e">install</a>, and
-<a href="#tlmgr-option">option</a> actions.
+<a href="#tlmgr-update-_005boption_002e_002e_002e_005d-_005bpkg_002e_002e_002e_005d">update</a>,
+<a href="#tlmgr-install-_005boption_002e_002e_002e_005d-pkg_002e_002e_002e">install</a>, and
+<a href="#tlmgr-option">option</a> actions.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#tlmgr-Machine_002dreadable-update-and-install-output" accesskey="1">tlmgr Machine-readable <code>update</code> and <code>install</code> output</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
@@ -6243,6 +6788,8 @@ Previous: <a href="#tlmgr-MACHINE_002dREADABLE-OUTPUT" accesskey="p" rel="prev">
distribution (<a href="http://tug.org/texlive">http://tug.org/texlive</a>) and both are licensed under the
GNU General Public License Version 2 or later.
</p>
+<p>$Id: tlmgr.pl 47303 2018-04-05 17:52:22Z karl $
+</p>
<hr>
<a name="Index"></a>
@@ -6374,7 +6921,7 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top
<tr><td></td><td valign="top"><a href="#index-_002dj-make-option"><code>-j make <span class="roman">option</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Build-in-parallel">Build in parallel</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Index_cp_symbol-2">.</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-_002etravis_002eyml"><code>.travis.yml</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Continuous-integration">Continuous integration</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002etravis_002eyml"><code>.travis.yml</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#CI-testing-on-Travis_002dCI">CI testing on Travis-CI</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Index_cp_letter-A">A</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-adapting-TeX-Live-for-distros">adapting TeX&nbsp;Live for distros</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Distro-builds">Distro builds</a></td></tr>