Re: [RFA] doc addition to gdbint.texinfo

[Eli Zaretskii <eliz at gnu dot org>]

> Date: Thu,  4 Feb 2010 13:37:09 -0800 (PST)
> From: dje@google.com (Doug Evans)
> 
> The Testsuite section of gdbint.texinfo is missing docs on at least
> two more DejaGnu variables that are available to be overridden:
> GDB, GDBSERVER.
> 
> Since there's at least three of them (those two plus TRANSCRIPT),
> with more to come, it seemed appropriate to create a new section to
> document them all.

I agree.

> Ok to check in?

Yes, after this:

> +Several variables exist to modify the behavior of the testsuite.
> +
> +@itemize @bullet
> +
> +@item TRANSCRIPT

Please give each variable the @code markup.

> +@smallexample
> +make check RUNTESTFLAGS="GDB=/usr/bin/gdb GDBSERVER=/usr/bin/gdbserver"
> +@end smallexample

Did you try to "make pdf"?  I suspect that this line is too long and
will overflow the right margin.  If it does, please break it into two
(and tell in the text that it is just one long line).

> +The second is to cd to the @file{testsuite} directory and invoke the DejaGnu
> +@kbd{runtest} command directly.

In this context, "runtest" is a name of a command, not a command line
typed at the keyboard.  So @command will be more appropriate than @kbd
here.

OK with these changes.

Thanks.