+2020-07-05 Keith Marshall <keith@users.osdn.me>
+
+ Update MBCS to wide character conversion man pages.
+
+ * man/btowc.3.man man/mbrlen.3.man man/mbrtowc.3.man
+ * man/mbsinit.3.man man/mbsrtowcs.3.man man/wcrtomb.3.man
+ * man/wcsrtombs.3.man man/wctob.3.man: Remove references to Microsoft
+ implementations of documented functions; all means of access to such
+ function implementations have been disabled for MinGW applications.
+
2020-07-04 Keith Marshall <keith@users.osdn.me>
Discontinue use of Microsoft's MBCS/wide character converters.
.I c
.B );
.
-.IP \& -4n
-Feature Test Macro Requirements for libmingwex:
-.PP
-.BR \%__MSVCRT_VERSION__ :
-since \%mingwrt\(hy5.3,
-if this feature test macro is
-.IR defined ,
-with a value of
-.I at least
-.IR \%0x0800 ,
-(corresponding to the symbolic constant,
-.BR \%__MSCVR80_DLL ,
-and thus declaring intent to link with \%MSVCR80.DLL,
-or any later version of \%Microsoft\(aqs \%non\(hyfree runtime library,
-instead of with \%MSVCRT.DLL),
-calls to
-.BR \%btowc ()
-will be directed to the implementation thereof,
-within \%Microsoft\(aqs runtime DLL.
-.
-.PP
-.BR \%_ISOC99_SOURCE ,
-.BR \%_ISOC11_SOURCE :
-since \%mingwrt\(hy5.3.1,
-when linking with \%MSVCRT.DLL,
-or when
-.B \%__MSVCRT_VERSION__
-is either
-.IR undefined ,
-or is
-.I defined
-with any value which is
-.I less than
-.IR \%0x0800 ,
-(thus denying intent to link with \%MSVCR80.DLL,
-or any later \%non\(hyfree version of Microsoft\(aqs runtime library),
-.I explicitly
-defining either of these feature test macros
-will cause any call to
-.BR \%btowc ()
-to be directed to the
-.I \%libmingwex
-implementation;
-if neither macro is defined,
-calls to
-.BR \%btowc ()
-will be directed to Microsoft\(aqs runtime implementation,
-if it is available,
-otherwise falling back to the
-.I \%libmingwex
-implementation.
-.
-.PP
-Prior to \%mingwrt\(hy5.3,
-none of the above feature test macros have any effect on
-.BR \%btowc ();
-all calls will be directed to the
-.I \%libmingwex
-implementation.
-.
.
.SH DESCRIPTION
If
.BR \%ISO\(hyC99 ,
.BR \%POSIX.1\(hy2001 ,
and
-.BR \%POSIX.1\(hy2008 ;
-(prior to \%mingwrt\-5.3,
-and in those cases where calls may be delegated
-to a Microsoft runtime DLL implementation,
-this level of conformity may not be achieved).
+.BR \%POSIX.1\(hy2008 .
.
.
.\"SH EXAMPLE
.B );
.
.
-.IP \& -4n
-Feature Test Macro Requirements for libmingwex:
-.PP
-.BR \%__MSVCRT_VERSION__ :
-since \%mingwrt\(hy5.3,
-if this feature test macro is
-.IR defined ,
-with a value of
-.I at least
-.IR \%0x0800 ,
-(corresponding to the symbolic constant,
-.BR \%__MSCVR80_DLL ,
-and thus declaring intent to link with \%MSVCR80.DLL,
-or any later version of \%Microsoft\(aqs \%non\(hyfree runtime library,
-instead of with \%MSVCRT.DLL),
-calls to
-.BR \%mbrlen ()
-will be directed to the implementation thereof,
-within \%Microsoft\(aqs runtime DLL.
-.
-.PP
-.BR \%_ISOC99_SOURCE ,
-.BR \%_ISOC11_SOURCE :
-since \%mingwrt\(hy5.3.1,
-when linking with \%MSVCRT.DLL,
-or when
-.B \%__MSVCRT_VERSION__
-is either
-.IR undefined ,
-or is
-.I defined
-with any value which is
-.I less than
-.IR \%0x0800 ,
-(thus denying intent to link with \%MSVCR80.DLL,
-or any later \%non\(hyfree version of Microsoft\(aqs runtime library),
-.I explicitly
-defining either of these feature test macros
-will cause any call to
-.BR \%mbrlen ()
-to be directed to the
-.I \%libmingwex
-implementation;
-if neither macro is defined,
-calls to
-.BR \%mbrlen ()
-will be directed to Microsoft\(aqs runtime implementation,
-if it is available,
-otherwise falling back to the
-.I \%libmingwex
-implementation.
-.
-.PP
-Prior to \%mingwrt\(hy5.3,
-none of the above feature test macros have any effect on
-.BR \%mbrlen ();
-all calls will be directed to the
-.I \%libmingwex
-implementation.
-.
-.
.SH DESCRIPTION
The
.BR \%mbrlen ()
.BR \%ISO\(hyC99 ,
.BR \%POSIX.1\(hy2001 ,
and
-.BR \%POSIX.1\(hy2008 ;
-(prior to \%mingwrt\-5.3 ,
-and in those cases where calls may be delegated
-to a Microsoft runtime DLL implementation,
-this level of conformity may not be achieved).
+.BR \%POSIX.1\(hy2008 .
.
.PP
The feature whereby
.BI * ps
.B );
.
-.IP \& -4n
-Feature Test Macro Requirements for libmingwex:
-.PP
-.BR \%__MSVCRT_VERSION__ :
-since \%mingwrt\(hy5.3,
-if this feature test macro is
-.IR defined ,
-with a value of
-.I at least
-.IR 0x0800 ,
-(corresponding to the symbolic constant,
-.BR \%__MSCVR80_DLL ,
-and thus declaring intent to link with \%MSVCR80.DLL,
-or any later version of \%Microsoft\(aqs \%non\(hyfree runtime library,
-instead of with \%MSVCRT.DLL),
-calls to
-.BR mbrtowc ()
-will be directed to the implementation thereof,
-within \%Microsoft\(aqs runtime DLL.
-.
-.PP
-.BR \%_ISOC99_SOURCE ,
-.BR \%_ISOC11_SOURCE :
-since \%mingwrt\(hy5.3.1,
-when linking with \%MSVCRT.DLL,
-or when
-.B \%__MSVCRT_VERSION__
-is either
-.IR undefined ,
-or is
-.I defined
-with any value which is
-.I less than
-.IR 0x0800 ,
-(thus denying intent to link with \%MSVCR80.DLL,
-or any later \%non\(hyfree version of Microsoft\(aqs runtime library),
-.I explicitly
-defining either of these feature test macros
-will cause any call to
-.BR \%mbrtowc ()
-to be directed to the
-.I \%libmingwex
-implementation;
-if neither macro is defined,
-calls to
-.BR \%mbrtowc ()
-will be directed to Microsoft\(aqs runtime implementation,
-if it is available,
-otherwise falling back to the
-.I \%libmingwex
-implementation.
-.
-.PP
-Prior to \%mingwrt\(hy5.3,
-none of the above feature test macros have any effect on
-.BR \%mbrtowc ();
-all calls will be directed to the
-.I \%libmingwex
-implementation.
-.
.
.SH DESCRIPTION
If
.BR \%ISO\(hyC99 ,
.BR \%POSIX.1\(hy2001 ,
and
-.BR \%POSIX.1\(hy2008 ;
-(prior to \%mingwrt\-5.3,
-and in those cases where calls may be delegated
-to a Microsoft runtime DLL implementation,
-this level of conformity may not be achieved).
+.BR \%POSIX.1\(hy2008 .
.
.PP
The feature whereby
.
.
.SH STANDARDS CONFORMANCE
-There is no Microsoft implementation of the
-.BR mbsinit ()
-function,
-which is readily accessible for use in MinGW applications;
-the
+The
.I \%libmingwex
-implementation conforms generally to
+implementation of
+.BR mbsinit ()
+conforms generally to
.BR \%ISO\(hyC99 ,
.BR \%POSIX.1\(hy2001 ,
and
.BI * ps
.B );
.
-.IP \& -4n
-Feature Test Macro Requirements for libmingwex:
-.PP
-.BR \%__MSVCRT_VERSION__ :
-since \%mingwrt\(hy5.3,
-if this feature test macro is
-.IR defined ,
-with a value of
-.I at least
-.IR 0x0800 ,
-(corresponding to the symbolic constant,
-.BR \%__MSCVR80_DLL ,
-and thus declaring intent to link with \%MSVCR80.DLL,
-or any later version of \%Microsoft\(aqs \%non\(hyfree runtime library,
-instead of with \%MSVCRT.DLL),
-calls to
-.BR mbsrtowcs ()
-will be directed to the implementation thereof,
-within \%Microsoft\(aqs runtime DLL.
-.
-.PP
-.BR \%_ISOC99_SOURCE ,
-.BR \%_ISOC11_SOURCE :
-since \%mingwrt\(hy5.3.1,
-when linking with \%MSVCRT.DLL,
-or when
-.B \%__MSVCRT_VERSION__
-is either
-.IR undefined ,
-or is
-.I defined
-with any value which is
-.I less than
-.IR 0x0800 ,
-(thus denying intent to link with \%MSVCR80.DLL,
-or any later \%non\(hyfree version of Microsoft\(aqs runtime library),
-.I explicitly
-defining either of these feature test macros
-will cause any call to
-.BR \%mbsrtowcs ()
-to be directed to the
-.I \%libmingwex
-implementation;
-if neither macro is defined,
-calls to
-.BR \%mbsrtowcs ()
-will be directed to Microsoft\(aqs runtime implementation,
-if it is available,
-otherwise falling back to the
-.I \%libmingwex
-implementation.
-.
-.PP
-Prior to \%mingwrt\(hy5.3,
-none of the above feature test macros have any effect on
-.BR \%mbsrtowcs ();
-all calls will be directed to the
-.I \%libmingwex
-implementation.
-.
.
.SH DESCRIPTION
.PP
.BR \%ISO\(hyC99 ,
.BR \%POSIX.1\(hy2001 ,
and
-.BR \%POSIX.1\(hy2008 ;
-(prior to \%mingwrt\-5.3,
-and in those cases where calls may be delegated
-to a Microsoft runtime DLL implementation,
-this level of conformity may not be achieved).
+.BR \%POSIX.1\(hy2008 .
.
.
.\"SH EXAMPLE
.BI * ps
.B );
.
-.IP \& -4n
-Feature Test Macro Requirements for libmingwex:
-.PP
-.BR \%__MSVCRT_VERSION__ :
-since \%mingwrt\(hy5.3,
-if this feature test macro is
-.IR defined ,
-with a value of
-.I at least
-.IR \%0x0800 ,
-(corresponding to the symbolic constant,
-.BR \%__MSCVR80_DLL ,
-and thus declaring intent to link with \%MSVCR80.DLL,
-or any later version of \%Microsoft\(aqs \%non\(hyfree runtime library,
-instead of with \%MSVCRT.DLL),
-calls to
-.BR \%wcrtomb ()
-will be directed to the implementation thereof,
-within \%Microsoft\(aqs runtime DLL.
-.
-.PP
-.BR \%_ISOC99_SOURCE ,
-.BR \%_ISOC11_SOURCE :
-since \%mingwrt\(hy5.3.1,
-when linking with \%MSVCRT.DLL,
-or when
-.B \%__MSVCRT_VERSION__
-is either
-.IR undefined ,
-or is
-.I defined
-with any value which is
-.I less than
-.IR \%0x0800 ,
-(thus denying intent to link with \%MSVCR80.DLL,
-or any later \%non\(hyfree version of Microsoft\(aqs runtime library),
-.I explicitly
-defining either of these feature test macros
-will cause any call to
-.BR \%wcrtomb ()
-to be directed to the
-.I \%libmingwex
-implementation;
-if neither macro is defined,
-calls to
-.BR \%wcrtomb ()
-will be directed to Microsoft\(aqs runtime implementation,
-if it is available,
-otherwise falling back to the
-.I \%libmingwex
-implementation.
-.
-.PP
-Prior to \%mingwrt\(hy5.3,
-none of the above feature test macros have any effect on
-.BR \%wcrtomb ();
-all calls will be directed to the
-.I \%libmingwex
-implementation.
-.
.
.SH DESCRIPTION
The
.BR \%ISO\(hyC99 ,
.BR \%POSIX.1\(hy2001 ,
and
-.BR \%POSIX.1\(hy2008 ;
-(prior to \%mingwrt\-5.3,
-and in those cases where calls may be delegated
-to a Microsoft runtime DLL implementation,
-this level of conformity may not be achieved).
+.BR \%POSIX.1\(hy2008 .
.
.
.\"SH EXAMPLE
.BI * ps
.B );
.
-.IP \& -4n
-Feature Test Macro Requirements for libmingwex:
-.PP
-.BR \%__MSVCRT_VERSION__ :
-since \%mingwrt\(hy5.3,
-if this feature test macro is
-.IR defined ,
-with a value of
-.I at least
-.IR \%0x0800 ,
-(corresponding to the symbolic constant,
-.BR \%__MSCVR80_DLL ,
-and thus declaring intent to link with \%MSVCR80.DLL,
-or any later version of \%Microsoft\(aqs \%non\(hyfree runtime library,
-instead of with \%MSVCRT.DLL),
-calls to
-.BR \%wcsrtombs ()
-will be directed to the implementation thereof,
-within \%Microsoft\(aqs runtime DLL.
-.
-.PP
-.BR \%_ISOC99_SOURCE ,
-.BR \%_ISOC11_SOURCE :
-since \%mingwrt\(hy5.3.1,
-when linking with \%MSVCRT.DLL,
-or when
-.B \%__MSVCRT_VERSION__
-is either
-.IR undefined ,
-or is
-.I defined
-with any value which is
-.I less than
-.IR \%0x0800 ,
-(thus denying intent to link with \%MSVCR80.DLL,
-or any later \%non\(hyfree version of Microsoft\(aqs runtime library),
-.I explicitly
-defining either of these feature test macros
-will cause any call to
-.BR \%wcsrtombs ()
-to be directed to the
-.I \%libmingwex
-implementation;
-if neither macro is defined,
-calls to
-.BR \%wcsrtombs ()
-will be directed to Microsoft\(aqs runtime implementation,
-if it is available,
-otherwise falling back to the
-.I \%libmingwex
-implementation.
-.
-.PP
-Prior to \%mingwrt\(hy5.3,
-none of the above feature test macros have any effect on
-.BR \%wcsrtombs ();
-all calls will be directed to the
-.I \%libmingwex
-implementation.
-.
.
.SH DESCRIPTION
The
.BR \%ISO\(hyC99 ,
.BR \%POSIX.1\(hy2001 ,
and
-.BR \%POSIX.1\(hy2008 ;
-(prior to \%mingwrt\-5.3,
-and in those cases where calls may be delegated
-to a Microsoft runtime DLL implementation,
-this level of conformity may not be achieved).
+.BR \%POSIX.1\(hy2008 .
.
.
.\"SH EXAMPLE
.I c
.B );
.
-.IP \& -4n
-Feature Test Macro Requirements for libmingwex:
-.PP
-.BR \%__MSVCRT_VERSION__ :
-since \%mingwrt\(hy5.3,
-if this feature test macro is
-.IR defined ,
-with a value of
-.I at least
-.IR \%0x0800 ,
-(corresponding to the symbolic constant,
-.BR \%__MSCVR80_DLL ,
-and thus declaring intent to link with \%MSVCR80.DLL,
-or any later version of \%Microsoft\(aqs \%non\(hyfree runtime library,
-instead of with \%MSVCRT.DLL),
-calls to
-.BR \%wctob ()
-will be directed to the implementation thereof,
-within \%Microsoft\(aqs runtime DLL.
-.
-.PP
-.BR \%_ISOC99_SOURCE ,
-.BR \%_ISOC11_SOURCE :
-since \%mingwrt\(hy5.3.1,
-when linking with \%MSVCRT.DLL,
-or when
-.B \%__MSVCRT_VERSION__
-is either
-.IR undefined ,
-or is
-.I defined
-with any value which is
-.I less than
-.IR \%0x0800 ,
-(thus denying intent to link with \%MSVCR80.DLL,
-or any later \%non\(hyfree version of Microsoft\(aqs runtime library),
-.I explicitly
-defining either of these feature test macros
-will cause any call to
-.BR \%wctob ()
-to be directed to the
-.I \%libmingwex
-implementation;
-if neither macro is defined,
-calls to
-.BR \%wctob ()
-will be directed to Microsoft\(aqs runtime implementation,
-if it is available,
-otherwise falling back to the
-.I \%libmingwex
-implementation.
-.
-.PP
-Prior to \%mingwrt\(hy5.3,
-none of the above feature test macros have any effect on
-.BR \%wctob ();
-all calls will be directed to the
-.I \%libmingwex
-implementation.
-.
.
.SH DESCRIPTION
The
.BR \%ISO\(hyC99 ,
.BR \%POSIX.1\(hy2001 ,
and
-.BR \%POSIX.1\(hy2008 ;
-(prior to \%mingwrt\(hy5.3,
-and in those cases where calls may be delegated
-to a Microsoft runtime DLL implementation,
-this level of conformity may not be achieved).
+.BR \%POSIX.1\(hy2008 .
.
.
.\"SH EXAMPLE