From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 102601 invoked by alias); 30 Apr 2018 14:40:11 -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 102435 invoked by uid 89); 30 Apr 2018 14:40:10 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-2.4 required=5.0 tests=AWL,BAYES_00,SPF_PASS autolearn=ham version=3.3.2 spammy=caps 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; Mon, 30 Apr 2018 14:40:08 +0000 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fD9yD-0003Si-Rw for gdb-patches@sourceware.org; Mon, 30 Apr 2018 10:40:06 -0400 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:36552) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fD9yD-0003Sc-P2; Mon, 30 Apr 2018 10:40:01 -0400 Received: from [176.228.60.248] (port=4035 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1fD9yD-0008C3-0W; Mon, 30 Apr 2018 10:40:01 -0400 Date: Mon, 30 Apr 2018 14:40:00 -0000 Message-Id: <83bme0sqq2.fsf@gnu.org> From: Eli Zaretskii To: Tom Tromey CC: gdb-patches@sourceware.org In-reply-to: <20180430143731.30007-1-tom@tromey.com> (message from Tom Tromey on Mon, 30 Apr 2018 08:37:19 -0600) Subject: Re: [RFA 00/12] Small help text tweaks Reply-to: Eli Zaretskii References: <20180430143731.30007-1-tom@tromey.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-04/txt/msg00647.txt.bz2 > From: Tom Tromey > Date: Mon, 30 Apr 2018 08:37:19 -0600 > > I've long understood the GNU style for "metasyntactic variables" -- > text that is a placeholder for some value -- to be to write them in > all caps. For example, from "gdb --help": > > --core=COREFILE Analyze the core dump COREFILE. > > However, while researching for this post, I couldn't actually find > this in the GNU coding standards -- I thought it was there, but the > closest I could find was in the Emacs Lisp manual. It's actually a simple side effect of how Texinfo formats @var{..} in Info output. I think.