Re: [RFA] doc addition to gdbint.texinfo

[Doug Evans <dje@google.com>]

On Thu, Feb 4, 2010 at 2:20 PM, Eli Zaretskii <eliz@gnu.org> wrote:
>> 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.
>

Thanks.  I just checked and the line wasn't too long, and I made the
other requested changes.