OSDN Git Service

Update MBCS to wide character conversion man pages.
authorKeith Marshall <keith@users.osdn.me>
Sun, 5 Jul 2020 18:26:24 +0000 (19:26 +0100)
committerKeith Marshall <keith@users.osdn.me>
Sun, 5 Jul 2020 18:26:24 +0000 (19:26 +0100)
mingwrt/ChangeLog
mingwrt/man/btowc.3.man
mingwrt/man/mbrlen.3.man
mingwrt/man/mbrtowc.3.man
mingwrt/man/mbsinit.3.man
mingwrt/man/mbsrtowcs.3.man
mingwrt/man/wcrtomb.3.man
mingwrt/man/wcsrtombs.3.man
mingwrt/man/wctob.3.man

index 5be08eb..fdbf8b6 100644 (file)
@@ -1,3 +1,13 @@
+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.
index 5f200c4..f748be3 100644 (file)
 .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
@@ -130,11 +70,7 @@ conforms generally to
 .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
index e86728a..7c2f7dc 100644 (file)
 .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 ()
@@ -250,11 +189,7 @@ conforms generally to
 .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
index d6615af..934efd1 100644 (file)
 .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
@@ -327,11 +267,7 @@ conforms generally to
 .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
index dfff9e3..ecf6de6 100644 (file)
@@ -160,13 +160,11 @@ No error conditions are defined.
 .
 .
 .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
index 1f754b5..71771a8 100644 (file)
 .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
@@ -263,11 +203,7 @@ conforms generally to
 .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
index 27bc620..1e21d61 100644 (file)
 .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
@@ -207,11 +147,7 @@ conforms generally to
 .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
index 74334b0..be09f01 100644 (file)
 .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
@@ -244,11 +184,7 @@ conforms generally to
 .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
index ef396b6..d8ba59d 100644 (file)
 .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
@@ -135,11 +75,7 @@ conforms generally to
 .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