Re: [patch] proposed docs for makefile targets

[Fergus Henderson <fjh at cs dot mu dot oz dot au>]

On 12-Jan-2001, DJ Delorie <dj@redhat.com> wrote:
> 
> --- gcc.texi	2001/01/13 01:54:15
> + 
> + @item check
> + Run the testsuite.  This creates a @file{testsuite} subdirectory that
> + has various @file{.sum} and @file{.log} files containing the results of
> + the testing.  You can run subsets with, for example, @code{make check-gcc}.
> + You can specify specific tests by setting RUNTESTFLAGS to be the name
> + of the @file{.exp} file, optionally followed by (for some tests) an equals
> + and a file wildcard, like:
> + 
> + @example
> + make check-gcc RUNTESTFLAGS="execute.exp=19980413-*"
> + @end example

It may be worth documenting that you need to have DejaGnu installed.

> + @item bubblestrap
> + Once bootstrapped, this incrementally rebuilds each of the three stages,
> + one at a time.  It does this by "bubbling" the stages up from their
> + stubdirectories, rebuilding them, and copying them back to their
> + subdirectories.

I think it might be helpful to explain here why one might want to do that.

-- 
Fergus Henderson <fjh@cs.mu.oz.au>  |  "I have always known that the pursuit
                                    |  of excellence is a lethal habit"
WWW: <http://www.cs.mu.oz.au/~fjh>  |     -- the last words of T. S. Garp.