From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 95075 invoked by alias); 23 Mar 2015 19:12:30 -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 95061 invoked by uid 89); 23 Mar 2015 19:12:30 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-2.5 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_NONE,SPF_SOFTFAIL autolearn=no version=3.3.2 X-HELO: mtaout21.012.net.il Received: from mtaout21.012.net.il (HELO mtaout21.012.net.il) (80.179.55.169) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Mon, 23 Mar 2015 19:12:28 +0000 Received: from conversion-daemon.a-mtaout21.012.net.il by a-mtaout21.012.net.il (HyperSendmail v2007.08) id <0NLO00B00ILQ7M00@a-mtaout21.012.net.il> for gdb-patches@sourceware.org; Mon, 23 Mar 2015 21:12:26 +0200 (IST) Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout21.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NLO00BR8IOP6A30@a-mtaout21.012.net.il>; Mon, 23 Mar 2015 21:12:26 +0200 (IST) Date: Mon, 23 Mar 2015 19:12:00 -0000 From: Eli Zaretskii Subject: Re: [PATCH 3/4] GDBServer: introduce --server-stderr command line option In-reply-to: <55105FFD.60204@redhat.com> To: Cleber Rosa Cc: gdb-patches@sourceware.org, areis@redhat.com Reply-to: Eli Zaretskii Message-id: <83iodrr0j6.fsf@gnu.org> References: <1426905265-8495-1-git-send-email-crosa@redhat.com> <1426905265-8495-4-git-send-email-crosa@redhat.com> <83384yvjr0.fsf@gnu.org> <55105FFD.60204@redhat.com> X-IsSubscribed: yes X-SW-Source: 2015-03/txt/msg00737.txt.bz2 > Date: Mon, 23 Mar 2015 15:48:29 -0300 > From: Cleber Rosa > CC: gdb-patches@sourceware.org, areis@redhat.com > > >> +@item --server-stderr > >> +Instruct @code{gdbserver} to redirect its own @code{stderr} to another > >> +file. > > The option requires an argument, so the argument should be mentioned > > with the option and referenced in the text that describes it. > > Sure, I also feel an example could help. How do you feel about this: > > @cindex @option{--server-output}, @code{gdbserver} option > The @option{--server-output=path} option tells @code{gdbserver} to send @option{--server-output=@var{path}} (and once again, please use "file" or "filename", not "path"). Also, what happened to the @item? > all its output to a file given by @var{path}. This can be useful, for ^^ Two spaces between sentences. > @smallexample > $ gdbserver --server-output=server.log :2222 testprog >test.out 2>test.err > @end smallexample This line is too long; either try to make it shorter, e.g., by using shorter file/program names, or break it into 2 lines. Otherwise, this is fine, thanks. > > AFAIK, GNU Coding Standards frown on using "path" for anything that is > > not PATH-style list of directories. So please use "file" or "file > > name" here. > > I could not find a mention on the GNU Coding Standards manual itself, It's in the node "GNU Manuals": Please do not use the term "pathname" that is used in Unix documentation; use "file name" (two words) instead. We use the term "path" only for search paths, which are lists of directory names.