]> git.ipfire.org Git - thirdparty/git.git/commitdiff
ci: stick with Asciidoctor v1.5.8 for now
authorSZEDER Gábor <szeder.dev@gmail.com>
Fri, 29 Mar 2019 19:52:46 +0000 (20:52 +0100)
committerJunio C Hamano <gitster@pobox.com>
Fri, 5 Apr 2019 05:40:40 +0000 (14:40 +0900)
The recent release of Asciidoctor v2.0.0 broke our documentation
build job on Travis CI, where we 'gem install asciidoctor', which
always brings us the latest and (supposedly) greatest.  Alas, we are
not ready for that just yet, because it removed support for DocBook
4.5, and we have been requiring that particular DocBook version to
build 'user-manual.xml' with Asciidoctor, resulting in:

  ASCIIDOC user-manual.xml
  asciidoctor: FAILED: missing converter for backend 'docbook45'. Processing aborted.
  Use --trace for backtrace
  make[1]: *** [user-manual.xml] Error 1

Unfortunately, we can't simply switch to DocBook 5 right away, as
doing so leads to validation errors from 'xmlto', and working around
those leads to yet another errors... [1]

So let's stick with Asciidoctor v1.5.8 (latest stable release before
v2.0.0) in our documentation build job on Travis CI for now, until we
figure out how to deal with the fallout from Asciidoctor v2.0.0.

[1] https://public-inbox.org/git/20190324162131.GL4047@pobox.com/

Signed-off-by: SZEDER Gábor <szeder.dev@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
ci/install-dependencies.sh

index 76ec308965dfaffbadcee47482c466863374ad2d..52a44c690a7a38850e77eb1525e6f8c56e782369 100755 (executable)
@@ -56,7 +56,7 @@ Documentation)
        sudo apt-get -q -y install asciidoc xmlto
 
        test -n "$ALREADY_HAVE_ASCIIDOCTOR" ||
-       gem install asciidoctor
+       gem install --version 1.5.8 asciidoctor
        ;;
 esac