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
