Improve c2man Documented-Total count. Changes:

dlls/user/class.c

@@ -510,6 +510,9 @@ void CLASS_AddWindow( CLASS *class, WND *win, WINDOWPROCTYPE type )
 
 /***********************************************************************
  *		RegisterClassA (USER32.@)
+ *
+ * Register a window class.
+ *
  * RETURNS
  *	>0: Unique identifier
  *	0: Failure
@@ -536,6 +539,8 @@ ATOM WINAPI RegisterClassA( const WNDCLASSA* wc ) /* [in] Address of structure w
 
 /***********************************************************************
  *		RegisterClassW (USER32.@)
+ *
+ * See RegisterClassA.
  */
 ATOM WINAPI RegisterClassW( const WNDCLASSW* wc )
 {

dlls/user/cursoricon.c

@@ -1233,6 +1233,10 @@ HICON16 WINAPI CreateIcon16( HINSTANCE16 hInstance, INT16 nWidth,
  *  (*) Windows does not support 15bpp but it supports the 555 RGB 16bpp
  *      format!
  *
+ * RETURNS
+ *  Success: handle to an icon
+ *  Failure: NULL
+ *
  * BUGS
  *
  *  - The provided bitmaps are not resized!
@@ -1492,7 +1496,10 @@ DWORD WINAPI DumpIcon16( SEGPTR pInfo, WORD *lpLen,
 
 /***********************************************************************
  *		SetCursor (USER32.@)
- * RETURNS:
+ *
+ * Set the cursor shape.
+ *
+ * RETURNS
  *	A handle to the previous cursor shape.
  */
 HCURSOR WINAPI SetCursor( HCURSOR hCursor /* [in] Handle of cursor to show */ )
@@ -2183,7 +2190,7 @@ end:
 /**********************************************************************
  *		LoadImageA (USER32.@)
  *
- * FIXME: implementation lacks some features, see LR_ defines in winuser.h
+ * See LoadImageW.
  */
 
 /* filter for page-fault exceptions */
@@ -2290,8 +2297,8 @@ HANDLE WINAPI LoadImageW( HINSTANCE hinst, LPCWSTR name, UINT type,
  *    Success: Handle to newly created image
  *    Failure: NULL
  *
- * FIXME: implementation still lacks nearly all features, see LR_*
- * defines in winuser.h
+ * FIXME
+ *    implementation still lacks nearly all features, see LR_* defines in winuser.h.
  */
 HICON WINAPI CopyImage( HANDLE hnd, UINT type, INT desiredx,
                              INT desiredy, UINT flags )
@@ -2342,6 +2349,8 @@ HBITMAP WINAPI LoadBitmapW(
 
 /**********************************************************************
  *		LoadBitmapA (USER32.@)
+ *
+ * See LoadBitmapW.
  */
 HBITMAP WINAPI LoadBitmapA( HINSTANCE instance, LPCSTR name )
 {

dlls/user/dde_misc.c

@@ -582,6 +582,8 @@ UINT WDML_Initialize(LPDWORD pidInst, PFNCALLBACK pfnCallback,
 
 /******************************************************************************
  *            DdeInitializeA   (USER32.@)
+ *
+ * See DdeInitializeW.
  */
 UINT WINAPI DdeInitializeA(LPDWORD pidInst, PFNCALLBACK pfnCallback,
 			   DWORD afCmd, DWORD ulRes)
@@ -1089,9 +1091,7 @@ static	HSZ	WDML_CreateString(WDML_INSTANCE* pInstance, LPCVOID ptr, int codepage
 /*****************************************************************
  * DdeCreateStringHandleA [USER32.@]
  *
- * RETURNS
- *    Success: String handle
- *    Failure: 0
+ * See DdeCreateStringHandleW.
  */
 HSZ WINAPI DdeCreateStringHandleA(DWORD idInst, LPCSTR psz, INT codepage)
 {
@@ -1147,7 +1147,8 @@ HSZ WINAPI DdeCreateStringHandleW(DWORD idInst, LPCWSTR psz, INT codepage)
 
 /*****************************************************************
  *            DdeFreeStringHandle   (USER32.@)
- * RETURNS: success: nonzero
+ * RETURNS
+ *  success: nonzero
  *  fail:    zero
  */
 BOOL WINAPI DdeFreeStringHandle(DWORD idInst, HSZ hsz)
@@ -1173,7 +1174,8 @@ BOOL WINAPI DdeFreeStringHandle(DWORD idInst, HSZ hsz)
 /*****************************************************************
  *            DdeKeepStringHandle  (USER32.@)
  *
- * RETURNS: success: nonzero
+ * RETURNS
+ *  success: nonzero
  *  fail:    zero
  */
 BOOL WINAPI DdeKeepStringHandle(DWORD idInst, HSZ hsz)
@@ -1201,7 +1203,11 @@ BOOL WINAPI DdeKeepStringHandle(DWORD idInst, HSZ hsz)
  * Compares the value of two string handles.  This comparison is
  * not case sensitive.
  *
- * Returns:
+ * PARAMS
+ *  hsz1    [I] Handle to the first string
+ *  hsz2    [I] Handle to the second string
+ *
+ * RETURNS
  *  -1 The value of hsz1 is zero or less than hsz2
  *  0  The values of hsz 1 and 2 are the same or both zero.
  *  1  The value of hsz2 is zero of less than hsz1

dlls/user/defwnd.c

@@ -716,6 +716,7 @@ static LRESULT DEFWND_DefWinProc( HWND hwnd, UINT msg, WPARAM wParam, LPARAM lPa
 /***********************************************************************
  *              DefWindowProcA (USER32.@)
  *
+ * See DefWindowProcW.
  */
 LRESULT WINAPI DefWindowProcA( HWND hwnd, UINT msg, WPARAM wParam, LPARAM lParam )
 {

dlls/user/menu.c

@@ -4802,8 +4802,8 @@ static BOOL translate_accelerator( HWND hWnd, UINT message, WPARAM wParam, LPARA
 }
 
 /**********************************************************************
- *      TranslateAccelerator      (USER32.@)
  *      TranslateAcceleratorA     (USER32.@)
+ *      TranslateAccelerator      (USER32.@)
  */
 INT WINAPI TranslateAcceleratorA( HWND hWnd, HACCEL hAccel, LPMSG msg )
 {

dlls/user/message.c

@@ -2810,8 +2810,8 @@ BOOL WINAPI GetMessageA( MSG *msg, HWND hwnd, UINT first, UINT last )
 
 
 /***********************************************************************
- *		IsDialogMessage  (USER32.@)
  *		IsDialogMessageA (USER32.@)
+ *		IsDialogMessage  (USER32.@)
  */
 BOOL WINAPI IsDialogMessageA( HWND hwndDlg, LPMSG pmsg )
 {
@@ -2873,6 +2873,8 @@ BOOL WINAPI TranslateMessage( const MSG *msg )
 
 /***********************************************************************
  *		DispatchMessageA (USER32.@)
+ *
+ * See DispatchMessageW.
  */
 LONG WINAPI DispatchMessageA( const MSG* msg )
 {
@@ -3203,8 +3205,8 @@ void WINAPI UserYield16(void)
 
 
 /***********************************************************************
- *		RegisterWindowMessage (USER.118)
  *		RegisterWindowMessageA (USER32.@)
+ *		RegisterWindowMessage (USER.118)
  */
 UINT WINAPI RegisterWindowMessageA( LPCSTR str )
 {
@@ -3226,8 +3228,8 @@ UINT WINAPI RegisterWindowMessageW( LPCWSTR str )
 
 
 /***********************************************************************
- *		BroadcastSystemMessage  (USER32.@)
  *		BroadcastSystemMessageA (USER32.@)
+ *		BroadcastSystemMessage  (USER32.@)
  */
 LONG WINAPI BroadcastSystemMessageA( DWORD flags, LPDWORD recipients, UINT msg, WPARAM wp, LPARAM lp )
 {

dlls/user/misc.c

@@ -190,6 +190,9 @@ BOOL WINAPI GetAltTabInfoW(HWND hwnd, int iItem, PALTTABINFO pati, LPWSTR pszIte
  *
  * PARAMS
  *    dwLevel [I] Debugging error level
+ *
+ * RETURNS
+ *    Nothing.
  */
 VOID WINAPI SetDebugErrorLevel( DWORD dwLevel )
 {

dlls/user/resource.c

@@ -296,7 +296,9 @@ HACCEL WINAPI CreateAcceleratorTableW(LPACCEL lpaccel, INT cEntries)
  * PARAMS
  *    handle [I] Handle to accelerator table
  *
- * RETURNS STD
+ * RETURNS
+ *    Success: TRUE
+ *    Failure: FALSE
  */
 BOOL WINAPI DestroyAcceleratorTable( HACCEL handle )
 {

dlls/user/scroll.c

@@ -1324,7 +1324,9 @@ static INT SCROLL_GetScrollPos(HWND hwnd, INT nBar)
  *    lpMin [O]  Where to store minimum value
  *    lpMax [O]  Where to store maximum value
  *
- * RETURNS STD
+ * RETURNS
+ *    Success: TRUE
+ *    Failure: FALSE
  */
 static BOOL SCROLL_GetScrollRange(HWND hwnd, INT nBar, LPINT lpMin, LPINT lpMax)
 {
@@ -1859,7 +1861,9 @@ INT WINAPI GetScrollPos(HWND hwnd, INT nBar)
  *    maxVal  [I]  New Maximum value
  *    bRedraw [I]  Should scrollbar be redrawn afterwards?
  *
- * RETURNS STD
+ * RETURNS
+ *    Success: TRUE
+ *    Failure: FALSE
  */
 BOOL WINAPI SetScrollRange(HWND hwnd, INT nBar, INT minVal, INT maxVal, BOOL bRedraw)
 {
@@ -1984,7 +1988,9 @@ static BOOL SCROLL_ShowScrollBar( HWND hwnd, INT nBar, BOOL fShowH, BOOL fShowV
  *    nBar    [I]  One of SB_HORZ, SB_VERT, or SB_CTL
  *    fShow   [I]  TRUE = show, FALSE = hide
  *
- * RETURNS STD
+ * RETURNS
+ *    Success: TRUE
+ *    Failure: FALSE
  */
 BOOL WINAPI ShowScrollBar(HWND hwnd, INT nBar, BOOL fShow)
 {

dlls/user/win.c

@@ -2127,6 +2127,8 @@ LONG WINAPI SetWindowLong16( HWND16 hwnd, INT16 offset, LONG newval )
 
 /**********************************************************************
  *		SetWindowLongA (USER32.@)
+ *
+ * See SetWindowLongW.
  */
 LONG WINAPI SetWindowLongA( HWND hwnd, INT offset, LONG newval )
 {
@@ -2274,8 +2276,8 @@ INT WINAPI GetWindowTextW( HWND hwnd, LPWSTR lpString, INT nMaxCount )
 
 
 /*******************************************************************
- *		SetWindowText  (USER32.@)
  *		SetWindowTextA (USER32.@)
+ *		SetWindowText  (USER32.@)
  */
 BOOL WINAPI SetWindowTextA( HWND hwnd, LPCSTR lpString )
 {

dlls/user/winproc.c

@@ -3293,6 +3293,8 @@ LRESULT WINAPI CallWindowProcA(
 
 /**********************************************************************
  *		CallWindowProcW (USER32.@)
+ *
+ * See CallWindowProcA.
  */
 LRESULT WINAPI CallWindowProcW( WNDPROC func, HWND hwnd, UINT msg,
                                   WPARAM wParam, LPARAM lParam )