docbkx-tools: Testing DocBook XSL 1.77.0

docbkx-tools logo DocBook XSL 1.77.0 has been out for a couple of weeks. I have not found anything unexpected, yet.

ForgeRock core docs have three layers to build between the stylesheets and the docs that use forgerock-doc-maven-plugin. Here is what I did in order to enable testing:

  1. Get the DocBook Maven project,, update the versions to pull the latest stylesheets, and mvn install a local copy.
    $ svn diff
    Index: docbook-xsl/pom.xml
    --- docbook-xsl/pom.xml	(revision 9386)
    +++ docbook-xsl/pom.xml	(working copy)
    @@ -5,7 +5,7 @@
       <name>DocBook XSL Stylesheets</name>
    -  <version>1.76.1</version>
    +  <version>1.77.0</version>
       <description>These are XSL stylesheets for transforming DocBook XML document instances into various output formats.
    @@ -18,8 +18,8 @@
    -    <docbook.xsl.release>docbook-xsl-1.76.1</docbook.xsl.release>
    -    <docbook.xslns.release>docbook-xsl-ns-1.76.1</docbook.xslns.release>
    +    <docbook.xsl.release>docbook-xsl-1.77.0</docbook.xsl.release>
    +    <docbook.xslns.release>docbook-xsl-ns-1.77.0</docbook.xslns.release>
  2. Get docbkx-tools,, update the stylesheet version, and mvn install a local copy.
    $ svn diff
    Index: docbkx-maven-plugin/pom.xml
    --- docbkx-maven-plugin/pom.xml	(revision 258)
    +++ docbkx-maven-plugin/pom.xml	(working copy)
    @@ -62,7 +62,7 @@
    -      <version>1.76.1</version>
    +      <version>1.77.0</version>
  3. Get forgerock-doc-maven-plugin,, update the docbkx-tools version, and mvn install a local copy.
    Update: Thanks to Chris Ridd. Also need to change as shown.

    $ svn diff
    Index: src/main/java/org/forgerock/doc/maven/
    --- src/main/java/org/forgerock/doc/maven/	(revision 311)
    +++ src/main/java/org/forgerock/doc/maven/	(working copy)
    @@ -32,7 +32,7 @@
          * Docbkx Tools plugin version to use. Executions seem to hit an NPE when
          * the version is not specified.
    -     * @parameter default-value="2.0.14" expression="${docbkxVersion}
    +     * @parameter default-value="2.0.15-SNAPSHOT" expression="${docbkxVersion}
          * @required
         private String docbkxVersion;
    Index: pom.xml
    --- pom.xml	(revision 312)
    +++ pom.xml	(working copy)
    @@ -61,7 +61,7 @@
    -  <docbkxVersion>2.0.14</docbkxVersion>
    +  <docbkxVersion>2.0.15-SNAPSHOT</docbkxVersion>
  4. Use your local Maven installation to build your test documentation.

Leave a comment

Filed under Docs, Tools

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s