[PATCH v2] winsup/doc/posix.xml: add note for getrlimit, setrlimit, xrefs to notes
Brian Inglis
Brian.Inglis@SystematicSw.ab.ca
Tue Feb 16 17:00:44 GMT 2021
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:
>> <xref linkend="std-notes">(see chapter "Implementation Notes")</xref>
>> -->
>> (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>)
>> 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.]
More information about the Cygwin-patches
mailing list