summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-02-20 18:24:46 +0000
committerKarl Berry <karl@freefriends.org>2018-02-20 18:24:46 +0000
commit7c1e49f3f8af11f0fd9e70027017b318ac81fea7 (patch)
tree79a2399402c9208b4dd429d8c2157b6d8f4fc165
parent64520e9c28f986551d982afb021df96193d23e51 (diff)
texinfo syntax
git-svn-id: svn://tug.org/texlive/trunk@46685 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Build/source/doc/ChangeLog8
-rw-r--r--Build/source/doc/tlbuild.info705
-rw-r--r--Build/source/doc/tlbuild.texi22
3 files changed, 416 insertions, 319 deletions
diff --git a/Build/source/doc/ChangeLog b/Build/source/doc/ChangeLog
index a3b45a264a5..fff890b60d6 100644
--- a/Build/source/doc/ChangeLog
+++ b/Build/source/doc/ChangeLog
@@ -1,3 +1,11 @@
+2018-02-20 Karl Berry <karl@freefriends.org>
+
+ * tlbuild.texi (Continuous integration): Texinfo syntax.
+
+2018-02-20 Norbert Preining <norbert@preining.info>
+
+ * tlbuild.texi (Continuous integration): new chapter.
+
2018-02-10 Karl Berry <karl@freefriends.org>
* tlbuild.texi (Adding a new program module): more specifics
diff --git a/Build/source/doc/tlbuild.info b/Build/source/doc/tlbuild.info
index 3dda348da6b..1e2ca4fd3da 100644
--- a/Build/source/doc/tlbuild.info
+++ b/Build/source/doc/tlbuild.info
@@ -49,6 +49,7 @@ For an overview of this manual, *note Introduction::.
* Configure options:: List of all configure options.
* Cross compilation:: Building on host X for target Y.
* Coding conventions:: Conventions to follow.
+* Continuous integration:: Automated build testing.
* install-tl:: The TeX Live installer.
* tlmgr:: The native TeX Live package manager.
* Index:: General index.
@@ -1909,7 +1910,7 @@ sufficiently recent installed versions of 'tangle', 'ctangle',
thus cross compilation is not possible.

-File: tlbuild.info, Node: Coding conventions, Next: install-tl, Prev: Cross compilation, Up: Top
+File: tlbuild.info, Node: Coding conventions, Next: Continuous integration, Prev: Cross compilation, Up: Top
9 Coding conventions
********************
@@ -2031,7 +2032,86 @@ must be carefully analyzed to make sure that they cannot cause the
modification of quantities supposed to be constant.

