From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 57930 invoked by alias); 16 May 2017 09:55:11 -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 57822 invoked by uid 89); 16 May 2017 09:55:10 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-24.5 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= X-HELO: smtp.pacific.net From: Rical Jasan To: libc-alpha@sourceware.org Cc: Joseph Myers , Carlos O'Donell , Michael Kerrisk Subject: [PATCH v3 2/7] manual: Create empty placeholder macros for @standards. Date: Tue, 16 May 2017 09:55:00 -0000 Message-Id: In-Reply-To: References: MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="------------2.12.2" X-SW-Source: 2017-05/txt/msg00469.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: 803 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. --- manual/macros.texi | 7 +++++++ 1 file changed, 7 insertions(+) --------------2.12.2 Content-Type: text/x-patch; name="0002-manual-Create-empty-placeholder-macros-for-standards.patch" Content-Transfer-Encoding: 8bit Content-Disposition: inline; filename="0002-manual-Create-empty-placeholder-macros-for-standards.patch" Content-length: 421 diff --git a/manual/macros.texi b/manual/macros.texi index 9cf8031d69..9c4326b108 100644 --- a/manual/macros.texi +++ b/manual/macros.texi @@ -267,4 +267,11 @@ cwd\comments\ @end macro @end ifnottex +@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--