From 63b596d7eafeb1ef58dde1566198cf51237ca4b1 Mon Sep 17 00:00:00 2001
From: Francois Gouget <fgouget@free.fr>
Date: Fri, 6 May 2005 14:33:02 +0000
Subject: [PATCH] Tweak the documentation to make winapi_check happy.

---
 dlls/msi/registry.c  | 18 +++++++++++++++++-
 dlls/x11drv/opengl.c | 36 ++++++++++++++++++++----------------
 2 files changed, 37 insertions(+), 17 deletions(-)

diff --git a/dlls/msi/registry.c b/dlls/msi/registry.c
index 61d8b1db73a..15e91090dc5 100644
--- a/dlls/msi/registry.c
+++ b/dlls/msi/registry.c
@@ -722,6 +722,10 @@ UINT WINAPI MsiEnumClientsW(LPCWSTR szComponent, DWORD index, LPWSTR szProduct)
     return r;
 }
 
+/*************************************************************************
+ *  MsiEnumComponentQualifiersA [MSI.@]
+ *
+ */
 UINT WINAPI MsiEnumComponentQualifiersA( LPSTR szComponent, DWORD iIndex,
                 LPSTR lpQualifierBuf, DWORD* pcchQualifierBuf,
                 LPSTR lpApplicationDataBuf, DWORD* pcchApplicationDataBuf)
@@ -768,7 +772,7 @@ UINT WINAPI MsiEnumComponentQualifiersA( LPSTR szComponent, DWORD iIndex,
 
     /*
      * A bit of wizardry to report back the length without the null.
-     * just in case the buffer is to small and is filled.
+     * just in case the buffer is too small and is filled.
      */
     if (lpQualifierBuf)
     {
@@ -799,6 +803,10 @@ UINT WINAPI MsiEnumComponentQualifiersA( LPSTR szComponent, DWORD iIndex,
     return rc;
 }
 
+/*************************************************************************
+ *  MsiEnumComponentQualifiersW [MSI.@]
+ *
+ */
 UINT WINAPI MsiEnumComponentQualifiersW( LPWSTR szComponent, DWORD iIndex,
                 LPWSTR lpQualifierBuf, DWORD* pcchQualifierBuf,
                 LPWSTR lpApplicationDataBuf, DWORD* pcchApplicationDataBuf )
@@ -858,6 +866,10 @@ UINT WINAPI MsiEnumComponentQualifiersW( LPWSTR szComponent, DWORD iIndex,
     return rc;
 }
 
+/*************************************************************************
+ *  MsiEnumRelatedProductsW   [MSI.@]
+ *
+ */
 UINT WINAPI MsiEnumRelatedProductsW(LPCWSTR szUpgradeCode, DWORD dwReserved,
                                     DWORD iProductIndex, LPWSTR lpProductBuf)
 {
@@ -885,6 +897,10 @@ UINT WINAPI MsiEnumRelatedProductsW(LPCWSTR szUpgradeCode, DWORD dwReserved,
     return r;
 }
 
+/*************************************************************************
+ *  MsiEnumRelatedProductsA   [MSI.@]
+ *
+ */
 UINT WINAPI MsiEnumRelatedProductsA(LPCSTR szUpgradeCode, DWORD dwReserved,
                                     DWORD iProductIndex, LPSTR lpProductBuf)
 {
diff --git a/dlls/x11drv/opengl.c b/dlls/x11drv/opengl.c
index 481665c12fc..302a472c3ad 100644
--- a/dlls/x11drv/opengl.c
+++ b/dlls/x11drv/opengl.c
@@ -272,10 +272,11 @@ choose_exit:
   return ret;
 }
 
-/* X11DRV_DescribePixelFormat
-
-     Get the pixel-format descriptor associated to the given id
-*/
+/**
+ * X11DRV_DescribePixelFormat
+ *
+ * Get the pixel-format descriptor associated to the given id
+ */
 int X11DRV_DescribePixelFormat(X11DRV_PDEVICE *physDev,
 			       int iPixelFormat,
 			       UINT nBytes,
@@ -403,20 +404,22 @@ int X11DRV_DescribePixelFormat(X11DRV_PDEVICE *physDev,
   return ret;
 }
 
-/* X11DRV_GetPixelFormat
-
-     Get the pixel-format id used by this DC
-*/
+/**
+ * X11DRV_GetPixelFormat
+ *
+ * Get the pixel-format id used by this DC
+ */
 int X11DRV_GetPixelFormat(X11DRV_PDEVICE *physDev) {
   TRACE("(%p): returns %d\n", physDev, physDev->current_pf);
 
   return physDev->current_pf;
 }
 
-/* X11DRV_SetPixelFormat
-
-     Set the pixel-format id used by this DC
-*/
+/**
+ * X11DRV_SetPixelFormat
+ *
+ * Set the pixel-format id used by this DC
+ */
 BOOL X11DRV_SetPixelFormat(X11DRV_PDEVICE *physDev,
 			   int iPixelFormat,
 			   const PIXELFORMATDESCRIPTOR *ppfd) {
@@ -427,10 +430,11 @@ BOOL X11DRV_SetPixelFormat(X11DRV_PDEVICE *physDev,
   return TRUE;
 }
 
-/* X11DRV_SwapBuffers
-
-     Swap the buffers of this DC
-*/
+/**
+ * X11DRV_SwapBuffers
+ *
+ * Swap the buffers of this DC
+ */
 BOOL X11DRV_SwapBuffers(X11DRV_PDEVICE *physDev) {
   if (opengl_handle == NULL) {
     ERR("No libGL on this box - disabling OpenGL support !\n");