From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 36136 invoked by alias); 26 May 2017 05:01:19 -0000 Mailing-List: contact libc-alpha-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: libc-alpha-owner@sourceware.org Received: (qmail 28896 invoked by uid 89); 26 May 2017 04:58:54 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-24.9 required=5.0 tests=AWL,BAYES_00,GIT_PATCH_0,GIT_PATCH_1,GIT_PATCH_2,GIT_PATCH_3,RP_MATCHES_RCVD,SPF_PASS autolearn=ham version=3.3.2 spammy=quo X-HELO: smtp.pacific.net From: Rical Jasan To: libc-alpha@sourceware.org Cc: Joseph Myers , Carlos O'Donell , Michael Kerrisk , Zack Weinberg Subject: [PATCH v5 1/3] manual: Create empty placeholder macros for @standards. Date: Fri, 26 May 2017 05:01:00 -0000 Message-Id: <20170526045850.30455-2-ricaljasan@pacific.net> In-Reply-To: <20170526045850.30455-1-ricaljasan@pacific.net> References: <20170519093353.6158-1-ricaljasan@pacific.net> <20170526045850.30455-1-ricaljasan@pacific.net> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="------------2.12.2" X-SW-Source: 2017-05/txt/msg00792.txt.bz2 This is a multi-part message in MIME format. --------------2.12.2 Content-Type: text/plain; charset=UTF-8; format=fixed Content-Transfer-Encoding: 8bit Content-length: 856 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 disambiguate annotations in lists of @*x elements, where a common description is shared but some elements may have different headers or standards. 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. --- manual/macros.texi | 7 +++++++ 1 file changed, 7 insertions(+) --------------2.12.2 Content-Type: text/x-patch; name="0001-manual-Create-empty-placeholder-macros-for-standards.patch" Content-Transfer-Encoding: 8bit Content-Disposition: inline; filename="0001-manual-Create-empty-placeholder-macros-for-standards.patch" Content-length: 421 diff --git a/manual/macros.texi b/manual/macros.texi index 6496f2e177..0b073908f1 100644 --- a/manual/macros.texi +++ b/manual/macros.texi @@ -273,4 +273,11 @@ cwd\comments\ @cindex \str\ @end macro +@c Dummy placeholder while converting annotations. +@macro standards {standard, header} +@end macro +@c To be used for @*x lists of elements. +@macro standardsx {element, standard, header} +@end macro + @end ifclear --------------2.12.2--