From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from sa-prd-fep-047.btinternet.com (mailomta27-sa.btinternet.com [213.120.69.33]) by sourceware.org (Postfix) with ESMTPS id E20D4385BF93 for ; Fri, 18 Feb 2022 14:17:03 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org E20D4385BF93 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=dronecode.org.uk Authentication-Results: sourceware.org; spf=none smtp.mailfrom=dronecode.org.uk Received: from sa-prd-rgout-002.btmx-prd.synchronoss.net ([10.2.38.5]) by sa-prd-fep-047.btinternet.com with ESMTP id <20220218141702.YBYJ16049.sa-prd-fep-047.btinternet.com@sa-prd-rgout-002.btmx-prd.synchronoss.net>; Fri, 18 Feb 2022 14:17:02 +0000 Authentication-Results: btinternet.com; auth=pass (PLAIN) smtp.auth=jonturney@btinternet.com; bimi=skipped X-SNCR-Rigid: 6139417C16010521 X-Originating-IP: [86.139.167.74] X-OWM-Source-IP: 86.139.167.74 (GB) X-OWM-Env-Sender: jonturney@btinternet.com X-VadeSecure-score: verdict=clean score=0/300, class=clean X-RazorGate-Vade: gggruggvucftvghtrhhoucdtuddrgedvvddrkedtgdeiudcutefuodetggdotefrodftvfcurfhrohhfihhlvgemuceutffkvffkuffjvffgnffgvefqofdpqfgfvfenuceurghilhhouhhtmecufedtudenucesvcftvggtihhpihgvnhhtshculddquddttddmnecujfgurhepkfffgggfuffvfhfhjggtgfesthekredttdefjeenucfhrhhomheplfhonhcuvfhurhhnvgihuceojhhonhdrthhurhhnvgihsegurhhonhgvtghouggvrdhorhhgrdhukheqnecuggftrfgrthhtvghrnhepvddtteffkeevveejgeehgeelhfdtgefgieelgffgudetudefvdeggfeiiefftdevnecukfhppeekiedrudefledrudeijedrjeegnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehhvghloheplgduledvrdduieekrddurddutdefngdpihhnvghtpeekiedrudefledrudeijedrjeegpdhmrghilhhfrhhomhepjhhonhdrthhurhhnvgihsegurhhonhgvtghouggvrdhorhhgrdhukhdpnhgspghrtghpthhtohepvddprhgtphhtthhopeeurhhirghnrdfknhhglhhishesufihshhtvghmrghtihgtufifrdgrsgdrtggrpdhrtghpthhtohepnhgvfihlihgssehsohhurhgtvgifrghrvgdrohhrgh X-RazorGate-Vade-Verdict: clean 0 X-RazorGate-Vade-Classification: clean Received: from [192.168.1.103] (86.139.167.74) by sa-prd-rgout-002.btmx-prd.synchronoss.net (5.8.716.04) (authenticated as jonturney@btinternet.com) id 6139417C16010521; Fri, 18 Feb 2022 14:17:02 +0000 Message-ID: Date: Fri, 18 Feb 2022 14:16:21 +0000 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:91.0) Gecko/20100101 Thunderbird/91.6.0 Subject: Re: [PATCH 0/1] newlib/libc/time/tzset_r.c(_tzset_unlocked_r): add POSIX <> quoted abbrs Content-Language: en-GB To: Brian Inglis , "newlib@sourceware.org" References: <20220215215701.40283-1-Brian.Inglis@SystematicSW.ab.ca> <1451bc59-821e-aa0f-100a-8abceca94662@SystematicSw.ab.ca> <66b3d84e-4faf-711b-ab2b-855554c3fafa@SystematicSw.ab.ca> From: Jon Turney In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-3570.8 required=5.0 tests=BAYES_00, FORGED_SPF_HELO, KAM_DMARC_STATUS, KAM_LAZY_DOMAIN_SECURITY, NICE_REPLY_A, RCVD_IN_DNSWL_NONE, SPF_HELO_PASS, SPF_NONE, TXREP, T_SCC_BODY_TEXT_LINE autolearn=no autolearn_force=no version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on server2.sourceware.org X-BeenThere: newlib@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Newlib mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 18 Feb 2022 14:17:05 -0000 On 18/02/2022 03:43, Brian Inglis wrote: > On 2022-02-17 05:11, Corinna Vinschen wrote: >> On Feb 16 12:18, Brian Inglis wrote: >>> On 2022-02-16 01:55, Corinna Vinschen wrote: >>>> On Feb 15 22:38, Brian Inglis wrote: >>>>> I am inclined to use if defined in order: >>>>> *    limits.h TZNAME_MAX >>>>> *    unistd.h sysconf(_SC_TZNAME_MAX) if available >>>>> *    limits.h _POSIX_TZNAME_MAX >>>>> *    6! >>>> >>>> I'd replace 6 with #error >>> >>> That's probably for the best - I'll look at adding that to a v2 patch >>> set >>> including doc update. >>> >>> What is required to remake newlib libc info and man pages? >> >> make info / make man? > > Thanks for the kick! > I finally found those targets under build64/newlib/Makefile and got > errors: it looks like python {lxml,ply} need to be manually upgraded to > python39-{lxml,ply} for these to work! > > Both the updated tzset info and man pages now look awful with a > screenful of run on text! That's odd since I would think the viewer should wrap appropriately. > As far as I can see, I can only use blank lines and angle brackets for > formatting, so I will add a whole bunch more of those, retry if they > will now build as part of Cygwin, and see if I can get them to look much > better. > > If anyone has any pointers to the embedded lib doc header semantic > formatting conventions I would be grateful for those. Yeah, this should be described in the documentation section of the 'HOWTO' file, but isn't. Briefly: '<<' and '>>' mark up function names and code '<[' and ']>' mark up formal parameter and variable names There are formatting instructions for bullet points, preformatted monospaced text and tables, which are probably best understood by looking at an existing example. In theory, you can also use any texinfo markup, but if you use anything outside the very limited subset currently used and understood by makedocbook. Unfortunately, makedocbook relies on the prototypes being marked-up in quite an exact way in order to be able to massage them into the very detailed content model of a docbook funcsynopsis.