texlive[47326] trunk: doc,sync
commits+karl at tug.org
commits+karl at tug.org
Fri Apr 6 17:25:16 CEST 2018
Revision: 47326
http://tug.org/svn/texlive?view=revision&revision=47326
Author: karl
Date: 2018-04-06 17:25:15 +0200 (Fri, 06 Apr 2018)
Log Message:
-----------
doc,sync
Modified Paths:
--------------
trunk/Build/source/libs/README
trunk/Build/source/texk/texlive/linked_scripts/texlive/tlmgr.pl
trunk/Master/tlpkg/bin/tl-update-asy
trunk/Master/tlpkg/doc/releng.txt
Modified: trunk/Build/source/libs/README
===================================================================
--- trunk/Build/source/libs/README 2018-04-06 15:21:10 UTC (rev 47325)
+++ trunk/Build/source/libs/README 2018-04-06 15:25:15 UTC (rev 47326)
@@ -27,7 +27,7 @@
harfbuzz 1.7.6 - checked 07mar18
http://www.freedesktop.org/software/harfbuzz/release/
-icu 60.2 - checked 11jan18
+icu 61.1 - checked 29mar18
http://download.icu-project.org/files/icu4c/
libpaper 1.1.24+nmu2 - checked 24oct13
Modified: trunk/Build/source/texk/texlive/linked_scripts/texlive/tlmgr.pl
===================================================================
--- trunk/Build/source/texk/texlive/linked_scripts/texlive/tlmgr.pl 2018-04-06 15:21:10 UTC (rev 47325)
+++ trunk/Build/source/texk/texlive/linked_scripts/texlive/tlmgr.pl 2018-04-06 15:25:15 UTC (rev 47326)
@@ -1,12 +1,12 @@
#!/usr/bin/env perl
-# $Id: tlmgr.pl 47273 2018-04-03 22:14:30Z karl $
+# $Id: tlmgr.pl 47303 2018-04-05 17:52:22Z karl $
#
# Copyright 2008-2018 Norbert Preining
# This file is licensed under the GNU General Public License version 2
# or any later version.
-my $svnrev = '$Revision: 47273 $';
-my $datrev = '$Date: 2018-04-04 00:14:30 +0200 (Wed, 04 Apr 2018) $';
+my $svnrev = '$Revision: 47303 $';
+my $datrev = '$Date: 2018-04-05 19:52:22 +0200 (Thu, 05 Apr 2018) $';
my $tlmgrrevision;
my $tlmgrversion;
my $prg;
@@ -7364,7 +7364,7 @@
=head1 SYNOPSIS
-tlmgr [I<option>]... I<action> [I<option>]... [I<operand>]...
+tlmgr [I<option>...] I<action> [I<option>...] [I<operand>...]
=head1 DESCRIPTION
@@ -7571,8 +7571,14 @@
If C<-v> has been given the revisions of the used modules are reported, too.
-=head2 backup [--clean[=I<N>]] [--backupdir I<dir>] [--all | I<pkg>]...
+=head2 backup
+=over 4
+
+=item B<backup [I<option>...] --all>
+
+=item B<backup [I<option>...] I<pkg>...>
+
If the C<--clean> option is not specified, this action makes a backup of
the given packages, or all packages given C<--all>. These backups are
saved to the value of the C<--backupdir> option, if that is an existing and
@@ -7617,19 +7623,15 @@
=back
+=back
+
=head2 candidates I<pkg>
-=over 4
-
-=item B<candidates I<pkg>>
-
Shows the available candidate repositories for package I<pkg>.
See L<MULTIPLE REPOSITORIES> below.
-=back
+=head2 check [I<option>...] [files|depends|executes|runfiles|all]
-=head2 check [I<option>]... [files|depends|executes|runfiles|all]
-
Executes one (or all) check(s) on the consistency of the installation.
=over 4
@@ -7671,10 +7673,14 @@
=back
-=head2 conf [texmf|tlmgr|updmap [--conffile I<file>] [--delete] [I<key> [I<value>]]]
+=head2 conf
-=head2 conf auxtrees [--conffile I<file>] [show|add|delete] [I<value>]
+=over 4
+=item B<conf [texmf|tlmgr|updmap [--conffile I<file>] [--delete] [I<key> [I<value>]]]>
+
+=item B<conf auxtrees [--conffile I<file>] [show|add|delete] [I<value>]>
+
With only C<conf>, show general configuration information for TeX Live,
including active configuration files, path settings, and more. This is
like running C<texconfig conf>, but works on all supported platforms.
@@ -7722,8 +7728,10 @@
no error checking on either keys or values is done, so any sort of
breakage is possible.
-=head2 dump-tlpdb [--local|--remote] [--json]
+=back
+=head2 dump-tlpdb [I<option>...] [--json]
+
Dump complete local or remote TLPDB to standard output, as-is. The
output is analogous to the C<--machine-readable> output; see
L<MACHINE-READABLE OUTPUT> section.
@@ -7760,17 +7768,17 @@
Line endings may be either LF or CRLF depending on the current platform.
-=head2 generate [I<option>]... I<what>
+=head2 generate
=over 4
-=item B<generate language>
+=item B<generate [I<option>...] language>
-=item B<generate language.dat>
+=item B<generate [I<option>...] language.dat>
-=item B<generate language.def>
+=item B<generate [I<option>...] language.def>
-=item B<generate language.dat.lua>
+=item B<generate [I<option>...] language.dat.lua>
=back
@@ -7877,8 +7885,16 @@
Start the graphical user interface. See B<GUI> below.
-=head2 info [I<option>...] [collections|schemes|I<pkg>...]
+=head2 info
+=over 4
+
+=item B<info [I<option>...] I<pkg>...>
+
+=item B<info [I<option>...] collections>
+
+=item B<info [I<option>...] schemes>
+
With no argument, lists all packages available at the package
repository, prefixing those already installed with C<i>.
@@ -7946,6 +7962,8 @@
=back
+=back
+
=head2 init-usertree
Sets up a texmf tree for so-called user mode management, either the
@@ -7952,7 +7970,7 @@
default user tree (C<TEXMFHOME>), or one specified on the command line
with C<--usertree>. See L<USER MODE> below.
-=head2 install [I<option>]... I<pkg>...
+=head2 install [I<option>...] I<pkg>...
Install each I<pkg> given on the command line, if it is not already
installed. (It does not touch existing packages; see the C<update>
@@ -8018,8 +8036,16 @@
=back
-=head2 key list|add I<file>|remove I<keyid>
+=head2 key
+=over 4
+
+=item B<key list>
+
+=item B<key add I<file>>
+
+=item B<key remove I<keyid>>
+
The action C<key> allows listing, adding and removing additional GPG
keys to the set of trusted keys, that is, those that are used to verify
the TeX Live databases.
@@ -8034,9 +8060,11 @@
The C<remove> argument requires a key id and removes the requested id
from the local keyring.
+=back
+
=head2 list
-Synonym for L<info|/info [I<option>...] [collections|schemes|I<pkg>...]>.
+Synonym for L</info>.
=head2 option
@@ -8182,8 +8210,14 @@
some programs, notably C<dvips>. C<tlmgr> does not support those extra
settings.
-=head2 path [--w32mode=user|admin] [add|remove]
+=head2 path
+=over 4
+
+=item B<path [--w32mode=user|admin] add>
+
+=item B<path [--w32mode=user|admin] remove>
+
On Unix, merely adds or removes symlinks for binaries, man pages, and
info pages in the system directories specified by the respective options
(see the L</option> description above). Does not change any
@@ -8209,6 +8243,8 @@
user without admin rights uses the option C<--w32mode admin> a warning
is issued that the caller does not have enough privileges.
+=back
+
=head2 pinning
The C<pinning> action manages the pinning file, see L</Pinning> below.
@@ -8235,12 +8271,16 @@
=back
-=head2 platform list|add|remove I<platform>...
+=head2 platform
-=head2 platform set I<platform>
+=over 4
-=head2 platform set auto
+=item B<platform list|add|remove I<platform>...>
+=item B<platform set I<platform>>
+
+=item B<platform set auto>
+
C<platform list> lists the TeX Live names of all the platforms
(a.k.a. architectures), (C<i386-linux>, ...) available at the package
repository.
@@ -8273,6 +8313,8 @@
=back
+=back
+
=cut
# keep the following on *ONE* line otherwise Losedows perldoc does
@@ -8280,13 +8322,25 @@
=pod
-=head2 postaction [--w32mode=user|admin] [--fileassocmode=1|2] [--all] [install|remove] [shortcut|fileassoc|script] [I<pkg>]...
+=head2 postaction
+=over 4
+
+=item B<postaction [I<option>...] install [shortcut|fileassoc|script] [I<pkg>...]>
+
+=item B<postaction [I<option>...] remove [shortcut|fileassoc|script] [I<pkg>...]>
+
Carry out the postaction C<shortcut>, C<fileassoc>, or C<script> given
as the second required argument in install or remove mode (which is the
first required argument), for either the packages given on the command
line, or for all if C<--all> is given.
+Options:
+
+=over 4
+
+=item B<--w32mode=[user|admin]>
+
If the option C<--w32mode> is given the value C<user>, all actions will
only be carried out in the user-accessible parts of the
registry/filesystem, while the value C<admin> selects the system-wide
@@ -8293,11 +8347,21 @@
parts of the registry for the file associations. If you do not have
enough permissions, using C<--w32mode=admin> will not succeed.
+=item B<--fileassocmode=[1|2]>
+
C<--fileassocmode> specifies the action for file associations. If it is
set to 1 (the default), only new associations are added; if it is set to
2, all associations are set to the TeX Live programs. (See also
C<option fileassocs>.)
+=item B<--all>
+
+Carry out the postactions for all packages
+
+=back
+
+=back
+
=head2 print-platform
Print the TeX Live identifier for the detected platform
@@ -8309,7 +8373,7 @@
Print the TeX Live platform identifier, TL platform long name, and
original output from guess.
-=head2 remove [I<option>]... I<pkg>...
+=head2 remove [I<option>...] I<pkg>...
Remove each I<pkg> specified. Removing a collection removes all package
dependencies (unless C<--no-depends> is specified), but not any
@@ -8328,12 +8392,11 @@
=item B<--backupdir> I<directory>
These options behave just as with the L<update|/update
-[I<option>]... [I<pkg>]...> action (q.v.), except they apply to making
+[I<option>...] [I<pkg>...]> action (q.v.), except they apply to making
backups of packages before they are removed. The default is to make
such a backup, that is, to save a copy of packages before removal.
-The L<restore|/restore [--json] [--backupdir I<dir>] [--all | I<pkg>
-[I<rev>]]> action explains how to restore from a backup.
+The L</restore> action explains how to restore from a backup.
=item B<--no-depends>
@@ -8341,7 +8404,7 @@
=item B<--no-depends-at-all>
-See above under L<install|/install [I<option>]... I<pkg>...> (and beware).
+See above under L<install|/install [I<option>...] I<pkg>...> (and beware).
=item B<--force>
@@ -8397,8 +8460,14 @@
=back
-=head2 restore [--json] [--backupdir I<dir>] [--all | I<pkg> [I<rev>]]
+=head2 restore
+=over 4
+
+=item B<restore [I<option>...] I<pkg> [I<rev>]>
+
+=item B<restore [I<option>...] --all>
+
Restore a package from a previously-made backup.
If C<--all> is given, try to restore the latest revision of all
@@ -8447,12 +8516,18 @@
=back
-=head2 search [I<option>...] I<what>
+=back
-=head3 search [I<option>...] --file I<what>
+=head2 search
-=head3 search [I<option>...] --all I<what>
+=over 4
+=item B<search [I<option>...] I<what>>
+
+=item B<search [I<option>...] --file I<what>>
+
+=item B<search [I<option>...] --all I<what>>
+
By default, search the names, short descriptions, and long descriptions
of all locally installed packages for the argument I<what>, interpreted
as a (Perl) regular expression.
@@ -8483,6 +8558,8 @@
=back
+=back
+
=head2 shell
Starts an interactive mode, where tlmgr prompts for commands. This can
@@ -8547,13 +8624,13 @@
=head2 show
-Synonym for L<info|/info [I<option>...] [collections|schemes|I<pkg>...]>.
+Synonym for L</info>.
=head2 uninstall
-Synonym for L<remove|/remove [I<option>]... I<pkg>...>.
+Synonym for L<remove|/remove [I<option>...] I<pkg>...>.
-=head2 update [I<option>]... [I<pkg>]...
+=head2 update [I<option>...] [I<pkg>...]
Updates the packages given as arguments to the latest version available
at the installation source. Either C<--all> or at least one I<pkg> name
@@ -8652,7 +8729,7 @@
the key C<update-exclude>.
-=item B<--no-auto-remove> [I<pkg>]...
+=item B<--no-auto-remove> [I<pkg>...]
By default, C<tlmgr> tries to remove packages which have disappeared on
the server, as described above under C<--all>. This option prevents
@@ -8661,7 +8738,7 @@
since packages are not infrequently renamed or replaced by their
authors. Therefore this is not recommend.
-=item B<--no-auto-install> [I<pkg>]...
+=item B<--no-auto-install> [I<pkg>...]
Under normal circumstances C<tlmgr> will install packages which are new
on the server, as described above under C<--all>. This option prevents
@@ -8715,8 +8792,7 @@
actual I<content> of the update causes problems, e.g., introduces an TeX
incompatibility.
-The L<restore|/restore [--json] [--backupdir I<dir>] [--all | I<pkg>
-[I<rev>]]> action explains how to restore from a backup.
+The L</restore> action explains how to restore from a backup.
=item B<--no-depends>
@@ -8726,7 +8802,7 @@
=item B<--no-depends-at-all>
-See above under L<install|/install [I<option>]... I<pkg>...> (and beware).
+See above under L<install|/install [I<option>...] I<pkg>...> (and beware).
=item B<--force>
@@ -9298,9 +9374,9 @@
information it needs by reading stdout.
Currently this option only applies to the
-L<update|/update [I<option>]... [I<pkg>]...>,
-L<install|/install [I<option>]... I<pkg>...>, and
-L</option> actions.
+L<update|/update [I<option>...] [I<pkg>...]>,
+L<install|/install [I<option>...] I<pkg>...>, and
+L</option> actions.
=head2 Machine-readable C<update> and C<install> output
@@ -9441,7 +9517,7 @@
distribution (L<http://tug.org/texlive>) and both are licensed under the
GNU General Public License Version 2 or later.
-$Id: tlmgr.pl 47273 2018-04-03 22:14:30Z karl $
+$Id: tlmgr.pl 47303 2018-04-05 17:52:22Z karl $
=cut
# to remake HTML version: pod2html --cachedir=/tmp tlmgr.pl >/tmp/tlmgr.html
Modified: trunk/Master/tlpkg/bin/tl-update-asy
===================================================================
--- trunk/Master/tlpkg/bin/tl-update-asy 2018-04-06 15:21:10 UTC (rev 47325)
+++ trunk/Master/tlpkg/bin/tl-update-asy 2018-04-06 15:25:15 UTC (rev 47326)
@@ -87,7 +87,7 @@
xu=$B/source/utils
xy=$xu/asymptote
cd $xy
- $cp binaries/i386-win32/texlive/asy.exe $pg/asymptote/
+ $cp binaries/i386-windows/texlive/asy.exe $pg/asymptote/
cd /tmp/ainst
$cp share/info/{*/,}*.info $xist/doc/info
@@ -100,10 +100,10 @@
$cp latex/asymptote/* $xist/tex/latex/asymptote/
$cp context*/asymptote/* $xist/tex/context/third/asymptote/
#
- # also copy in i386-linux binaryfrom build machine.
- lb=$xb/x86_64-linux
- $cp bin/asy $lb/
- strip $lb/asy
+ # also copy in i386-linux binary from build machine (not any more).
+ #lb=$xb/x86_64-linux
+ #$cp bin/asy $lb/
+ #strip $lb/asy
cd $xist/doc/man
make
@@ -110,7 +110,7 @@
ci="$xu/README \
$xy \
- $xb/i386-linux $lb $pg/asymptote/ \
+ $pg/asymptote* \
$xist/doc/info/ $xist/doc/man $xist/doc/asymptote \
$xist/asymptote/ $xist/tex/*/asymptote"
Modified: trunk/Master/tlpkg/doc/releng.txt
===================================================================
--- trunk/Master/tlpkg/doc/releng.txt 2018-04-06 15:21:10 UTC (rev 47325)
+++ trunk/Master/tlpkg/doc/releng.txt 2018-04-06 15:25:15 UTC (rev 47326)
@@ -173,15 +173,20 @@
Consider updates of core man pages in Build/source/texk/web2c/man.
Remake updmap,fmtutil man pages with help2man:
make -C Build/source/Work/texk/texlive/tl_scripts xupdmap.1 xfmtutil.1
- They must be moved from /tmp into Master by hand.
- Also update ~www/texlive/doc/*.html: groff -mandoc -Thtml fmtutil.1
+ They must be moved from /tmp into Master by hand:
+ mv /tmp/xupdmap.1 $x1/updmap.1
+ mv /tmp/xfmtutil.1 $x1/fmtutil.1
+ Also update ~www/texlive/doc/*.html (groff -mandoc -Thtml fmtutil.1):
+ mv /tmp/xupdmap.1.html $lw/doc/updmap.html
+ mv /tmp/xfmtutil.1.html $lw/doc/fmtutil.html
Texinfo manuals from Build to Master:
- tl-update-txi # then commit in texmf-dist/doc
+ tl-update-txi
Man pages from Build to Master (after doing a build):
tl-update-man
# then run make in texmf-dist/doc/man
# and check /tmp/so.rules against man1/Makefile
Update texdoc Data.tlpdb.lua.
+ Don't forget commit in texmf-dist/doc.
N. Really test during pretest (really! don't leave it for Knuth to do!):
.fmt's sharable across endian-different platforms (including luatex).
More information about the tex-live-commits
mailing list