Tweak the API documentation to silence winapi_check warnings.

dlls/advapi32/crypt.c

@@ -1899,6 +1899,8 @@ BOOL WINAPI CryptVerifySignatureA (HCRYPTHASH hHash, BYTE *pbSignature, DWORD dw
 /******************************************************************************
  * SystemFunction040   (ADVAPI32.@)
  *
+ * MSDN documents this function as RtlEncryptMemory.
+ *
  * PARAMS
  *  memory [I/O] Pointer to memory to encrypt.
  *  length [I] Length of region to encrypt in bytes.
@@ -1912,7 +1914,7 @@ BOOL WINAPI CryptVerifySignatureA (HCRYPTHASH hHash, BYTE *pbSignature, DWORD dw
  *  If flags are specified when encrypting, the same flag value must be given
  *  when decrypting the memory.
  */
-NTSTATUS WINAPI SystemFunction040(PVOID memory, ULONG length, ULONG flags)  /* RtlEncryptMemory */
+NTSTATUS WINAPI SystemFunction040(PVOID memory, ULONG length, ULONG flags)
 {
 	FIXME("(%p, %lx, %lx): stub [RtlEncryptMemory]\n", memory, length, flags);
 	return STATUS_SUCCESS;
@@ -1921,6 +1923,8 @@ NTSTATUS WINAPI SystemFunction040(PVOID memory, ULONG length, ULONG flags)  /* R
 /******************************************************************************
  * SystemFunction041  (ADVAPI32.@)
  *
+ * MSDN documents this function as RtlDecryptMemory.
+ *
  * PARAMS
  *  memory [I/O] Pointer to memory to decrypt.
  *  length [I] Length of region to decrypt in bytes.
@@ -1934,7 +1938,7 @@ NTSTATUS WINAPI SystemFunction040(PVOID memory, ULONG length, ULONG flags)  /* R
  *  If flags are specified when encrypting, the same flag value must be given
  *  when decrypting the memory.
  */
-NTSTATUS WINAPI SystemFunction041(PVOID memory, ULONG length, ULONG flags)  /* RtlDecryptMemory */
+NTSTATUS WINAPI SystemFunction041(PVOID memory, ULONG length, ULONG flags)
 {
 	FIXME("(%p, %lx, %lx): stub [RtlDecryptMemory]\n", memory, length, flags);
 	return STATUS_SUCCESS;

dlls/advapi32/security.c

@@ -1673,6 +1673,9 @@ LsaQueryInformationPolicy(
 	return TRUE;
 }
 
+/******************************************************************************
+ * LsaSetInformationPolicy [ADVAPI32.@]
+ */
 NTSTATUS WINAPI
 LsaSetInformationPolicy(
     LSA_HANDLE PolicyHandle,
@@ -1937,6 +1940,9 @@ LookupAccountNameA(
     return ret;
 }
 
+/******************************************************************************
+ * LookupAccountNameW [ADVAPI32.@]
+ */
 BOOL WINAPI LookupAccountNameW( LPCWSTR lpSystemName, LPCWSTR lpAccountName, PSID Sid,
                                 LPDWORD cbSid, LPWSTR ReferencedDomainName,
                                 LPDWORD cchReferencedDomainName, PSID_NAME_USE peUse )

dlls/gdi/palette.c

@@ -956,6 +956,9 @@ BOOL WINAPI GetICMProfileA(HDC hDC, LPDWORD lpcbName, LPSTR lpszFilename)
     return TRUE;
 }
 
+/**********************************************************************
+ * GetICMProfileW [GDI32.@]
+ **/
 BOOL WINAPI GetICMProfileW(HDC hDC, LPDWORD lpcbName, LPWSTR lpszFilename)
 {
     DWORD callerLen;

dlls/mshtml/main.c

@@ -249,7 +249,11 @@ HRESULT WINAPI MSHTML_DllCanUnloadNow(void)
     return hres;
 }
 
-/* appears to have the same prototype as WinMain */
+/***********************************************************************
+ *          RunHTMLApplication (MSHTML.@)
+ *
+ * Appears to have the same prototype as WinMain.
+ */
 INT WINAPI RunHTMLApplication( HINSTANCE hinst, HINSTANCE hPrevInst,
                                LPCSTR szCmdLine, INT nCmdShow )
 {

dlls/msi/action.c

@@ -6402,6 +6402,10 @@ static UINT ACTION_PublishComponents(MSIPACKAGE *package)
 }
 
 /* Msi functions that seem appropriate here */
+
+/***********************************************************************
+ * MsiDoActionA       (MSI.@)
+ */
 UINT WINAPI MsiDoActionA( MSIHANDLE hInstall, LPCSTR szAction )
 {
     LPWSTR szwAction;
@@ -6425,6 +6429,9 @@ UINT WINAPI MsiDoActionA( MSIHANDLE hInstall, LPCSTR szAction )
     return rc;
 }
 
+/***********************************************************************
+ * MsiDoActionW       (MSI.@)
+ */
 UINT WINAPI MsiDoActionW( MSIHANDLE hInstall, LPCWSTR szAction )
 {
     MSIPACKAGE *package;
@@ -6570,6 +6577,9 @@ UINT WINAPI MsiGetSourcePathW( MSIHANDLE hInstall, LPCWSTR szFolder, LPWSTR
 }
 
 
+/***********************************************************************
+ * MsiSetTargetPathA  (MSI.@)
+ */
 UINT WINAPI MsiSetTargetPathA(MSIHANDLE hInstall, LPCSTR szFolder, 
                              LPCSTR szFolderPath)
 {
@@ -6659,6 +6669,9 @@ UINT MSI_SetTargetPathW(MSIPACKAGE *package, LPCWSTR szFolder,
     return ERROR_SUCCESS;
 }
 
+/***********************************************************************
+ * MsiSetTargetPathW  (MSI.@)
+ */
 UINT WINAPI MsiSetTargetPathW(MSIHANDLE hInstall, LPCWSTR szFolder, 
                              LPCWSTR szFolderPath)
 {
@@ -6713,7 +6726,9 @@ BOOL WINAPI MsiGetMode(MSIHANDLE hInstall, MSIRUNMODE iRunMode)
     return TRUE;
 }
 
-/*
+/***********************************************************************
+ * MsiSetFeatureStateA (MSI.@)
+ *
  * According to the docs, when this is called it immediately recalculates
  * all the component states as well
  */
@@ -6735,6 +6750,9 @@ UINT WINAPI MsiSetFeatureStateA(MSIHANDLE hInstall, LPCSTR szFeature,
     return rc;
 }
 
+/***********************************************************************
+ * MsiSetFeatureStateW (MSI.@)
+ */
 UINT WINAPI MsiSetFeatureStateW(MSIHANDLE hInstall, LPCWSTR szFeature,
                                 INSTALLSTATE iState)
 {
@@ -6815,6 +6833,9 @@ piAction);
     return ret;
 }
 
+/***********************************************************************
+ * MsiGetComponentStateA (MSI.@)
+ */
 UINT WINAPI MsiGetComponentStateA(MSIHANDLE hInstall, LPSTR szComponent,
                   INSTALLSTATE *piInstalled, INSTALLSTATE *piAction)
 {
@@ -6854,6 +6875,9 @@ piAction);
     return ERROR_SUCCESS;
 }
 
+/***********************************************************************
+ * MsiGetComponentStateW (MSI.@)
+ */
 UINT WINAPI MsiGetComponentStateW(MSIHANDLE hInstall, LPWSTR szComponent,
                   INSTALLSTATE *piInstalled, INSTALLSTATE *piAction)
 {

dlls/msi/msi.c

@@ -968,6 +968,9 @@ end:
     return rrc;
 }
 
+/******************************************************************
+ * MsiQueryFeatureStateA      [MSI.@]
+ */
 INSTALLSTATE WINAPI MsiQueryFeatureStateA(LPCSTR szProduct, LPCSTR szFeature)
 {
     INSTALLSTATE rc;
@@ -999,6 +1002,9 @@ INSTALLSTATE WINAPI MsiQueryFeatureStateA(LPCSTR szProduct, LPCSTR szFeature)
     return rc;
 }
 
+/******************************************************************
+ * MsiQueryFeatureStateW      [MSI.@]
+ */
 INSTALLSTATE WINAPI MsiQueryFeatureStateW(LPCWSTR szProduct, LPCWSTR szFeature)
 {
     FIXME("%s %s\n", debugstr_w(szProduct), debugstr_w(szFeature));
@@ -1008,6 +1014,9 @@ INSTALLSTATE WINAPI MsiQueryFeatureStateW(LPCWSTR szProduct, LPCWSTR szFeature)
     return INSTALLSTATE_LOCAL;
 }
 
+/******************************************************************
+ * MsiGetFileVersionA         [MSI.@]
+ */
 UINT WINAPI MsiGetFileVersionA(LPCSTR szFilePath, LPSTR lpVersionBuf,
                 DWORD* pcchVersionBuf, LPSTR lpLangBuf, DWORD* pcchLangBuf)
 {
@@ -1053,6 +1062,9 @@ end:
     return ret;
 }
 
+/******************************************************************
+ * MsiGetFileVersionW         [MSI.@]
+ */
 UINT WINAPI MsiGetFileVersionW(LPCWSTR szFilePath, LPWSTR lpVersionBuf,
                 DWORD* pcchVersionBuf, LPWSTR lpLangBuf, DWORD* pcchLangBuf)
 {
@@ -1193,7 +1205,7 @@ static IClassFactoryVtbl MsiCF_Vtbl =
 static IClassFactoryImpl Msi_CF = { &MsiCF_Vtbl };
 
 /******************************************************************
- *    	DllGetClassObject [MSI.@]
+ * DllGetClassObject          [MSI.@]
  */
 HRESULT WINAPI MSI_DllGetClassObject(REFCLSID rclsid, REFIID riid, LPVOID *ppv)
 {
@@ -1212,7 +1224,7 @@ HRESULT WINAPI MSI_DllGetClassObject(REFCLSID rclsid, REFIID riid, LPVOID *ppv)
 }
 
 /******************************************************************
- *    	DllGetVersion [MSI.@]
+ * DllGetVersion              [MSI.@]
  */
 HRESULT WINAPI MSI_DllGetVersion(DLLVERSIONINFO *pdvi)
 {
@@ -1230,7 +1242,7 @@ HRESULT WINAPI MSI_DllGetVersion(DLLVERSIONINFO *pdvi)
 }
 
 /******************************************************************
- *    	DllCanUnloadNow [MSI.@]
+ * DllCanUnloadNow            [MSI.@]
  */
 BOOL WINAPI MSI_DllCanUnloadNow(void)
 {
@@ -1270,6 +1282,9 @@ INSTALLSTATE WINAPI MsiUseFeatureExW(LPCWSTR szProduct, LPCWSTR szFeature,
     return INSTALLSTATE_LOCAL;
 }
 
+/***********************************************************************
+ * MsiUseFeatureExA           [MSI.@]
+ */
 INSTALLSTATE WINAPI MsiUseFeatureExA(LPCSTR szProduct, LPCSTR szFeature,
                              DWORD dwInstallMode, DWORD dwReserved)
 {

dlls/ole32/ole2.c

@@ -2292,13 +2292,13 @@ HRESULT WINAPI OleCreate(
 /******************************************************************************
  *              OleSetAutoConvert        [OLE32.@]
  */
-/* FIXME: convert to Unicode */
 HRESULT WINAPI OleSetAutoConvert(REFCLSID clsidOld, REFCLSID clsidNew)
 {
     HKEY hkey = 0;
     char buf[200], szClsidNew[200];
     HRESULT res = S_OK;
 
+    /* FIXME: convert to Unicode */
     TRACE("(%s,%s)\n", debugstr_guid(clsidOld), debugstr_guid(clsidNew));
     sprintf(buf,"CLSID\\");WINE_StringFromCLSID(clsidOld,&buf[6]);
     WINE_StringFromCLSID(clsidNew, szClsidNew);

dlls/rpcrt4/rpcrt4_main.c

@@ -749,7 +749,10 @@ BOOL RPCRT4_RPCSSOnDemandCall(PRPCSS_NP_MESSAGE msg, char *vardata_payload, PRPC
     return TRUE;
 }
 
-/* DceErrorInqText
+#define MAX_RPC_ERROR_TEXT 256
+
+/******************************************************************************
+ * DceErrorInqTextW   (rpcrt4.@)
  *
  * Notes
  * 1. On passing a NULL pointer the code does bomb out.
@@ -760,9 +763,6 @@ BOOL RPCRT4_RPCSSOnDemandCall(PRPCSS_NP_MESSAGE msg, char *vardata_payload, PRPC
  * 4. The MSDN documentation currently declares that the second argument is
  *    unsigned char *, even for the W version.  I don't believe it.
  */
-
-#define MAX_RPC_ERROR_TEXT 256
-
 RPC_STATUS RPC_ENTRY DceErrorInqTextW (RPC_STATUS e, unsigned short *buffer)
 {
     DWORD count;
@@ -783,6 +783,9 @@ RPC_STATUS RPC_ENTRY DceErrorInqTextW (RPC_STATUS e, unsigned short *buffer)
     return RPC_S_OK;
 }
 
+/******************************************************************************
+ * DceErrorInqTextA   (rpcrt4.@)
+ */
 RPC_STATUS RPC_ENTRY DceErrorInqTextA (RPC_STATUS e, unsigned char *buffer)
 {
     RPC_STATUS status;

dlls/user/misc.c

@@ -58,7 +58,9 @@ static BOOL CALLBACK EnumDesktopProcWtoA(LPWSTR lpszDesktop, LPARAM lParam)
 }
 
 /**********************************************************************
- * SetLastErrorEx [USER32.@]  Sets the last-error code.
+ * SetLastErrorEx [USER32.@]
+ *
+ * Sets the last-error code.
  *
  * RETURNS
  *    None.
@@ -82,12 +84,18 @@ void WINAPI SetLastErrorEx(
     SetLastError( error );
 }
 
+/******************************************************************************
+ * GetAltTabInfoA [USER32.@]
+ */
 BOOL WINAPI GetAltTabInfoA(HWND hwnd, int iItem, PALTTABINFO pati, LPSTR pszItemText, UINT cchItemText)
 {
     FIXME("(%p, 0x%08x, %p, %p, 0x%08x)\n", hwnd, iItem, pati, pszItemText, cchItemText);
     return FALSE;
 }
 
+/******************************************************************************
+ * GetAltTabInfoW [USER32.@]
+ */
 BOOL WINAPI GetAltTabInfoW(HWND hwnd, int iItem, PALTTABINFO pati, LPWSTR pszItemText, UINT cchItemText)
 {
     FIXME("(%p, 0x%08x, %p, %p, 0x%08x)\n", hwnd, iItem, pati, pszItemText, cchItemText);
@@ -95,7 +103,9 @@ BOOL WINAPI GetAltTabInfoW(HWND hwnd, int iItem, PALTTABINFO pati, LPWSTR pszIte
 }
 
 /******************************************************************************
- * GetProcessWindowStation [USER32.@]  Returns handle of window station
+ * GetProcessWindowStation [USER32.@]
+ *
+ * Returns handle of window station
  *
  * NOTES
  *    Docs say the return value is HWINSTA
@@ -112,7 +122,9 @@ HWINSTA WINAPI GetProcessWindowStation(void)
 
 
 /******************************************************************************
- * GetThreadDesktop [USER32.@]  Returns handle to desktop
+ * GetThreadDesktop [USER32.@]
+ *
+ * Returns handle to desktop
  *
  * PARAMS
  *    dwThreadId [I] Thread identifier

dlls/wininet/ftp.c

@@ -1233,6 +1233,9 @@ lend:
     return bSuccess;
 }
 
+/***********************************************************************
+ *           FtpGetFileSize  (WININET.@)
+ */
 DWORD WINAPI FtpGetFileSize( HINTERNET hFile, LPDWORD lpdwFileSizeHigh )
 {
     FIXME("(%p, %p)\n", hFile, lpdwFileSizeHigh);
@@ -1611,6 +1614,9 @@ lend:
     return bSuccess;
 }
 
+/***********************************************************************
+ *           FtpCommandA  (WININET.@)
+ */
 BOOL WINAPI FtpCommandA( HINTERNET hConnect, BOOL fExpectResponse, DWORD dwFlags,
                          LPCSTR lpszCommand, DWORD_PTR dwContext, HINTERNET* phFtpCommand )
 {
@@ -1620,6 +1626,9 @@ BOOL WINAPI FtpCommandA( HINTERNET hConnect, BOOL fExpectResponse, DWORD dwFlags
     return TRUE;
 }
 
+/***********************************************************************
+ *           FtpCommandW  (WININET.@)
+ */
 BOOL WINAPI FtpCommandW( HINTERNET hConnect, BOOL fExpectResponse, DWORD dwFlags,
                          LPCWSTR lpszCommand, DWORD_PTR dwContext, HINTERNET* phFtpCommand )
 {

dlls/x11drv/xrender.c

@@ -1613,6 +1613,9 @@ done:
     return retv;
 }
 
+/******************************************************************************
+ * AlphaBlend         (x11drv.@)
+ */
 BOOL X11DRV_AlphaBlend(X11DRV_PDEVICE *devDst, INT xDst, INT yDst, INT widthDst, INT heightDst,
                        X11DRV_PDEVICE *devSrc, INT xSrc, INT ySrc, INT widthSrc, INT heightSrc,
                        BLENDFUNCTION blendfn)
@@ -1785,6 +1788,9 @@ void X11DRV_XRender_UpdateDrawable(X11DRV_PDEVICE *physDev)
   return;
 }
 
+/******************************************************************************
+ * AlphaBlend         (x11drv.@)
+ */
 BOOL X11DRV_AlphaBlend(X11DRV_PDEVICE *devDst, INT xDst, INT yDst, INT widthDst, INT heightDst,
                        X11DRV_PDEVICE *devSrc, INT xSrc, INT ySrc, INT widthSrc, INT heightSrc,
                        BLENDFUNCTION blendfn)