Re: Doc buildscripts cleanup

[John Mandereau]

Le mercredi 07 février 2007 à 01:29 +0100, Han-Wen Nienhuys a écrit :
> yes, please push.

Done. I'll have time to cherry-pick to master on Friday afternoon.


> However, it would be nice if you would keep on standby
> for a couple of days in case we have problems with using this.

I mean, I may be (and I usually am) connected every evening, but often
not for a long time.


> > ------------------------------------------------------------------------
> > 
> > diff --git a/buildscripts/add_html_footer.py 
> > b/buildscripts/add_html_footer.py
> > index a7bc7e1..7c63755 100644
> > --- a/buildscripts/add_html_footer.py
> > +++ b/buildscripts/add_html_footer.py
> > @@ -9,10 +9,23 @@ import time
> >  
> >  import langdefs
> >  
> > -default_header = r"""
> > +# This is to try to make the docball not too big with almost duplicate 
> > files
> > +# see process_links()
> > +non_copied_pages = ['Documentation/user/out-www/lilypond-big-page',
> > +                    
> > 'Documentation/user/out-www/lilypond-internals-big-page',
> > +                    'Documentation/user/out-www/music-glossary-big-page',
> > +                    'out-www/examples',
> > +                    'Documentation/topdocs/out-www/NEWS',
> > +                    'Documentation/topdocs/out-www/INSTALL',
> > +                    'Documentation/bibliography/out-www/index',
> > +                    'Documentation/out-www/THANKS',
> > +                    'Documentation/out-www/DEDICATION',
> > +                    'Documentation/topdocs/ou-www/AUTHORS']
> > +
> 
> is this tested? ou-www surely doens't work?

Good catch; in fact, I've added the files other than big pages after my
last test.  Typos in this file list shouldn't break anything, though, it
will simply make the docball bigger.



> >      Arguments:
> >       package_name=NAME         set package_name to NAME
> >       package_version=VERSION   set package version to VERSION
> > -     header=TEXT               use TEXT as header
> > -     footer=TEXT               use TEXT as footer
> >       targets=offline|online    set page processing depending on the target
> >            offline is for reading HTML pages locally
> >            online is for hosting the HTML pages on a website with content
> >              negotiation
> > -     mail_address              set \"Report errors to\" link
> > -     pages_dict                a dictionnary returned by build_pages_dict()
> > -     out_root                  a path prefix where to write HTML pages
> >       name_filter               a HTML file name filter
> 
> i'd consider passing a dict, and initing subst from that dict.

Sorry, I don't understand what you mean here.

Cheers,
-- 
John Mandereau <address@hidden>