[xml/sgml-pkgs] Bug#800537: linuxdoc-tools documentation is built during the install stage

[Agustin Martin]

Control: tags 800537 + pending

On Thu, Oct 01, 2015 at 01:14:34PM +0200, Agustin Martin wrote:
> On Wed, Sep 30, 2015 at 06:53:01PM +0300, Ilya Tumaykin wrote:
> > linuxdoc-tools builds and installs documentation in the 'install' make target, 
> > see [0]. This is illogically and simply wrong. Documentation should be built 
> > in 'build' target and later installed in 'install' target.
> > 
> > Also linuxdoc-tools documentation requires heavy latex stuff to be built. Could 
> > you please make documentation build optional via configure option?
> 
> Hi,
> 
> Thanks for the info. 
> 
> I have also been thinking about a --disable-docs option after knowing about
> something named linuxdoc-tools-native, which is plain linuxdoc-tools with
> patches which hardcode disabling of doc generation. I think an option is the
> way to go, rather than those patches.
> 
> Regarding docs I also have some changes to no longer generate dvi+ps, but
> just pdf, I think that is better.

Hi,

I had a look at this and I have something almost done. A new configure
option is provided --enable-docs[=types] which should allow fine grained
selection of doc formats to be built, or complete disabling of docs if
invoked through --disable-docs (or --enable-docs="no"). Doc building is
enabled by default.

> Regarding the main issue in this report (where docs are built), this will
> take longer. I have only done some minor changes in this part and is mostly
> as it was when I started caring about linuxdoc-tools. I looked into it and
> is a big hack to have docs built, since it uses already installed tree for
> doc building, so it needs many things installed at this time. Also, it is in
> a 'it works, do not touch it' state.

Also looked at this, Had to install iso-entities, entitymap and some
binaries in the doc tempdir, but seems to work, even if iso-entities and
entitymap get installed twice, once in tmpdir for doc build and other in
destination dir during final installation.

I also have set a repo at

https://gitlab.com/agmartin/linuxdoc-tools

for easier upstream tracking. Most changes are already there if tou are
curious about them. Unless I find something wrong in the meantime, expect a
new upstream release soon.

Regards,

-- 
Agustin