diff options
Diffstat (limited to 'Build/source/doc/tlbuild-incl')
-rw-r--r-- | Build/source/doc/tlbuild-incl/install-tl.texi | 23 | ||||
-rw-r--r-- | Build/source/doc/tlbuild-incl/tlmgr.texi | 86 |
2 files changed, 53 insertions, 56 deletions
diff --git a/Build/source/doc/tlbuild-incl/install-tl.texi b/Build/source/doc/tlbuild-incl/install-tl.texi index 1437b31ad0a..957f361ec55 100644 --- a/Build/source/doc/tlbuild-incl/install-tl.texi +++ b/Build/source/doc/tlbuild-incl/install-tl.texi @@ -24,8 +24,6 @@ install-tl [@emph{option}]... install-tl-windows.bat [@emph{option}]... -install-tl-advanced.bat [@emph{option}]... - @node install-tl DESCRIPTION @appendixsec DESCRIPTION @@ -172,6 +170,12 @@ For more information on custom binaries, see @url{https://tug.org/texlive/custom-bin.html}. For general information on building TeX Live, see @url{https://tug.org/texlive/build.html}. +@item @strong{-debug-fakenet} +@anchor{install-tl @strong{-debug-fakenet}} + +Pretend we're doing a network install, for the sole purpose of testing +broken downloads via moving package files aside in a tlnet mirror. + @item @strong{-debug-translation} @anchor{install-tl @strong{-debug-translation}} @@ -515,9 +519,6 @@ Set the default paper size for all relevant programs; must be either @item @code{TEXLIVE_INSTALL_PREFIX} @anchor{install-tl @code{TEXLIVE_INSTALL_PREFIX}} -@item @code{TEXLIVE_INSTALL_TEXDIR} -@anchor{install-tl @code{TEXLIVE_INSTALL_TEXDIR}} - @item @code{TEXLIVE_INSTALL_TEXMFCONFIG} @anchor{install-tl @code{TEXLIVE_INSTALL_TEXMFCONFIG}} @@ -536,12 +537,14 @@ Set the default paper size for all relevant programs; must be either @item @code{TEXLIVE_INSTALL_TEXMFSYSVAR} @anchor{install-tl @code{TEXLIVE_INSTALL_TEXMFSYSVAR}} -Specify the respective directories. @code{TEXLIVE_INSTALL_PREFIX} defaults -to @code{/usr/local/texlive}, while @code{TEXLIVE_INSTALL_TEXDIR} defaults to -the release directory within that prefix, e.g., -@code{/usr/local/texlive/2016}. All the defaults can be seen by running the +Specify the respective directories. @code{TEXLIVE_INSTALL_PREFIX} defaults +to @code{/usr/local/texlive}. All the defaults can be seen by running the installer interactively and then typing @code{D} for the directory menu. +To override the so-called @code{TEXDIR}, which defaults to the release +directory within that prefix, e.g., @code{/usr/local/texlive/2020}, use a +profile file (q.v.). + @item @code{NOPERLDOC} @anchor{install-tl @code{NOPERLDOC}} @@ -556,5 +559,5 @@ This script and its documentation were written for the TeX Live distribution (@url{https://tug.org/texlive}) and both are licensed under the GNU General Public License Version 2 or later. -$Id: install-tl 58938 2021-04-21 21:26:24Z karl $ +$Id: install-tl 62146 2022-02-22 22:48:10Z karl $ diff --git a/Build/source/doc/tlbuild-incl/tlmgr.texi b/Build/source/doc/tlbuild-incl/tlmgr.texi index 7a316911578..f1a4403831f 100644 --- a/Build/source/doc/tlbuild-incl/tlmgr.texi +++ b/Build/source/doc/tlbuild-incl/tlmgr.texi @@ -839,8 +839,8 @@ is available in a remote repository using @item @strong{--data @code{item1,item2,...}} @anchor{tlmgr @strong{--data @code{item1@comma{}item2@comma{}...}}} -If the option @code{--data} is given, its argument must be a comma separated -list of field names from: @code{name}, @code{category}, @code{localrev}, +If the option @code{--data} is given, its argument must be a comma or colon +separated list of field names from: @code{name}, @code{category}, @code{localrev}, @code{remoterev}, @code{shortdesc}, @code{longdesc}, @code{installed}, @code{size}, @code{relocatable}, @code{depends}, @code{cat-version}, @code{cat-date}, @code{cat-license}, plus various @code{cat-contact-*} fields (see below). @@ -1386,9 +1386,10 @@ written to the terminal. @end table -This action does not automatically remove symlinks to executables from -system directories; you need to run @code{tlmgr path remove} (@ref{tlmgr path,, path}) -yourself if you are using this feature and want stale symlinks removed. +Except with @code{--all}, this @code{remove} action does not automatically +remove symlinks to executables from system directories; you need to run +@code{tlmgr path remove} (@ref{tlmgr path,, path}) yourself if you remove an individual +package with a symlink in a system directory. @node tlmgr repository @appendixsubsec repository @@ -1902,62 +1903,56 @@ where the spaces are optional but the @code{=} is required. The allowed keys are: @table @asis -@item @code{auto-remove}, value 0 or 1 (default 1), same as command-line option. -@anchor{tlmgr @code{auto-remove}@comma{} value 0 or 1 (default 1)@comma{} same as command-line option.} +@item @code{auto-remove =} 0 or 1 (default 1), same as command-line option. +@anchor{tlmgr @code{auto-remove =} 0 or 1 (default 1)@comma{} same as command-line option.} -@item @code{gui-expertmode}, value 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings. -@anchor{tlmgr @code{gui-expertmode}@comma{} value 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings.} +@item @code{gui-expertmode =} 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings. +@anchor{tlmgr @code{gui-expertmode =} 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings.} -@item @code{gui-lang} @emph{llcode}, with a language code value as with the command-line option. -@anchor{tlmgr @code{gui-lang} @emph{llcode}@comma{} with a language code value as with the command-line option.} +@item @code{gui-lang =} @emph{llcode}, with a language code value as with the command-line option. +@anchor{tlmgr @code{gui-lang =} @emph{llcode}@comma{} with a language code value as with the command-line option.} -@item @code{no-checksums}, value 0 or 1 (default 0, see below). -@anchor{tlmgr @code{no-checksums}@comma{} value 0 or 1 (default 0@comma{} see below).} +@item @code{no-checksums =} 0 or 1 (default 0, see below). +@anchor{tlmgr @code{no-checksums =} 0 or 1 (default 0@comma{} see below).} -@item @code{persistent-downloads}, value 0 or 1 (default 1), same as command-line option. -@anchor{tlmgr @code{persistent-downloads}@comma{} value 0 or 1 (default 1)@comma{} same as command-line option.} +@item @code{persistent-downloads =} 0 or 1 (default 1), same as command-line option. +@anchor{tlmgr @code{persistent-downloads =} 0 or 1 (default 1)@comma{} same as command-line option.} -@item @code{require-verification}, value 0 or 1 (default 0), same as command-line option. -@anchor{tlmgr @code{require-verification}@comma{} value 0 or 1 (default 0)@comma{} same as command-line option.} +@item @code{require-verification =} 0 or 1 (default 0), same as command-line option. +@anchor{tlmgr @code{require-verification =} 0 or 1 (default 0)@comma{} same as command-line option.} -@item @code{tkfontscale}, value any float. Controls the scaling of fonts in the Tk based frontends. -@anchor{tlmgr @code{tkfontscale}@comma{} value any float. Controls the scaling of fonts in the Tk based frontends.} +@item @code{tkfontscale =} @emph{floating-point number} (default 1.0); scaling factor for fonts in the Tk-based frontends. +@anchor{tlmgr @code{tkfontscale =} @emph{floating-point number} (default 1.0); scaling factor for fonts in the Tk-based frontends.} -@item @code{update-exclude}, value: comma-separated list of packages (no space allowed). Same as the command line option @code{--exclude} for the action @code{update}. -@anchor{tlmgr @code{update-exclude}@comma{} value: comma-separated list of packages (no space allowed). Same as the command line option @code{--exclude} for the action @code{update}.} +@item @code{update-exclude =} @emph{comma-separated list of packages} (no spaces allowed). Same as the command line option @code{--exclude} for the @code{update} action. +@anchor{tlmgr @code{update-exclude =} @emph{comma-separated list of packages} (no spaces allowed). Same as the command line option @code{--exclude} for the @code{update} action.} -@item @code{verify-downloads}, value 0 or 1 (default 1), same as command-line option. -@anchor{tlmgr @code{verify-downloads}@comma{} value 0 or 1 (default 1)@comma{} same as command-line option.} +@item @code{verify-downloads =} 0 or 1 (default 1), same as command-line option. +@anchor{tlmgr @code{verify-downloads =} 0 or 1 (default 1)@comma{} same as command-line option.} @end table The system-wide config file can contain one additional key: @table @asis -@item @code{allowed-actions} @emph{action1} [,@emph{action},...] The value is a comma-separated list of @code{tlmgr} actions which are allowed to be executed when @code{tlmgr} is invoked in system mode (that is, without @code{--usermode}). -@anchor{tlmgr @code{allowed-actions} @emph{action1} [@comma{}@emph{action}@comma{}...] The value is a comma-separated list of @code{tlmgr} actions which are allowed to be executed when @code{tlmgr} is invoked in system mode (that is@comma{} without @code{--usermode}).} - -This allows distributors to include the @code{tlmgr} 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't -make sense to set this. +@item @code{allowed-actions =} @emph{action1}[,@emph{action2},...] The value is a comma-separated list (no spaces) of @code{tlmgr} actions which are allowed to be executed when @code{tlmgr} is invoked in system mode (that is, without @code{--usermode}). This allows distributors to include @code{tlmgr} 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't make sense to set this. +@anchor{tlmgr @code{allowed-actions =} @emph{action1}[@comma{}@emph{action2}@comma{}...] The value is a comma-separated list (no spaces) of @code{tlmgr} actions which are allowed to be executed when @code{tlmgr} is invoked in system mode (that is@comma{} without @code{--usermode}). This allows distributors to include @code{tlmgr} in their packaging@comma{} but allow only a restricted set of actions that do not interfere with their distro package manager. For native TeX Live installations@comma{} it doesn't make sense to set this.} @end table -The @code{no-checksums} 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} -disables this process. - -The checksum algorithm is SHA-512. Your system must have one of (looked -for in this order) the Perl @code{Digest::SHA} module, the @code{openssl} -program (@url{https://openssl.org}), the @code{sha512sum} program (from GNU -Coreutils, @url{https://www.gnu.org/software/coreutils}), or finally the -@code{shasum} program (just to support old Macs). If none of these are -available, a warning is issued and @code{tlmgr} 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} avoids the warning. +Finally, the @code{no-checksums} 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} disables this process. The checksum algorithm is +SHA-512. Your system must have one of (looked for in this order) the +Perl @code{Digest::SHA} module, the @code{openssl} program +(@url{https://openssl.org}), the @code{sha512sum} program (from GNU Coreutils, +@url{https://www.gnu.org/software/coreutils}), or finally the @code{shasum} +program (just to support old Macs). If none of these are available, a +warning is issued and @code{tlmgr} proceeds without checking checksums. +@code{no-checksums} avoids the warning. (Incidentally, other SHA +implementations, such as the pure Perl and pure Lua modules, are much +too slow to be usable in our context.) @node tlmgr CRYPTOGRAPHIC VERIFICATION @appendixsec CRYPTOGRAPHIC VERIFICATION @@ -2108,7 +2103,6 @@ just as in normal mode. In user mode, these actions operate only on the user tree's configuration files and/or @code{texlive.tlpdb}. -creates configuration files in user tree @node tlmgr MULTIPLE REPOSITORIES @appendixsec MULTIPLE REPOSITORIES @@ -2764,5 +2758,5 @@ This script and its documentation were written for the TeX Live distribution (@url{https://tug.org/texlive}) and both are licensed under the GNU General Public License Version 2 or later. -$Id: tlmgr.pl 58938 2021-04-21 21:26:24Z karl $ +$Id: tlmgr.pl 62273 2022-02-28 08:52:17Z preining $ |