-File: tlbuild.info, Node: install-tl, Next: tlmgr, Prev: Coding conventions, Up: Top
+File: tlbuild.info, Node: Continuous integration, Next: install-tl, Prev: Coding conventions, Up: Top
+
+10 Continuous integration
+*************************
+
+The sources of TeX Live are subjected to continuous integration testing
+on Travis-CI (<https://travis-ci.org/TeX-Live/texlive-source>) via a
+git-svn mirror of the sources that is pushed to Github
+(<https://github.com/TeX-Live/texlive-source>). The git-svn mirror is
+updated (currently) at a 30min interval and only the last commit pushed
+is tested on Travis-CI.
+
+Transfer from Subversion to Github
+----------------------------------
+
+Git-svn (<https://git-scm.com/docs/git-svn>) is used to check out the
+subtree 'Build/source' of the Subversion repository. The author index
+file used is not maintained in Git or Subversion but provided on demand.
+
+ TODO what should we do here with the author index file? It contains
+a mapping from subversion names to name/email as shown in git.
+
+ The initial checkout was done by invoking 'git svn --authors-file
+usermap clone svn://USER@tug.org/texlive/trunk/Build/source' where the
+'usermap' file maps subversion user names to name and emails of the
+authors.
+
+ TODO should we use anonymous checkout here? Should be possible!
+
+ In the following we will refer with _admin_ to a user who has
+read/write access to the TeX Live subversion repository, and an
+administrator of the 'TeX-Live' Team on Github. The above initial
+checkout has been carried out by _admin_ on the server 'texlive.info'.
+
+ On Github (<https://github.com/>) a new git repository named
+'texlive-source' was created by _admin_ within the 'TeX-Live'
+organization (<https://github.com/TeX-Live/>), the remote added to the
+checkout with 'git remote add origin
+git@github.com:TeX-Live/texlive-source.git'.
+
+ To automate the update on Github, a new ssh key was generated and
+added to the 'texlive-source' repository on Github as deployment key.
+This way pushes using this key can only go to the 'texlive-source'
+repository and not anywhere else.
+
+ The usage of 'git-svn' requires a strict discipline to keep a linear
+history in the master branch. Since we are aiming at a pure mirror
+facility, we have decided to further restrict the 'master' branch of the
+'texlive-source' repository on Github to changes by _admin_.
+
+ This setup allows other developers to branch of 'master' and push
+their branches to the Github repository, but all updates need to from
+the local 'master' (not the one on Github) to Subversion and back to
+'master' on 'texlive.info' and from there to Github. See below for
+setup for developers.
+
+Automatic update of the Git mirror
+----------------------------------
+
+_admin_ has installed a cron job on 'texlive.info' running every 30min
+which basically runs 'git svn rebase' and 'git push' in the 'master'
+branch of the checkout. The first command fetches the changes from the
+Subversion repository and updates the 'master' branch with them, the
+second one pushes changes (if available) to Github.
+
+CI testing on Travis-CI
+-----------------------
+
+The 'source' tree of TeX Live contains a file '.travis.yml' which
+controls the automatic testing on Travis-CI. _admin_ has registered to
+Travis-CI and allowed access to the Github's 'TeX-Live' organization's
+'texlive-source' repository. The default settings are to build the last
+commit of each push. No further action is necessary on Travis-CI.
+
+ In case changes have been pushed during the cron job mentioned above,
+Travis-CI will automatically checkout the last pushed commit and try
+building it.
+
+
+File: tlbuild.info, Node: install-tl, Next: tlmgr, Prev: Continuous integration, Up: Top
Appendix A install-tl
*********************
@@ -4617,6 +4697,8 @@ Index
* CC_BUILD: Cross problems. (line 13)
* chktex: Declarations and definitions.
(line 18)
+* ci: Continuous integration.
+ (line 6)
* clisp: Variables for configure.
(line 18)
* CLISP: Variables for configure.
@@ -4658,6 +4740,8 @@ Index
(line 6)
* configuring, for cross compilation: Cross configuring. (line 6)
* const: Const. (line 6)
+* continuous integration: Continuous integration.
+ (line 6)
* conventions, coding: Coding conventions. (line 6)
* CPPFLAGS: Variables for configure.
(line 12)
@@ -4933,6 +5017,8 @@ Index
* top-level directories: Top-level directories.
(line 6)
* touching files to avoid rerunning: Build system tools. (line 39)
+* Travis-CI: Continuous integration.
+ (line 6)
* type cast, avoiding: Const. (line 38)
* use-commit-times, Subversion: Build system tools. (line 34)
* variable declarations, in source code: Declarations and definitions.
@@ -4984,312 +5070,313 @@ Index

Tag Table:
Node: Top1208
-Node: Introduction2126
-Node: Overview of build system3881
-Node: Prerequisites5924
-Node: Building8322
-Node: Build iteration9570
-Node: Build problems10642
-Node: Build in parallel11045
-Node: Build distribution11637
-Node: Build one package12208
-Node: Installing15560
-Node: Installation directories16575
-Node: Linked scripts18391
-Node: Distro builds19872
-Node: Layout and infrastructure22262
-Node: Build system tools23090
-Node: Top-level directories25101
-Node: Autoconf macros27515
-Node: General setup macros28216
-Node: Macros for programs29083
-Node: Macros for compilers29895
-Node: Macros for libraries31329
-Node: Macros for library and header flags31755
-Node: Macros for Windows33635
-Node: Library modules35212
-Node: png library35701
-Node: zlib library37975
-Node: freetype library38490
-Node: kpathsea library39018
-Node: Program modules40417
-Node: t1utils package40845
-Node: xindy package41396
-Node: xdvik package42546
-Node: asymptote43619
-Node: Extending TeX Live44070
-Node: Adding a new program module44847
-Node: Adding a new generic library module48142
-Node: Adding a new TeX-specific library module50355
-Node: Configure options51042
-Node: Global configure options52424
-Node: --disable-native-texlive-build52966
-Node: --prefix --bindir ...53956
-Node: --disable-largefile54496
-Node: --disable-missing55181
-Node: --enable-compiler-warnings=LEVEL55582
-Node: --enable-cxx-runtime-hack56321
-Node: --enable-maintainer-mode56748
-Node: --enable-multiplatform57277
-Node: --enable-shared57815
-Node: --enable-silent-rules58186
-Node: --without-ln-s58642
-Node: --without-x58993
-Node: Program-specific configure options59181
-Node: --enable-PROG --disable-PROG59824
-Node: --disable-all-pkgs60101
-Node: Configure options for texk/web2c61087
-Node: Configure options for texk/bibtex-x63605
-Node: Configure options for texk/dvipdfm-x64148
-Node: Configure options for texk/dvisvgm64921
-Node: Configure options for texk/texlive65807
-Node: Configure options for texk/xdvik66228
-Node: Configure options for utils/xindy66832
-Node: Library-specific configure options67733
-Node: Configure options for kpathsea68744
-Node: Configure options for system poppler69453
-Node: Variables for configure70244
-Node: Cross compilation71672
-Node: Cross configuring72971
-Node: Cross problems74644
-Node: Coding conventions76291
-Node: Declarations and definitions77018
-Node: Const79200
-Node: install-tl81063
-Node: install-tl NAME81404
-Node: install-tl SYNOPSIS81562
-Node: install-tl DESCRIPTION81770
-Node: install-tl REFERENCES82771
-Node: install-tl OPTIONS83287
-Ref: install-tl *-gui* [[=]_module_]83641
-Ref: install-tl text83850
-Ref: install-tl wizard83973
-Ref: install-tl perltk84127
-Ref: install-tl *-no-gui*84561
-Ref: install-tl *-lang* _llcode_84642
-Ref: install-tl *-repository* _url|path_85329
-Ref: install-tl *-select-repository*87140
-Ref: install-tl *-all-options*87576
-Ref: install-tl *-custom-bin* _path_87883
-Ref: install-tl *-debug-translation*88538
-Ref: install-tl *-force-platform* _platform_88757
-Ref: install-tl *-help*, *--help*, *-?*89001
-Ref: install-tl *-in-place*89394
-Ref: install-tl *-logfile* _file_89921
-Ref: install-tl *-no-cls*90272
-Ref: install-tl *-non-admin*90403
-Ref: install-tl *--persistent-downloads*90508
-Ref: install-tl *--no-persistent-downloads*90536
-Ref: install-tl *-portable*91144
-Ref: install-tl *-print-platform*91283
-Ref: install-tl *-profile* _profile_91476
-Ref: install-tl *-q*92970
-Ref: install-tl *-scheme* _scheme_93032
-Ref: install-tl *-v*93506
-Ref: install-tl *-version*, *--version*93667
-Node: install-tl ENVIRONMENT VARIABLES93798
-Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK94187
-Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE94389
-Ref: install-tl TEXLIVE_INSTALL_PREFIX94495
-Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG94526
-Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME94555
-Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL94585
-Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG94619
-Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR94650
-Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR94678
-Ref: install-tl NOPERLDOC94733
-Node: install-tl AUTHORS AND COPYRIGHT94797
-Node: tlmgr95155
-Node: tlmgr NAME95592
-Node: tlmgr SYNOPSIS95717
-Node: tlmgr DESCRIPTION95907
-Node: tlmgr EXAMPLES97003
-Ref: tlmgr tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet97294
-Ref: tlmgr tlmgr update --list97475
-Ref: tlmgr tlmgr update --all97568
-Ref: tlmgr tlmgr info _pkg_97724
-Node: tlmgr OPTIONS97930
-Ref: tlmgr *--repository* _url|path_98450
-Ref: tlmgr *--gui* [_action_]99175
-Ref: tlmgr *--gui-lang* _llcode_99582
-Ref: tlmgr *--debug-translation*100265
-Ref: tlmgr *--machine-readable*100468
-Ref: tlmgr *--no-execute-actions*100736
-Ref: tlmgr *--package-logfile* _file_100929
-Ref: tlmgr *--pause*101184
-Ref: tlmgr *--persistent-downloads*101339
-Ref: tlmgr *--no-persistent-downloads*101367
-Ref: tlmgr *--pin-file*101861
-Ref: tlmgr *--usermode*102079
-Ref: tlmgr *--usertree* _dir_102199
-Node: tlmgr ACTIONS102749
-Node: tlmgr help103981
-Node: tlmgr version104457
-Node: tlmgr backup [--clean[=_N_]] [--backupdir _dir_] [--all | _pkg_]...104775
-Ref: tlmgr *--backupdir* _directory_105869
-Ref: tlmgr *--all*106066
-Ref: tlmgr *--clean*[=_N_]106288
-Ref: tlmgr *--dry-run*106585
-Node: tlmgr candidates _pkg_106705
-Ref: tlmgr *candidates _pkg_* 1106992
-Node: tlmgr check [_option_]... [files|depends|executes|runfiles|all]107136
-Ref: tlmgr *files*107579
-Ref: tlmgr *depends*107714
-Ref: tlmgr *executes*108056
-Ref: tlmgr *runfiles*108174
-Ref: tlmgr *--use-svn*108286
-Node: tlmgr conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]108403
-Node: tlmgr dump-tlpdb [--local|--remote]110475
-Ref: tlmgr *--local*110985
-Ref: tlmgr *--remote*111024
-Node: tlmgr generate [_option_]... _what_111446
-Ref: tlmgr *generate language*111687
-Ref: tlmgr *generate language.dat*111712
-Ref: tlmgr *generate language.def*111737
-Ref: tlmgr *generate language.dat.lua*111766
-Ref: tlmgr *generate fmtutil*111786
-Ref: tlmgr *--dest* _output_file_114023
-Ref: tlmgr *--localcfg* _local_conf_file_114599
-Ref: tlmgr *--rebuild-sys*114722
-Node: tlmgr gui115583
-Node: tlmgr info [_option_...] [collections|schemes|_pkg_...]115827
-Ref: tlmgr *--list*117032
-Ref: tlmgr *--only-installed*117311
-Ref: tlmgr *--taxonomy*117526
-Ref: tlmgr *--keyword*117538
-Ref: tlmgr *--functionality*117556
-Ref: tlmgr *--characterization*117577
-Node: tlmgr init-usertree117790
-Node: tlmgr install [_option_]... _pkg_...118216
-Ref: tlmgr *--file*118580
-Ref: tlmgr *--reinstall*118806
-Ref: tlmgr *--no-depends*119186
-Ref: tlmgr *--no-depends-at-all*119345
-Ref: tlmgr *--dry-run* 1119743
-Ref: tlmgr *--force*119861
-Node: tlmgr option120067
-Ref: tlmgr *option [show]*120240
-Ref: tlmgr *option showall*120258
-Ref: tlmgr *option _key_ [_value_]*120284
-Node: tlmgr paper124132
-Ref: tlmgr *paper [a4|letter]*124317
-Ref: tlmgr *[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*124391
-Node: tlmgr path [--w32mode=user|admin] [add|remove]125418
-Node: tlmgr pinning126901
-Ref: tlmgr pinning show127208
-Ref: tlmgr pinning add _repo_ _pkgglob_...127281
-Ref: tlmgr pinning remove _repo_ _pkgglob_...127400
-Ref: tlmgr pinning remove _repo_ --all127553
-Node: tlmgr platform list|add|remove _platform_...127607
-Node: tlmgr platform set _platform_127855
-Node: tlmgr platform set auto128083
-Ref: tlmgr *--dry-run* 2129200
-Node: tlmgr postaction [--w32mode=user|admin] [--fileassocmode=1|2] [--all] [install|remove] [shortcut|fileassoc|script] [_pkg_]...129309
-Node: tlmgr print-platform130611
-Node: tlmgr restore [--backupdir _dir_] [--all | _pkg_ [_rev_]]131083
-Ref: tlmgr *--all* 1131979
-Ref: tlmgr *--backupdir* _directory_ 1132173
-Ref: tlmgr *--dry-run* 3132329
-Ref: tlmgr *--force* 1132446
-Node: tlmgr remove [_option_]... _pkg_...132474
-Ref: tlmgr *--no-depends* 1132997
-Ref: tlmgr *--no-depends-at-all* 1133059
-Ref: tlmgr *--force* 2133115
-Ref: tlmgr *--dry-run* 4133587
-Node: tlmgr repository133694
-Ref: tlmgr *repository list*133902
-Ref: tlmgr *repository list _path|tag_*133932
-Ref: tlmgr *repository add _path_ [_tag_]*133965
-Ref: tlmgr *repository remove _path|tag_*133997
-Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*134051
-Node: tlmgr search [_option_...] _what_135135
-Node: tlmgr search [_option_...] --file _what_135646
-Node: tlmgr search [_option_...] --taxonomy _what_135897
-Node: tlmgr search [_option_...] --keyword _what_136208
-Node: tlmgr search [_option_...] --functionality _what_136526
-Node: tlmgr search [_option_...] --characterization _what_136864
-Node: tlmgr search [_option_...] --all _what_137204
-Ref: tlmgr *--global*137652
-Ref: tlmgr *--word*137764
-Ref: tlmgr *--list* 1138003
-Ref: tlmgr *--file* 1138349
-Ref: tlmgr *--taxonomy* 1138406
-Ref: tlmgr *--keyword* 1138418
-Ref: tlmgr *--functionality* 1138436
-Ref: tlmgr *--characterization* 1138457
-Ref: tlmgr *--all* 2138612
-Node: tlmgr uninstall138695
-Ref: tlmgr *--force* 3138949
-Node: tlmgr update [_option_]... [_pkg_]...139005
-Ref: tlmgr *--all* 3139376
-Ref: tlmgr *--self*141117
-Ref: tlmgr *--dry-run* 5141881
-Ref: tlmgr *--list* [_pkg_]142058
-Ref: tlmgr *--exclude* _pkg_142747
-Ref: tlmgr *--no-auto-remove* [_pkg_]...143440
-Ref: tlmgr *--no-auto-install* [_pkg_]...143891
-Ref: tlmgr *--reinstall-forcibly-removed*144547
-Ref: tlmgr *--backup* and *--backupdir* _directory_145111
-Ref: tlmgr *--no-depends* 2146292
-Ref: tlmgr *--no-depends-at-all* 2146495
-Ref: tlmgr *--force* 4146551
-Node: tlmgr USER MODE146977
-Node: tlmgr user mode install149788
-Node: tlmgr user mode backup; restore; remove; update150735
-Node: tlmgr user mode generate; option; paper151177
-Node: tlmgr CONFIGURATION FILE FOR TLMGR151553
-Node: tlmgr TAXONOMIES152644
-Ref: tlmgr --keyword 2153270
-Ref: tlmgr --functionality 2153355
-Ref: tlmgr --characterization 2153511
-Ref: tlmgr --taxonomy 2153652
-Node: tlmgr MULTIPLE REPOSITORIES154193
-Node: tlmgr Pinning155914
-Node: tlmgr GUI FOR TLMGR157889
-Node: tlmgr Main display159111
-Node: tlmgr Display configuration area159363
-Ref: tlmgr Status159724
-Ref: tlmgr Category159888
-Ref: tlmgr Match160074
-Ref: tlmgr Selection160334
-Ref: tlmgr Display configuration buttons160538
-Node: tlmgr Package list area160721
-Ref: tlmgr a checkbox161305
-Ref: tlmgr package name161441
-Ref: tlmgr local revision (and version)161540
-Ref: tlmgr remote revision (and version)161915
-Ref: tlmgr short description162212
-Node: tlmgr Main display action buttons162257
-Ref: tlmgr Update all installed162523
-Ref: tlmgr Update162895
-Ref: tlmgr Install162945
-Ref: tlmgr Remove163131
-Ref: tlmgr Backup163309
-Node: tlmgr Menu bar163466
-Ref: tlmgr tlmgr menu163663
-Ref: tlmgr Options menu163971
-Ref: tlmgr Actions menu165054
-Ref: tlmgr Help menu165482
-Node: tlmgr MACHINE-READABLE OUTPUT165615
-Node: tlmgr Machine-readable update and install output166425
-Ref: tlmgr location-url _location_167701
-Ref: tlmgr total-bytes _count_167917
-Ref: tlmgr _pkgname_168327
-Ref: tlmgr _status_168537
-Ref: tlmgr d168615
-Ref: tlmgr f168675
-Ref: tlmgr u168854
-Ref: tlmgr r168900
-Ref: tlmgr a169023
-Ref: tlmgr i169201
-Ref: tlmgr I169320
-Ref: tlmgr _localrev_169422
-Ref: tlmgr _serverrev_169529
-Ref: tlmgr _size_169641
-Ref: tlmgr _runtime_169810
-Ref: tlmgr _esttot_169880
-Node: tlmgr Machine-readable option output169913
-Node: tlmgr AUTHORS AND COPYRIGHT170425
-Node: Index170772
+Node: Introduction2183
+Node: Overview of build system3938
+Node: Prerequisites5981
+Node: Building8379
+Node: Build iteration9627
+Node: Build problems10699
+Node: Build in parallel11102
+Node: Build distribution11694
+Node: Build one package12265
+Node: Installing15617
+Node: Installation directories16632
+Node: Linked scripts18448
+Node: Distro builds19929
+Node: Layout and infrastructure22319
+Node: Build system tools23147
+Node: Top-level directories25158
+Node: Autoconf macros27572
+Node: General setup macros28273
+Node: Macros for programs29140
+Node: Macros for compilers29952
+Node: Macros for libraries31386
+Node: Macros for library and header flags31812
+Node: Macros for Windows33692
+Node: Library modules35269
+Node: png library35758
+Node: zlib library38032
+Node: freetype library38547
+Node: kpathsea library39075
+Node: Program modules40474
+Node: t1utils package40902
+Node: xindy package41453
+Node: xdvik package42603
+Node: asymptote43676
+Node: Extending TeX Live44127
+Node: Adding a new program module44904
+Node: Adding a new generic library module48199
+Node: Adding a new TeX-specific library module50412
+Node: Configure options51099
+Node: Global configure options52481
+Node: --disable-native-texlive-build53023
+Node: --prefix --bindir ...54013
+Node: --disable-largefile54553
+Node: --disable-missing55238
+Node: --enable-compiler-warnings=LEVEL55639
+Node: --enable-cxx-runtime-hack56378
+Node: --enable-maintainer-mode56805
+Node: --enable-multiplatform57334
+Node: --enable-shared57872
+Node: --enable-silent-rules58243
+Node: --without-ln-s58699
+Node: --without-x59050
+Node: Program-specific configure options59238
+Node: --enable-PROG --disable-PROG59881
+Node: --disable-all-pkgs60158
+Node: Configure options for texk/web2c61144
+Node: Configure options for texk/bibtex-x63662
+Node: Configure options for texk/dvipdfm-x64205
+Node: Configure options for texk/dvisvgm64978
+Node: Configure options for texk/texlive65864
+Node: Configure options for texk/xdvik66285
+Node: Configure options for utils/xindy66889
+Node: Library-specific configure options67790
+Node: Configure options for kpathsea68801
+Node: Configure options for system poppler69510
+Node: Variables for configure70301
+Node: Cross compilation71729
+Node: Cross configuring73028
+Node: Cross problems74701
+Node: Coding conventions76348
+Node: Declarations and definitions77087
+Node: Const79269
+Node: Continuous integration81132
+Node: install-tl84689
+Node: install-tl NAME85034
+Node: install-tl SYNOPSIS85192
+Node: install-tl DESCRIPTION85400
+Node: install-tl REFERENCES86401
+Node: install-tl OPTIONS86917
+Ref: install-tl *-gui* [[=]_module_]87271
+Ref: install-tl text87480
+Ref: install-tl wizard87603
+Ref: install-tl perltk87757
+Ref: install-tl *-no-gui*88191
+Ref: install-tl *-lang* _llcode_88272
+Ref: install-tl *-repository* _url|path_88959
+Ref: install-tl *-select-repository*90770
+Ref: install-tl *-all-options*91206
+Ref: install-tl *-custom-bin* _path_91513
+Ref: install-tl *-debug-translation*92168
+Ref: install-tl *-force-platform* _platform_92387
+Ref: install-tl *-help*, *--help*, *-?*92631
+Ref: install-tl *-in-place*93024
+Ref: install-tl *-logfile* _file_93551
+Ref: install-tl *-no-cls*93902
+Ref: install-tl *-non-admin*94033
+Ref: install-tl *--persistent-downloads*94138
+Ref: install-tl *--no-persistent-downloads*94166
+Ref: install-tl *-portable*94774
+Ref: install-tl *-print-platform*94913
+Ref: install-tl *-profile* _profile_95106
+Ref: install-tl *-q*96600
+Ref: install-tl *-scheme* _scheme_96662
+Ref: install-tl *-v*97136
+Ref: install-tl *-version*, *--version*97297
+Node: install-tl ENVIRONMENT VARIABLES97428
+Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK97817
+Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE98019
+Ref: install-tl TEXLIVE_INSTALL_PREFIX98125
+Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG98156
+Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME98185
+Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL98215
+Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG98249
+Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR98280
+Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR98308
+Ref: install-tl NOPERLDOC98363
+Node: install-tl AUTHORS AND COPYRIGHT98427
+Node: tlmgr98785
+Node: tlmgr NAME99222
+Node: tlmgr SYNOPSIS99347
+Node: tlmgr DESCRIPTION99537
+Node: tlmgr EXAMPLES100633
+Ref: tlmgr tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet100924
+Ref: tlmgr tlmgr update --list101105
+Ref: tlmgr tlmgr update --all101198
+Ref: tlmgr tlmgr info _pkg_101354
+Node: tlmgr OPTIONS101560
+Ref: tlmgr *--repository* _url|path_102080
+Ref: tlmgr *--gui* [_action_]102805
+Ref: tlmgr *--gui-lang* _llcode_103212
+Ref: tlmgr *--debug-translation*103895
+Ref: tlmgr *--machine-readable*104098
+Ref: tlmgr *--no-execute-actions*104366
+Ref: tlmgr *--package-logfile* _file_104559
+Ref: tlmgr *--pause*104814
+Ref: tlmgr *--persistent-downloads*104969
+Ref: tlmgr *--no-persistent-downloads*104997
+Ref: tlmgr *--pin-file*105491
+Ref: tlmgr *--usermode*105709
+Ref: tlmgr *--usertree* _dir_105829
+Node: tlmgr ACTIONS106379
+Node: tlmgr help107611
+Node: tlmgr version108087
+Node: tlmgr backup [--clean[=_N_]] [--backupdir _dir_] [--all | _pkg_]...108405
+Ref: tlmgr *--backupdir* _directory_109499
+Ref: tlmgr *--all*109696
+Ref: tlmgr *--clean*[=_N_]109918
+Ref: tlmgr *--dry-run*110215
+Node: tlmgr candidates _pkg_110335
+Ref: tlmgr *candidates _pkg_* 1110622
+Node: tlmgr check [_option_]... [files|depends|executes|runfiles|all]110766
+Ref: tlmgr *files*111209
+Ref: tlmgr *depends*111344
+Ref: tlmgr *executes*111686
+Ref: tlmgr *runfiles*111804
+Ref: tlmgr *--use-svn*111916
+Node: tlmgr conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]112033
+Node: tlmgr dump-tlpdb [--local|--remote]114105
+Ref: tlmgr *--local*114615
+Ref: tlmgr *--remote*114654
+Node: tlmgr generate [_option_]... _what_115076
+Ref: tlmgr *generate language*115317
+Ref: tlmgr *generate language.dat*115342
+Ref: tlmgr *generate language.def*115367
+Ref: tlmgr *generate language.dat.lua*115396
+Ref: tlmgr *generate fmtutil*115416
+Ref: tlmgr *--dest* _output_file_117653
+Ref: tlmgr *--localcfg* _local_conf_file_118229
+Ref: tlmgr *--rebuild-sys*118352
+Node: tlmgr gui119213
+Node: tlmgr info [_option_...] [collections|schemes|_pkg_...]119457
+Ref: tlmgr *--list*120662
+Ref: tlmgr *--only-installed*120941
+Ref: tlmgr *--taxonomy*121156
+Ref: tlmgr *--keyword*121168
+Ref: tlmgr *--functionality*121186
+Ref: tlmgr *--characterization*121207
+Node: tlmgr init-usertree121420
+Node: tlmgr install [_option_]... _pkg_...121846
+Ref: tlmgr *--file*122210
+Ref: tlmgr *--reinstall*122436
+Ref: tlmgr *--no-depends*122816
+Ref: tlmgr *--no-depends-at-all*122975
+Ref: tlmgr *--dry-run* 1123373
+Ref: tlmgr *--force*123491
+Node: tlmgr option123697
+Ref: tlmgr *option [show]*123870
+Ref: tlmgr *option showall*123888
+Ref: tlmgr *option _key_ [_value_]*123914
+Node: tlmgr paper127762
+Ref: tlmgr *paper [a4|letter]*127947
+Ref: tlmgr *[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*128021
+Node: tlmgr path [--w32mode=user|admin] [add|remove]129048
+Node: tlmgr pinning130531
+Ref: tlmgr pinning show130838
+Ref: tlmgr pinning add _repo_ _pkgglob_...130911
+Ref: tlmgr pinning remove _repo_ _pkgglob_...131030
+Ref: tlmgr pinning remove _repo_ --all131183
+Node: tlmgr platform list|add|remove _platform_...131237
+Node: tlmgr platform set _platform_131485
+Node: tlmgr platform set auto131713
+Ref: tlmgr *--dry-run* 2132830
+Node: tlmgr postaction [--w32mode=user|admin] [--fileassocmode=1|2] [--all] [install|remove] [shortcut|fileassoc|script] [_pkg_]...132939
+Node: tlmgr print-platform134241
+Node: tlmgr restore [--backupdir _dir_] [--all | _pkg_ [_rev_]]134713
+Ref: tlmgr *--all* 1135609
+Ref: tlmgr *--backupdir* _directory_ 1135803
+Ref: tlmgr *--dry-run* 3135959
+Ref: tlmgr *--force* 1136076
+Node: tlmgr remove [_option_]... _pkg_...136104
+Ref: tlmgr *--no-depends* 1136627
+Ref: tlmgr *--no-depends-at-all* 1136689
+Ref: tlmgr *--force* 2136745
+Ref: tlmgr *--dry-run* 4137217
+Node: tlmgr repository137324
+Ref: tlmgr *repository list*137532
+Ref: tlmgr *repository list _path|tag_*137562
+Ref: tlmgr *repository add _path_ [_tag_]*137595
+Ref: tlmgr *repository remove _path|tag_*137627
+Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*137681
+Node: tlmgr search [_option_...] _what_138765
+Node: tlmgr search [_option_...] --file _what_139276
+Node: tlmgr search [_option_...] --taxonomy _what_139527
+Node: tlmgr search [_option_...] --keyword _what_139838
+Node: tlmgr search [_option_...] --functionality _what_140156
+Node: tlmgr search [_option_...] --characterization _what_140494
+Node: tlmgr search [_option_...] --all _what_140834
+Ref: tlmgr *--global*141282
+Ref: tlmgr *--word*141394
+Ref: tlmgr *--list* 1141633
+Ref: tlmgr *--file* 1141979
+Ref: tlmgr *--taxonomy* 1142036
+Ref: tlmgr *--keyword* 1142048
+Ref: tlmgr *--functionality* 1142066
+Ref: tlmgr *--characterization* 1142087
+Ref: tlmgr *--all* 2142242
+Node: tlmgr uninstall142325
+Ref: tlmgr *--force* 3142579
+Node: tlmgr update [_option_]... [_pkg_]...142635
+Ref: tlmgr *--all* 3143006
+Ref: tlmgr *--self*144747
+Ref: tlmgr *--dry-run* 5145511
+Ref: tlmgr *--list* [_pkg_]145688
+Ref: tlmgr *--exclude* _pkg_146377
+Ref: tlmgr *--no-auto-remove* [_pkg_]...147070
+Ref: tlmgr *--no-auto-install* [_pkg_]...147521
+Ref: tlmgr *--reinstall-forcibly-removed*148177
+Ref: tlmgr *--backup* and *--backupdir* _directory_148741
+Ref: tlmgr *--no-depends* 2149922
+Ref: tlmgr *--no-depends-at-all* 2150125
+Ref: tlmgr *--force* 4150181
+Node: tlmgr USER MODE150607
+Node: tlmgr user mode install153418
+Node: tlmgr user mode backup; restore; remove; update154365
+Node: tlmgr user mode generate; option; paper154807
+Node: tlmgr CONFIGURATION FILE FOR TLMGR155183
+Node: tlmgr TAXONOMIES156274
+Ref: tlmgr --keyword 2156900
+Ref: tlmgr --functionality 2156985
+Ref: tlmgr --characterization 2157141
+Ref: tlmgr --taxonomy 2157282
+Node: tlmgr MULTIPLE REPOSITORIES157823
+Node: tlmgr Pinning159544
+Node: tlmgr GUI FOR TLMGR161519
+Node: tlmgr Main display162741
+Node: tlmgr Display configuration area162993
+Ref: tlmgr Status163354
+Ref: tlmgr Category163518
+Ref: tlmgr Match163704
+Ref: tlmgr Selection163964
+Ref: tlmgr Display configuration buttons164168
+Node: tlmgr Package list area164351
+Ref: tlmgr a checkbox164935
+Ref: tlmgr package name165071
+Ref: tlmgr local revision (and version)165170
+Ref: tlmgr remote revision (and version)165545
+Ref: tlmgr short description165842
+Node: tlmgr Main display action buttons165887
+Ref: tlmgr Update all installed166153
+Ref: tlmgr Update166525
+Ref: tlmgr Install166575
+Ref: tlmgr Remove166761
+Ref: tlmgr Backup166939
+Node: tlmgr Menu bar167096
+Ref: tlmgr tlmgr menu167293
+Ref: tlmgr Options menu167601
+Ref: tlmgr Actions menu168684
+Ref: tlmgr Help menu169112
+Node: tlmgr MACHINE-READABLE OUTPUT169245
+Node: tlmgr Machine-readable update and install output170055
+Ref: tlmgr location-url _location_171331
+Ref: tlmgr total-bytes _count_171547
+Ref: tlmgr _pkgname_171957
+Ref: tlmgr _status_172167
+Ref: tlmgr d172245
+Ref: tlmgr f172305
+Ref: tlmgr u172484
+Ref: tlmgr r172530
+Ref: tlmgr a172653
+Ref: tlmgr i172831
+Ref: tlmgr I172950
+Ref: tlmgr _localrev_173052
+Ref: tlmgr _serverrev_173159
+Ref: tlmgr _size_173271
+Ref: tlmgr _runtime_173440
+Ref: tlmgr _esttot_173510
+Node: tlmgr Machine-readable option output173543
+Node: tlmgr AUTHORS AND COPYRIGHT174055
+Node: Index174402

End Tag Table
diff --git a/Build/source/doc/tlbuild.texi b/Build/source/doc/tlbuild.texi
index 2f9b48b232e..08b1e1e87d4 100644
--- a/Build/source/doc/tlbuild.texi
+++ b/Build/source/doc/tlbuild.texi
@@ -90,6 +90,7 @@ For an overview of this manual, @pxref{Introduction}.
* Configure options:: List of all configure options.
* Cross compilation:: Building on host X for target Y.
* Coding conventions:: Conventions to follow.
+* Continuous integration:: Automated build testing.
* install-tl:: The @TL{} installer.
* tlmgr:: The native @TL{} package manager.
* Index:: General index.
@@ -2482,11 +2483,12 @@ otherwise must be carefully analyzed to make sure that they cannot
cause the modification of quantities supposed to be constant.
-@node Continuous Integration
-@chapter Continuous Integration
+@node Continuous integration
+@chapter Continuous integration
@cindex ci
@cindex continuous integration
+@cindex Travis-CI
The sources of @TL{} are subjected to continuous integration testing on
Travis-CI (@url{https://travis-ci.org/TeX-Live/texlive-source}) via a
@@ -2513,8 +2515,8 @@ emails of the authors.
TODO should we use anonymous checkout here? Should be possible!
In the following we will refer with @emph{admin} to a user who has
-read/write access to the \TL{} subversion repository, and an
-administrator of the \@code{TeX-Live} Team on Github. The above initial
+read/write access to the @TL{} subversion repository, and an
+administrator of the @code{TeX-Live} Team on Github. The above initial
checkout has been carried out by @emph{admin} on the server
@code{texlive.info}.
@@ -2552,12 +2554,12 @@ available) to Github.
@subheading CI testing on Travis-CI
-The @code{source} tree of \TL{} already contains a file
-@code{.travis.yml} which controls the automatic testing on
-Travis-CI. @emph{admin} has registered to Travis-CI and allowed access
-to the Github's @code{TeX-Live} organization's @code{texlive-source}
-repository. The default settings are to build the last commit of each
-push. No further action is necessary on Travis-CI.
+The @code{source} tree of @TL{} contains a file @code{.travis.yml}
+which controls the automatic testing on Travis-CI. @emph{admin} has
+registered to Travis-CI and allowed access to the Github's
+@code{TeX-Live} organization's @code{texlive-source} repository. The
+default settings are to build the last commit of each push. No further
+action is necessary on Travis-CI.
In case changes have been pushed during the cron job mentioned above,
Travis-CI will automatically checkout the last pushed commit and try