Documentation tweaks to make winapi_check happy.

Also specify the documented spec file entry.

dlls/ntdll/resource.c

@@ -360,9 +360,12 @@ static inline NTSTATUS access_resource( HMODULE hmod, const IMAGE_RESOURCE_DATA_
 
 /**********************************************************************
  *	LdrAccessResource  (NTDLL.@)
+ *
+ * NOTE
+ * On x86, Shrinker, an executable compressor, depends on the
+ * "call access_resource" instruction being there.
  */
 #ifdef __i386__
-/* Shrinker depends on the "call access_resource" instruction being there */
 __ASM_GLOBAL_FUNC( LdrAccessResource,
     "pushl %ebp\n\t"
     "movl %esp, %ebp\n\t"

dlls/usp10/usp10.c

@@ -50,12 +50,20 @@ BOOL WINAPI DllMain(HINSTANCE hInstDLL, DWORD fdwReason, LPVOID lpv)
     return TRUE;
 }
 
+/***********************************************************************
+ *      ScriptGetProperties (USP10.@)
+ *
+ */
 HRESULT WINAPI ScriptGetProperties(const SCRIPT_PROPERTIES ***ppSp, int *piNumScripts)
 {
     FIXME("%p,%p\n",ppSp,piNumScripts);
     return E_NOTIMPL;
 }
 
+/***********************************************************************
+ *      ScriptGetFontProperties (USP10.@)
+ *
+ */
 HRESULT WINAPI ScriptGetFontProperties(HDC hdc, SCRIPT_CACHE *psc, SCRIPT_FONTPROPERTIES *sfp)
 {
     FIXME("%p,%p,%p\n", hdc, psc, sfp);
@@ -71,12 +79,20 @@ HRESULT WINAPI ScriptGetFontProperties(HDC hdc, SCRIPT_CACHE *psc, SCRIPT_FONTPR
     return 0;
 }
 
+/***********************************************************************
+ *      ScriptRecordDigitSubstitution (USP10.@)
+ *
+ */
 HRESULT WINAPI ScriptRecordDigitSubstitution(LCID Locale,SCRIPT_DIGITSUBSTITUTE *psds)
 {
     FIXME("%ld,%p\n",Locale,psds);
     return E_NOTIMPL;
 }
 
+/***********************************************************************
+ *      ScriptApplyDigitSubstitution (USP10.@)
+ *
+ */
 HRESULT WINAPI ScriptApplyDigitSubstitution(const SCRIPT_DIGITSUBSTITUTE* psds, 
                                             SCRIPT_CONTROL* psc, SCRIPT_STATE* pss)
 {
@@ -84,6 +100,10 @@ HRESULT WINAPI ScriptApplyDigitSubstitution(const SCRIPT_DIGITSUBSTITUTE* psds,
     return E_NOTIMPL;
 }
 
+/***********************************************************************
+ *      ScriptItemize (USP10.@)
+ *
+ */
 HRESULT WINAPI ScriptItemize(const WCHAR *pwcInChars, int cInChars, int cMaxItems, 
                              const SCRIPT_CONTROL *psControl, const SCRIPT_STATE *psState, 
                              SCRIPT_ITEM *pItems, int *pcItems)
@@ -93,6 +113,10 @@ HRESULT WINAPI ScriptItemize(const WCHAR *pwcInChars, int cInChars, int cMaxItem
     return E_INVALIDARG;
 }
 
+/***********************************************************************
+ *      ScriptStringAnalyse (USP10.@)
+ *
+ */
 HRESULT WINAPI ScriptStringAnalyse(HDC hdc, 
 				   const void *pString, 
 				   int cString, 
@@ -120,11 +144,19 @@ HRESULT WINAPI ScriptStringAnalyse(HDC hdc,
   return E_NOTIMPL;
 }
 
+/***********************************************************************
+ *      ScriptStringFree (USP10.@)
+ *
+ */
 HRESULT WINAPI ScriptStringFree(SCRIPT_STRING_ANALYSIS *pssa) {
   FIXME("(%p): stub\n",pssa);
   return S_OK;
 }
 
+/***********************************************************************
+ *      ScriptIsComplex (USP10.@)
+ *
+ */
 HRESULT WINAPI ScriptIsComplex(const WCHAR* pwcInChars, int cInChars, DWORD dwFlags) {
   FIXME("(%s,%d,0x%lx): stub\n",  debugstr_w(pwcInChars), cInChars, dwFlags);
    return E_NOTIMPL;

dlls/wininet/internet.c

@@ -3307,7 +3307,7 @@ static VOID INTERNET_ExecuteWork(void)
 
 
 /***********************************************************************
- *          INTERNET_GetResponseBuffer
+ *          INTERNET_GetResponseBuffer  (internal)
  *
  * RETURNS
  *
@@ -3436,7 +3436,7 @@ BOOL WINAPI InternetQueryDataAvailable( HINTERNET hFile,
 
 
 /***********************************************************************
- *
+ *      InternetLockRequestFile (WININET.@)
  */
 BOOL WINAPI InternetLockRequestFile( HINTERNET hInternet, HANDLE
 *lphLockReqHandle)
@@ -3453,7 +3453,7 @@ BOOL WINAPI InternetUnlockRequestFile( HANDLE hLockHandle)
 
 
 /***********************************************************************
- *           InternetAutodial
+ *      InternetAutodial (WININET.@)
  *
  * On windows this function is supposed to dial the default internet
  * connection. We don't want to have Wine dial out to the internet so
@@ -3473,7 +3473,7 @@ BOOL WINAPI InternetAutodial(DWORD dwFlags, HWND hwndParent)
 }
 
 /***********************************************************************
- *           InternetAutodialHangup
+ *      InternetAutodialHangup (WININET.@)
  *
  * Hangs up a connection made with InternetAutodial
  *
@@ -3493,8 +3493,7 @@ BOOL WINAPI InternetAutodialHangup(DWORD dwReserved)
 }
 
 /***********************************************************************
- *
+ *      InternetCombineUrlA (WININET.@)
- *         InternetCombineUrlA
  *
  * Combine a base URL with a relative URL
  *
@@ -3520,8 +3519,7 @@ BOOL WINAPI InternetCombineUrlA(LPCSTR lpszBaseUrl, LPCSTR lpszRelativeUrl,
 }
 
 /***********************************************************************
- *
+ *      InternetCombineUrlW (WININET.@)
- *         InternetCombineUrlW
  *
  * Combine a base URL with a relative URL
  *
@@ -3681,8 +3679,7 @@ static void convert_urlcomp_atow(LPURL_COMPONENTSA lpUrlComponents, LPURL_COMPON
 }
 
 /***********************************************************************
- *
+ *      InternetCreateUrlA (WININET.@)
- *         InternetCreateUrlA
  *
  * RETURNS
  *   TRUE on success
@@ -3732,8 +3729,7 @@ BOOL WINAPI InternetCreateUrlA(LPURL_COMPONENTSA lpUrlComponents, DWORD dwFlags,
 }
 
 /***********************************************************************
- *
+ *      InternetCreateUrlW (WININET.@)
- *         InternetCreateUrlW
  *
  * RETURNS
  *   TRUE on success
@@ -3818,12 +3814,20 @@ BOOL WINAPI InternetCreateUrlW(LPURL_COMPONENTSW lpUrlComponents, DWORD dwFlags,
     return TRUE;
 }
 
+/***********************************************************************
+ *      InternetConfirmZoneCrossingA (WININET.@)
+ *
+ */
 DWORD WINAPI InternetConfirmZoneCrossingA( HWND hWnd, LPSTR szUrlPrev, LPSTR szUrlNew, BOOL bPost )
 {
     FIXME("(%p, %s, %s, %x) stub\n", hWnd, debugstr_a(szUrlPrev), debugstr_a(szUrlNew), bPost);
     return ERROR_SUCCESS;
 }
 
+/***********************************************************************
+ *      InternetConfirmZoneCrossingW (WININET.@)
+ *
+ */
 DWORD WINAPI InternetConfirmZoneCrossingW( HWND hWnd, LPWSTR szUrlPrev, LPWSTR szUrlNew, BOOL bPost )
 {
     FIXME("(%p, %s, %s, %x) stub\n", hWnd, debugstr_w(szUrlPrev), debugstr_w(szUrlNew), bPost);