Re: [PATCH 0/6] More documentation fixes

[Corinna Vinschen <vinschen at redhat dot com>]

Hi Jon,

On Jul 21 14:41, Jon TURNEY wrote:
> Patches to fix a few errors and inconsistencies in the newlib documentation.
> 
> Jon TURNEY (6):
>   Add missing NEWPAGE commands to makedoc markup in reent/
>   Use makedoc generated texinfo documentation for reentrant syscalls
>   Fix SYNPOSIS prototypes for iconv functions
>   Fix a typo in iconv.tex
>   Remove a stray sentence fragment in iconv.tex
>   Remove workaround for texinfo bug with underscores in filenames from
>     mothballed mathfp/
> 
>  newlib/libc/iconv/iconv.tex    |   3 +-
>  newlib/libc/iconv/lib/iconv.c  |   8 +-
>  newlib/libc/reent/execr.c      |   2 +
>  newlib/libc/reent/signalr.c    |   1 +
>  newlib/libc/sys.tex            | 189 +++++++++--------------------------------
>  newlib/libm/mathfp/Makefile.am | 144 ++++++-------------------------
>  6 files changed, 76 insertions(+), 271 deletions(-)

all patches ok to apply.

I'm not sure either what to do about the stdio64 functions.  They
only make sense on some platforms, and on some platforms they may
be transparently used as the standard entry points, as on 32 bit
Cygwin.

Is there some way to allow different per-target documenting?

Or, what about adding a note to their documentation section along the
lines of "these functions may not be available on all platforms"?


Thanks,
Corinna

-- 
Corinna Vinschen
Cygwin Maintainer
Red Hat

Attachment: pgp9WT5fMirTJ.pgp
Description: PGP signature