texlive[74241] Master/texmf-dist: tlmgr doc update, man page rebuild
commits+karl at tug.org
commits+karl at tug.org
Mon Feb 24 00:10:35 CET 2025
Revision: 74241
https://tug.org/svn/texlive?view=revision&revision=74241
Author: karl
Date: 2025-02-24 00:10:34 +0100 (Mon, 24 Feb 2025)
Log Message:
-----------
tlmgr doc update, man page rebuild
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/context/scripts/mkii/mptopdf.man
trunk/Master/texmf-dist/doc/man/man1/contextjit.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/luatools.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/mtxrunjit.man1.pdf
trunk/Master/texmf-dist/doc/man/man1/tlmgr.1
trunk/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf
trunk/Master/texmf-dist/doc/texlive/tlmgr.html
trunk/Master/texmf-dist/scripts/texlive/NEWS
trunk/Master/texmf-dist/scripts/texlive/tlmgr.pl
Modified: trunk/Master/texmf-dist/doc/context/scripts/mkii/mptopdf.man
===================================================================
--- trunk/Master/texmf-dist/doc/context/scripts/mkii/mptopdf.man 2025-02-23 23:00:50 UTC (rev 74240)
+++ trunk/Master/texmf-dist/doc/context/scripts/mkii/mptopdf.man 2025-02-23 23:10:34 UTC (rev 74241)
@@ -1,4 +1,4 @@
-.TH "mptopdf" "1" "01-01-2024" "version 1.4.1" "convert MetaPost figures to PDF"
+.TH "mptopdf" "1" "01-01-2025" "version 1.4.1" "convert MetaPost figures to PDF"
.SH NAME
mptopdf - convert MetaPost figures to PDF
.SH SYNOPSIS
Modified: trunk/Master/texmf-dist/doc/man/man1/contextjit.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/luatools.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/mtxrunjit.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/man/man1/tlmgr.1
===================================================================
--- trunk/Master/texmf-dist/doc/man/man1/tlmgr.1 2025-02-23 23:00:50 UTC (rev 74240)
+++ trunk/Master/texmf-dist/doc/man/man1/tlmgr.1 2025-02-23 23:10:34 UTC (rev 74241)
@@ -55,7 +55,7 @@
.\" ========================================================================
.\"
.IX Title "TLMGR 1"
-.TH TLMGR 1 2025-01-17 "perl v5.40.0" "User Contributed Perl Documentation"
+.TH TLMGR 1 2025-02-23 "perl v5.40.1" "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
@@ -285,8 +285,10 @@
.IP \fB\-\-no\-execute\-actions\fR 4
.IX Item "--no-execute-actions"
Suppress the execution of the execute actions as defined in the tlpsrc
-files. Documented only for completeness, as this is only useful in
-debugging.
+files. Unless you are going to do the postprocessing yourself (as, for
+example, \f(CW\*(C`install\-tl\*(C'\fR does), this shouldn't be specified. Otherwise,
+format files and the filename database will become stale, among other
+problems.
.IP "\fB\-\-package\-logfile\fR \fIfile\fR" 4
.IX Item "--package-logfile file"
\&\f(CW\*(C`tlmgr\*(C'\fR logs all package actions (install, remove, update, failed
@@ -1001,6 +1003,10 @@
argument (e.g., \f(CW\*(C`tlmgr dvips paper a4\*(C'\fR), set the default for that
program to that paper size.
.PP
+If either \f(CW\*(C`pdftex\*(C'\fR or \f(CW\*(C`context\*(C'\fR is one of the arguments, whether
+implicitly or explicitly, existing formats are rebuilt (i.e., \f(CW\*(C`fmtutil
+\&\-\-refresh\*(C'\fR is called), unless \f(CW\*(C`\-\-no\-execute\-actions\*(C'\fR is specified.
+.PP
With a program given as the first argument and \f(CW\*(C`\-\-list\*(C'\fR given as the
last argument (e.g., \f(CW\*(C`tlmgr dvips paper \-\-list\*(C'\fR), shows all valid paper
sizes for that program. The first size shown is the default.
Modified: trunk/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/texlive/tlmgr.html
===================================================================
--- trunk/Master/texmf-dist/doc/texlive/tlmgr.html 2025-02-23 23:00:50 UTC (rev 74240)
+++ trunk/Master/texmf-dist/doc/texlive/tlmgr.html 2025-02-23 23:10:34 UTC (rev 74241)
@@ -287,7 +287,7 @@
<dt id="no-execute-actions"><b>--no-execute-actions</b></dt>
<dd>
-<p>Suppress the execution of the execute actions as defined in the tlpsrc files. Documented only for completeness, as this is only useful in debugging.</p>
+<p>Suppress the execution of the execute actions as defined in the tlpsrc files. Unless you are going to do the postprocessing yourself (as, for example, <code>install-tl</code> does), this shouldn't be specified. Otherwise, format files and the filename database will become stale, among other problems.</p>
</dd>
<dt id="package-logfile-file"><b>--package-logfile</b> <i>file</i></dt>
@@ -917,6 +917,8 @@
<p>With a program given as the first argument and a paper size as the last argument (e.g., <code>tlmgr dvips paper a4</code>), set the default for that program to that paper size.</p>
+<p>If either <code>pdftex</code> or <code>context</code> is one of the arguments, whether implicitly or explicitly, existing formats are rebuilt (i.e., <code>fmtutil --refresh</code> is called), unless <code>--no-execute-actions</code> is specified.</p>
+
<p>With a program given as the first argument and <code>--list</code> given as the last argument (e.g., <code>tlmgr dvips paper --list</code>), shows all valid paper sizes for that program. The first size shown is the default.</p>
<p>If <code>--json</code> is specified without other options, the paper setup is dumped in JSON format. For the format of JSON output see <code>tlpkg/doc/json-formats.txt</code>, format definition <code>TLPAPER</code>.</p>
Modified: trunk/Master/texmf-dist/scripts/texlive/NEWS
===================================================================
--- trunk/Master/texmf-dist/scripts/texlive/NEWS 2025-02-23 23:00:50 UTC (rev 74240)
+++ trunk/Master/texmf-dist/scripts/texlive/NEWS 2025-02-23 23:10:34 UTC (rev 74241)
@@ -1,6 +1,9 @@
(This file public domain. Originally written by Norbert Preining and
Karl Berry, 2010.)
+<p><b>tlmgr 74241 (released 24feb25):</b>
+<li>doc-only update: tlmgr paper rebuilds existing formats.
+
<p><b>tlmgr 73493 (released 17jan25):</b>
<li>new option --only-files for tlmgr info to just report files of a package.
Modified: trunk/Master/texmf-dist/scripts/texlive/tlmgr.pl
===================================================================
--- trunk/Master/texmf-dist/scripts/texlive/tlmgr.pl 2025-02-23 23:00:50 UTC (rev 74240)
+++ trunk/Master/texmf-dist/scripts/texlive/tlmgr.pl 2025-02-23 23:10:34 UTC (rev 74241)
@@ -8363,8 +8363,10 @@
=item B<--no-execute-actions>
Suppress the execution of the execute actions as defined in the tlpsrc
-files. Documented only for completeness, as this is only useful in
-debugging.
+files. Unless you are going to do the postprocessing yourself (as, for
+example, C<install-tl> does), this shouldn't be specified. Otherwise,
+format files and the filename database will become stale, among other
+problems.
=item B<--package-logfile> I<file>
@@ -9134,6 +9136,10 @@
argument (e.g., C<tlmgr dvips paper a4>), set the default for that
program to that paper size.
+If either C<pdftex> or C<context> is one of the arguments, whether
+implicitly or explicitly, existing formats are rebuilt (i.e., C<fmtutil
+--refresh> is called), unless C<--no-execute-actions> is specified.
+
With a program given as the first argument and C<--list> given as the
last argument (e.g., C<tlmgr dvips paper --list>), shows all valid paper
sizes for that program. The first size shown is the default.
More information about the tex-live-commits
mailing list.