wine/dlls/ole32 storage32.c storage.c ole2.c o ...

[Alexandre Julliard]

ChangeSet ID:	21191
CVSROOT:	/opt/cvs-commit
Module name:	wine
Changes by:	julliard at winehq.org	2005/11/09 04:59:11

Modified files:
	dlls/ole32     : storage32.c storage.c ole2.c ole16.c 
	                 memlockbytes16.c clipboard.c 

Log message:
	Markus Amsler <markus.amsler at oribi.org>
	Improve c2man Documented-Total count.

Patch: http://cvs.winehq.org/patch.py?id=21191

Old revision  New revision  Changes     Path
 1.95          1.96          +10 -1      wine/dlls/ole32/storage32.c
 1.51          1.52          +6 -1       wine/dlls/ole32/storage.c
 1.78          1.79          +8 -6       wine/dlls/ole32/ole2.c
 1.23          1.24          +8 -2       wine/dlls/ole32/ole16.c
 1.14          1.15          +2 -2       wine/dlls/ole32/memlockbytes16.c
 1.46          1.47          +1 -1       wine/dlls/ole32/clipboard.c

Index: wine/dlls/ole32/storage32.c
diff -u -p wine/dlls/ole32/storage32.c:1.95 wine/dlls/ole32/storage32.c:1.96
--- wine/dlls/ole32/storage32.c:1.95	9 Nov 2005 10:59:11 -0000
+++ wine/dlls/ole32/storage32.c	9 Nov 2005 10:59:11 -0000
@@ -6140,7 +6140,16 @@ HRESULT WINAPI WriteClassStg(IStorage* p
 /***********************************************************************
  *    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){
 
Index: wine/dlls/ole32/storage.c
diff -u -p wine/dlls/ole32/storage.c:1.51 wine/dlls/ole32/storage.c:1.52
--- wine/dlls/ole32/storage.c:1.51	9 Nov 2005 10:59:11 -0000
+++ wine/dlls/ole32/storage.c	9 Nov 2005 10:59:11 -0000
@@ -2227,7 +2227,12 @@ HRESULT WINAPI StgOpenStorageOnILockByte
  * 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)
 {
Index: wine/dlls/ole32/ole2.c
diff -u -p wine/dlls/ole32/ole2.c:1.78 wine/dlls/ole32/ole2.c:1.79
--- wine/dlls/ole32/ole2.c:1.78	9 Nov 2005 10:59:11 -0000
+++ wine/dlls/ole32/ole2.c	9 Nov 2005 10:59:11 -0000
@@ -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,
Index: wine/dlls/ole32/ole16.c
diff -u -p wine/dlls/ole32/ole16.c:1.23 wine/dlls/ole32/ole16.c:1.24
--- wine/dlls/ole32/ole16.c:1.23	9 Nov 2005 10:59:11 -0000
+++ wine/dlls/ole32/ole16.c	9 Nov 2005 10:59:11 -0000
@@ -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 */
Index: wine/dlls/ole32/memlockbytes16.c
diff -u -p wine/dlls/ole32/memlockbytes16.c:1.14 wine/dlls/ole32/memlockbytes16.c:1.15
--- wine/dlls/ole32/memlockbytes16.c:1.14	9 Nov 2005 10:59:11 -0000
+++ wine/dlls/ole32/memlockbytes16.c	9 Nov 2005 10:59:11 -0000
@@ -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.
  *
  */
Index: wine/dlls/ole32/clipboard.c
diff -u -p wine/dlls/ole32/clipboard.c:1.46 wine/dlls/ole32/clipboard.c:1.47
--- wine/dlls/ole32/clipboard.c:1.46	9 Nov 2005 10:59:11 -0000
+++ wine/dlls/ole32/clipboard.c	9 Nov 2005 10:59:11 -0000
@@ -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