Re: [PATCH] Improve gcore manpage and clarify "-o" option

[Sergio Durigan Junior <sergiodj@redhat.com>]

On Friday, July 27 2018, Eli Zaretskii wrote:

>> From: Sergio Durigan Junior <sergiodj@redhat.com>
>> Cc: Eli Zaretskii <eliz@gnu.org>,
>> 	Sergio Durigan Junior <sergiodj@redhat.com>
>> Date: Fri, 27 Jul 2018 01:02:34 -0400
>> 
>> Ref.: https://bugs.debian.org/904628
>> 
>> It has been reported that gcore's manpage is a bit imprecise when it
>> comes to two things:
>> 
>> - It doesn't explicity say that the command accepts more than one PID
>>   on its CLI.
>> 
>> - It fails to mention that the argument passed through the "-o" option
>>   is actually a prefix that will be used to compose the corefile's
>>   filename, and not the actual filename.
>> 
>> I decided to give it a try and rewrite parts of the text to further
>> clarify these two points.  I ended up rewording the "Description"
>> section because, IMHO, it was a bit confuse to understand.
>> 
>> To make things consistent, I've also renamed the "$name" variable in
>> the gcore.in script, and expanded the usage text.
>> 
>> gdb/doc/ChangeLog:
>> yyyy-mm-dd  Sergio Durigan Junior  <sergiodj@redhat.com>
>> 
>> 	* gdb.texinfo (gcore man): Rewrite "Description" and "-o"
>> 	option sections to further clarify that gcore can take more
>> 	than one PID, and that "-o" is used to specify a prefix, not a
>> 	filename.
>> 
>> gdb/ChangeLog:
>> yyyy-mm-dd  Sergio Durigan Junior  <sergiodj@redhat.com>
>> 
>> 	* gcore.in: Rename variable "name" to "prefix".  Expand
>> 	"usage" text.
>
> This is OK, thanks.

Thanks, pushed:

129eb0f1f16dc7a49799a024a7bcb109d954a1e7

-- 
Sergio
GPG key ID: 237A 54B1 0287 28BF 00EF  31F4 D0EB 7628 65FC 5E36
Please send encrypted e-mail if possible
http://sergiodj.net/