[Open-graphics] Nanocontroller Manual and Documentation Build Tweaks

[Robin Sheat]

Bringing it back on-list for anyone interested (hence the extreme quoting :)

On Tuesday 14 August 2007 05:08:55 Petter Urkedal wrote:
> On 2007-08-13, Robin Sheat wrote:
> > On Monday 13 August 2007 03:58:09 Petter Urkedal wrote:
> > >   * I use \ref and table-of-contents, so I'll need to run latex and
> > >     pdflatex twice.  I could make separate rules for my document; the
> >
> > I use:
> >         pdflatex $<
> >         bibtex $(TITLE)
> >         while ( egrep "Rerun to get (cross|cita)" $(<:%.tex=%.log)
> > > /dev/null ) do \
> >
> >                 pdflatex $< ; \
> >         done
> > to conditionally re-run. This is helpful because sometimes it needs to
> > run three times, other times only one.
>
> That's smart!  You should probably clear it on the list or someone more
> authorative that me since I had already commited my version.  But I'll
> keep it in mind if it's needed later.  Some notes:
>
>   * $(TITLE) seems wrong.  In GNU make (at least) $* gives you the root
>     of the rule, if that's what you need.
TITLE is defined elsewhere, this is a bit of the makefile for my thesis, so in 
that case it's defined as 'thesis' I think. (I didn't actually write this, I 
took it from a standard one and hacked it a bit though)

>   * The paretheses around the while-condition creates a sub-shell; I
>     don't think that's needed here.
You're spawning off pdflatex and egrep anyway, I think it's probably not a 
huge loss :) that said, there may be a more make-ish way of doing this 
(although, the shell is probably needed to avoid the grep output going to the 
terminal)

>   * Is there something which you could grep for to test if the bibtex
>     invocation is needed?  (It's some time since I used BibTeX myself.)
Hmm. I expect that it would give you the same 'rerun to get citations' 
message, but I'm not sure. Best to force it to ensure it's up-to-date anyway. 
Of course, that could be tested with make if you want to be fancy :)

-- 
Robin <robin at kallisti.net.nz> JabberID: <eythian at jabber.kallisti.net.nz>

Hostes alienigeni me abduxerunt. Qui annus est?

PGP Key 0xA99CEB6D = 5957 6D23 8B16 EFAB FEF8  7175 14D3 6485 A99C EB6D
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
Url : http://lists.duskglow.com/open-graphics/attachments/20070814/6fa98539/attachment.bin