From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-patches-return-131052-listarch-gdb-patches=sources.redhat.com@sourceware.org>
Received: (qmail 97910 invoked by alias); 18 Apr 2016 20:02:29 -0000
Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm
Precedence: bulk
List-Id: <gdb-patches.sourceware.org>
List-Subscribe: <mailto:gdb-patches-subscribe@sourceware.org>
List-Archive: <http://sourceware.org/ml/gdb-patches/>
List-Post: <mailto:gdb-patches@sourceware.org>
List-Help: <mailto:gdb-patches-help@sourceware.org>, <http://sourceware.org/ml/#faqs>
Sender: gdb-patches-owner@sourceware.org
Received: (qmail 97887 invoked by uid 89); 18 Apr 2016 20:02:28 -0000
Authentication-Results: sourceware.org; auth=none
X-Virus-Found: No
X-Spam-SWARE-Status: No, score=-3.4 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_LOW,RP_MATCHES_RCVD,SPF_PASS autolearn=ham version=3.3.2 spammy=
X-HELO: mail-vk0-f54.google.com
Received: from mail-vk0-f54.google.com (HELO mail-vk0-f54.google.com) (209.85.213.54) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with (AES128-GCM-SHA256 encrypted) ESMTPS; Mon, 18 Apr 2016 20:02:19 +0000
Received: by mail-vk0-f54.google.com with SMTP id t129so234083057vkg.2        for <gdb-patches@sourceware.org>; Mon, 18 Apr 2016 13:02:19 -0700 (PDT)
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;        d=1e100.net; s=20130820;        h=x-gm-message-state:mime-version:in-reply-to:references:from:date         :message-id:subject:to:cc;        bh=RMA70lmnhKObPKkpsiBiZoRuNEDJkukgKUggrccSY5M=;        b=U72PRBcXGMj8fplH1edoeVazD3175GJ5a882YXpULGuZjMMXrky9B/dpHj0/0e9gv9         GHGGf+74gzS/bWthgzG91RFiO1VeR+dFodCF6UGiXTCI2Ub8fl21scq1xvhPP+wNLS/e         ZvDReqmB1WQcNRqv0W6aYytarC8+sWjHp25o+3mbo/6uumA7UOAR0Y0++U89zMEhfLBK         +1TcumRNbxGLArR9+N8naicz7I/Z+8Li2jW4q366QIhzyEltp94U3GbwbP/mEEJiiRV2         w4XZBOG3qhawVn4B8oAdX6SYyUSk105S10n00qZNkqNJI8VaNC+1nzKrYklbgeQfYYzz         PZKg==
X-Gm-Message-State: AOPr4FVs1fy/nDHTvUQUPBcYUvdL0Muaz8XDrOWe6aLnnVHhUWS7YL9XrWQTyo3IjSIDmcSWbArWjEevvoL7pWcm
X-Received: by 10.31.54.139 with SMTP id d133mr19529959vka.132.1461009737435; Mon, 18 Apr 2016 13:02:17 -0700 (PDT)
MIME-Version: 1.0
Received: by 10.31.136.141 with HTTP; Mon, 18 Apr 2016 13:01:37 -0700 (PDT)
In-Reply-To: <83potm8zj2.fsf@gnu.org>
References: <047d7bdc05e2ada5ef0530c446d1@google.com> <83zisq923i.fsf@gnu.org> <CADPb22RDOModEuNmrJOwAfPN7ig6nTOQy=ajcxBbb4M31kM74w@mail.gmail.com> <83potm8zj2.fsf@gnu.org>
From: Doug Evans <dje@google.com>
Date: Mon, 18 Apr 2016 20:02:00 -0000
Message-ID: <CADPb22SQeyD9FZ9yRHiCEK=u4VsfsGiu-rNKJr9yyf3ecj1YZA@mail.gmail.com>
Subject: Re: [PATCH 2/3] deprecate "skip enable/etc.", doc string cleanup
To: Eli Zaretskii <eliz@gnu.org>
Cc: gdb-patches <gdb-patches@sourceware.org>
Content-Type: text/plain; charset=UTF-8
X-IsSubscribed: yes
X-SW-Source: 2016-04/txt/msg00424.txt.bz2

On Mon, Apr 18, 2016 at 12:53 PM, Eli Zaretskii <eliz@gnu.org> wrote:
>> From: Doug Evans <dje@google.com>
>> Date: Mon, 18 Apr 2016 12:42:04 -0700
>> Cc: gdb-patches <gdb-patches@sourceware.org>
>>
>> I certainly don't want to replicate all that text again
>> and again (hence the macros).
>
> I understand, but put yourself in the position of someone who needs to
> review a patch, and sees something like this:
>
>   +Display the status of skips.\n"
>   +EDDI_USAGE_DOC_STRING_WITH_ALL ("skip", "info skip", "displayed")));
>
> How does that someone know if the resulting text is good English and
> will produce a clear help text, or needs to be fixed in some way?

I'm open to suggestions.

I really hope the solution is to not expand all those macro
invocations in place.