RFA: mention gdb/gdbserver/README in gdb/README

RFA: mention gdb/gdbserver/README in gdb/README

[Jim Blandy]

Does this change look okay?

gdb/ChangeLog:
2008-01-16  Jim Blandy  <jimb@codesourcery.com>

	* README: Doc fix.

diff -r 79c1d0c9402b gdb/README
--- a/gdb/README	Tue Jan 15 10:14:02 2008 -0800
+++ b/gdb/README	Wed Jan 16 14:55:33 2008 -0800
@@ -453,6 +453,10 @@ allows remote debugging for Unix applica
 allows remote debugging for Unix applications.  gdbserver is only
 supported for some native configurations, including Sun 3, Sun 4, and
 Linux.
+The file gdb/gdbserver/README includes further notes on gdbserver; in
+particular, it explains how to build gdbserver for cross-debugging
+(where gdbserver runs on the target machine, which is of a different
+architecture than the host machine running GDB).
 
    There are a number of remote interfaces for talking to existing ROM
 monitors and other hardware:

Re: RFA: mention gdb/gdbserver/README in gdb/README

[Doug Evans]

On Jan 16, 2008 2:56 PM, Jim Blandy <jimb@codesourcery.com> wrote:
>
> Does this change look okay?
>
> gdb/ChangeLog:
> 2008-01-16  Jim Blandy  <jimb@codesourcery.com>
>
>         * README: Doc fix.
>
> diff -r 79c1d0c9402b gdb/README
> --- a/gdb/README        Tue Jan 15 10:14:02 2008 -0800
> +++ b/gdb/README        Wed Jan 16 14:55:33 2008 -0800
> @@ -453,6 +453,10 @@ allows remote debugging for Unix applica
>  allows remote debugging for Unix applications.  gdbserver is only
>  supported for some native configurations, including Sun 3, Sun 4, and
>  Linux.
> +The file gdb/gdbserver/README includes further notes on gdbserver; in
> +particular, it explains how to build gdbserver for cross-debugging
> +(where gdbserver runs on the target machine, which is of a different
> +architecture than the host machine running GDB).
>
>     There are a number of remote interfaces for talking to existing ROM
>  monitors and other hardware:
>

Heh.  I grepped through *.texinfo but missed gdbserver/README.  Blech.

Not that I care now that it's burned into my memory, but I wonder to
what extent things in gdb/README, gdb/gdbserver/README, etc. might be
better placed in foo.texinfo.

Re: RFA: mention gdb/gdbserver/README in gdb/README

[Jim Blandy]

"Doug Evans" <dje at google.com> writes:
> On Jan 16, 2008 2:56 PM, Jim Blandy <jimb@codesourcery.com> wrote:
>>
>> Does this change look okay?
>>
>> gdb/ChangeLog:
>> 2008-01-16  Jim Blandy  <jimb@codesourcery.com>
>>
>>         * README: Doc fix.
>>
>> diff -r 79c1d0c9402b gdb/README
>> --- a/gdb/README        Tue Jan 15 10:14:02 2008 -0800
>> +++ b/gdb/README        Wed Jan 16 14:55:33 2008 -0800
>> @@ -453,6 +453,10 @@ allows remote debugging for Unix applica
>>  allows remote debugging for Unix applications.  gdbserver is only
>>  supported for some native configurations, including Sun 3, Sun 4, and
>>  Linux.
>> +The file gdb/gdbserver/README includes further notes on gdbserver; in
>> +particular, it explains how to build gdbserver for cross-debugging
>> +(where gdbserver runs on the target machine, which is of a different
>> +architecture than the host machine running GDB).
>>
>>     There are a number of remote interfaces for talking to existing ROM
>>  monitors and other hardware:
>>
>
> Heh.  I grepped through *.texinfo but missed gdbserver/README.  Blech.
>
> Not that I care now that it's burned into my memory, but I wonder to
> what extent things in gdb/README, gdb/gdbserver/README, etc. might be
> better placed in foo.texinfo.

Nah.  Trauma is just as good as documentation.
:)

Re: RFA: mention gdb/gdbserver/README in gdb/README

[Eli Zaretskii]

> From: Jim Blandy <jimb@codesourcery.com>
> Date: Wed, 16 Jan 2008 14:56:53 -0800
> 
> 
> Does this change look okay?

Yes, but maybe the ChangeLog entry should be more descriptive ("doc
fix" for a change in README says absolutely nothing).

Thanks.

Re: RFA: mention gdb/gdbserver/README in gdb/README

[Jim Blandy]

Eli Zaretskii <eliz at gnu.org> writes:
>> From: Jim Blandy <jimb@codesourcery.com>
>> Date: Wed, 16 Jan 2008 14:56:53 -0800
>> 
>> 
>> Does this change look okay?
>
> Yes, but maybe the ChangeLog entry should be more descriptive ("doc
> fix" for a change in README says absolutely nothing).

Committed as follows --- thanks.

gdb/ChangeLog:
2008-01-17  Jim Blandy  <jimb@codesourcery.com>

	* README: Mention gdbserver/README.

diff -r 9ed5b2935471 gdb/README
--- a/gdb/README	Thu Jan 17 11:42:36 2008 -0800
+++ b/gdb/README	Thu Jan 17 12:17:13 2008 -0800
@@ -453,6 +453,10 @@ allows remote debugging for Unix applica
 allows remote debugging for Unix applications.  gdbserver is only
 supported for some native configurations, including Sun 3, Sun 4, and
 Linux.
+The file gdb/gdbserver/README includes further notes on gdbserver; in
+particular, it explains how to build gdbserver for cross-debugging
+(where gdbserver runs on the target machine, which is of a different
+architecture than the host machine running GDB).
 
    There are a number of remote interfaces for talking to existing ROM
 monitors and other hardware: