Re: [Axiom-developer] ${SRC}/scripts/Makefile

[Ralf Hemmecke]

On 08/01/2006 10:04 PM, Page, Bill wrote:
> On Tuesday, August 01, 2006 8:00 AM Ralf Hemmecke wrote:
> > Could someone explain the target
> >
> > ${SRC}/scripts/Makefile:
> >
> > in chunk <<scriptsdir>> in src/Makefile.pamphlet?
> >
> > ${SRC}/scripts/Makefile: ${SRC}/scripts/Makefile.pamphlet
> >         @echo 2 making ${SRC}/scripts/Makefile from \
> >             ${SRC}/scripts/Makefile.pamphlet
> >         @( cd scripts ; \
> >             ${DOCUMENT} ${NOISE} Makefile ; \
> >             cp Makefile.dvi 
> > ${MNT}/${SYS}/doc/src/scripts.Makefile.dvi )
> >
> > I don't see that this chunk creates src/scripts/Makefile. 
> > It's a bit weird.
>
> The untangle that creates Makefile is embedded in the script
> ${DOCUMENT} = 'document'. I agree that it is a bit obscure.
> Probably it should be separate.
>
> You can find 'document' in the src/scripts directory.

If this is the case then the literate document describing the target
${SRC}/scripts/Makefile should mention this behaviour. (And better 
still, the Makefiles would be linked together and a click on ${DOCUMENT} 
jumps to its definition and maybe from value of DOCUMENT there is a link 
to the file and another click into the .dvi and my editor opens inside 
the documentation of the "document" command.)

We have a long way to go...

Ralf