On Tue, Apr 22, 2008 at 4:52 PM, Jan de Groot <jan@jgc.homeip.net> wrote:
What do we do with gtk-doc documentation? They're very useful when developing software, but they take a shitload of space compared to the libraries and include files shipped with a library like glib2. Before we stripped these docs, glib2 would take >50MB, now with stripped docs, it's 8-9MB in size. I always defended the removal of gtk-doc API documentation as "we don't ship docs by policy". If we change this policy, I have no serious defense against keeping these docs any longer, which means gtk-doc API documentation will get included, meaning a base package like glib2 will grow to 50MB again.
Hey Jan, I just want to make sure you're ok with this, because you're the hardest hit. I am thinking that stripping gtk-docs and things of that nature is perfectly acceptable. I would defend it with "they're too big and it's my freaking package". Let me know if you have any qualms here. Keep in mind, I'm really thinking of JUST info pages here - there are a lot of GNU tools that document all their stuff in info pages - I'm not too concerned about HTML documentation that's pretty much only usable in a desktop-environment (read: you can just browse it online)