On Monday 23 January 2006 07:39, Jim Bublitz wrote: > It really doesn't matter a lot to me either way - anybody have an opinion > one way or the other?
No strong opinion other than the niftyness factor of "building" the docs. After all it is source code being built so the build stage IMHO is most appropriate to generate docs rather than shipping them in formatted form. It seems to be a common thing to do with docbook, pydoc etc. I can think of some potential advantages: May save you some time down the line and might be easier if any packager wants to add or change something or reformat or such thing, perhaps even for translating it may be useful. Anything that requires editing the html might be easier done editing the script or adding one. On the other hand, 300k is just peanuts. Considering what a huge amount of classes you get for a measly 1.4 MB tarball I'd say it's not overweight at all. The package size here (tbz, incl. sip files, doc, examples, templates) is 8.3 MB, still quite small. For completeness: using bzip2 to compress the source tarball it's only 886 kB. That would pay off if download size is a concern. Dan _______________________________________________ PyKDE mailing list [email protected] http://mats.imk.fraunhofer.de/mailman/listinfo/pykde
