[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: More documentation restructure issues
From: |
Patrick McCarty |
Subject: |
Re: More documentation restructure issues |
Date: |
Mon, 27 Jul 2009 13:33:57 -0700 |
User-agent: |
Mutt/1.5.20 (2009-06-14) |
On Mon, Jul 27, 2009 at 10:23:03PM +0200, John Mandereau wrote:
> Le lundi 27 juillet 2009 à 13:04 -0700, Patrick McCarty a écrit :
> > I just modified Documentation/notation/spacing.itely, and when I ran
> > "make doc", the changes did not appear in my local offline-root/
> > documentation.
> >
> > I needed to touch Documentation/notation.tely for the changes to be
> > compiled. But this is an inconvenience.
> >
> > Can the old behavior be restored, so that when one of the *.itely
> > files is modified, "make doc" will notice?
>
> It can, but I make no warranty on when it will happen exactly. There
> are three degrees of makefiles function:
>
> 1. clean builds complete without errors;
> 2. output is built correctly;
> 3. in case of non-clean builds, the parts of the output that need to be
> rebuilt are effectively rebuilt, and nothing else.
>
> 2. is currently not satisfied for the docs, and I want to factorize
> texinfo and doc-i18n-root templates, so you clearly see the short-term
> situation :-P
>
> As for 3., if my upcoming Texinfo parser is fast enough, it will
> possibly be used to determine almost all documentation prerequisites
> (dependencies in more common language), which will make all docs editing
> more comfortable. It it's too slow, we'll probably have to stick with
> partial prerequisites.
Okay, great. I'll be patient then.
Thanks again for your hard work. We all very much appreciate it.
Regards,
-Patrick