From 811725ac209803838aa9e723ac1843885ee680f3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Vincent=20B=C3=A9ron?= <vberon@mecano.gme.usherb.ca>
Date: Mon, 21 Mar 2005 10:55:13 +0000
Subject: [PATCH] Correct and complete some api documentation.

---
 dlls/avifil32/api.c       |  6 +++++-
 dlls/itss/itss.c          |  3 +++
 dlls/ole32/compobj.c      | 20 +++++++++++++++-----
 dlls/twain/twain16_main.c |  6 +++++-
 dlls/winmm/mmsystem.c     |  4 ++--
 5 files changed, 30 insertions(+), 9 deletions(-)

diff --git a/dlls/avifil32/api.c b/dlls/avifil32/api.c
index 5e22f6f81bd..8be7900edc8 100644
--- a/dlls/avifil32/api.c
+++ b/dlls/avifil32/api.c
@@ -190,6 +190,7 @@ void WINAPI AVIFileExit(void) {
 }
 
 /***********************************************************************
+ *		AVIFileOpen		(AVIFIL32.@)
  *		AVIFileOpenA		(AVIFIL32.@)
  *		AVIFileOpen		(AVIFILE.102)
  */
@@ -363,6 +364,7 @@ HRESULT WINAPI AVIFileGetStream(PAVIFILE pfile, PAVISTREAM *avis,
 }
 
 /***********************************************************************
+ *		AVIFileCreateStream	(AVIFIL32.@)
  *		AVIFileCreateStreamA	(AVIFIL32.@)
  *              AVIFileCreateStream	(AVIFILE.144)
  */
@@ -782,8 +784,9 @@ HRESULT WINAPI AVIMakeFileFromStreams(PAVIFILE *ppfile, int nStreams,
 }
 
 /***********************************************************************
- *		AVIStreamOpenFromFile   (AVIFILE.103)
+ *		AVIStreamOpenFromFile	(AVIFIL32.@)
  *		AVIStreamOpenFromFileA	(AVIFIL32.@)
+ *		AVIStreamOpenFromFile   (AVIFILE.103)
  */
 HRESULT WINAPI AVIStreamOpenFromFileA(PAVISTREAM *ppavi, LPCSTR szFile,
 				      DWORD fccType, LONG lParam,
@@ -987,6 +990,7 @@ LONG WINAPI AVIStreamTimeToSample(PAVISTREAM pstream, LONG lTime)
 }
 
 /***********************************************************************
+ *		AVIBuildFilter		(AVIFIL32.@)
  *		AVIBuildFilterA		(AVIFIL32.@)
  *		AVIBuildFilter		(AVIFILE.123)
  */
diff --git a/dlls/itss/itss.c b/dlls/itss/itss.c
index 208a239ed6f..56308939a8b 100644
--- a/dlls/itss/itss.c
+++ b/dlls/itss/itss.c
@@ -168,6 +168,9 @@ static IClassFactoryVtbl ITSSCF_Vtbl =
 };
 
 
+/***********************************************************************
+ *		DllGetClassObject	(ITSS.@)
+ */
 HRESULT WINAPI DllGetClassObject(REFCLSID rclsid, REFIID iid, LPVOID *ppv)
 {
     DWORD i;
diff --git a/dlls/ole32/compobj.c b/dlls/ole32/compobj.c
index 246ffec5fda..300e13ef5c6 100644
--- a/dlls/ole32/compobj.c
+++ b/dlls/ole32/compobj.c
@@ -1036,10 +1036,21 @@ HRESULT WINAPI ProgIDFromCLSID(REFCLSID clsid, LPOLESTR *lplpszProgID)
   return ret;
 }
 
-HRESULT WINAPI CLSIDFromProgID16(
-	LPCOLESTR16 progid,	/* [in] program id as found in registry */
-	LPCLSID riid		/* [out] associated CLSID */
-) {
+/******************************************************************************
+ *		CLSIDFromProgID [COMPOBJ.61]
+ *
+ * Converts a program ID into the respective GUID.
+ *
+ * PARAMS
+ *  progid       [I] program id as found in registry
+ *  riid         [O] associated CLSID
+ *
+ * RETURNS
+ *	Success: S_OK
+ *  Failure: CO_E_CLASSSTRING - the given ProgID cannot be found.
+ */
+HRESULT WINAPI CLSIDFromProgID16(LPCOLESTR16 progid, LPCLSID riid)
+{
 	char	*buf,buf2[80];
 	DWORD	buf2len;
 	HRESULT	err;
@@ -1063,7 +1074,6 @@ HRESULT WINAPI CLSIDFromProgID16(
 
 /******************************************************************************
  *		CLSIDFromProgID	[OLE32.@]
- *		CLSIDFromProgID	[COMPOBJ.61]
  *
  * Converts a program id into the respective GUID.
  *
diff --git a/dlls/twain/twain16_main.c b/dlls/twain/twain16_main.c
index dc80440d063..89140b9ee2d 100644
--- a/dlls/twain/twain16_main.c
+++ b/dlls/twain/twain16_main.c
@@ -30,7 +30,11 @@
 
 WINE_DEFAULT_DEBUG_CHANNEL(twain);
 
-/* Main entry point for the TWAIN library */
+/***********************************************************************
+ *		DSM_Entry (TWAIN.1)
+ *
+ * Main entry point for the TWAIN library
+ */
 TW_UINT16 WINAPI
 DSM_Entry16 (pTW_IDENTITY pOrigin,
            pTW_IDENTITY pDest,
diff --git a/dlls/winmm/mmsystem.c b/dlls/winmm/mmsystem.c
index e12b0282a8b..08bb674eeb0 100644
--- a/dlls/winmm/mmsystem.c
+++ b/dlls/winmm/mmsystem.c
@@ -731,7 +731,7 @@ UINT16 WINAPI midiOutGetDevCaps16(UINT16 uDeviceID, LPMIDIOUTCAPS16 lpCaps,
 
 /**************************************************************************
  * 				midiOutGetErrorText 	[MMSYSTEM.203]
- * 				midiInGetErrorText 	[MMSYSTEM.203]
+ * 				midiInGetErrorText 	[MMSYSTEM.303]
  */
 UINT16 WINAPI midiOutGetErrorText16(UINT16 uError, LPSTR lpText, UINT16 uSize)
 {
@@ -1231,7 +1231,7 @@ UINT16 WINAPI waveOutGetDevCaps16(UINT16 uDeviceID,
 
 /**************************************************************************
  * 				waveOutGetErrorText 	[MMSYSTEM.403]
- * 				waveInGetErrorText 	[MMSYSTEM.403]
+ * 				waveInGetErrorText 	[MMSYSTEM.503]
  */
 UINT16 WINAPI waveOutGetErrorText16(UINT16 uError, LPSTR lpText, UINT16 uSize)
 {