diff options
author | Karl Berry <karl@freefriends.org> | 2009-08-26 01:27:36 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2009-08-26 01:27:36 +0000 |
commit | aaee878a1d8923ebbf68dbb6b14e5cbc04565f9f (patch) | |
tree | 72472ccd1ea8792c53ab69cf70b954b737cc4522 /Master | |
parent | cbe6a77d73a6e63c437a7d7deda8c686a206f08c (diff) |
/home/texlive/karl/Master/tlpkg/bin/tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@14861 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
-rw-r--r-- | Master/readme-txt.dir/README.EN | 89 | ||||
-rw-r--r-- | Master/texmf/doc/man/man1/install-tl.1 | 26 | ||||
-rw-r--r-- | Master/texmf/doc/man/man1/install-tl.pdf | bin | 14252 -> 14322 bytes | |||
-rw-r--r-- | Master/texmf/doc/man/man1/tlmgr.1 | 58 | ||||
-rw-r--r-- | Master/texmf/doc/man/man1/tlmgr.pdf | bin | 41300 -> 42397 bytes |
5 files changed, 56 insertions, 117 deletions
diff --git a/Master/readme-txt.dir/README.EN b/Master/readme-txt.dir/README.EN index 86e4ec2e22e..e69de29bb2d 100644 --- a/Master/readme-txt.dir/README.EN +++ b/Master/readme-txt.dir/README.EN @@ -1,89 +0,0 @@ - -Welcome to TeX Live - - The TeX Live software distribution offers a complete TeX system for a - variety of Unix, Macintosh, Windows and other platforms. It - encompasses programs for editing, typesetting, previewing and printing - of TeX documents in many different languages, and a large collection - of TeX macros and font libraries. - - The distribution includes extensive general documentation about TeX, - as well as the documentation for the included software packages. - - For licensing information, please see the top-level [1]LICENSE.TL and - [2]LICENSE.CTAN text files. - - Where to start - - We strongly recommend that you read the TeX Live Guide before - undertaking the installation. It includes step-by-step instructions, a - description of the top-level directories, and more. - - English versions of the Guide are in the full distribution (for - example, on the DVD) in the [3]texmf-doc/doc/english/ hierarchy, in - both [4]html and [5]pdf formats. Translations to other languages are - also available under [6]texmf-doc/doc/*. - - We also provide a list of [7]links to the available PDF and HTML - documentation for the included packages and programs. - - If you are installing from the Internet, the above links won't work. - In that case, you can view the [8]TeX Live documentation on the - Internet. - - For a list of the most important changes in this year's release, see - the Release history section at the end of the documentation. - - Installation - - The installation script is now named install-tl (that's install-tl.bat - on Windows), and it has both GUI (default on Windows) and text - (default on everything else) operation modes. You can force one or the - other with the options -gui and -no-gui, respectively. - - Post-installation package updates and other configurations are now - performed with the tlmgr (TeX Live Package Manager) script, which - likewise has both GUI and text modes. - - You can give the command-line option --help to both install-tl and - tlmgr for an overview. See the documentation links above for (much) - more information. - - Links - - Finally, a few related web pages, for your reference. These are not - included in TeX Live: - - * [9]http://tug.org/begin.html - if you are new to TeX and/or want - introductory material. - * [10]http://tug.org/interest.html - general list of TeX web - resources, including documentation, systems, packages, fonts, and - more. - * [11]http://tug.org/ctan.html - one entry point into the - Comprehensive TeX Archive Network (CTAN), which is an online - repository of all things TeX. - * [12]http://tug.org/usergroups.html - list of TeX user groups - around the world, with contact information. We strongly encourage - you to join the user group of your choice, to support TeX Live and - other TeX activities. - - Happy TeXing! - _________________________________________________________________ - - [13]TeX Live home page. - -References - - 1. file:LICENSE.TL - 2. file:LICENSE.CTAN - 3. file:texmf-doc/doc/english - 4. file:texmf-doc/doc/english/texlive-en/texlive-en.html - 5. file:texmf-doc/doc/english/texlive-en/texlive-en.pdf - 6. file:texmf-doc/doc/ - 7. file:doc.html - 8. http://tug.org/texlive/doc.html - 9. http://tug.org/begin.html - 10. http://tug.org/interest.html - 11. http://tug.org/ctan.html - 12. http://tug.org/usergroups.html - 13. http://tug.org/texlive/ diff --git a/Master/texmf/doc/man/man1/install-tl.1 b/Master/texmf/doc/man/man1/install-tl.1 index 5cd46795ac4..42eac4f17c5 100644 --- a/Master/texmf/doc/man/man1/install-tl.1 +++ b/Master/texmf/doc/man/man1/install-tl.1 @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "INSTALL-TL 1" -.TH INSTALL-TL 1 "2009-08-22" "perl v5.8.8" "User Contributed Perl Documentation" +.TH INSTALL-TL 1 "2009-08-25" "perl v5.8.8" "User Contributed Perl Documentation" .SH "NAME" install\-tl \- TeX Live cross\-platform installer .SH "SYNOPSIS" @@ -193,28 +193,32 @@ languages: English (en, default), Czech (cs), German (de), French (fr), Italian (it), Dutch (nl), Polish (pl), Russian (ru), Slovak (sk), Slovenian (sl), Vietnamese (vi), simplified Chinese (zh\-cn), and traditional Chinese (zh\-tw). +.IP "\fB\-repo[sitory]\fR \fIurl|path\fR" 4 +.IX Item "-repo[sitory] url|path" +.PD 0 .IP "\fB\-location\fR \fIurl|path\fR" 4 .IX Item "-location url|path" -Provide an installation source, 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. +.PD +Provide the package repository as installation source, 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. .Sp -If the location is local, the installation type (compressed or live) is +If the repository is local, the installation type (compressed or live) is automatically determined, by checking for the presence of a \&\f(CW\*(C`archive\*(C'\fR 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: .Sp .Vb 1 -\& -location /local/TL/repository/copy +\& -repository /local/TL/repository/copy .Ve .Sp -If the location is on the network, trailing \f(CW\*(C`/\*(C'\fR characters and/or +If the repository is on the network, trailing \f(CW\*(C`/\*(C'\fR characters and/or trailing \f(CW\*(C`/tlpkg\*(C'\fR and \f(CW\*(C`/archive\*(C'\fR components are ignored. For example, you could choose a particular \s-1CTAN\s0 mirror with something like this: .Sp .Vb 1 -\& -location http://mirror.example.org/its/path/to/ctan/texlive/tlnet +\& -repository http://mirror.example.org/its/path/to/ctan/texlive/tlnet .Ve .Sp Of course a proper hostname and its particular top-level \s-1CTAN\s0 path @@ -223,12 +227,12 @@ have to be specified. The list of \s-1CTAN\s0 mirrors is available at .Sp The default is to pick a mirror automatically, using <http://mirror.ctan.org/systems/texlive/tlnet>; the chosen mirror is -used for the entire download. You can use the special location name +used for the entire download. You can use the special repository name \&\f(CW\*(C`ctan\*(C'\fR as an abbreviation for this. See <http://ctan.org> for more about \s-1CTAN\s0 and its mirrors. .Sp After installation is complete, you can use that installation as the -location for another installation. If you chose to install less than +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. .IP "\fB\-no\-cls\fR" 4 @@ -283,7 +287,7 @@ default is to use the \f(CW\*(C`full\*(C'\fR scheme, which includes everything. option overrides that default. You can change the scheme again before the actual installation with the usual menu. The \fIscheme\fR argument may optionally have a prefix \f(CW\*(C`scheme\-\*(C'\fR. The list of supported scheme names -depends on what your installation location provides; see the interactive +depends on what your package repository provides; see the interactive menu list. .IP "\fB\-custom\-bin\fR \fIpath\fR" 4 .IX Item "-custom-bin path" diff --git a/Master/texmf/doc/man/man1/install-tl.pdf b/Master/texmf/doc/man/man1/install-tl.pdf Binary files differindex b8938e8163a..b939ff66ffd 100644 --- a/Master/texmf/doc/man/man1/install-tl.pdf +++ b/Master/texmf/doc/man/man1/install-tl.pdf diff --git a/Master/texmf/doc/man/man1/tlmgr.1 b/Master/texmf/doc/man/man1/tlmgr.1 index 7ba3e8ab076..b8f5e71d357 100644 --- a/Master/texmf/doc/man/man1/tlmgr.1 +++ b/Master/texmf/doc/man/man1/tlmgr.1 @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "TLMGR 1" -.TH TLMGR 1 "2009-08-24" "perl v5.8.8" "User Contributed Perl Documentation" +.TH TLMGR 1 "2009-08-25" "perl v5.8.8" "User Contributed Perl Documentation" .SH "NAME" tlmgr \- the TeX Live Manager .SH "SYNOPSIS" @@ -154,12 +154,16 @@ non-option argument will be the main action. In all cases, \f(CW\*(C`\-\-\*(C'\fR\fIoption\fR and \&\f(CW\*(C`\-\*(C'\fR\fIoption\fR are equivalent, and an \f(CW\*(C`=\*(C'\fR is optional between an option name and its value. -.IP "\fB\-\-location\fR \fIlocation\fR" 4 -.IX Item "--location location" -Specifies the location from which packages should be installed or -updated, overriding the location found in the installation's TeX Live -Package Database (\s-1TLPDB\s0). The documentation for \f(CW\*(C`install\-tl\*(C'\fR has more -details about this. +.IP "\fB\-\-repo[sitory]\fR \fIurl|path\fR" 4 +.IX Item "--repo[sitory] url|path" +.PD 0 +.IP "\fB\-\-location\fR \fIurl|path\fR" 4 +.IX Item "--location url|path" +.PD +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 (\s-1TLPDB\s0). +The documentation for \f(CW\*(C`install\-tl\*(C'\fR has more details about this. .IP "\fB\-\-gui\fR [\fIaction\fR]" 4 .IX Item "--gui [action]" You can give this option together with an action to be brought directly @@ -488,7 +492,7 @@ Possible values for \fIkey\fR are (but see \fBtlmgr option showall\fR for the definitive list): .PP .Vb 9 -\& location (default installation source), +\& location (default package repository), \& formats (create formats at installation time), \& docfiles (install documentation files), \& srcfiles (install source files), @@ -620,7 +624,7 @@ those extra settings at present. .Sh "arch list|add|remove \fIarch\fP..." .IX Subsection "arch list|add|remove arch..." \&\f(CW\*(C`arch list\*(C'\fR lists the TeX Live names of all the architectures -(\f(CW\*(C`i386\-linux\*(C'\fR, ...) available at the default install location. +(\f(CW\*(C`i386\-linux\*(C'\fR, ...) available at the package repository. .PP \&\f(CW\*(C`arch add\*(C'\fR \fIarch\fR... adds the executables for each given architecture \&\fIarch\fR to the installation. @@ -661,8 +665,8 @@ dependencies. When given with schemes and collections, \f(CW\*(C`\-\-list\*(C'\ outputs their dependencies in a similar way. .Sh "list [\-\-only\-installed] [collections|schemes|\fIpkg\fP...]" .IX Subsection "list [--only-installed] [collections|schemes|pkg...]" -With no argument, lists all packages available at the default install -location, prefixing those already installed with \f(CW\*(C`i\*(C'\fR. +With no argument, lists all packages available at the package repository, +prefixing those already installed with \f(CW\*(C`i\*(C'\fR. .PP With the single word \f(CW\*(C`collections\*(C'\fR or \f(CW\*(C`schemes\*(C'\fR as the argument, lists the request type. @@ -819,13 +823,16 @@ messages for human consumption are written to stderr (normally they are written to stdout). The idea is that a program can get all the information it needs by reading stdout. .PP -Currently this option only applies to the update action. The output format is as follows: +Currently this option only applies to the +update and +install actions. +The output format is as follows: .PP .Vb 7 \& fieldname "\et" value \& ... \& "end-of-header" -\& pkgname status localrev serverrev size +\& pkgname status localrev serverrev size estrem esttot \& ... \& "end-of-updates" \& other output from post actions, not in machine readable form @@ -836,18 +843,20 @@ repository source from which updates are being drawn), and \&\f(CW\*(C`total\-bytes\*(C'\fR (the total number of bytes to be downloaded). .PP The \fIlocalrev\fR and \fIserverrev\fR fields for each package are the -revision numbers in the location installation and server repository, +revision numbers in the local installation and server repository, respectively. The \fIsize\fR field is the number of bytes to be downloaded, i.e., the size of the compressed tar file for a network -installation, not the unpacked size. +installation, not the unpacked size. The estrem and esttot fields +are only present for updated and auto-install packages, and contain +the estimated remaining time and the estimated total time. .PP Line endings may be either \s-1LF\s0 or \s-1CRLF\s0 depending on the current platform. .ie n .IP """location\-url""\fR \fIlocation" 4 .el .IP "\f(CWlocation\-url\fR \fIlocation\fR" 4 .IX Item "location-url location" The \fIlocation\fR may be a url (including \f(CW\*(C`file:///foo/bar/...\*(C'\fR), or a -directory name (\f(CW\*(C`/foo/bar\*(C'\fR). It is the server repository from which -the new package information was drawn. +directory name (\f(CW\*(C`/foo/bar\*(C'\fR). It is the use package repository +from which the new package information was drawn. .ie n .IP """total\-bytes""\fR \fIcount" 4 .el .IP "\f(CWtotal\-bytes\fR \fIcount\fR" 4 .IX Item "total-bytes count" @@ -892,6 +901,15 @@ version on the server. .IX Item "a" Automatically-determined need for installation, the package is new on the server and is (most probably) part of an installed collection. +.ie n .IP """i""" 8 +.el .IP "\f(CWi\fR" 8 +.IX Item "i" +Package will be installed and isn't present in the local installation +(action install). +.ie n .IP """I""" 8 +.el .IP "\f(CWI\fR" 8 +.IX Item "I" +Package is already present but will be reinstalled (action install). .RE .RS 4 .RE @@ -907,6 +925,12 @@ present on the server. .IX Item "size" The size in bytes of the package on the server. The sum of all the package sizes is given in the \f(CW\*(C`total\-bytes\*(C'\fR header field mentioned above. +.IP "\fIestrem\fR" 4 +.IX Item "estrem" +The estimated remaining time. +.IP "\fIesttot\fR" 4 +.IX Item "esttot" +The estimated total time. .PP 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. diff --git a/Master/texmf/doc/man/man1/tlmgr.pdf b/Master/texmf/doc/man/man1/tlmgr.pdf Binary files differindex 5057a2fac00..ad94449fe21 100644 --- a/Master/texmf/doc/man/man1/tlmgr.pdf +++ b/Master/texmf/doc/man/man1/tlmgr.pdf |