[PATCH v2] Cygwin: Add spawn family of functions to docs

[Corinna Vinschen]

Hi Mark,

a few points:

On Feb 25 22:37, Mark Geisert wrote:
> In the doc tree, add a new section "Other system interfaces[...]" that
> lists the spawn family of functions, most of the exposed cygwin internal
> functions that a user might have use for, and some other functions
> duplicating Windows or DOS interfaces that might have some utility.
> 
> ---
>  winsup/doc/posix.xml | 35 +++++++++++++++++++++++++++++++++++
>  1 file changed, 35 insertions(+)
> 
> diff --git a/winsup/doc/posix.xml b/winsup/doc/posix.xml
> index 43e860b0d..b9443eaae 100644
> --- a/winsup/doc/posix.xml
> +++ b/winsup/doc/posix.xml
> @@ -1762,6 +1762,41 @@ ISO®/IEC DIS 9945 Information technology
>  
>  </sect1>
>  
> +<sect1 id="std-other"><title>Other system interfaces, some from Windows:</title>
> +
> +<screen>
> +    _alloca			(Windows)

Uhm... yeah, we export this symbol.  Because it's (incorrectly) used by
some apps like cmake.  They should use alloca which translates to
__builtin_alloca in GCC, but... well...  OTOH, do we really WANT to
expose this via our docs?  I think no.

> +    _feinitialise

_feinitialise is internal only and called from the DLL init code.
We export this symbol only for old applications, see Cygwin's fenv.c.

> +    _get_osfhandle		(Windows)
> +    _pipe			(Windows)

We export _pipe, but I don't remember why, and it's not in any
header.  We shouldn't document it.

Looks good, otherwise.


Thanks,
Corinna