From f64a5ef35eb8d877ddecb70223ebaa4980b268e0 Mon Sep 17 00:00:00 2001
From: Amine Khaldi <amine.khaldi@reactos.org>
Date: Fri, 22 Mar 2013 16:13:06 +0000
Subject: [PATCH] [CRT] * Annotate sys/stat.h.

svn path=/trunk/; revision=58578
---
 reactos/include/crt/sys/stat.h | 126 ++++++++++++++++++++++++++++-----
 1 file changed, 109 insertions(+), 17 deletions(-)

diff --git a/reactos/include/crt/sys/stat.h b/reactos/include/crt/sys/stat.h
index 45ec7eaad57..766536c7c8a 100644
--- a/reactos/include/crt/sys/stat.h
+++ b/reactos/include/crt/sys/stat.h
@@ -139,30 +139,122 @@ extern "C" {
 #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 *************************************************/