From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp-out-so.shaw.ca (smtp-out-so.shaw.ca [64.59.136.137]) by sourceware.org (Postfix) with ESMTPS id 83B45384400A for ; Tue, 16 Feb 2021 17:00:46 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 83B45384400A Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=SystematicSw.ab.ca Authentication-Results: sourceware.org; spf=none smtp.mailfrom=brian.inglis@systematicsw.ab.ca Received: from [192.168.1.104] ([24.64.172.44]) by shaw.ca with ESMTP id C3iOlaiFcnRGtC3iPlwr0Q; Tue, 16 Feb 2021 10:00:45 -0700 X-Authority-Analysis: v=2.4 cv=cagXElPM c=1 sm=1 tr=0 ts=602bfa3d a=kiZT5GMN3KAWqtYcXc+/4Q==:117 a=kiZT5GMN3KAWqtYcXc+/4Q==:17 a=IkcTkHD0fZMA:10 a=uYT-Tk0qkVT609LjNaIA:9 a=QEXdDO2ut3YA:10 Reply-To: cygwin-patches@cygwin.com Subject: Re: [PATCH v2] winsup/doc/posix.xml: add note for getrlimit, setrlimit, xrefs to notes To: cygwin-patches@cygwin.com References: <20210215223540.18256-1-Brian.Inglis@SystematicSW.ab.ca> <39425336-2abc-793e-f2fd-ac6ade12d55c@SystematicSw.ab.ca> From: Brian Inglis Organization: Systematic Software Message-ID: Date: Tue, 16 Feb 2021 10:00:44 -0700 User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:78.0) Gecko/20100101 Thunderbird/78.7.1 MIME-Version: 1.0 In-Reply-To: <39425336-2abc-793e-f2fd-ac6ade12d55c@SystematicSw.ab.ca> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-CA Content-Transfer-Encoding: 8bit X-CMAE-Envelope: MS4xfJYLZ2bWiwM/UpCb5qZ0LtPF0pIuuoWVXW2/puO47o9r1++U/NiwG7w5V6UW4aYXpVbRd4SIj9Y6O1rWiw0wQxefSyOX+qLk2pHz7Wfi+zmr/YyKmhIf vD7KriC9P5U9ZBbGMod+JN30P6Y3G0QtJr/F04GUki88Z1l+dBZoysat2IXYjpJH/rKlBzDqHYXl8YIm/R6cKiyHD0HChEV2yCk= X-Spam-Status: No, score=-5.5 required=5.0 tests=BAYES_00, KAM_DMARC_STATUS, KAM_LAZY_DOMAIN_SECURITY, NICE_REPLY_A, RCVD_IN_DNSWL_LOW, RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL, SPF_HELO_NONE, SPF_NONE, TXREP autolearn=no autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on server2.sourceware.org X-BeenThere: cygwin-patches@cygwin.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Cygwin core component patch submission and discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 16 Feb 2021 17:00:48 -0000 On 2021-02-16 09:51, Brian Inglis wrote: > On 2021-02-16 04:30, Corinna Vinschen via Cygwin-patches wrote: >> On Feb 15 15:35, Brian Inglis wrote: >>> change notes to see "Implementation Notes" to xref to std-notes; >>> add xref to std-notes to getrlimit, setrlimit; >>> add note to document limitations of getrlimit, setrlimit resources support >>> --- >>>   winsup/doc/posix.xml | 101 ++++++++++++++++++++++++------------------- >>>   1 file changed, 57 insertions(+), 44 deletions(-) > >> Pushed with a change: >>    (see chapter "Implementation Notes") >> --> >>    (see chapter "Implementation Notes") >> The reason is how xref is handled when creating html docs.  The result >> of an xref is always 'the section called "..."'.  With the above change, >> the text works (albeit differently) in html and info file. > > Cheers, thanks, I'll bear that in mind in future, and read the generated output > more carefully. > > I'm not seeing .info generated with Note:... links, is that okay? > > Also ...api.pdf is no longer being regenerated, so what have I lost or am missing? > > I have the following doc tools (and others): > > $ apt l asciidoc dblatex poppler\$ xmlto > asciidoc 8.6.9-1 x86_64 [installed, manual] > dblatex 0.3.10-1 x86_64 [installed, automatic] > poppler 21.01.0-1 x86_64 [installed, manual] > xmlto 0.0.28-1 x86_64 [installed, automatic] Also as documented plus other dependencies: $ apt l build-docbook-catalog docbook-sgml45 docbook-utils docbook-xml45 \ docbook-xsl docbook2X build-docbook-catalog 1.5-2 x86_64 [installed, automatic] docbook-sgml45 4.5-1 x86_64 [installed, automatic] docbook-utils 0.6.14-2 x86_64 [installed, manual] docbook-xml45 4.5-1 x86_64 [installed, manual] docbook-xsl 1.77.1-1 x86_64 [installed, automatic] docbook2X 0.8.8-1 x86_64 [installed, manual] > What else is needed? -- Take care. Thanks, Brian Inglis, Calgary, Alberta, Canada This email may be disturbing to some readers as it contains too much technical detail. Reader discretion is advised. [Data in binary units and prefixes, physical quantities in SI.]