[PATCH] winsup/doc/posix.xml: add note for getrlimit, setrlimit, links to notes

Corinna Vinschen corinna-cygwin@cygwin.com
Mon Feb 15 10:43:50 GMT 2021

Hi Brian,

On Feb 12 18:06, Brian Inglis wrote:
> change notes to see "Implementation Notes" to links to std-notes.html;
> links work in html docs but appear as text in info docs;
> add link to std-notes.html 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(-)

Thanks for the patch, but...

> diff --git a/winsup/doc/posix.xml b/winsup/doc/posix.xml
> index 0669d07de890..71f0373940a5 100644
> --- a/winsup/doc/posix.xml
> +++ b/winsup/doc/posix.xml
> @@ -64,7 +64,7 @@ also IEEE Std 1003.1-2008 (POSIX.1-2008).</para>
>      atoi
>      atol
>      atoll
> -    basename			(see chapter "Implementation Notes")
> +    basename			<ulink url="std-notes.html">(see chapter "Implementation Notes")</ulink>

...please use xref rather than ulink for cross refs within the same
documentation,  i.e.

  (see <xref linkend="std-notes">chapter "Implementation Notes"</xref>)

Unfortunately I just noticed in both cases, that a matching link is
missing in cygwin-api.info afterwards.  However, cross referencing works
in cygwin-ug-net.info, afaics.

Jon, any idea why this is?  I don't see any difference in how the info
files are created.


More information about the Cygwin-patches mailing list