texlive[46591] trunk: doc
commits+karl at tug.org
commits+karl at tug.org
Sun Feb 11 01:19:58 CET 2018
Revision: 46591
http://tug.org/svn/texlive?view=revision&revision=46591
Author: karl
Date: 2018-02-11 01:19:58 +0100 (Sun, 11 Feb 2018)
Log Message:
-----------
doc
Modified Paths:
--------------
trunk/Build/source/texk/kpathsea/ChangeLog
trunk/Build/source/texk/kpathsea/doc/kpathsea.info
trunk/Build/source/texk/kpathsea/doc/kpathsea.texi
trunk/Master/texmf-dist/scripts/texlive/tlmgr.pl
Modified: trunk/Build/source/texk/kpathsea/ChangeLog
===================================================================
--- trunk/Build/source/texk/kpathsea/ChangeLog 2018-02-10 23:30:32 UTC (rev 46590)
+++ trunk/Build/source/texk/kpathsea/ChangeLog 2018-02-11 00:19:58 UTC (rev 46591)
@@ -1,3 +1,9 @@
+2018-02-10 Karl Berry <karl at freefriends.org>
+
+ * doc/kpathsea.texi (Path searching options): clarify that
+ --no-casefold-search doesn't mean the underlying (file)system
+ magically becomes case-sensitive.
+
2018-02-07 Karl Berry <karl at freefriends.org>
* tests/kpsewhich.test: don't run --no-casefold-search with
Modified: trunk/Build/source/texk/kpathsea/doc/kpathsea.info
===================================================================
--- trunk/Build/source/texk/kpathsea/doc/kpathsea.info 2018-02-10 23:30:32 UTC (rev 46590)
+++ trunk/Build/source/texk/kpathsea/doc/kpathsea.info 2018-02-11 00:19:58 UTC (rev 46591)
@@ -1159,8 +1159,11 @@
'--no-casefold-search'
Explicitly enable or disable the fallback to a case-insensitive
search on Unix platforms (*note Casefolding search::); no effect on
- Windows. The default is the same as the system setup, which is (by
- default) enabled.
+ Windows. The default is enabled, set in 'texmf.cnf'. Disabling
+ ('--no-casefold-search') does not mean that searches magically
+ become case-sensitive when the underlying (file)system is
+ case-insensitive, it merely means that Kpathsea does not do any
+ casefolding itself.
'--dpi=NUM'
Set the resolution to NUM; this only affects 'gf' and 'pk' lookups.
@@ -2943,37 +2946,37 @@
* --color=tty: ls-R. (line 21)
* --debug=NUM: Auxiliary tasks. (line 9)
* --dpi=NUM: Path searching options.
- (line 24)
+ (line 27)
* --engine=NAME: Path searching options.
- (line 28)
+ (line 31)
* --expand-braces=STRING: Auxiliary tasks. (line 12)
* --expand-path=STRING: Auxiliary tasks. (line 16)
* --expand-var=STRING: Auxiliary tasks. (line 34)
* --format=NAME: Path searching options.
- (line 44)
+ (line 47)
* --help: Standard options. (line 8)
* --help-formats: Auxiliary tasks. (line 39)
* --interactive: Path searching options.
- (line 126)
+ (line 129)
* --mktex=FILETYPE: Path searching options.
- (line 131)
+ (line 134)
* --mode=STRING: Path searching options.
- (line 137)
+ (line 140)
* --must-exist: Path searching options.
- (line 142)
+ (line 145)
* --no-casefold-search: Path searching options.
(line 18)
* --no-mktex=FILETYPE: Path searching options.
- (line 131)
+ (line 134)
* --path=STRING: Path searching options.
- (line 147)
+ (line 150)
* --progname=NAME: Path searching options.
- (line 155)
+ (line 158)
* --safe-in-name=NAME: Auxiliary tasks. (line 45)
* --safe-out-name=NAME: Auxiliary tasks. (line 45)
* --show-path=NAME: Auxiliary tasks. (line 51)
* --subdir=STRING: Path searching options.
- (line 160)
+ (line 163)
* --var-value=VARIABLE: Auxiliary tasks. (line 57)
* --version: Standard options. (line 11)
* --with-mktextex-default: mktex configuration. (line 12)
@@ -2986,7 +2989,7 @@
* -1 debugging value: Debugging. (line 23)
* -A option to ls: ls-R. (line 33)
* -D NUM: Path searching options.
- (line 24)
+ (line 27)
* -iname, find predicate: Casefolding examples.
(line 78)
* -L option to ls: ls-R. (line 38)
@@ -3265,7 +3268,7 @@
* ENCFONTS: Supported file formats.
(line 61)
* engine name: Path searching options.
- (line 28)
+ (line 31)
* environment variable, source for path: Path sources. (line 9)
* environment variables for TeX: Supported file formats.
(line 6)
@@ -3373,7 +3376,7 @@
(line 84)
* input lines, reading: Calling sequence. (line 110)
* interactive query: Path searching options.
- (line 126)
+ (line 129)
* interface, not frozen: Introduction. (line 29)
* introduction: Introduction. (line 6)
* kdebug:: Debugging. (line 105)
@@ -3596,7 +3599,7 @@
* reporting bugs: Reporting bugs. (line 6)
* resident.c: Calling sequence. (line 47)
* resolution, setting: Path searching options.
- (line 24)
+ (line 27)
* resolutions, last-resort: Fallback font. (line 6)
* retrieving TeX: unixtex.ftp. (line 6)
* right-hand side of variable assignments: Config files. (line 56)
@@ -3868,36 +3871,36 @@
Node: Database format47958
Node: Invoking kpsewhich48971
Node: Path searching options49926
-Node: Specially-recognized files58128
-Node: Auxiliary tasks59483
-Node: Standard options61822
-Node: TeX support62178
-Node: Supported file formats63532
-Node: File lookup71197
-Node: Glyph lookup72946
-Node: Basic glyph lookup74070
-Node: Fontmap74950
-Node: Fallback font77479
-Node: Suppressing warnings78391
-Node: mktex scripts79518
-Node: mktex configuration80733
-Node: mktex script names86536
-Node: mktex script arguments87922
-Node: Programming88801
-Node: Programming overview89374
-Node: Calling sequence92235
-Node: Program-specific files98767
-Node: Programming with config files99790
-Node: Reporting bugs101102
-Node: Bug checklist101780
-Node: Mailing lists105252
-Node: Debugging105927
-Node: Logging111004
-Node: Common problems112871
-Node: Unable to find files113348
-Node: Slow path searching115758
-Node: Unable to generate fonts117133
-Node: TeX or Metafont failing119604
-Node: Index120957
+Node: Specially-recognized files58327
+Node: Auxiliary tasks59682
+Node: Standard options62021
+Node: TeX support62377
+Node: Supported file formats63731
+Node: File lookup71396
+Node: Glyph lookup73145
+Node: Basic glyph lookup74269
+Node: Fontmap75149
+Node: Fallback font77678
+Node: Suppressing warnings78590
+Node: mktex scripts79717
+Node: mktex configuration80932
+Node: mktex script names86735
+Node: mktex script arguments88121
+Node: Programming89000
+Node: Programming overview89573
+Node: Calling sequence92434
+Node: Program-specific files98966
+Node: Programming with config files99989
+Node: Reporting bugs101301
+Node: Bug checklist101979
+Node: Mailing lists105451
+Node: Debugging106126
+Node: Logging111203
+Node: Common problems113070
+Node: Unable to find files113547
+Node: Slow path searching115957
+Node: Unable to generate fonts117332
+Node: TeX or Metafont failing119803
+Node: Index121156
End Tag Table
Modified: trunk/Build/source/texk/kpathsea/doc/kpathsea.texi
===================================================================
--- trunk/Build/source/texk/kpathsea/doc/kpathsea.texi 2018-02-10 23:30:32 UTC (rev 46590)
+++ trunk/Build/source/texk/kpathsea/doc/kpathsea.texi 2018-02-11 00:19:58 UTC (rev 46591)
@@ -1444,7 +1444,11 @@
@opindex --no-casefold-search
Explicitly enable or disable the fallback to a case-insensitive search
on Unix platforms (@pxref{Casefolding search}); no effect on Windows.
-The default is the same as the system setup, which is (by default) enabled.
+The default is enabled, set in @code{texmf.cnf}. Disabling
+(@code{--no-casefold-search}) does not mean that searches magically
+become case-sensitive when the underlying (file)system is
+case-insensitive, it merely means that Kpathsea does not do any
+casefolding itself.
@item --dpi=@var{num}
@opindex --dpi=@var{num}
Modified: trunk/Master/texmf-dist/scripts/texlive/tlmgr.pl
===================================================================
--- trunk/Master/texmf-dist/scripts/texlive/tlmgr.pl 2018-02-10 23:30:32 UTC (rev 46590)
+++ trunk/Master/texmf-dist/scripts/texlive/tlmgr.pl 2018-02-11 00:19:58 UTC (rev 46591)
@@ -1,10 +1,9 @@
#!/usr/bin/env perl
# $Id$
#
-# Copyright 2008-2017 Norbert Preining
+# Copyright 2008-2018 Norbert Preining
# This file is licensed under the GNU General Public License version 2
# or any later version.
-#
my $svnrev = '$Revision$';
my $datrev = '$Date$';
@@ -6526,7 +6525,7 @@
tldie("$prefix, verification explicitly requested on command line, quitting.\n");
}
if ($config{'verify-downloads'}) {
- # verification explicitely requested in config file, but not gpg, die
+ # verification explicitly requested in config file, but not gpg, die
tldie("$prefix, verification explicitly requested in config file, quitting.\n");
}
# it was requested via the default setting, so just debug it
@@ -7424,9 +7423,11 @@
=item B<--no-require-verification>
-Instructs C<tlmgr> to only accept signed and verified remotes. In any
-other case C<tlmgr> will quit operation.
-See L<CRYPTOGRAPHIC VERIFICATION> below for details.
+Verify that all remote repositories to be correctly signed, or quit.
+With C<--no-require-verification>, all verification is omitted. By
+default, verification is performed (but not required) if GnuPG and the
+relevant keys are available. See L<CRYPTOGRAPHIC VERIFICATION> below for
+details.
=item B<--usermode>
@@ -7440,9 +7441,11 @@
=item B<--no-verify-downloads>
-Enables or disables cryptographic verification of downloaded database files.
-A working GnuPG (C<gpg>) binary needs to be present in the path, otherwise
-this option has no effect. See L<CRYPTOGRAPHIC VERIFICATION> below for details.
+Enables or disables cryptographic verification of all downloaded
+database files. A working GnuPG (C<gpg>) binary needs to be present in
+the path, otherwise this option has no effect. By default, the main
+repository is verified, while any other repositories are not verified.
+See L<CRYPTOGRAPHIC VERIFICATION> below for details.
=back
@@ -8438,11 +8441,12 @@
Get the value of I<var>, or set it to I<val>. Possible I<var> names:
C<debug-translation>, C<machine-readable>, C<no-execute-actions>,
-C<require-verification>, C<verify-downloads>, C<repository>, and C<prompt>. All
-except C<repository> and C<prompt> are booleans, taking values 0 and 1, and behave
-like the corresponding command line option. The C<repository> variable
-takes a string, and sets the remote repository location. The C<prompt> variable
-takes a string, and sets the current default prompt.
+C<require-verification>, C<verify-downloads>, C<repository>, and
+C<prompt>. All except C<repository> and C<prompt> are booleans, taking
+values 0 and 1, and behave like the corresponding command line option.
+The C<repository> variable takes a string, and sets the remote
+repository location. The C<prompt> variable takes a string, and sets the
+current default prompt.
If I<var> or then I<val> is not specified, it is prompted for.
@@ -8723,11 +8727,8 @@
The C<no-checksums> key needs more explanation. By default, package
checksums computed and stored on the server (in the TLPDB) are compared
-to checksums computed locally after downloading. That is, for each
-C<texlive.tlpdb> loaded from a repository, the corresponding checksum
-file C<texlive.tlpdb.sha512> is also downloaded, and C<tlmgr> confirms
-whether the checksum of the downloaded TLPDB file agrees with the
-download data. C<no-checksums> disables this process.
+to checksums computed locally after downloading. C<no-checksums>
+disables this process.
The checksum algorithm is SHA-512. Your system must have one of (looked
for in this order) the Perl C<Digest::SHA> module, the C<openssl>
@@ -8744,26 +8745,22 @@
C<tlmgr> and C<install-tl> perform cryptographic verification if
possible. If verification is performed and successful, the programs
report C<(verified)> after loading the TLPDB; otherwise, they report
-C<(not verified)>. Either way, by default the installation and/or
+C<(not verified)>. But either way, by default the installation and/or
updates proceed normally.
-If a program named C<gpg> is available (that is, it is found in the
-C<PATH>), cryptographic signatures will be checked. In this case we
-require that the main repository is signed, but signing is not required
-for additional repositories. If C<gpg> is not available, signatures are
-not checked and no verification is carried out, but C<tlmgr> proceeds
-normally.
+If a program named C<gpg> is available (that is, found in C<PATH>),
+cryptographic signatures will be checked. In this case we require the
+main repository be signed, but not any additional repositories. If
+C<gpg> is not available, signatures are not checked and no verification
+is carried out, but C<tlmgr> proceeds normally.
-The attempted verification can be suppressed by specifying
-C<--no-verify-downloads> on the command line, or the entry
-C<verify-downloads=0> in a C<tlmgr> config file (described in
-L<CONFIGURATION FILE FOR TLMGR>). On the other hand, you can
-I<require> verification by specifying C<--require-verification> on the
-command line, or C<require-verification=1> in a C<tlmgr> config file;
-in this case, if verification is not possible, the program quits.
-Note that as mentioned above, if C<gpg> is available, the main repository
-is always required to have a signature. Using the C<--require-verification>
-switch, C<tlmgr> also requires signatures from additional repositories.
+The attempted verification can be suppressed entirely by specifying
+C<--no-verify-downloads> on the command line, or a line
+C<verify-downloads=0> in a C<tlmgr> config file (see L<CONFIGURATION
+FILE FOR TLMGR>). On the other hand, you can I<require> successful
+verification by specifying C<--require-verification> on the command
+line, or C<require-verification=1> in a C<tlmgr> config file; in this
+case, if verification is not possible, or fails, the program quits.
Cryptographic verification requires checksum checking (described just
above) to succeed, and a working GnuPG (C<gpg>) program (see below for
More information about the tex-live-commits
mailing list