From 7c1e49f3f8af11f0fd9e70027017b318ac81fea7 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Tue, 20 Feb 2018 18:24:46 +0000 Subject: texinfo syntax git-svn-id: svn://tug.org/texlive/trunk@46685 c570f23f-e606-0410-a88d-b1316a301751 --- Build/source/doc/ChangeLog | 8 + Build/source/doc/tlbuild.info | 705 ++++++++++++++++++++++++------------------ Build/source/doc/tlbuild.texi | 22 +- 3 files changed, 416 insertions(+), 319 deletions(-) (limited to 'Build') 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 + + * tlbuild.texi (Continuous integration): Texinfo syntax. + +2018-02-20 Norbert Preining + + * tlbuild.texi (Continuous integration): new chapter. + 2018-02-10 Karl Berry * 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 () via a +git-svn mirror of the sources that is pushed to Github +(). 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 () 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 () a new git repository named +'texlive-source' was created by _admin_ within the 'TeX-Live' +organization (), 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 -- cgit v1.2.3