Subject: Re: CVS commit: basesrc/distrib/notes
To: John Hawkinson <jhawk@MIT.EDU>
From: Alan Barrett <apb@cequrux.com>
List: source-changes
Date: 11/27/2001 10:05:40
On Mon, 26 Nov 2001, John Hawkinson wrote:
> It's 15 seconds to regen all 4 kinds for the i386 on my architecture.

In order to get guaranteed correct results, and to accommodate my
philosophical objection to having generated files committed to the
source tree, I'd be more than willing to accept a 15 second penaly every
time I do a build.

> I'd find it annoying, when debugging changes to the notes,
> to have to wait 8 seconds above and beyond the time it takes
> to generate one version of the notes just to see if the markup
> I'd just added came out looking reasonable.

I suggest using a make variable to control whether TOC files are
regenerated.  People who are debugging the formatting of the notes could
set it one way, while a normal build sets it the other way.

MAKETOC?=YES
foo.toc: foo.source
.if ${REGENERATE_TOC} = YES
	command to regenerate ${.TARGET}
.else
	@echo Warning: ${.TARGET} might be out of date
	${TOUCH} ${.TARGET}
.endif

--apb (Alan Barrett)