Improve c2man Documented-Total count.

dlls/ntdll/error.c

@@ -132,6 +132,9 @@ DWORD WINAPI RtlGetLastWin32Error(void)
  *
  * PARAMS
  *  err [I] The new error value to set
+ *
+ * RETURNS
+ *  Nothing.
  */
 void WINAPI RtlSetLastWin32Error( DWORD err )
 {
@@ -145,6 +148,9 @@ void WINAPI RtlSetLastWin32Error( DWORD err )
  *
  * PARAMS
  *  err [I] The new status value to set
+ *
+ * RETURNS
+ *  Nothing.
  */
 void WINAPI RtlSetLastWin32ErrorAndNtStatusFromNtStatus( NTSTATUS status )
 {

dlls/ntdll/reg.c

@@ -837,9 +837,9 @@ NTSTATUS WINAPI RtlFormatCurrentUserKeyPath( IN OUT PUNICODE_STRING KeyPath)
 /******************************************************************************
  *  RtlOpenCurrentUser		[NTDLL.@]
  *
- * if we return just HKEY_CURRENT_USER the advapi tries to find a remote
- * registry (odd handle) and fails
- *
+ * NOTES
+ *  If we return just HKEY_CURRENT_USER the advapi tries to find a remote
+ *  registry (odd handle) and fails.
  */
 DWORD WINAPI RtlOpenCurrentUser(
 	IN ACCESS_MASK DesiredAccess, /* [in] */

dlls/ntdll/sec.c

@@ -414,7 +414,7 @@ BOOLEAN WINAPI RtlValidSid( PSID pSid )
  *  lpsd [O] Descriptor to initialise.
  *  rev  [I] Revision, must be set to SECURITY_DESCRIPTOR_REVISION.
  *
- * RETURNS:
+ * RETURNS
  *  Success: STATUS_SUCCESS.
  *  Failure: STATUS_UNKNOWN_REVISION if rev is incorrect.
  */
@@ -438,7 +438,7 @@ NTSTATUS WINAPI RtlCreateSecurityDescriptor(
  *  pSourceSD      [O] SD to copy from.
  *  pDestinationSD [I] Destination SD.
  *
- * RETURNS:
+ * RETURNS
  *  Success: STATUS_SUCCESS.
  *  Failure: STATUS_UNKNOWN_REVISION if rev is incorrect.
  */

dlls/ntdll/string.c

@@ -382,6 +382,9 @@ LONGLONG __cdecl _atoi64( char *str )
  *  dir    [O] Destination for directory component. Should be at least MAX_PATH characters.
  *  fname  [O] Destination for File name component. Should be at least MAX_PATH characters.
  *  ext    [O] Destination for file extension component. Should be at least MAX_PATH characters.
+ *
+ * RETURNS
+ *  Nothing.
  */
 void __cdecl _splitpath(const char* inpath, char * drv, char * dir,
                         char* fname, char * ext )

dlls/ole32/clipboard.c

@@ -303,7 +303,7 @@ typedef struct tagClipboardWindowInfo
  *  Places a pointer to the specified data object onto the clipboard,
  *  making the data object accessible to the OleGetClipboard function.
  *
- * RETURNS:
+ * RETURNS
  *
  *    S_OK                  IDataObject pointer placed on the clipboard
  *    CLIPBRD_E_CANT_OPEN   OpenClipboard failed

dlls/ole32/memlockbytes16.c

@@ -500,12 +500,12 @@ HRESULT HGLOBALLockBytesImpl16_Stat(
  * 
  * Creates an ILockBytes interface for a HGLOBAL handle.
  *
- * Params:
+ * PARAMS
  * 	hGlobal			the global handle (16bit)
  *	fDeleteOnRelease	delete handle on release.
  *	ppLkbyt			pointer to ILockBytes interface.
  *
- * Returns:
+ * RETURNS
  *	Staddard OLE error return codes.
  *
  */

dlls/ole32/ole16.c

@@ -204,6 +204,9 @@ IMalloc16_Constructor()
 
 /***********************************************************************
  *           CoGetMalloc    [COMPOBJ.4]
+ *
+ * Retrieve the current win16 IMalloc interface.
+ *
  * RETURNS
  *	The current win16 IMalloc
  */
@@ -344,9 +347,12 @@ HRESULT WINAPI StringFromCLSID16(
 
 /******************************************************************************
  * ProgIDFromCLSID [COMPOBJ.62]
+ *
  * Converts a class id into the respective Program ID. (By using a registry lookup)
- * RETURNS S_OK on success
- * riid associated with the progid
+ *
+ * RETURNS
+ *  S_OK on success
+ *  riid associated with the progid
  */
 HRESULT WINAPI ProgIDFromCLSID16(
   REFCLSID clsid, /* [in] class id as found in registry */

dlls/ole32/ole2.c

@@ -1553,21 +1553,23 @@ HRESULT WINAPI OleDestroyMenuDescriptor(
 
 /***********************************************************************
  * OleSetMenuDescriptor [OLE32.@]
- * Installs or removes OLE dispatching code for the containers frame window
- * FIXME: The lpFrame and lpActiveObject parameters are currently ignored
- * OLE should install context sensitive help F1 filtering for the app when
- * these are non null.
+ * Installs or removes OLE dispatching code for the containers frame window.
  *
- * PARAMS:
+ * PARAMS
  *     hOleMenu         Handle to composite menu descriptor
  *     hwndFrame        Handle to containers frame window
  *     hwndActiveObject Handle to objects in-place activation window
  *     lpFrame          Pointer to IOleInPlaceFrame on containers window
  *     lpActiveObject   Pointer to IOleInPlaceActiveObject on active in-place object
  *
- * RETURNS:
+ * RETURNS
  *      S_OK                               - menu installed correctly
  *      E_FAIL, E_INVALIDARG, E_UNEXPECTED - failure
+ *
+ * FIXME
+ *      The lpFrame and lpActiveObject parameters are currently ignored
+ *      OLE should install context sensitive help F1 filtering for the app when
+ *      these are non null.
  */
 HRESULT WINAPI OleSetMenuDescriptor(
   HOLEMENU               hOleMenu,

dlls/ole32/storage.c

@@ -2227,7 +2227,12 @@ HRESULT WINAPI StgOpenStorageOnILockBytes16(
  * the WriteClassStg.
  *
  * PARAMS
- *  pstg Segmented LPSTORAGE pointer.
+ *  pstg    [I] Segmented LPSTORAGE pointer.
+ *  pclsid  [O] Pointer to where the CLSID is written
+ *
+ * RETURNS
+ *  Success: S_OK.
+ *  Failure: HRESULT code.
  */
 HRESULT WINAPI ReadClassStg16(SEGPTR pstg, CLSID *pclsid)
 {

dlls/ole32/storage32.c

@@ -6140,7 +6140,16 @@ HRESULT WINAPI WriteClassStg(IStorage* pStg, REFCLSID rclsid)
 /***********************************************************************
  *    ReadClassStg (OLE32.@)
  *
- * This method reads the CLSID previously written to a storage object with the WriteClassStg.
+ * This method reads the CLSID previously written to a storage object with
+ * the WriteClassStg.
+ *
+ * PARAMS
+ *  pstg    [I] IStorage pointer
+ *  pclsid  [O] Pointer to where the CLSID is written
+ *
+ * RETURNS
+ *  Success: S_OK.
+ *  Failure: HRESULT code.
  */
 HRESULT WINAPI ReadClassStg(IStorage *pstg,CLSID *pclsid){