From c5ad0b1434f22257a1e23eb519ad56e781b03471 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 24 Apr 2017 00:06:43 +0000 Subject: tl-update-auto git-svn-id: svn://tug.org/texlive/trunk@44005 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/man/man1/install-tl.1 | 97 +++++++++++++++-------------- 1 file changed, 51 insertions(+), 46 deletions(-) (limited to 'Master/texmf-dist/doc/man/man1/install-tl.1') diff --git a/Master/texmf-dist/doc/man/man1/install-tl.1 b/Master/texmf-dist/doc/man/man1/install-tl.1 index 5349d696e04..55974b03100 100644 --- a/Master/texmf-dist/doc/man/man1/install-tl.1 +++ b/Master/texmf-dist/doc/man/man1/install-tl.1 @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "INSTALL-TL 1" -.TH INSTALL-TL 1 "2017-04-22" "perl v5.24.1" "User Contributed Perl Documentation" +.TH INSTALL-TL 1 "2017-04-23" "perl v5.24.1" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -146,11 +146,12 @@ install\-tl\-advanced.bat [\fIoption\fR]... .SH "DESCRIPTION" .IX Header "DESCRIPTION" 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 . +media, including over the network, from local hard disk, a \s-1DVD,\s0 etc. +The installer works across all platforms supported by TeX Live. For +information on initially downloading the TeX Live, see +. .PP -The basic idea of TeX Live installation is to choose one of the +The basic idea of TeX Live installation is for you to choose one of the top-level \fIschemes\fR, each of which is defined as a different set of \&\fIcollections\fR and \fIpackages\fR, where a collection is a set of packages, and a package is what contains actual files. @@ -158,18 +159,18 @@ and a package is what contains actual files. 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 \f(CW\*(C`tlmgr\*(C'\fR (reference below) after the initial installation is -completely. +complete. .PP -The default is \f(CW\*(C`scheme\-full\*(C'\fR, to install everything, and this is highly -recommended. +The default is \f(CW\*(C`scheme\-full\*(C'\fR, which installs everything, and this is +highly recommended. .SH "REFERENCES" .IX Header "REFERENCES" Post-installation configuration, package updates, and much more, are handled through \fBtlmgr\fR(1), the TeX Live Manager (). .PP -The most up-to-date version of this documentation is on the Internet at -. +The most up-to-date version of this installer documentation is on the +Internet at . .PP For the full documentation of TeX Live, see . @@ -180,31 +181,31 @@ leading \f(CW\*(C`\-\*(C'\fR or \f(CW\*(C`\-\-\*(C'\fR. An argument value can b option by either a space or \f(CW\*(C`=\*(C'\fR. .IP "\fB\-gui\fR [[=]\fImodule\fR]" 4 .IX Item "-gui [[=]module]" -If no \fImodule\fR is given starts the \f(CW\*(C`perltk\*(C'\fR (see below) \s-1GUI\s0 installer. +If no \fImodule\fR is given, starts the \f(CW\*(C`perltk\*(C'\fR (see below) \s-1GUI\s0 installer. .Sp If \fImodule\fR is given loads the given installer module. Currently the following modules are supported: .RS 4 -.ie n .IP """text""" 8 -.el .IP "\f(CWtext\fR" 8 +.ie n .IP """text""" 4 +.el .IP "\f(CWtext\fR" 4 .IX Item "text" The text mode user interface (default on Unix systems). Same as the \&\f(CW\*(C`\-no\-gui\*(C'\fR option. -.ie n .IP """wizard""" 8 -.el .IP "\f(CWwizard\fR" 8 +.ie n .IP """wizard""" 4 +.el .IP "\f(CWwizard\fR" 4 .IX Item "wizard" The wizard mode user interface (default on Windows), asking only minimal questions before installing all of TeX Live. -.ie n .IP """perltk""" 8 -.el .IP "\f(CWperltk\fR" 8 +.ie n .IP """perltk""" 4 +.el .IP "\f(CWperltk\fR" 4 .IX Item "perltk" The expert \s-1GUI\s0 installer, providing access to more options. Can also be invoked on Windows by running \f(CW\*(C`install\-tl\-advanced.bat\*(C'\fR. .RE .RS 4 .Sp -The \f(CW\*(C`perltk\*(C'\fR and \f(CW\*(C`wizard\*(C'\fR modules, and thus also when calling with a -bare \f(CW\*(C`\-gui\*(C'\fR (without \fImodule\fR), requires the Perl/Tk module +The \f(CW\*(C`perltk\*(C'\fR and \f(CW\*(C`wizard\*(C'\fR modules, and thus also when calling with +bare \f(CW\*(C`\-gui\*(C'\fR (with no \fImodule\fR), require the Perl/Tk module (); if Perl/Tk is not available, installation continues in text mode. .RE @@ -226,8 +227,9 @@ simplified Chinese (zh_CN), and traditional Chinese (zh_TW). .IX Item "-repository url|path" Specify the package repository to be used as the source of the installation, either a local directory via \f(CW\*(C`/path/to/directory\*(C'\fR or a -\&\f(CW\*(C`file:/\*(C'\fR url, or a network location via a \f(CW\*(C`http://\*(C'\fR or \f(CW\*(C`ftp://\*(C'\fR url. -(No other protocols are supported.) +\&\f(CW\*(C`file:/\*(C'\fR url, or a network location via a \f(CW\*(C`http://\*(C'\fR, \f(CW\*(C`https://\*(C'\fR, or +\&\f(CW\*(C`ftp://\*(C'\fR url. (No other protocols are supported, and \f(CW\*(C`http://\*(C'\fR may +not work on all platforms.) .Sp The default is to pick a mirror automatically, using ; the chosen mirror is @@ -243,7 +245,7 @@ you could choose a particular \s-1CTAN\s0 mirror with something like this: \& \-repository http://ctan.example.org/its/ctan/dir/systems/texlive/tlnet .Ve .Sp -Of course a real hostname and its particular top-level \s-1CTAN\s0 path +Of course a real hostname and its particular top-level \s-1CTAN\s0 directory have to be specified. The list of \s-1CTAN\s0 mirrors is available at . .Sp @@ -275,9 +277,9 @@ choose a good host for you. .IP "\fB\-all\-options\fR" 4 .IX Item "-all-options" 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 \f(CW\*(C`texlive.tlpdb\*(C'\fR 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 \*(L"foreign\*(R" +settings. .IP "\fB\-custom\-bin\fR \fIpath\fR" 4 .IX Item "-custom-bin path" If you have built your own set of TeX Live binaries (perhaps because @@ -287,8 +289,12 @@ the current system are present. The installation will continue as usual, but at the end all files from \fIpath\fR are copied over to \&\f(CW\*(C`bin/custom/\*(C'\fR under your installation directory and this \f(CW\*(C`bin/custom/\*(C'\fR directory is what will be added to the path for the post-install -actions. (By the way, for information on building TeX Live, see -). +actions. To install multiple custom binary sets, manully rename +\&\f(CW\*(C`custom\*(C'\fR before doing each. +.Sp +For more information on custom binaries, see +. For general information on +building TeX Live, see . .IP "\fB\-debug\-translation\fR" 4 .IX Item "-debug-translation" In \s-1GUI\s0 mode, this switch makes \f(CW\*(C`tlmgr\*(C'\fR report any missing, or more @@ -301,7 +307,7 @@ Binaries for this platform must be present and they must actually be runnable, or installation will fail. \f(CW\*(C`\-force\-arch\*(C'\fR is a synonym. .IP "\fB\-help\fR, \fB\-\-help\fR, \fB\-?\fR" 4 .IX Item "-help, --help, -?" -Display this help and exit (on the web via +Display this help and exit. (This help is on the web at ). Sometimes the \&\f(CW\*(C`perldoc\*(C'\fR and/or \f(CW\*(C`PAGER\*(C'\fR programs on the system have problems, possibly resulting in control characters being literally output. This @@ -369,23 +375,21 @@ Load the file \fIprofile\fR and do the installation with no user interaction, that is, a batch (unattended) install. .Sp A \fIprofile\fR file contains all the values needed to perform an -installation. From the text menu one can select 'P' to save the -current setup as profile. Furthermore, after a normal installation +installation. From the text menu one can select \f(CW\*(C`P\*(C'\fR to save the +current setup as profile. In addition, 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 +\&\f(CW\*(C`tlpkg/texlive.profile\*(C'\fR. That file can be given as the argument to \&\f(CW\*(C`\-profile\*(C'\fR 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. .Sp -Normally a profile has to specify the value \f(CW1\fR 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 \f(CW\*(C`selected_scheme\*(C'\fR and \fIno\fR collection variables at all are defined -in the profile, then the collections which the specified scheme requires -are installed. +Within a profile file, if the variable \f(CW\*(C`selected_scheme\*(C'\fR is defined and +\&\fIno\fR collection variables at all are defined, then the collections +required by the specified scheme are installed, without explicitly +listing them. This eases maintenance of profile files. If any +collections are specified in a profile, though, then this does not +apply, and all desired collections must be given explicitly. .Sp Thus, a line \f(CW\*(C`selected_scheme scheme\-medium\*(C'\fR together with the definitions of the installation directories (\f(CW\*(C`TEXDIR\*(C'\fR, \f(CW\*(C`TEXMFHOME\*(C'\fR, @@ -397,8 +401,8 @@ For more detailed explanations on the meaning of the options consult the TeX Live installation manual. Values are either \&\f(CW0\fR, \f(CW1\fR, or strings. .RS 4 -.ie n .IP "\fBinstaller options\fR (those with prefix ""instopt_"")" 8 -.el .IP "\fBinstaller options\fR (those with prefix \f(CWinstopt_\fR)" 8 +.ie n .IP "\fBinstaller options\fR (those with prefix ""instopt_"")" 4 +.el .IP "\fBinstaller options\fR (those with prefix \f(CWinstopt_\fR)" 4 .IX Item "installer options (those with prefix instopt_)" \&\f(CW\*(C`instopt_portable\*(C'\fR (default 0, see \f(CW\*(C`\-portable\*(C'\fR), \&\f(CW\*(C`instopt_letter\*(C'\fR (default 0, selecting letter size instead of a4), @@ -407,8 +411,8 @@ mirror after installation), \&\f(CW\*(C`instopt_write18_restricted\*(C'\fR (default 1, enable write8 for a restricted set of programs), \&\f(CW\*(C`instopt_adjustpath\*(C'\fR (default 0 on Unix, 1 on Windows, adjust \s-1PATH\s0 environment). -.ie n .IP "\fBtlpdb options\fR (those with prefix ""tlpdbopt_"")" 8 -.el .IP "\fBtlpdb options\fR (those with prefix \f(CWtlpdbopt_\fR)" 8 +.ie n .IP "\fBtlpdb options\fR (those with prefix ""tlpdbopt_"")" 4 +.el .IP "\fBtlpdb options\fR (those with prefix \f(CWtlpdbopt_\fR)" 4 .IX Item "tlpdb options (those with prefix tlpdbopt_)" The definitive list is give in \f(CW\*(C`TeXLive::TLConfig.pm\*(C'\fR in \&\f(CW%TeXLive::TLConfig::TLPDBOptions\fR, together with explanations. @@ -420,12 +424,12 @@ The current list is given below: \&\f(CW\*(C`tlpdbopt_install_srcfiles\*(C'\fR, \f(CW\*(C`tlpdbopt_post_code\*(C'\fR, \&\f(CW\*(C`tlpdbopt_sys_bin\*(C'\fR, \f(CW\*(C`tlpdbopt_sys_info\*(C'\fR, \f(CW\*(C`tlpdbopt_sys_man\*(C'\fR, \&\f(CW\*(C`tlpdbopt_w32_multi_user\*(C'\fR, \f(CW\*(C`tlpdbopt_generate_updmap\*(C'\fR -.IP "\fBpath options\fR" 8 +.IP "\fBpath options\fR" 4 .IX Item "path options" \&\f(CW\*(C`TEXDIR\*(C'\fR, \f(CW\*(C`TEXMFHOME\*(C'\fR, \f(CW\*(C`TEXMFCONFIG\*(C'\fR, \f(CW\*(C`TEXMFSYSCONFIG\*(C'\fR, \&\f(CW\*(C`TEXMFVAR\*(C'\fR, \f(CW\*(C`TEXMFSYSVAR\*(C'\fR, \f(CW\*(C`TEXMFLOCAL\*(C'\fR -.ie n .IP "\fBarchitecture selection options\fR (those starting with ""binary_"")" 8 -.el .IP "\fBarchitecture selection options\fR (those starting with \f(CWbinary_\fR)" 8 +.ie n .IP "\fBarchitecture selection options\fR (those starting with ""binary_"")" 4 +.el .IP "\fBarchitecture selection options\fR (those starting with \f(CWbinary_\fR)" 4 .IX Item "architecture selection options (those starting with binary_)" For every supported architecture of TeX Live (directories under \&\f(CW\*(C`bin/\*(C'\fR), the key \f(CW\*(C`binary_ARCH\*(C'\fR can be set. @@ -518,3 +522,4 @@ Don't try to run the \f(CW\*(C`\-\-help\*(C'\fR message through \f(CW\*(C`perldo This script and its documentation were written for the TeX Live distribution () and both are licensed under the \&\s-1GNU\s0 General Public License Version 2 or later. +\&\f(CW$Id\fR$ -- cgit v1.2.3