texlive[46719] Build/source: -min-crossrefs needs .aux removal; other

commits+karl at tug.org commits+karl at tug.org
Fri Feb 23 20:30:02 CET 2018


Revision: 46719
          http://tug.org/svn/texlive?view=revision&revision=46719
Author:   karl
Date:     2018-02-23 20:30:01 +0100 (Fri, 23 Feb 2018)
Log Message:
-----------
-min-crossrefs needs .aux removal; other doc tweaks

Modified Paths:
--------------
    trunk/Build/source/doc/tlbuild.info
    trunk/Build/source/doc/tlbuild.texi
    trunk/Build/source/texk/kpathsea/ChangeLog
    trunk/Build/source/texk/kpathsea/cnf-to-paths.awk
    trunk/Build/source/texk/kpathsea/lib.h
    trunk/Build/source/texk/web2c/ChangeLog
    trunk/Build/source/texk/web2c/doc/web2c.info
    trunk/Build/source/texk/web2c/doc/web2c.texi
    trunk/Build/source/texk/web2c/man/ChangeLog
    trunk/Build/source/texk/web2c/man/bibtex.man
    trunk/Build/source/utils/README

Modified: trunk/Build/source/doc/tlbuild.info
===================================================================
(Binary files differ)

Modified: trunk/Build/source/doc/tlbuild.texi
===================================================================
--- trunk/Build/source/doc/tlbuild.texi	2018-02-23 16:18:47 UTC (rev 46718)
+++ trunk/Build/source/doc/tlbuild.texi	2018-02-23 19:30:01 UTC (rev 46719)
@@ -119,13 +119,13 @@
 For information on acquiring the TL sources, see
 @url{http://tug.org/texlive/svn}.
 
-This manual does not duplicate the (primarily user-level) information
-found in other TL documentation resources, such as:
+This manual does not duplicate the information found in other TL
+documentation resources, such as:
 
 @itemize
 @item The @TL{} web pages: @url{http://tug.org/texlive}.
 
- at item The web page with an overview of how to build the binaries which 
+ at item The web page describing how to build the binaries which 
 are distributed with @TL{}: @url{http://tug.org/texlive/build.html}.
 
 @item The @TL{} user manual: @url{http://tug.org/texlive/doc.html}, or
@@ -2571,64 +2571,6 @@
 If changes have been pushed via the cron job above, Travis-CI will
 automatically checkout the last pushed commit and try building it.
 
- at comment
- at comment The following needs improvement
- at comment
- at comment @subheading Developer setup for Git/Subversion
- at comment 
- at comment In case a developer of code in the @TL{} source code wants to use the CI
- at comment testing facility, the following steps are necessary for initialization:
- at comment 
- at comment @itemize @bullet
- at comment @item
- at comment Initial @code{git-svn} checkout as laid out above, replacing
- at comment @code{USER} with the Subversion user name. This initial checkout might
- at comment take quite some time as the whole history has to be parsed. In case the
- at comment checkout is interrupted, change into the already created folder and call
- at comment @code{git svn fetch} to continue pulling from the remote until all
- at comment changes have been fetched.
- at comment 
- at comment @item
- at comment Adding the Git remote as laid out above. After that it is also necessary
- at comment to set the upstream for the @code{master} branch with
- at comment @code{git branch --set-upstream-to=origin/master master} followed by a
- at comment @code{git pull}. The last command will probably not fetch anything since
- at comment but update the local information about availability.
- at comment 
- at comment @end itemize
- at comment 
- at comment After this development can be done as follows:
- at comment 
- at comment @itemize @bullet
- at comment @item
- at comment Create a new branch based on @code{master}: @code{git checkout -b feature}
- at comment and develop the new features in this branch.
- at comment 
- at comment @item
- at comment Pushing the branch to Github will kick of automatic CI testing on this
- at comment branch, too.
- at comment 
- at comment @item
- at comment When the feature is ready, first the branch @code{feature} needs to be
- at comment rebased onto current @code{master} with @code{git rebase master}, then
- at comment merged into @code{master}, followed by a submission to the Subversion
- at comment repository via @code{git svn dcommit}. Don't push to master on Github
- at comment (it is anyway protected), your changes will come in in due time via a
- at comment pull on master.
- at comment 
- at comment @item
- at comment After the branch is included in master, optionally delete the local and
- at comment rmeote branch @code{feature}.
- at comment 
- at comment @end itemize
- at comment 
- at comment The above method is the standards and safest method, but there is an
- at comment alternative way by first pulling from Github, and then tricking git-svn
- at comment into believing that everything has been fetched from Subversion
- at comment already. This alternative method is explained XXXXXXXXX (my BLOG?)
- at comment 
- at comment 
-
 @c made from pod doc.
 @include tlbuild-incl/install-tl.texi
 @include tlbuild-incl/tlmgr.texi

Modified: trunk/Build/source/texk/kpathsea/ChangeLog
===================================================================
--- trunk/Build/source/texk/kpathsea/ChangeLog	2018-02-23 16:18:47 UTC (rev 46718)
+++ trunk/Build/source/texk/kpathsea/ChangeLog	2018-02-23 19:30:01 UTC (rev 46719)
@@ -1,3 +1,9 @@
+2018-02-23  Karl Berry  <karl at freefriends.org>
+
+	* lib.h (LIB_START_FATAL): mention that the identifier `kpse'
+	has to be defined for this to work.  (In practice, it's a local
+	variable.) Private report from Douglas McKenna, 2018/02/21.
+
 2018-02-21  Akira Kakuto  <kakuto at fuk.kindai.ac.jp>
 
 	* xgetcwd.c: Replace LIB_FATAL2 by FATAL2.

Modified: trunk/Build/source/texk/kpathsea/cnf-to-paths.awk
===================================================================
--- trunk/Build/source/texk/kpathsea/cnf-to-paths.awk	2018-02-23 16:18:47 UTC (rev 46718)
+++ trunk/Build/source/texk/kpathsea/cnf-to-paths.awk	2018-02-23 19:30:01 UTC (rev 46719)
@@ -14,7 +14,10 @@
   # 
   # 1) definitions referring to SELFAUTO*, which we want to keep.  In
   # particular, this is how the compile-time TEXMFCNF gets defined and
-  # thus how texmf.cnf gets found.
+  # thus how texmf.cnf gets found.  In fact, TEXMFCNF is the only
+  # relevant compile-time value at all, and since its value is not used
+  # from texmf.cnf, we could simplify this whole process in both
+  # directions. Maybe someday.
   # 
   # 2) definitions starting with a /, which we also want to keep.  Here
   # we assume a distro maintainer has changed a variable, e.g.,
@@ -25,7 +28,7 @@
   # That way, the binaries don't get changed just because we change
   # definitions in texmf.cnf.
   # 
-  # The definition of DEFAULT_TEXMF (and other variables)
+  # The definition of DEFAULT_TEXMFROOT (and other variables)
   # that winds up in the final paths.h will not be used.
   
   # Extract the identifier and the value from the line.  Since

Modified: trunk/Build/source/texk/kpathsea/lib.h
===================================================================
--- trunk/Build/source/texk/kpathsea/lib.h	2018-02-23 16:18:47 UTC (rev 46718)
+++ trunk/Build/source/texk/kpathsea/lib.h	2018-02-23 19:30:01 UTC (rev 46719)
@@ -87,6 +87,7 @@
 #define WARNING4(str, e1, e2, e3, e4)                                   \
   START_WARNING (); fprintf (stderr, str, e1, e2, e3, e4); END_WARNING ()
 
+/* This requires an identifier `kpse' to be set up correctly.  Sorry.  */
 #define LIB_START_FATAL() do { \
   fprintf (stderr, "%s: fatal: ", kpse->invocation_name);
 

Modified: trunk/Build/source/texk/web2c/ChangeLog
===================================================================
--- trunk/Build/source/texk/web2c/ChangeLog	2018-02-23 16:18:47 UTC (rev 46718)
+++ trunk/Build/source/texk/web2c/ChangeLog	2018-02-23 19:30:01 UTC (rev 46719)
@@ -1,3 +1,9 @@
+2018-02-23  Karl Berry  <karl at freefriends.org>
+
+	* doc/web2c.texi (bibtex invocation): mention need to remove aux
+	file from previous run for -min-crossrefs to be effective.
+	https://tex.stackexchange.com/questions/123740
+
 2018-02-18  Karl Berry  <karl at tug.org>
 
 	* bibtex.ch (str_ends_with): new fn.

Modified: trunk/Build/source/texk/web2c/doc/web2c.info
===================================================================
--- trunk/Build/source/texk/web2c/doc/web2c.info	2018-02-23 16:18:47 UTC (rev 46718)
+++ trunk/Build/source/texk/web2c/doc/web2c.info	2018-02-23 19:30:01 UTC (rev 46719)
@@ -1,4 +1,4 @@
-This is web2c.info, produced by makeinfo version 6.3 from web2c.texi.
+This is web2c.info, produced by makeinfo version 6.5 from web2c.texi.
 
 This file documents the installation and use of the programs in Web2c,
 an implementation of Donald Knuth's TeX system.
@@ -2227,10 +2227,14 @@
      even if it was not explicitly referenced in the .aux file.  For
      example, E might be a conference proceedings as a whole, with the
      cross-referencing entries being individual articles published in
-     the proceedings.  In some circumstances, you may want to avoid
-     these automatic inclusions altogether; to do this, make N a
-     sufficiently large number.
+     the proceedings.
 
+     If you want to avoid these automatic inclusions altogether, make N
+     a sufficiently large number, and be sure to remove any previous
+     .aux and .bbl files.  Otherwise the option may appear to have no
+     effect, since BibTeX will have added the citation for E to the
+     .aux, and nothing will remove it.
+
    See also:
 'btxdoc.tex'
      Basic LaTeXable documentation for general BibTeX users.
@@ -2318,9 +2322,9 @@
 
 * Menu:
 
-* tangle invocation::           
-* weave invocation::            
-* pooltype invocation::         
+* tangle invocation::
+* weave invocation::
+* pooltype invocation::
 
 
 File: web2c.info,  Node: tangle invocation,  Next: weave invocation,  Up: WEB
@@ -2559,7 +2563,7 @@
 
 * Menu:
 
-* dvitype output example::      
+* dvitype output example::
 
 
 File: web2c.info,  Node: dvitype output example,  Up: dvitype invocation
@@ -3635,7 +3639,7 @@
 * bibliography items, cross-referenced:  bibtex invocation.   (line  31)
 * bibtex:                                bibtex invocation.   (line   6)
 * BibTeX:                                BibTeX.              (line   6)
-* BibTeX collection:                     bibtex invocation.   (line  54)
+* BibTeX collection:                     bibtex invocation.   (line  58)
 * BibTeX style files:                    Basic BibTeX style files.
                                                               (line   6)
 * BigEndian machines:                    Hardware and memory dumps.
@@ -3647,9 +3651,9 @@
 * Breitenlohner, Peter:                  Introduction.        (line   9)
 * BSTINPUTS, search path for bst files:  bibtex invocation.   (line  18)
 * btex for MetaPost labels:              mpost invocation.    (line  48)
-* btxdoc.bib:                            bibtex invocation.   (line  48)
-* btxdoc.tex:                            bibtex invocation.   (line  42)
-* btxhak.tex:                            bibtex invocation.   (line  45)
+* btxdoc.bib:                            bibtex invocation.   (line  52)
+* btxdoc.tex:                            bibtex invocation.   (line  46)
+* btxhak.tex:                            bibtex invocation.   (line  49)
 * byte position:                         pktype invocation.   (line  40)
 * byte position <1>:                     gftype invocation.   (line  76)
 * byte swapping:                         Hardware and memory dumps.
@@ -3830,7 +3834,7 @@
                                                               (line  21)
 * Free Software Foundation documentation system: Formats.     (line  47)
 * freedom of Web2c:                      Introduction.        (line  23)
-* ftp.math.utah.edu:                     bibtex invocation.   (line  54)
+* ftp.math.utah.edu:                     bibtex invocation.   (line  58)
 * generating source specials:            tex invocation.      (line 133)
 * geometric designs:                     Metafont.            (line   6)
 * geometric font scaling:                Font file formats.   (line  21)
@@ -4212,7 +4216,7 @@
 * string numbers, displaying:            pooltype invocation. (line   6)
 * string pool, writing:                  tangle invocation.   (line  16)
 * string representation:                 pooltype invocation. (line  30)
-* style design, for BibTeX:              bibtex invocation.   (line  45)
+* style design, for BibTeX:              bibtex invocation.   (line  49)
 * style files:                           mft invocation.      (line  67)
 * substitutions of font glyphs:          MLTeX.               (line   6)
 * sun:                                   Online Metafont graphics.
@@ -4245,7 +4249,7 @@
 * terminator for filenames:              \input filenames.    (line  10)
 * terse output:                          bibtex invocation.   (line  28)
 * tex:                                   tex invocation.      (line   6)
-* TeX, bibliographies for:               bibtex invocation.   (line  54)
+* TeX, bibliographies for:               bibtex invocation.   (line  58)
 * TeX, creating from Metafont:           mft invocation.      (line   6)
 * TeX, creating from WEB:                weave invocation.    (line   6)
 * TeX, description of:                   TeX.                 (line   6)
@@ -4297,7 +4301,7 @@
 * Troff, and MetaPost:                   mpost invocation.    (line  65)
 * Troff, WEB for:                        WEB.                 (line  12)
 * Trojan horses and TeX programs:        tex invocation.      (line  48)
-* TUGboat bibliography:                  bibtex invocation.   (line  54)
+* TUGboat bibliography:                  bibtex invocation.   (line  58)
 * Type 1 conversion:                     Font utilities available elsewhere.
                                                               (line  39)
 * type design, personal:                 Initial Metafont.    (line  31)
@@ -4362,7 +4366,7 @@
                                                               (line  69)
 * X toolkits and Metafont:               Online Metafont graphics.
                                                               (line  59)
-* xampl.bib:                             bibtex invocation.   (line  51)
+* xampl.bib:                             bibtex invocation.   (line  55)
 * xbfe, bitmap font editor:              Font utilities available elsewhere.
                                                               (line  23)
 * XeTeX:                                 TeX extensions.      (line  31)
@@ -4432,28 +4436,28 @@
 Node: dvitomp invocation91116
 Node: BibTeX91781
 Node: bibtex invocation92142
-Node: Basic BibTeX style files94440
-Node: WEB95770
-Node: tangle invocation97011
-Node: weave invocation99134
-Node: pooltype invocation100541
-Node: DVI utilities101671
-Node: dvicopy invocation102603
-Node: dvitype invocation103886
-Node: dvitype output example106221
-Node: Font utilities109272
-Node: Font file formats110452
-Node: gftopk invocation113721
-Node: pktogf invocation114912
-Node: pktype invocation116078
-Node: gftype invocation118901
-Node: tftopl invocation123404
-Node: pltotf invocation127997
-Node: vftovp invocation129048
-Node: vptovf invocation131283
-Node: Font utilities available elsewhere132310
-Node: Legalisms134690
-Node: References136844
-Node: Index141411
+Node: Basic BibTeX style files94616
+Node: WEB95946
+Node: tangle invocation97155
+Node: weave invocation99278
+Node: pooltype invocation100685
+Node: DVI utilities101815
+Node: dvicopy invocation102747
+Node: dvitype invocation104030
+Node: dvitype output example106359
+Node: Font utilities109410
+Node: Font file formats110590
+Node: gftopk invocation113859
+Node: pktogf invocation115050
+Node: pktype invocation116216
+Node: gftype invocation119039
+Node: tftopl invocation123542
+Node: pltotf invocation128135
+Node: vftovp invocation129186
+Node: vptovf invocation131421
+Node: Font utilities available elsewhere132448
+Node: Legalisms134828
+Node: References136982
+Node: Index141549
 
 End Tag Table

Modified: trunk/Build/source/texk/web2c/doc/web2c.texi
===================================================================
--- trunk/Build/source/texk/web2c/doc/web2c.texi	2018-02-23 16:18:47 UTC (rev 46718)
+++ trunk/Build/source/texk/web2c/doc/web2c.texi	2018-02-23 19:30:01 UTC (rev 46719)
@@ -2699,9 +2699,14 @@
 @t{.bbl} file, even if it was not explicitly referenced in the @t{.aux}
 file. For example, @var{e} might be a conference proceedings as a whole,
 with the cross-referencing entries being individual articles published
-in the proceedings.  In some circumstances, you may want to avoid these
-automatic inclusions altogether; to do this, make @var{n} a sufficiently
-large number.
+in the proceedings.
+
+If you want to avoid these automatic inclusions altogether, make
+ at var{n} a sufficiently large number, and be sure to remove any
+previous @t{.aux} and @t{.bbl} files.  Otherwise the option may
+appear to have no effect, since Bib at TeX{} will have added the citation
+for @var{e} to the @t{.aux}, and nothing will remove it.
+
 @end table
 
 See also:

Modified: trunk/Build/source/texk/web2c/man/ChangeLog
===================================================================
--- trunk/Build/source/texk/web2c/man/ChangeLog	2018-02-23 16:18:47 UTC (rev 46718)
+++ trunk/Build/source/texk/web2c/man/ChangeLog	2018-02-23 19:30:01 UTC (rev 46719)
@@ -1,3 +1,9 @@
+2018-02-23  Karl Berry  <karl at freefriends.org>
+
+	* bibtex.man: mention need to remove aux file from previous run
+	for -min-crossrefs to be effective.
+	https://tex.stackexchange.com/questions/123740
+
 2018-01-18  Karl Berry  <karl at freefriends.org>
 
 	* mf.man: spacing, no openin, per Debian.

Modified: trunk/Build/source/texk/web2c/man/bibtex.man
===================================================================
--- trunk/Build/source/texk/web2c/man/bibtex.man	2018-02-23 16:18:47 UTC (rev 46718)
+++ trunk/Build/source/texk/web2c/man/bibtex.man	2018-02-23 19:30:01 UTC (rev 46719)
@@ -1,4 +1,4 @@
-.TH BIBTEX 1 "16 June 2015" "bibtex 0.99d" "Web2C @VERSION@"
+.TH BIBTEX 1 "23 February 2018" "bibtex 0.99d" "Web2C @VERSION@"
 .\"=====================================================================
 .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
 .if n .ds TX TeX
@@ -63,8 +63,20 @@
 .B \-min-crossrefs
 option defines the minimum number of
 .B crossref
-required for automatic inclusion of the crossref'd entry on the citation
+required for automatic inclusion of the crossref base entry in the citation
 list; the default is two. 
+To avoid these automatic inclusions altogether, give this option
+a sufficiently large number, and be sure to remove any
+previous
+.B .aux 
+and
+.B .bbl
+files.  Otherwise the option may
+appear to have no effect, since \*(BX will have added the citation
+for the base entry to the
+.B .aux
+file, and nothing will remove it.
+.PP
 With the
 .B \-terse
 option, \*(BX operates silently.  Without it, a banner and progress

Modified: trunk/Build/source/utils/README
===================================================================
--- trunk/Build/source/utils/README	2018-02-23 16:18:47 UTC (rev 46718)
+++ trunk/Build/source/utils/README	2018-02-23 19:30:01 UTC (rev 46719)
@@ -75,7 +75,8 @@
 #
 # you may need this hack on 64-bit systems
 # if clisp's configure does not find libsigsegv.  Harmless to do in any case.
-ln -s lib $clisp_toolsdir/lib64
+ln -s lib $clisp_toolsdir/lib64 # for GNU/Linux 64-bit
+ln -s . $clisp_toolsdir/lib/64  # for Solaris 64-bit
 #
 # if you can't build libsigsegv, pass --ignore-absence-of-libsigsegv
 # when running configure for clisp.
@@ -82,7 +83,7 @@
 
 ffcall_ver=libffcall-2.1
 cd $clisp_basedir
-$wget https://ftp.gnu.org/gnu/libsigsegv/$ffcall_ver.tar.gz
+$wget https://ftp.gnu.org/gnu/libffcall/$ffcall_ver.tar.gz
 gzip -dc $ffcall_ver.tar.gz | tar xf -
 cd $ffcall_ver
 ./configure -C --prefix=$clisp_toolsdir --disable-shared --enable-static \
@@ -104,7 +105,7 @@
 # foil wrong attempts at dynamic linking, etc.
 (cd $clisp_basedir/clisp-tools/lib && rm -f *.dylib *.la)
 
-clisp_ver=clisp-2.49.50
+clisp_ver=clisp-2.49.92
 cd $clisp_basedir
 $wget https://haible.de/bruno/gnu/clisp-2.49.50.tar.bz2
 bunzip2 -dc $clisp_ver.tar.bz2 | tar xf -
@@ -118,9 +119,13 @@
 #
 ./configure CPPFLAGS=-DUNIX_BINARY_DISTRIB --prefix=$clisp_toolsdir \
   --without-readline --without-dynamic-modules --without-termcap-ncurses \
-  --disable-nls --enable-portability \
+  --disable-nls \
   --with-libsigsegv-prefix=$clisp_toolsdir \
   --with-libffcall-prefix=$clisp_toolsdir \
   --with-libiconv-prefix=$clisp_toolsdir \
   $clisp_builddir \
 && (cd $clisp_builddir && make)
+
+There may be clisp test failures relating to sockets on some
+systems. Since xindy doesn't use sockets, we can ignore those for TL.
+



More information about the tex-live-commits mailing list