[akhaldi] 58578: [CRT] * Annotate sys/stat.h.

Author: akhaldi
Date: Fri Mar 22 16:13:06 2013
New Revision: 58578

URL: http://svn.reactos.org/svn/reactos?rev=58578&view=rev
Log:
[CRT]
* Annotate sys/stat.h.

Modified:
    trunk/reactos/include/crt/sys/stat.h

Modified: trunk/reactos/include/crt/sys/stat.h
URL: http://svn.reactos.org/svn/reactos/trunk/reactos/include/crt/sys/stat.h?rev=...
==============================================================================
--- trunk/reactos/include/crt/sys/stat.h [iso-8859-1] (original)
+++ trunk/reactos/include/crt/sys/stat.h [iso-8859-1] Fri Mar 22 16:13:06 2013
@@ -139,30 +139,122 @@
 #define _S_IWRITE 0x0080
 #define _S_IEXEC 0x0040

-  _CRTIMP int __cdecl _fstat(int _FileDes,struct _stat *_Stat);
-  _CRTIMP int __cdecl _fstat32(int _FileDes,struct _stat32 *_Stat);
-  _CRTIMP int __cdecl _stat(const char *_Name,struct _stat *_Stat);
-  _CRTIMP int __cdecl _stat32(const char *_Name,struct _stat32 *_Stat);
+  _CRTIMP
+  int
+  __cdecl
+  _fstat(
+    _In_ int _FileDes,
+    _Out_ struct _stat *_Stat);
+
+  _CRTIMP
+  int
+  __cdecl
+  _fstat32(
+    _In_ int _FileDes,
+    _Out_ struct _stat32 *_Stat);
+
+  _CRTIMP
+  int
+  __cdecl
+  _stat(
+    _In_z_ const char *_Name,
+    _Out_ struct _stat *_Stat);
+
+  _CRTIMP
+  int
+  __cdecl
+  _stat32(
+    _In_z_ const char *_Name,
+    _Out_ struct _stat32 *_Stat);

#if _INTEGRAL_MAX_BITS >= 64
-  _CRTIMP int __cdecl _fstat64(int _FileDes,struct _stat64 *_Stat);
-  _CRTIMP int __cdecl _fstat32i64(int _FileDes,struct _stat32i64 *_Stat);
-  _CRTIMP int __cdecl _fstat64i32(int _FileDes,struct _stat64i32 *_Stat);
-  _CRTIMP int __cdecl _stat64(const char *_Name,struct _stat64 *_Stat);
-  _CRTIMP int __cdecl _stat32i64(const char *_Name,struct _stat32i64 *_Stat);
-  _CRTIMP int __cdecl _stat64i32(const char *_Name,struct _stat64i32 *_Stat);
+
+  _CRTIMP
+  int
+  __cdecl
+  _fstat64(
+    _In_ int _FileDes,
+    _Out_ struct _stat64 *_Stat);
+
+  _CRTIMP
+  int
+  __cdecl
+  _fstat32i64(
+    _In_ int _FileDes,
+    _Out_ struct _stat32i64 *_Stat);
+
+  _CRTIMP
+  int
+  __cdecl
+  _fstat64i32(
+    _In_ int _FileDes,
+    _Out_ struct _stat64i32 *_Stat);
+
+  _CRTIMP
+  int
+  __cdecl
+  _stat64(
+    _In_z_ const char *_Name,
+    _Out_ struct _stat64 *_Stat);
+
+  _CRTIMP
+  int
+  __cdecl
+  _stat32i64(
+    _In_z_ const char *_Name,
+    _Out_ struct _stat32i64 *_Stat);
+
+  _CRTIMP
+  int
+  __cdecl
+  _stat64i32(
+    _In_z_ const char *_Name,
+    _Out_ struct _stat64i32 *_Stat);
+
 #endif /* _INTEGRAL_MAX_BITS >= 64 */

#ifndef _WSTAT_DEFINED
 #define _WSTAT_DEFINED
-  _CRTIMP int __cdecl _wstat(const wchar_t *_Name,struct _stat *_Stat);
-  _CRTIMP int __cdecl _wstat32(const wchar_t *_Name,struct _stat32 *_Stat);
+
+  _CRTIMP
+  int
+  __cdecl
+  _wstat(
+    _In_z_ const wchar_t *_Name,
+    _Out_ struct _stat *_Stat);
+
+  _CRTIMP
+  int
+  __cdecl
+  _wstat32(
+    _In_z_ const wchar_t *_Name,
+    _Out_ struct _stat32 *_Stat);
+
 #if _INTEGRAL_MAX_BITS >= 64
-  _CRTIMP int __cdecl _wstat32i64(const wchar_t *_Name,struct _stat32i64 *_Stat);
-  _CRTIMP int __cdecl _wstat64i32(const wchar_t *_Name,struct _stat64i32 *_Stat);
-  _CRTIMP int __cdecl _wstat64(const wchar_t *_Name,struct _stat64 *_Stat);
-#endif
-#endif
+  _CRTIMP
+  int
+  __cdecl
+  _wstat32i64(
+    _In_z_ const wchar_t *_Name,
+    _Out_ struct _stat32i64 *_Stat);
+
+  _CRTIMP
+  int
+  __cdecl
+  _wstat64i32(
+    _In_z_ const wchar_t *_Name,
+    _Out_ struct _stat64i32 *_Stat);
+
+  _CRTIMP
+  int
+  __cdecl
+  _wstat64(
+    _In_z_ const wchar_t *_Name,
+    _Out_ struct _stat64 *_Stat);
+
+#endif /* _INTEGRAL_MAX_BITS >= 64 */
+
+#endif /* _WSTAT_DEFINED */

/** Compatibility definitons *************************************************/