summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-06-03 18:09:29 +0000
committerKarl Berry <karl@freefriends.org>2018-06-03 18:09:29 +0000
commitde1d6dbb61cf492e66ff9733139fbe03c4407f6f (patch)
tree1f9a7d29a47b80ccc4261cdf9739b3f43fd90a4f
parented62f6c3f3ff564e386dce340a538a14db5e22e9 (diff)
doc, consistency
git-svn-id: svn://tug.org/texlive/trunk@47907 c570f23f-e606-0410-a88d-b1316a301751
-rwxr-xr-xMaster/install-tl173
-rwxr-xr-xMaster/texmf-dist/scripts/texlive/tlmgr.pl132
-rw-r--r--Master/tlpkg/TeXLive/TLCrypto.pm4
-rw-r--r--Master/tlpkg/TeXLive/TLTREE.pm4
-rw-r--r--Master/tlpkg/TeXLive/TLWinGoo.pm4
5 files changed, 133 insertions, 184 deletions
diff --git a/Master/install-tl b/Master/install-tl
index 9454e4e544e..9b28ca04377 100755
--- a/Master/install-tl
+++ b/Master/install-tl
@@ -288,11 +288,14 @@ if ($opt_version) {
close (REL_TL);
}
if ($::opt_verbosity > 0) {
- print "Revision of modules:";
+ print "Module revisions:";
print "\nTLConfig: " . TeXLive::TLConfig->module_revision();
- print "\nTLUtils: " . TeXLive::TLUtils->module_revision();
- print "\nTLPOBJ: " . TeXLive::TLPOBJ->module_revision();
+ print "\nTLCrypto: " . TeXLive::TLCrypto->module_revision();
+ print "\nTLDownload: ".TeXLive::TLDownload->module_revision();
print "\nTLPDB: " . TeXLive::TLPDB->module_revision();
+ print "\nTLPOBJ: " . TeXLive::TLPOBJ->module_revision();
+ print "\nTLTREE: " . TeXLive::TLTREE->module_revision();
+ print "\nTLUtils: " . TeXLive::TLUtils->module_revision();
print "\nTLWinGoo: " . TeXLive::TLWinGoo->module_revision() if win32();
print "\n";
}
@@ -2496,9 +2499,9 @@ install-tl-advanced.bat [I<option>]...
=head1 DESCRIPTION
This installer creates a runnable TeX Live installation from various
-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
+media, including over the network, from local hard disk, a DVD, etc. The
+installer works on all platforms supported by TeX Live. For information
+on initially downloading TeX Live, see
L<http://tug.org/texlive/acquire.html>.
The basic idea of TeX Live installation is for you to choose one of the
@@ -2517,7 +2520,7 @@ highly recommended.
=head1 REFERENCES
-Post-installation configuration, package updates, and much more, are
+Post-installation configuration, package updates, and more, are
handled through B<tlmgr>(1), the TeX Live Manager
(L<http://tug.org/texlive/tlmgr.html>).
@@ -2588,50 +2591,29 @@ simplified Chinese (zh_CN), and traditional Chinese (zh_TW).
=item B<-repository> I<url|path>
Specify the package repository to be used as the source of the
-installation, either a local directory via C</path/to/directory> or a
-C<file:/> url, or a network location. See L</SUPPORTED URL SCHEMATA>
-for details.
+installation. In short, this can be a directory name or a url using
+http(s), ftp, or scp. The documentation for C<tlmgr> has the details
+(L<http://tug.org/texlive/doc/install-tl.html#OPTIONS>).
-The default is to pick a mirror automatically, using
+For installation, the default is to pick a mirror automatically, using
L<http://mirror.ctan.org/systems/texlive/tlnet>; the chosen mirror is
-used for the entire download. You can use the special argument C<ctan>
-as an abbreviation for this. See L<http://ctan.org> for more about CTAN
-and its mirrors.
-
-If the repository is on the network, trailing C</> characters and/or
-trailing C</tlpkg> and C</archive> components are ignored. For example,
-you could choose a particular CTAN mirror with something like this:
-
- -repository http://ctan.example.org/its/ctan/dir/systems/texlive/tlnet
-
-Of course a real hostname and its particular top-level CTAN directory
-have to be specified. The list of CTAN mirrors is available at
-L<http://ctan.org/mirrors>.
-
-If the repository is local, the installation type (compressed or live) is
-automatically determined, by checking for the presence of a
-C<archive> directory relative to the root. Compressed is
-preferred if both are available, since it is faster. Here's an example
-of using a local directory:
-
- -repository /local/TL/repository
+used for the entire download. You can use the special argument C<ctan>
+as an abbreviation for this. (See L<http://ctan.org> for more about CTAN
+and its mirrors.)
After installation is complete, you can use that installation as the
repository for another installation. If you chose to install less than
the full scheme containing all packages, the list of available schemes
will be adjusted accordingly.
-For backward compatibility and convenience, C<--location> and C<--repo>
-are accepted as aliases for this option.
-
=item B<-select-repository>
-This option allows manual selection of a mirror from the current list of
-active CTAN mirrors. This option is supported in all installer modes
-(text, wizard, perltk), and will also offer to install from local media
-if available, or from a repository specified on the command line (see
-above). It's useful when the (default) automatic redirection does not
-choose a good host for you.
+This option allows you to choose a particular mirror from the current
+list of active CTAN mirrors. This option is supported in all installer
+modes (text, wizard, perltk), and will also offer to install from local
+media if available, or from a repository specified on the command line.
+It's useful when the (default) automatic redirection does not choose a
+good host for you.
=item B<-all-options>
@@ -2658,9 +2640,9 @@ building TeX Live, see L<http://tug.org/texlive/build.html>.
=item B<-debug-translation>
-In GUI mode, this switch makes C<tlmgr> report any missing, or more
-likely untranslated, messages to standard error. Helpful for
-translators to see what remains to be done.
+In GUI mode, this options reports any missing, or more likely
+untranslated, messages to standard error. Helpful for translators to see
+what remains to be done.
=item B<-force-platform> I<platform>
@@ -2670,12 +2652,12 @@ runnable, or installation will fail. C<-force-arch> is a synonym.
=item B<-help>, B<--help>, B<-?>
-Display this help and exit. (This help is on the web at
-L<http://tug.org/texlive/doc/install-tl.html>). Sometimes the
-C<perldoc> and/or C<PAGER> programs on the system have problems,
-possibly resulting in control characters being literally output. This
-can't always be detected, but you can set the C<NOPERLDOC> environment
-variable and C<perldoc> will not be used.
+Display this help and exit. (This help is also on the web at
+L<http://tug.org/texlive/doc/install-tl.html>). Sometimes the C<perldoc>
+and/or C<PAGER> programs on the system have problems, possibly resulting
+in control characters being literally output. This can't always be
+detected, but you can set the C<NOPERLDOC> environment variable and
+C<perldoc> will not be used.
=item B<-in-place>
@@ -2708,14 +2690,10 @@ release.
For the text mode installer only: do not clear the screen when entering
a new menu (for debugging purposes).
-=item B<-non-admin>
-
-For Windows only: configure for the current user, not for all users.
+=item B<-no-persistent-downloads>
=item B<-persistent-downloads>
-=item B<-no-persistent-downloads>
-
For network installs, activating this option makes the installer try to
set up a persistent connection using the C<Net::LWP> Perl module. This
opens only one connection between your computer and the server per
@@ -2734,6 +2712,10 @@ verification. The full description is in the Crytographic Verification
section of the C<tlmgr> documentation, e.g.,
L<http://tug.org/texlive/doc/tlmgr.html#CRYPTOGRAPHIC-VERIFICATION>
+=item B<-non-admin>
+
+For Windows only: configure for the current user, not for all users.
+
=item B<-portable>
Install for portable use, e.g., on a USB stick. Also selectable from
@@ -2771,8 +2753,8 @@ Include verbose debugging messages; repeat for maximum debugging: C<-v
=item B<-version>, B<--version>
-Output version information and exit. If C<-v> has also been given the
-revisions of the used modules are reported, too.
+Output version information and exit. If C<-v> is also given, the
+versions of the TeX Live modules used are also reported.
=back
@@ -2907,45 +2889,11 @@ written, the names above are always used.
For more details on all of the above options, consult the TeX Live
installation manual, linked from L<http://tug.org/texlive/doc>.
-=head1 SUPPORTED URL SCHEMATA
-
-The following URL schemata are supported
-
-=over 4
-
-=item C<http://server/path/to/tlnet>
-
-Standard schema, is supported without any restrictions. If the (default)
-LWP method is used, this schema supports persistent connections.
-
-=item C<ftp://server/path/to/tlnet>
-
-If the (default) LWP method is used, this schema supports persistent connections.
-
-=item C<https://server/path/to/tlnet>
-
-If the (default) LWP method is used, this schema supports persistent connections.
-Some versions of C<wget> do not support this schema. Furthermore, even if
-C<wget> supports https, it might check the certificate. C<curl> generally
-supports https.
-
-=item C<user@machine:/path/to/tlnet>
-
-=item C<scp://user@machine/path/to/tlnet>
-
-=item C<ssh://user@machine/path/to/tlnet>
-
-These schemata use C<scp> to transfer files. The use of an C<ssh-agent>
-is highly recommended.
-
-=back
-
-
=head1 ENVIRONMENT VARIABLES
-For ease in scripting and debugging, C<install-tl> will look for the
-following environment variables. They are not of interest for normal
+For ease in scripting and debugging, C<install-tl> looks for the
+following environment variables. They are not of interest for normal
user installations.
=over 4
@@ -2956,40 +2904,9 @@ user installations.
=item C<TL_DOWNLOAD_ARGS>
-These options allow selecting different download programs then the ones
-automatically selected by the installer. The order of selection is:
-
-=over 8
-
-=item 1.
-
-If the environment variable C<TEXLIVE_DOWNLOADER> is
-defined, use it; abort if the specified program doesn't work.
-Possible values: C<curl>, C<wget>.
-
-=item 2.
-
-If the environment variable C<TL_DOWNLOAD_PROGRAM> is
-defined (can be any value), use it together with
-C<TL_DOWNLOAD_ARGS>; abort if it doesn't work.
-
-=item 3.
-
-If LWP is available and working, use that (by far the most
-efficient method, as it supports persistent downloads).
-
-=item 4.
-
-If curl is available (from the system) and working, use that.
-
-=item 5.
-
-If wget is available (either from the system or TL) and working, use that.
-
-=back
-
-TL still provides C<wget> binaries for some platforms, so
-some download method should always be available.
+These override the normal choice of a download program; see the C<tlmgr>
+documentation, e.g.,
+L<http://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES>.
=item C<TEXLIVE_INSTALL_ENV_NOCHECK>
@@ -3004,7 +2921,7 @@ Omit creating the ConTeXt cache. This is useful for redistributors.
=item C<TEXLIVE_INSTALL_NO_WELCOME>
Omit printing the welcome message after successful installation, e.g.,
-for testing.
+when testing.
=item C<TEXLIVE_INSTALL_PREFIX>
diff --git a/Master/texmf-dist/scripts/texlive/tlmgr.pl b/Master/texmf-dist/scripts/texlive/tlmgr.pl
index 2160de025e4..d0fd67f9d20 100755
--- a/Master/texmf-dist/scripts/texlive/tlmgr.pl
+++ b/Master/texmf-dist/scripts/texlive/tlmgr.pl
@@ -7457,21 +7457,88 @@ between an option name and its value.
=item B<--repository> I<url|path>
-Specifies the package repository from which packages should be installed
-or updated, overriding the default package repository found in the
-installation's TeX Live Package Database (a.k.a. the TLPDB, defined
-entirely in the file C<tlpkg/texlive.tlpdb>). The documentation for
-C<install-tl> has more details about this
-(L<http://tug.org/texlive/doc/install-tl.html>).
-
-C<--repository> changes the repository location only for the current
+Specify the package repository from which packages should be installed
+or updated, either a local directory or network location, as below. This
+overridesthe default package repository found in the installation's TeX
+Live Package Database (a.k.a. the TLPDB, which is given entirely in the
+file C<tlpkg/texlive.tlpdb>).
+
+This C<--repository> option changes the location only for the current
run; to make a permanent change, use C<option repository> (see the
L</option> action).
+As an example, you can choose a particular CTAN mirror with something
+like this:
+
+ -repository http://ctan.example.org/its/ctan/dir/systems/texlive/tlnet
+
+Of course a real hostname and its particular top-level CTAN directory
+have to be specified. The list of CTAN mirrors is available at
+L<http://ctan.org/mirrors>.
+
+Here's an example of using a local directory:
+
+ -repository /local/TL/repository
+
For backward compatibility and convenience, C<--location> and C<--repo>
are accepted as aliases for this option.
-See L</SUPPORTED URL SCHEMATA> for details on the supported schemata.
+Locations can be specified as any of the following:
+
+=over 4
+
+=item C</some/local/dir>
+
+=item C<file:/some/local/dir>
+
+Equivalent ways of specifying a local directory.
+
+=item C<ctan>
+
+=item C<http://mirror.ctan.org/systems/texlive/tlnet>
+
+Pick a CTAN mirror automatically, trying for one that is both nearby and
+up-to-date. The chosen mirror is used for the entire download. The bare
+C<ctan> is merely an alias for the full url. (See L<http://ctan.org> for
+more about CTAN and its mirrors.)
+
+=item C<http://server/path/to/tlnet>
+
+Standard HTTP. If the (default) LWP method is used, persistent
+connections are supported. TL can also use C<curl> or C<wget> to do the
+downloads, or an arbitrary user-specified program, as described in the
+C<tlmgr> documentation
+(L<http://tug.org/texlive/doc/tlmgr.html#ENVIRONMENT-VARIABLES>).
+
+=item C<https://server/path/to/tlnet>
+
+Again, if the (default) LWP method is used, this supports persistent
+connections. Unfortunately, some versions of C<wget> and C<curl> do not
+support https, and even when C<wget> supports https, certificates may be
+rejected even when the certificate is fine, due to a lack of local
+certificate roots. The simplest workaround for this problem is to use
+http or ftp.
+
+=item C<ftp://server/path/to/tlnet>
+
+If the (default) LWP method is used, persistent connections are
+supported.
+
+=item C<user@machine:/path/to/tlnet>
+
+=item C<scp://user@machine/path/to/tlnet>
+
+=item C<ssh://user@machine/path/to/tlnet>
+
+These forms are equivalent; they all use C<scp> to transfer files. Using
+C<ssh-agent> is recommended. (Info:
+L<https://en.wikipedia.org/wiki/OpenSSH>,
+L<https://en.wikipedia.org/wiki/Ssh-agent>.)
+
+=back
+
+If the repository is on the network, trailing C</> characters and/or
+trailing C</tlpkg> and/or C</archive> components are ignored.
=item B<--gui> [I<action>]
@@ -9534,44 +9601,13 @@ If a value is not saved in the database the string C<(not set)> is shown.
If you are developing a program that uses this output, and find that
changes would be helpful, do not hesitate to write the mailing list.
-=head1 SUPPORTED URL SCHEMATA
-
-The following URL schemata are supported
-
-=over 4
-
-=item C<http://server/path/to/tlnet>
-
-Standard schema, is supported without any restrictions. If the (default)
-LWP method is used, this schema supports persistent connections.
-
-=item C<ftp://server/path/to/tlnet>
-
-If the (default) LWP method is used, this schema supports persistent connections.
-
-=item C<https://server/path/to/tlnet>
-
-If the (default) LWP method is used, this schema supports persistent connections.
-Some versions of C<wget> do not support this schema. Furthermore, even if
-C<wget> supports https, it might check the certificate. C<curl> generally
-supports https.
-
-=item C<user@machine:/path/to/tlnet>
-
-=item C<scp://user@machine/path/to/tlnet>
-
-=item C<ssh://user@machine/path/to/tlnet>
-
-These schemata use C<scp> to transfer files. The use of an C<ssh-agent>
-is highly recommended.
-
-=back
-
-
=head1 ENVIRONMENT VARIABLES
-For ease in scripting and debugging, C<install-tl> will look for the
-following environment variables. They are not of interest for normal
+C<tlmgr> uses many of the standard TeX environment variables, as
+reported by, e.g., C<tlmgr conf> (L</conf>).
+
+In addition, for ease in scripting and debugging, C<tlmgr> looks for the
+following environment variables. These are not of interest for normal
user installations.
=over 4
@@ -9587,8 +9623,7 @@ backups and intermediate rollback containers. The order of selection is:
If the environment variable C<TEXLIVE_COMPRESSOR> is
defined, use it; abort if it doesn't work. Possible values:
-C<lz4>, C<gzip>, C<xz>.
-
+C<lz4>, C<gzip>, C<xz>. The necessary options are added internally.
=item 2.
@@ -9623,7 +9658,8 @@ automatically selected by the installer. The order of selection is:
If the environment variable C<TEXLIVE_DOWNLOADER> is
defined, use it; abort if the specified program doesn't work.
-Possible values: C<curl>, C<wget>.
+Possible values: C<curl>, C<wget>. The necessary options are added
+internally.
=item 2.
diff --git a/Master/tlpkg/TeXLive/TLCrypto.pm b/Master/tlpkg/TeXLive/TLCrypto.pm
index a663b5e11f6..07b67ad6654 100644
--- a/Master/tlpkg/TeXLive/TLCrypto.pm
+++ b/Master/tlpkg/TeXLive/TLCrypto.pm
@@ -9,8 +9,8 @@ package TeXLive::TLCrypto;
use Digest::MD5;
use TeXLive::TLConfig;
-use TeXLive::TLUtils qw(debug ddebug win32 which platform conv_to_w32_path tlwarn tldie);
-
+use TeXLive::TLUtils qw(debug ddebug win32 which platform
+ conv_to_w32_path tlwarn tldie);
my $svnrev = '$Revision$';
my $_modulerevision = ($svnrev =~ m/: ([0-9]+) /) ? $1 : "unknown";
diff --git a/Master/tlpkg/TeXLive/TLTREE.pm b/Master/tlpkg/TeXLive/TLTREE.pm
index 09599571ac1..5b67de191d1 100644
--- a/Master/tlpkg/TeXLive/TLTREE.pm
+++ b/Master/tlpkg/TeXLive/TLTREE.pm
@@ -13,9 +13,7 @@ if ($svnrev =~ m/: ([0-9]+) /) {
} else {
$_modulerevision = "unknown";
}
-sub module_revision {
- return $_modulerevision;
-}
+sub module_revision { return $_modulerevision; }
use TeXLive::TLUtils;
diff --git a/Master/tlpkg/TeXLive/TLWinGoo.pm b/Master/tlpkg/TeXLive/TLWinGoo.pm
index f652172bdab..232a4099e1a 100644
--- a/Master/tlpkg/TeXLive/TLWinGoo.pm
+++ b/Master/tlpkg/TeXLive/TLWinGoo.pm
@@ -18,9 +18,7 @@ if ($svnrev =~ m/: ([0-9]+) /) {
} else {
$_modulerevision = "unknown";
}
-sub module_revision {
- return $_modulerevision;
-}
+sub module_revision { return $_modulerevision; }
=pod