Re: Building documentation, chunkfast.xsl URL in doc/style/kawa.xsl

["Sudarshan S Chawathe" <chaw@eip10.org>]

> Be aware that there are two sets of stylesheets: the newer DocBook 5 are
> namespace-aware, and the olrder ones aren't.
> Kawa requires the former.

That is a good catch; thanks!

> On Fedora there is both:
> 
> lrwxrwxrwx.  1 root root   25 Jul  8  2016 xsl-ns-stylesheets -> xsl-ns-stylesheets-1.79.1
> drwxr-xr-x. 28 root root 4096 Nov 16 15:23 xsl-ns-stylesheets-1.79.1
> lrwxrwxrwx.  1 root root   22 Jul  8  2016 xsl-stylesheets -> xsl-stylesheets-1.79.1
> drwxr-xr-x. 20 root root 4096 Nov 16 14:49 xsl-stylesheets-1.79.1
> 
> Kawa needs the xsl-ns-stylesheets ones.

Debian too seems to have both (and both are installed on my system, not
sure if that's the default): packages are docbook-xsl and
docbook-xsl-ns.

So based on the above, the correct path to give to configure's
--with-docbook-stylesheets option on Debian would be

  /usr/share/xml/docbook/stylesheet/docbook-xsl-ns

To test it all, I just did a fresh build starting from git pull and
everything worked great, except for building kawa.pdf.

The 'make' also built kawa-manual.epub by default, which I'm guessing is
a side effect of using the --with-docbook-stylesheets option, as I don't
recall that happening on my earlier builds.  I was also able to build
the "fancy" and "plain" HTML docs properly.

The only minor problem seems to be building kawa.pdf, which is likely
something outdated on my system. I did use a newish version of texinfo
(6.3) since I know that's needed by Kawa.  Not sure if it's worth
chasing, but I'm including the error from 'make kawa.pdf' (in the doc
subdirectory) below for reference.

Regards,

-chaw


  [163] [164] [165]
  ../../../.././kawa.texi:8889: Argument of @parseargline has an extra }.
  <inserted text> 
                 @par 
  <to be read again> 
                     }
  @next ...required-arg}|@stxref  {guard})@sup  {*}}
                                                    @futurelet @next @smartita...
  l.1 ...s  {required-arg}|@stxref {guard})@sup {*}}
                                                    @texinfoc
  @scanmacro ...atspaces }@scantokens {#1@texinfoc }
                                                    @aftermacro 
  l.1 ...uired-arg}|@stxref {guard})@sup{*}@texinfoc
                                                    
  ...
  l.8889 ...{(@stxref{required-arg}|@stxref{guard})}
                                                     [@stxlit{#!optional} @stx...
  
  ?