Fix gtkD api display
Adam D. Ruppe via Digitalmars-d-learn
digitalmars-d-learn at puremagic.com
Thu Aug 10 06:57:46 PDT 2017
On Saturday, 5 August 2017 at 14:02:09 UTC, Mike Wey wrote:
> One issue is the shear size of the generated documentation,
> though the current version of ddox no longer generates a ton of
> unused files bringing the size down from 15-20GB to a mere 2GB.
what?! I'm not actually sure how much gtk alone takes, but my
entire doc folder is 4 GB, including a good chunk of the dub
repo, phobos, druntime, my stuff, search indexes, archives, etc.
I guess it is possible the gtkd is 2 GB of that, but at least it
isn't 20.
> The need to go trough the empty module page when browsing the
> documentation. For a lot / most? functions the complete
> documentation is in the overview defeating the purpose of the
> one page per artifact.
If you guys are interested, I can do a custom adrdox for gtk that:
* reads more of the gtk syntax
https://developer.gnome.org/gtk-doc-manual/stable/documenting_syntax.html.en
* recognizes the one-item-per-module pattern and skips the empty
pages
* has a style more like https://gtkd.org/index.html
* Maybe a few other little things?
> And im not a big fan of the one page per artifact style of
> documentation.
Oh, it is so much better in a lot of ways.
More information about the Digitalmars-d-learn
mailing list