From a2977def5a26973461d5be29f039328eaf79fa9f Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 17 Jul 2022 23:49:23 +0000 Subject: tl-update-auto git-svn-id: svn://tug.org/texlive/trunk@63925 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/man/man1/install-tl.1 | 18 +++++++++++++----- Master/texmf-dist/doc/man/man1/install-tl.man1.pdf | Bin 59334 -> 59765 bytes Master/texmf-dist/doc/texlive/install-tl.html | 8 +++++--- 3 files changed, 18 insertions(+), 8 deletions(-) (limited to 'Master/texmf-dist') diff --git a/Master/texmf-dist/doc/man/man1/install-tl.1 b/Master/texmf-dist/doc/man/man1/install-tl.1 index c956650ec69..88228eefb82 100644 --- a/Master/texmf-dist/doc/man/man1/install-tl.1 +++ b/Master/texmf-dist/doc/man/man1/install-tl.1 @@ -133,7 +133,7 @@ .\" ======================================================================== .\" .IX Title "INSTALL-TL 1" -.TH INSTALL-TL 1 "2022-06-21" "perl v5.34.0" "User Contributed Perl Documentation" +.TH INSTALL-TL 1 "2022-07-17" "perl v5.34.0" "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 @@ -794,6 +794,14 @@ variable settings. .PP The defaults vary slightly on Macs, as explained above in \*(L"\s-1OPTIONS\*(R"\s0. .PP +For the user trees, the default value uses \f(CW\*(C`~\*(C'\fR, and this is left as a +literal \f(CW\*(C`~\*(C'\fR in \f(CW\*(C`texmf.cnf\*(C'\fR. That way, each user can have their own +\&\f(CW\*(C`TEXMFHOME\*(C'\fR, etc., as intended. On the other hand, for the system +trees, if \f(CW\*(C`~\*(C'\fR is used during the installation, this is assumed to +simply be a typing shorthand, and the expanded home directory is written +in \f(CW\*(C`texmf.cnf\*(C'\fR, since it doesn't make sense to have user-specific +system directories. +.PP For more on the directory trees and their intended usage, see the main TeX Live documentation at . .SH "BUGS" @@ -802,18 +810,18 @@ The \f(CW\*(C`install\-tl\*(C'\fR script copies itself into the installed tree. Usually, it can be run from there, using the installed tree as the source for another installation. Occasionally, however, there may be incompatibilities in the code of the new \f(CW\*(C`install\-tl\*(C'\fR and the -infrastructure, resulting in (typically) inscrutable Perl errors. The +infrastructure, resulting in (probably) inscrutable Perl errors. The way forward is to run \f(CW\*(C`install\-tl\*(C'\fR out of the installer package (\f(CW\*(C`install\-tl\-unx.tar.gz\*(C'\fR or \f(CW\*(C`install\-tl.zip\*(C'\fR) instead of the -installation. Feel free to also report the bug and generally the code +installation. Feel free to also report the issue; usually the code can be easily synced up again. .PP By the way, do not try to use \f(CW\*(C`install\-tl\*(C'\fR to adjust options or -installed packaged in an existing installed tree. Use \f(CW\*(C`tlmgr\*(C'\fR instead. +installed packages in an existing installed tree. Use \f(CW\*(C`tlmgr\*(C'\fR instead. .SH "AUTHORS AND COPYRIGHT" .IX Header "AUTHORS AND COPYRIGHT" 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. .PP -\&\f(CW$Id:\fR install-tl 63676 2022\-06\-21 00:09:29Z preining $ +\&\f(CW$Id:\fR install-tl 63919 2022\-07\-17 17:49:31Z karl $ diff --git a/Master/texmf-dist/doc/man/man1/install-tl.man1.pdf b/Master/texmf-dist/doc/man/man1/install-tl.man1.pdf index c5d5beecdb3..e0b9d4e0df0 100644 Binary files a/Master/texmf-dist/doc/man/man1/install-tl.man1.pdf and b/Master/texmf-dist/doc/man/man1/install-tl.man1.pdf differ diff --git a/Master/texmf-dist/doc/texlive/install-tl.html b/Master/texmf-dist/doc/texlive/install-tl.html index 7d295b8650b..457c8a47265 100644 --- a/Master/texmf-dist/doc/texlive/install-tl.html +++ b/Master/texmf-dist/doc/texlive/install-tl.html @@ -612,19 +612,21 @@ tlpdbopt_w32_multi_user

The defaults vary slightly on Macs, as explained above in "OPTIONS".

+

For the user trees, the default value uses ~, and this is left as a literal ~ in texmf.cnf. That way, each user can have their own TEXMFHOME, etc., as intended. On the other hand, for the system trees, if ~ is used during the installation, this is assumed to simply be a typing shorthand, and the expanded home directory is written in texmf.cnf, since it doesn't make sense to have user-specific system directories.

+

For more on the directory trees and their intended usage, see the main TeX Live documentation at https://tug.org/texlive/doc.

BUGS

-

The install-tl script copies itself into the installed tree. Usually, it can be run from there, using the installed tree as the source for another installation. Occasionally, however, there may be incompatibilities in the code of the new install-tl and the infrastructure, resulting in (typically) inscrutable Perl errors. The way forward is to run install-tl out of the installer package (install-tl-unx.tar.gz or install-tl.zip) instead of the installation. Feel free to also report the bug and generally the code can be easily synced up again.

+

The install-tl script copies itself into the installed tree. Usually, it can be run from there, using the installed tree as the source for another installation. Occasionally, however, there may be incompatibilities in the code of the new install-tl and the infrastructure, resulting in (probably) inscrutable Perl errors. The way forward is to run install-tl out of the installer package (install-tl-unx.tar.gz or install-tl.zip) instead of the installation. Feel free to also report the issue; usually the code can be easily synced up again.

-

By the way, do not try to use install-tl to adjust options or installed packaged in an existing installed tree. Use tlmgr instead.

+

By the way, do not try to use install-tl to adjust options or installed packages in an existing installed tree. Use tlmgr instead.

AUTHORS AND COPYRIGHT

This script and its documentation were written for the TeX Live distribution (https://tug.org/texlive) and both are licensed under the GNU General Public License Version 2 or later.

-

$Id: install-tl 63676 2022-06-21 00:09:29Z preining $

+

$Id: install-tl 63919 2022-07-17 17:49:31Z karl $

-- cgit v1.2.3