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


_______________________________________________
Axiom-developer mailing list
Axiom-developer@nongnu.org
http://lists.nongnu.org/mailman/listinfo/axiom-developer

Reply via email to