[lxml-dev] Generating PDF documentation

[Tres Seaver]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Stefan Behnel wrote:
> Hi,
> 
> Marcin Kasperski wrote:
>>> If there are no
>>> objection, I'll just add the generated PDF to the source release, that's not
>>> even 1MB more.
>> I'd suggest distributing PDF separately (and linking it from the website
>> so it is easily available). PDFs aren't compressing too well.
> 
> The PDF gzips from 900KB down to 600KB, so that's not too much in addition.
> 
> On the other hand, many people just use easy_install or a buildout to grab the
> tar.gz, so they won't benefit from the docs at all.
> 
> We currently have a source distribution of a bit less than 2MB. Most of that
> is generated HTML documentation (gzipped 1.1MB, mainly the API docs). If we
> removed everything that easy_install doesn't use, maybe even the test suites,
> I guess we would be down to some 600KB, including the generated C source. We
> could still provide a complete tar.gz for download, maybe next to the plain
> source on PyPI, or just from the lxml homepage. It's harder to do, though, as
> I don't think distutils supports this without a little setup.py tweaking.
> 
> Any opinions on this?

+1 for leaving the docs, etc. in the source dist (*especially* the test
suite code).



Tres.
- --
===================================================================
Tres Seaver          +1 540-429-0999          tseaver at palladion.com
Palladion Software   "Excellence by Design"    http://palladion.com
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFICjEb+gerLs4ltQ4RAtOLAJ0TGL+7oYOYP3ITdlOXq/fTVXuecQCgodBq
OQfh8NAQYVE44uVUqMN9vh4=
=ZZoD
-----END PGP SIGNATURE-----