From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 60769 invoked by alias); 27 Jul 2018 06:08:29 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Received: (qmail 60759 invoked by uid 89); 27 Jul 2018 06:08:29 -0000 Authentication-Results: sourceware.org; auth=none X-Spam-SWARE-Status: No, score=-2.4 required=5.0 tests=AWL,BAYES_00,SPF_PASS autolearn=ham version=3.3.2 spammy=Hx-languages-length:1419 X-HELO: eggs.gnu.org Received: from eggs.gnu.org (HELO eggs.gnu.org) (208.118.235.92) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Fri, 27 Jul 2018 06:08:27 +0000 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fivvJ-0006GI-1S for gdb-patches@sourceware.org; Fri, 27 Jul 2018 02:08:26 -0400 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:40136) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fivvI-0006GE-TC; Fri, 27 Jul 2018 02:08:20 -0400 Received: from [176.228.60.248] (port=3288 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1fivvH-0003aH-Cf; Fri, 27 Jul 2018 02:08:20 -0400 Date: Fri, 27 Jul 2018 06:08:00 -0000 Message-Id: <831sbptdm3.fsf@gnu.org> From: Eli Zaretskii To: Sergio Durigan Junior CC: gdb-patches@sourceware.org In-reply-to: <20180727050234.20742-1-sergiodj@redhat.com> (message from Sergio Durigan Junior on Fri, 27 Jul 2018 01:02:34 -0400) Subject: Re: [PATCH] Improve gcore manpage and clarify "-o" option References: <20180727050234.20742-1-sergiodj@redhat.com> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-IsSubscribed: yes X-SW-Source: 2018-07/txt/msg00730.txt.bz2 > From: Sergio Durigan Junior > Cc: Eli Zaretskii , > Sergio Durigan Junior > 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 > > * 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 > > * gcore.in: Rename variable "name" to "prefix". Expand > "usage" text. This is OK, thanks.