summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/texlive
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-06-08 23:48:55 +0000
committerKarl Berry <karl@freefriends.org>2021-06-08 23:48:55 +0000
commit8541f6b3be04738924af433edaf22d063f36c465 (patch)
treec73512420e16b0d2780ce658bf43f1d65e777001 /Master/texmf-dist/doc/texlive
parent6eb49cde21f14581e57af90600b013bdbd2baa03 (diff)
tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@59528 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/texlive')
-rw-r--r--Master/texmf-dist/doc/texlive/install-tl.html46
-rw-r--r--Master/texmf-dist/doc/texlive/tlmgr.html138
2 files changed, 92 insertions, 92 deletions
diff --git a/Master/texmf-dist/doc/texlive/install-tl.html b/Master/texmf-dist/doc/texlive/install-tl.html
index f432abaa95c..3b613e5a9c1 100644
--- a/Master/texmf-dist/doc/texlive/install-tl.html
+++ b/Master/texmf-dist/doc/texlive/install-tl.html
@@ -256,7 +256,7 @@
<p>For example, a line</p>
-<pre><code> selected_scheme scheme-small</code></pre>
+<pre><code>selected_scheme scheme-small</code></pre>
<p>along with definitions for the installation directories (given below under &quot;path options&quot;) suffices to install the &quot;small&quot; scheme with all default options. The schemes are described in the <code>S</code> menu in the text installer, or equivalent.</p>
@@ -272,13 +272,13 @@
<p>It is best to define all of these, even though they may not be used in the installation, so as to avoid unintentionally getting a default value that could cause problems later.</p>
-<pre><code> TEXDIR
- TEXMFCONFIG
- TEXMFVAR
- TEXMFHOME
- TEXMFLOCAL
- TEXMFSYSCONFIG
- TEXMFSYSVAR</code></pre>
+<pre><code>TEXDIR
+TEXMFCONFIG
+TEXMFVAR
+TEXMFHOME
+TEXMFLOCAL
+TEXMFSYSCONFIG
+TEXMFSYSVAR</code></pre>
<p><b>installer options</b> (prefix <code>instopt_</code>)</p>
@@ -320,25 +320,25 @@
<p>The definitive list is given in <code>tlpkg/TeXLive/TLConfig.pm</code>, in the hash <code>%TeXLive::TLConfig::TLPDBOptions</code>, together with explanations. All items given there <i>except</i> for <code>tlpdbopt_location</code> can be specified. Here is the current list:</p>
-<pre><code> tlpdbopt_autobackup
- tlpdbopt_backupdir
- tlpdbopt_create_formats
- tlpdbopt_desktop_integration
- tlpdbopt_file_assocs
- tlpdbopt_generate_updmap
- tlpdbopt_install_docfiles
- tlpdbopt_install_srcfiles
- tlpdbopt_post_code
- tlpdbopt_sys_bin
- tlpdbopt_sys_info
- tlpdbopt_sys_man
- tlpdbopt_w32_multi_user</code></pre>
+<pre><code>tlpdbopt_autobackup
+tlpdbopt_backupdir
+tlpdbopt_create_formats
+tlpdbopt_desktop_integration
+tlpdbopt_file_assocs
+tlpdbopt_generate_updmap
+tlpdbopt_install_docfiles
+tlpdbopt_install_srcfiles
+tlpdbopt_post_code
+tlpdbopt_sys_bin
+tlpdbopt_sys_info
+tlpdbopt_sys_man
+tlpdbopt_w32_multi_user</code></pre>
<p><b>platform options</b> (prefix <code>binary_</code>)</p>
<p>For each supported platform in TeX Live (directories under <code>bin/</code>), the variable <code>binary_</code><i>PLATFORM</i> can be set with value 1. For example:</p>
-<pre><code> binary_x86_64-linux 1</code></pre>
+<pre><code>binary_x86_64-linux 1</code></pre>
<p>If no <code>binary_</code> settings are made, the default is whatever the current machine is running.</p>
@@ -442,7 +442,7 @@
<p>This script and its documentation were written for the TeX Live distribution (<a href="https://tug.org/texlive">https://tug.org/texlive</a>) and both are licensed under the GNU General Public License Version 2 or later.</p>
-<p>$Id: install-tl 58931 2021-04-20 22:20:56Z karl $</p>
+<p>$Id: install-tl 59056 2021-05-02 21:48:01Z karl $</p>
</body>
diff --git a/Master/texmf-dist/doc/texlive/tlmgr.html b/Master/texmf-dist/doc/texlive/tlmgr.html
index 3d30c43e6d8..1a362d2ea8f 100644
--- a/Master/texmf-dist/doc/texlive/tlmgr.html
+++ b/Master/texmf-dist/doc/texlive/tlmgr.html
@@ -165,13 +165,13 @@
<p>As an example, you can choose a particular CTAN mirror with something like this:</p>
-<pre><code> -repository http://ctan.example.org/its/ctan/dir/systems/texlive/tlnet</code></pre>
+<pre><code>-repository http://ctan.example.org/its/ctan/dir/systems/texlive/tlnet</code></pre>
<p>Of course a real hostname and its particular top-level CTAN directory have to be specified. The list of CTAN mirrors is available at <a href="https://ctan.org/mirrors/mirmon">https://ctan.org/mirrors/mirmon</a>.</p>
<p>Here&#39;s an example of using a local directory:</p>
-<pre><code> -repository /local/TL/repository</code></pre>
+<pre><code>-repository /local/TL/repository</code></pre>
<p>For backward compatibility and convenience, <code>--location</code> and <code>--repo</code> are accepted as aliases for this option.</p>
@@ -243,7 +243,7 @@
<p><code>tlmgr</code> itself has a graphical interface as well as the command line interface. You can give the option to invoke it, <code>--gui</code>, together with an action to be brought directly into the respective screen of the GUI. For example, running</p>
-<pre><code> tlmgr --gui update</code></pre>
+<pre><code>tlmgr --gui update</code></pre>
<p>starts you directly at the update screen. If no action is given, the GUI will be started at the main screen. See <a href="#GUI-FOR-TLMGR">&quot;GUI FOR TLMGR&quot;</a>.</p>
@@ -495,12 +495,12 @@
<p>Here is a practical example of changing configuration values. If the execution of (some or all) system commands via <code>\write18</code> was left enabled during installation, you can disable it afterwards:</p>
-<pre><code> tlmgr conf texmf shell_escape 0</code></pre>
+<pre><code>tlmgr conf texmf shell_escape 0</code></pre>
<p>The subcommand <code>auxtrees</code> allows adding and removing arbitrary additional texmf trees, completely under user control. <code>auxtrees show</code> shows the list of additional trees, <code>auxtrees add</code> <i>tree</i> adds a tree to the list, and <code>auxtrees remove</code> <i>tree</i> removes a tree from the list (if present). The trees should not contain an <code>ls-R</code> file (or files will not be found if the <code>ls-R</code> becomes stale). This works by manipulating the Kpathsea variable <code>TEXMFAUXTREES</code>, in (by default) <code>ROOT/texmf.cnf</code>. Example:</p>
-<pre><code> tlmgr conf auxtrees add /quick/test/tree
- tlmgr conf auxtrees remove /quick/test/tree</code></pre>
+<pre><code>tlmgr conf auxtrees add /quick/test/tree
+tlmgr conf auxtrees remove /quick/test/tree</code></pre>
<p>In all cases the configuration file can be explicitly specified via the option <code>--conffile</code> <i>file</i>, e.g., if you don&#39;t want to change the system-wide configuration.</p>
@@ -541,7 +541,7 @@
<p>In either case, the first line of the output specifies the repository location, in this format:</p>
-<pre><code> &quot;location-url&quot; &quot;\t&quot; location</code></pre>
+<pre><code>&quot;location-url&quot; &quot;\t&quot; location</code></pre>
<p>where <code>location-url</code> is the literal field name, followed by a tab, and <i>location</i> is the file or url to the repository.</p>
@@ -583,13 +583,13 @@
<p>Local files specify entries to be disabled with a comment line, namely one of these:</p>
-<pre><code> %!NAME
- --!NAME</code></pre>
+<pre><code>%!NAME
+--!NAME</code></pre>
<p>where <code>language.dat</code> and <code>language.def</code> use <code>%</code>, and <code>language.dat.lua</code> use <code>--</code>. In all cases, the <i>name</i> is the respective format name or hyphenation pattern identifier. Examples:</p>
-<pre><code> %!german
- --!usenglishmax</code></pre>
+<pre><code>%!german
+--!usenglishmax</code></pre>
<p>(Of course, you&#39;re not likely to actually want to disable those particular items. They&#39;re just examples.)</p>
@@ -625,9 +625,9 @@
<p>The respective locations are as follows:</p>
-<pre><code> tex/generic/config/language.dat (and language-local.dat)
- tex/generic/config/language.def (and language-local.def)
- tex/generic/config/language.dat.lua (and language-local.dat.lua)</code></pre>
+<pre><code>tex/generic/config/language.dat (and language-local.dat)
+tex/generic/config/language.def (and language-local.def)
+tex/generic/config/language.dat.lua (and language-local.dat.lua)</code></pre>
<h2 id="gui">gui</h2>
@@ -766,7 +766,7 @@
<p>While not recommended, the <code>install-tl</code> program provides an option to omit installation of all documentation and/or source files. (By default, everything is installed.) After such an installation, you may find that you want the documentation or source files for a given package after all. You can get them by using these options in conjunction with <code>--reinstall</code>, as in (using the <code>fontspec</code> package as the example):</p>
-<pre><code> tlmgr install --reinstall --with-doc --with-src fontspec</code></pre>
+<pre><code>tlmgr install --reinstall --with-doc --with-src fontspec</code></pre>
</dd>
</dl>
@@ -831,23 +831,23 @@
<p>Possible values for <i>key</i> are (run <code>tlmgr option showall</code> for the definitive list):</p>
-<pre><code> repository (default package repository),
- formats (generate formats at installation or update time),
- postcode (run postinst code blobs)
- docfiles (install documentation files),
- srcfiles (install source files),
- backupdir (default directory for backups),
- autobackup (number of backups to keep).
- sys_bin (directory to which executables are linked by the path action)
- sys_man (directory to which man pages are linked by the path action)
- sys_info (directory to which Info files are linked by the path action)
- desktop_integration (Windows-only: create Start menu shortcuts)
- fileassocs (Windows-only: change file associations)
- multiuser (Windows-only: install for all users)</code></pre>
+<pre><code>repository (default package repository),
+formats (generate formats at installation or update time),
+postcode (run postinst code blobs)
+docfiles (install documentation files),
+srcfiles (install source files),
+backupdir (default directory for backups),
+autobackup (number of backups to keep).
+sys_bin (directory to which executables are linked by the path action)
+sys_man (directory to which man pages are linked by the path action)
+sys_info (directory to which Info files are linked by the path action)
+desktop_integration (Windows-only: create Start menu shortcuts)
+fileassocs (Windows-only: change file associations)
+multiuser (Windows-only: install for all users)</code></pre>
<p>One common use of <code>option</code> is to permanently change the installation to get further updates from the Internet, after originally installing from DVD. To do this, you can run</p>
-<pre><code> tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet</code></pre>
+<pre><code>tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet</code></pre>
<p>The <code>install-tl</code> documentation has more information about the possible values for <code>repository</code>. (For backward compatibility, <code>location</code> can be used as a synonym for <code>repository</code>.)</p>
@@ -863,7 +863,7 @@
<p>To setup <code>autobackup</code> to <code>-1</code> on the command line, use:</p>
-<pre><code> tlmgr option -- autobackup -1</code></pre>
+<pre><code>tlmgr option -- autobackup -1</code></pre>
<p>The <code>--</code> avoids having the <code>-1</code> treated as an option. (The <code>--</code> stops parsing for options at the point where it appears; this is a general feature across most Unix programs.)</p>
@@ -1378,10 +1378,10 @@
<p>In short:</p>
-<pre><code> tlmgr update --self # update infrastructure only
- tlmgr update --self --all # update infrastructure and all packages
- tlmgr update --force --all # update all packages but *not* infrastructure
- # ... this last at your own risk, not recommended!</code></pre>
+<pre><code>tlmgr update --self # update infrastructure only
+tlmgr update --self --all # update infrastructure and all packages
+tlmgr update --force --all # update all packages but *not* infrastructure
+ # ... this last at your own risk, not recommended!</code></pre>
</dd>
<dt id="dry-run5"><b>--dry-run</b></dt>
@@ -1403,7 +1403,7 @@
<p>An argument <i>pkg</i> excludes both the package <i>pkg</i> itself and all its related platform-specific packages <i>pkg.ARCH</i>. For example,</p>
-<pre><code> tlmgr update --all --exclude a2ping</code></pre>
+<pre><code>tlmgr update --all --exclude a2ping</code></pre>
<p>will not update <code>a2ping</code>, <code>a2ping.i386-linux</code>, or any other <code>a2ping.</code><i>ARCH</i> package.</p>
@@ -1425,12 +1425,12 @@
<p>Furthermore, after the <code>tlmgr</code> run using this has finished, the packages that would have been auto-installed <i>will be considered as forcibly removed</i>. So, if <code>foobar</code> is the only new package on the server, then</p>
-<pre><code> tlmgr update --all --no-auto-install</code></pre>
+<pre><code>tlmgr update --all --no-auto-install</code></pre>
<p>is equivalent to</p>
-<pre><code> tlmgr update --all
- tlmgr remove --force foobar</code></pre>
+<pre><code>tlmgr update --all
+tlmgr remove --force foobar</code></pre>
<p>Again, since packages are sometimes renamed or replaced, using this option is not recommended.</p>
@@ -1442,7 +1442,7 @@
<p>This option makes <code>tlmgr</code> ignore the forcible removals and re-install all such packages. This can be used to completely synchronize an installation with the server&#39;s idea of what is available:</p>
-<pre><code> tlmgr update --reinstall-forcibly-removed --all</code></pre>
+<pre><code>tlmgr update --reinstall-forcibly-removed --all</code></pre>
</dd>
<dt id="backup2"><b>--backup</b></dt>
@@ -1497,7 +1497,7 @@
<p>In these config files, empty lines and lines starting with # are ignored. All other lines must look like:</p>
-<pre><code> key = value</code></pre>
+<pre><code>key = value</code></pre>
<p>where the spaces are optional but the <code>=</code> is required.</p>
@@ -1637,46 +1637,46 @@
<p>First, check that we have support for multiple repositories, and have only one enabled (as is the case by default):</p>
-<pre><code> $ tlmgr repository list
- List of repositories (with tags if set):
- /var/www/norbert/tlnet</code></pre>
+<pre><code>$ tlmgr repository list
+List of repositories (with tags if set):
+ /var/www/norbert/tlnet</code></pre>
<p>Ok. Let&#39;s add the <code>tlcontrib</code> repository (this is a real repository hosted at <a href="http://contrib.texlive.info">http://contrib.texlive.info</a>) with the tag <code>tlcontrib</code>:</p>
-<pre><code> $ tlmgr repository add http://contrib.texlive.info/current tlcontrib</code></pre>
+<pre><code>$ tlmgr repository add http://contrib.texlive.info/current tlcontrib</code></pre>
<p>Check the repository list again:</p>
-<pre><code> $ tlmgr repository list
- List of repositories (with tags if set):
- http://contrib.texlive.info/current (tlcontrib)
- /var/www/norbert/tlnet (main)</code></pre>
+<pre><code>$ tlmgr repository list
+List of repositories (with tags if set):
+ http://contrib.texlive.info/current (tlcontrib)
+ /var/www/norbert/tlnet (main)</code></pre>
<p>Now we specify a pinning entry to get the package <code>classico</code> from <code>tlcontrib</code>:</p>
-<pre><code> $ tlmgr pinning add tlcontrib classico</code></pre>
+<pre><code>$ tlmgr pinning add tlcontrib classico</code></pre>
<p>Check that we can find <code>classico</code>:</p>
-<pre><code> $ tlmgr show classico
- package: classico
- ...
- shortdesc: URW Classico fonts
- ...</code></pre>
+<pre><code>$ tlmgr show classico
+package: classico
+...
+shortdesc: URW Classico fonts
+...</code></pre>
<p>- install <code>classico</code>:</p>
-<pre><code> $ tlmgr install classico
- tlmgr: package repositories:
- ...
- [1/1, ??:??/??:??] install: classico @tlcontrib [737k]</code></pre>
+<pre><code>$ tlmgr install classico
+tlmgr: package repositories:
+...
+[1/1, ??:??/??:??] install: classico @tlcontrib [737k]</code></pre>
<p>In the output here you can see that the <code>classico</code> package has been installed from the <code>tlcontrib</code> repository (<code>@tlcontrib</code>).</p>
<p>Finally, <code>tlmgr pinning</code> also supports removing certain or all packages from a given repository:</p>
-<pre><code> $ tlmgr pinning remove tlcontrib classico # remove just classico
- $ tlmgr pinning remove tlcontrib --all # take nothing from tlcontrib</code></pre>
+<pre><code>$ tlmgr pinning remove tlcontrib classico # remove just classico
+$ tlmgr pinning remove tlcontrib --all # take nothing from tlcontrib</code></pre>
<p>A summary of <code>tlmgr pinning</code> actions is given above.</p>
@@ -1904,13 +1904,13 @@
<p>The output format is as follows:</p>
-<pre><code> fieldname &quot;\t&quot; value
- ...
- &quot;end-of-header&quot;
- pkgname status localrev serverrev size runtime esttot
- ...
- &quot;end-of-updates&quot;
- other output from post actions, not in machine readable form</code></pre>
+<pre><code>fieldname &quot;\t&quot; value
+...
+&quot;end-of-header&quot;
+pkgname status localrev serverrev size runtime esttot
+...
+&quot;end-of-updates&quot;
+other output from post actions, not in machine readable form</code></pre>
<p>The header section currently has two fields: <code>location-url</code> (the repository source from which updates are being drawn), and <code>total-bytes</code> (the total number of bytes to be downloaded).</p>
@@ -2034,7 +2034,7 @@
<p>The output format is as follows:</p>
-<pre><code> key &quot;\t&quot; value</code></pre>
+<pre><code>key &quot;\t&quot; value</code></pre>
<p>If a value is not saved in the database the string <code>(not set)</code> is shown.</p>
@@ -2125,7 +2125,7 @@
<p>This script and its documentation were written for the TeX Live distribution (<a href="https://tug.org/texlive">https://tug.org/texlive</a>) and both are licensed under the GNU General Public License Version 2 or later.</p>
-<p>$Id: tlmgr.pl 59064 2021-05-03 17:37:44Z karl $</p>
+<p>$Id: tlmgr.pl 59291 2021-05-21 03:14:40Z preining $</p>
</body>