Re: Slowness problem with GTK-Doc

On 02/19/2017 09:14 PM, Stefan Sauer wrote:
On 02/18/2017 10:30 PM, Ross Burton wrote:

On 18 February 2017 at 18:40, Shaun McCance <shaunm gnome org> wrote:
But in the short term, switching to yelp-xsl would make builds faster.

Is this just a matter of pointing at a different set of stylesheets, or is there more to the port than that?


It is probably not that simple. gtk-doc has some customization layer on top of the docbook xslt stylesheets. Most of the customization is to fi some of the bad performance (e.g. disabling i18n since we don't use it). But other targets are used to e.g. create the top-navbar.

It would be interesting to try still.
I just gave it a quick test for buzztrax. Its is ~ 2 as fast. If you'd like to try it, cd to your doc-html dir and change the master.xml docname (DOC_MODULE from in the command-lines below:

cd /your/project/docs/html
time xsltproc --nonet --xinclude --stringparam gtkdoc.bookname "foo" --stringparam gtkdoc.version "1.12" /usr/share/gtk-doc/data/gtk-doc.xsl ../buzztrax-core-docs.xml
real  0m6.633s  user    0m6.464s  sys    0m0.128s
real    0m6.459s  user    0m6.384s  sys    0m0.068s

time xsltproc --nonet --xinclude --stringparam gtkdoc.bookname "buzztrax-core" --stringparam gtkdoc.version "1.12"  /usr/share/yelp-xsl/xslt/docbook/html/db2html.xsl ../buzztrax-core-docs.xml
real    0m3.312s  user    0m3.224s  sys    0m0.076s
real    0m3.549s  user    0m3.464s  sys    0m0.076s

Not sure, how much it will get slower if we add some of the customizations back though.



desktop-devel-list mailing list
desktop-devel-list gnome org

desktop-devel-list mailing list
desktop-devel-list gnome org

[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]