From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <libc-alpha-return-79584-listarch-libc-alpha=sources.redhat.com@sourceware.org>
Received: (qmail 61640 invoked by alias); 19 May 2017 21:02:58 -0000
Mailing-List: contact libc-alpha-help@sourceware.org; run by ezmlm
Precedence: bulk
List-Id: <libc-alpha.sourceware.org>
List-Subscribe: <mailto:libc-alpha-subscribe@sourceware.org>
List-Archive: <http://sourceware.org/ml/libc-alpha/>
List-Post: <mailto:libc-alpha@sourceware.org>
List-Help: <mailto:libc-alpha-help@sourceware.org>, <http://sourceware.org/ml/#faqs>
Sender: libc-alpha-owner@sourceware.org
Received: (qmail 60112 invoked by uid 89); 19 May 2017 21:02:57 -0000
Authentication-Results: sourceware.org; auth=none
X-Virus-Found: No
X-Spam-SWARE-Status: No, score=-1.7 required=5.0 tests=AWL,BAYES_00,FREEMAIL_FROM,RCVD_IN_DNSWL_NONE,RCVD_IN_SORBS_SPAM,SPF_PASS autolearn=no version=3.3.2 spammy=
X-HELO: mail-qk0-f173.google.com
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=1e100.net; s=20161025;
        h=x-gm-message-state:subject:to:references:cc:from:message-id:date
         :user-agent:mime-version:in-reply-to:content-transfer-encoding;
        bh=QMU7Qwc9VVxecfhHmBpOfGy0/bVy8TQ9s6yJB9q4C/Y=;
        b=bOtFrn7gxMW4HuTAE8Z0z6jepM8Lu14IloyJOONmJDvL/ao6CzqF5E8AoLRS2SqV9Y
         8tJ03wp58nANSzKH8vDYSq1+xVrz8w/EfGpKKW2X2ttzaah4VwGGAI6RyslX4vgzOi4b
         oVeAgRjliKMLFH+MYjIV4jQGKK7pKOtUjNmNxqJKXxvr6VnsekEC8atnkyJn0+2KUHst
         mN0Ub5ELu+JFSyawMHQHNcXJjtbjZpAO6xGgcA9YIFm53TlplieYWo5ujd68VwvtOgkf
         /h548C+9P9CqW8+tuSu3vzVfkM7U0e58dHtdPrBR7xOGfvJH5VPrnhsGZ87A2VlAASdE
         4e3A==
X-Gm-Message-State: AODbwcD73jpY0QShA0rDNKqOusI6nQnjbSGSrpt+YBZwCAKzhBIWqib/
	SOZUDn8SL0Mg1A==
X-Received: by 10.55.18.23 with SMTP id c23mr11057899qkh.41.1495227777630;
        Fri, 19 May 2017 14:02:57 -0700 (PDT)
Subject: Re: [PATCH v4 2/5] manual: Create empty placeholder macros for
 @standards.
To: Rical Jasan <ricaljasan@pacific.net>, libc-alpha@sourceware.org
References: <cover.1494920105.git.ricaljasan@pacific.net>
 <20170519093353.6158-1-ricaljasan@pacific.net>
 <20170519093353.6158-3-ricaljasan@pacific.net>
Cc: Joseph Myers <joseph@codesourcery.com>,
 Carlos O'Donell <carlos@redhat.com>, Michael Kerrisk <mtk.manpages@gmail.com>
From: Zack Weinberg <zackw@panix.com>
Message-ID: <e790f073-caef-9c0d-6f42-540e9da37396@panix.com>
Date: Fri, 19 May 2017 21:02:00 -0000
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101
 Thunderbird/45.8.0
MIME-Version: 1.0
In-Reply-To: <20170519093353.6158-3-ricaljasan@pacific.net>
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit
X-SW-Source: 2017-05/txt/msg00612.txt.bz2

On 05/19/2017 05:33 AM, Rical Jasan wrote:
> Header and standards annotations are slated for standardization,
> including being rendered in the description of functions, variables,
> etc. (elements), and eventually required.  This commit adds @standards
> dummy macros so we can convert all existing annotations to the new
> framework while maintaining the rendered status quo.
> 
> There needs to be a way to provide separate annotations for lists of
> @*x elements, where a common description is shared.  The @standardsx
> macro fills this role by accepting an additional parameter: the name
> of the annotated element.
> 
> 	* manual/macros.texi (@standards): New macro.  Provide
> 	placeholder for header and standards annotations.
> 	(@standardsx): New macro.  Likewise, for lists of @*x
> 	elements.

This is OK.  Please go ahead and check it in.

zw