Re: [matplotlib-devel] Debian + mpl 0.98.5 - Can we reduce the size of generated doc?

On Tue, Dec 16, 2008 at 9:39 AM, John Hunter <jd...@gm...> wrote:

> On Tue, Dec 16, 2008 at 8:10 AM, Michael Droettboom <md...@st...>
> wrote:
>
> > Another option would be to not generate the high-res png and pdf
> > examples.  (Either or both).  Just removing them after the fact won't
> > work, since one would end up with broken links from the docs.  We would
> > also have to change the html to not include those links.  It should be
> > fairly simple to provide an option to the doc build system to do this,
> > and I'm happy to implement that if we all agree that's the direction to
> > take.
>
> This is fine with me.  Just add an rc option
>
>  doc.minimal_footprint
>
> or something like that which drops the high res and pdf.  This will
> prbably reduce the size 50-60%
>
> I have also removed the mpl_data symlink in my doc tree, and am still
> testing before I commit, because that is causing our binaries to get
> much larger on platforms which do not properly support linking.
> Instead, we'll refer explicitly to ../lib/matplotlib/mpl-data in the
> docs.  I am leaving the mpl_examples symlink because of all the
> relative path woes in pyplot.
>
> Other than simple optimizations like this, I am discinclined to try
> and build smaller manuals simply to reduce their size.  The feature
> that caused the explosion in size between 98.3 and 98.5 is the
> gallery, and image enhanced examples, which is arguably the most
> useful feature on the site.
>

It seems like the documentation should be a separately installable package
as far as package managers are concerned.