Re: [PATCH 23/23] Multi-target: NEWS and user manual

Pedro Alves
2019-10-17T15:31:55Z

On 10/17/19 9:13 AM, Eli Zaretskii wrote:
>> Cc: gdb-patches@sourceware.org
>> From: Pedro Alves <palves@redhat.com>
>> Date: Thu, 17 Oct 2019 03:42:37 +0100
>>
>> * Kill Process:: Killing the child process
>> -
>> -* Inferiors and Programs:: Debugging multiple inferiors and programs
>> +* Inferiors Connections and Programs::
>> + Debugging multiple inferiors connections and programs
>
> The last line should look like this:
>
> * Inferiors Connections and Programs::
> Debugging multiple inferiors connections
> and programs
>
> or like this:
>
> * Inferiors Connections and Programs:: Debugging multiple inferiors
> connections and programs
>
> I prefer the latter variant, but it's up to you. The important part
> is to keep the description aligned to the other descriptions or be to
> the right of that alignment, and if you break in two, indent the
> second line slightly.

Thanks. I went with the latter then.

>
>> +@smallexample
>> +(@value{GDBP}) info connections
>> + Num What Description
>> +* 1 extended-remote host:10000 Extended remote serial target in gdb-specific protocol
>> + 2 native Native process
>> + 3 core Local core dump file
>> @end smallexample
>
> Did you see if that long line causes overlong lines in the printed
> output?

Yes, pdf output looks good. Also confirmed that the
"Debugging multiple inferiors connections and programs" title fits
in a single line.

> Otherwise, this is OK. Thanks.

Thanks,
Pedro Alves