From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 125878 invoked by alias); 24 Nov 2016 13:17:40 -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 125859 invoked by uid 89); 24 Nov 2016 13:17:40 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-1.9 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_NONE,SPF_PASS,URIBL_RED autolearn=ham version=3.3.2 spammy=meet, settle X-HELO: relay1.mentorg.com Date: Thu, 24 Nov 2016 13:17:00 -0000 From: Joseph Myers To: Rical Jasan CC: , Michael Kerrisk , Carlos O'Donell Subject: Re: [PATCH 1/3] manual: Refactor header and standards annotations. In-Reply-To: <52a4b7bf-3a5a-8194-a18a-6b523e12acad@pacific.net> Message-ID: References: <20161123063807.14845-1-ricaljasan@pacific.net> <20161123063807.14845-2-ricaljasan@pacific.net> <52a4b7bf-3a5a-8194-a18a-6b523e12acad@pacific.net> User-Agent: Alpine 2.20 (DEB 67 2015-01-07) MIME-Version: 1.0 Content-Type: text/plain; charset="US-ASCII" X-ClientProxiedBy: svr-ies-mbx-01.mgc.mentorg.com (139.181.222.1) To svr-ies-mbx-01.mgc.mentorg.com (139.181.222.1) X-SW-Source: 2016-11/txt/msg00896.txt.bz2 On Thu, 24 Nov 2016, Rical Jasan wrote: > First, I was going to ask if there was a preference for whether > summary.awk should be modified or if a new script was acceptable, and if > so which language. To help make sense of things while working this out > I used a Perl script for a scratchpad, which I could clean up for Building the manual already requires perl (to generate libm-err.texi) so use of perl is not necessarily a problem. > Second, I expect we'll move away from @comment-based annotations to > something more explicit/obvious, so I was avoiding enforcing a syntax > until we settle on one. (Not that it's an argument against enforcing > now.) For example, I'm already using new @vitem and @titem macros to My view is that when patches cause the manual to meet particular syntax rules that help conversion to another form of annotations, they should also make sure those rules are enforced so we don't regress before the conversion. -- Joseph S. Myers joseph@codesourcery.com