This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: [RFA] doc addition to gdbint.texinfo
- From: Eli Zaretskii <eliz at gnu dot org>
- To: dje at google dot com (Doug Evans)
- Cc: gdb-patches at sourceware dot org
- Date: Fri, 05 Feb 2010 00:20:15 +0200
- Subject: Re: [RFA] doc addition to gdbint.texinfo
- References: <20100204213709.C7D4884414@ruffy.mtv.corp.google.com>
- Reply-to: 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.