Documentation fixes.

This commit is contained in:
Jon Griffiths 2004-02-09 20:47:42 +00:00 committed by Alexandre Julliard
parent cf09f5a9f1
commit 783a39544b
8 changed files with 105 additions and 43 deletions

View File

@ -83,7 +83,9 @@ static INT BITMAP_GetWidthBytes( INT bmWidth, INT bpp )
/****************************************************************************** /******************************************************************************
* CreateBitmap [GDI32.@] Creates a bitmap with the specified info * CreateBitmap [GDI32.@]
*
* Creates a bitmap with the specified info.
* *
* PARAMS * PARAMS
* width [I] bitmap width * width [I] bitmap width
@ -152,7 +154,9 @@ HBITMAP WINAPI CreateBitmap( INT width, INT height, UINT planes,
/****************************************************************************** /******************************************************************************
* CreateCompatibleBitmap [GDI32.@] Creates a bitmap compatible with the DC * CreateCompatibleBitmap [GDI32.@]
*
* Creates a bitmap compatible with the DC.
* *
* PARAMS * PARAMS
* hdc [I] Handle to device context * hdc [I] Handle to device context
@ -199,7 +203,9 @@ HBITMAP WINAPI CreateCompatibleBitmap( HDC hdc, INT width, INT height)
/****************************************************************************** /******************************************************************************
* CreateBitmapIndirect [GDI32.@] Creates a bitmap with the specifies info * CreateBitmapIndirect [GDI32.@]
*
* Creates a bitmap with the specifies info.
* *
* RETURNS * RETURNS
* Success: Handle to bitmap * Success: Handle to bitmap
@ -214,7 +220,9 @@ HBITMAP WINAPI CreateBitmapIndirect(
/*********************************************************************** /***********************************************************************
* GetBitmapBits [GDI32.@] Copies bitmap bits of bitmap to buffer * GetBitmapBits [GDI32.@]
*
* Copies bitmap bits of bitmap to buffer.
* *
* RETURNS * RETURNS
* Success: Number of bytes copied * Success: Number of bytes copied
@ -286,7 +294,9 @@ LONG WINAPI GetBitmapBits(
/****************************************************************************** /******************************************************************************
* SetBitmapBits [GDI32.@] Sets bits of color data for a bitmap * SetBitmapBits [GDI32.@]
*
* Sets bits of color data for a bitmap.
* *
* RETURNS * RETURNS
* Success: Number of bytes used in setting the bitmap bits * Success: Number of bytes used in setting the bitmap bits
@ -580,7 +590,9 @@ static INT BITMAP_GetObject( HGDIOBJ handle, void *obj, INT count, LPVOID buffer
/****************************************************************************** /******************************************************************************
* CreateDiscardableBitmap [GDI32.@] Creates a discardable bitmap * CreateDiscardableBitmap [GDI32.@]
*
* Creates a discardable bitmap.
* *
* RETURNS * RETURNS
* Success: Handle to bitmap * Success: Handle to bitmap
@ -596,7 +608,9 @@ HBITMAP WINAPI CreateDiscardableBitmap(
/****************************************************************************** /******************************************************************************
* GetBitmapDimensionEx [GDI32.@] Retrieves dimensions of a bitmap * GetBitmapDimensionEx [GDI32.@]
*
* Retrieves dimensions of a bitmap.
* *
* RETURNS * RETURNS
* Success: TRUE * Success: TRUE
@ -615,7 +629,9 @@ BOOL WINAPI GetBitmapDimensionEx(
/****************************************************************************** /******************************************************************************
* SetBitmapDimensionEx [GDI32.@] Assignes dimensions to a bitmap * SetBitmapDimensionEx [GDI32.@]
*
* Assigns dimensions to a bitmap.
* *
* RETURNS * RETURNS
* Success: TRUE * Success: TRUE

View File

@ -1092,7 +1092,9 @@ BOOL WINAPI SetWorldTransform( HDC hdc, const XFORM *xform )
* Multiplies xform into the world transformation matrix from * Multiplies xform into the world transformation matrix from
* the right. * the right.
* *
* RETURNS STD * RETURNS
* Success: TRUE.
* Failure: FALSE. Use GetLastError() to determine the cause.
*/ */
BOOL WINAPI ModifyWorldTransform( HDC hdc, const XFORM *xform, BOOL WINAPI ModifyWorldTransform( HDC hdc, const XFORM *xform,
DWORD iMode ) DWORD iMode )
@ -1155,7 +1157,9 @@ BOOL WINAPI ModifyWorldTransform( HDC hdc, const XFORM *xform,
* REMARKS * REMARKS
* The same matrix can be passed in for more than one of the parameters. * The same matrix can be passed in for more than one of the parameters.
* *
* RETURNS STD * RETURNS
* Success: TRUE.
* Failure: FALSE. Use GetLastError() to determine the cause.
*/ */
BOOL WINAPI CombineTransform( LPXFORM xformResult, const XFORM *xform1, BOOL WINAPI CombineTransform( LPXFORM xformResult, const XFORM *xform1,
const XFORM *xform2 ) const XFORM *xform2 )

View File

@ -224,7 +224,9 @@ INT WINAPI StretchDIBits(HDC hdc, INT xDst, INT yDst, INT widthDst,
/****************************************************************************** /******************************************************************************
* SetDIBits [GDI32.@] Sets pixels in a bitmap using colors from DIB * SetDIBits [GDI32.@]
*
* Sets pixels in a bitmap using colors from DIB.
* *
* PARAMS * PARAMS
* hdc [I] Handle to device context * hdc [I] Handle to device context
@ -385,7 +387,9 @@ static RGBQUAD DefLogPalette[20] = { /* Copy of Default Logical Palette */
/****************************************************************************** /******************************************************************************
* GetDIBits [GDI32.@] Retrieves bits of bitmap and copies to buffer * GetDIBits [GDI32.@]
*
* Retrieves bits of bitmap and copies to buffer.
* *
* RETURNS * RETURNS
* Success: Number of scan lines copied from bitmap * Success: Number of scan lines copied from bitmap

View File

@ -2213,7 +2213,9 @@ BOOL WINAPI DeleteEnhMetaFile(HENHMETAFILE hmf)
} }
/***************************************************************************** /*****************************************************************************
* CopyEnhMetaFileA (GDI32.@) Duplicate an enhanced metafile * CopyEnhMetaFileA (GDI32.@)
*
* Duplicate an enhanced metafile.
* *
* *
*/ */
@ -2250,7 +2252,9 @@ HENHMETAFILE WINAPI CopyEnhMetaFileA(
} }
/***************************************************************************** /*****************************************************************************
* CopyEnhMetaFileW (GDI32.@) Duplicate an enhanced metafile * CopyEnhMetaFileW (GDI32.@)
*
* See CopyEnhMetaFileA.
* *
* *
*/ */

View File

@ -989,7 +989,9 @@ BOOL WINAPI GetTextExtentPoint32A( HDC hdc, LPCSTR str, INT count,
/*********************************************************************** /***********************************************************************
* GetTextExtentPoint32W [GDI32.@] Computes width/height for a string * GetTextExtentPoint32W [GDI32.@]
*
* Computes width/height for a string.
* *
* Computes width and height of the specified string. * Computes width and height of the specified string.
* *
@ -1645,7 +1647,9 @@ BOOL WINAPI GetCharABCWidthsA(HDC hdc, UINT firstChar, UINT lastChar,
/****************************************************************************** /******************************************************************************
* GetCharABCWidthsW [GDI32.@] Retrieves widths of characters in range * GetCharABCWidthsW [GDI32.@]
*
* Retrieves widths of characters in range.
* *
* PARAMS * PARAMS
* hdc [I] Handle of device context * hdc [I] Handle of device context
@ -1691,7 +1695,7 @@ DWORD WINAPI GetGlyphOutline16( HDC16 hdc, UINT16 uChar, UINT16 fuFormat,
{ {
FIXME("(%04x, '%c', %04x, %p, %ld, %p, %p): stub\n", FIXME("(%04x, '%c', %04x, %p, %ld, %p, %p): stub\n",
hdc, uChar, fuFormat, lpgm, cbBuffer, lpBuffer, lpmat2 ); hdc, uChar, fuFormat, lpgm, cbBuffer, lpBuffer, lpmat2 );
return (DWORD)-1; /* failure */ return ~0UL; /* failure */
} }
@ -1842,8 +1846,8 @@ BOOL WINAPI TranslateCharsetInfo(
if flags == TCI_SRCCODEPAGE: a code page value if flags == TCI_SRCCODEPAGE: a code page value
*/ */
LPCHARSETINFO lpCs, /* [out] structure to receive charset information */ LPCHARSETINFO lpCs, /* [out] structure to receive charset information */
DWORD flags /* [in] determines interpretation of lpSrc */ DWORD flags /* [in] determines interpretation of lpSrc */)
) { {
int index = 0; int index = 0;
switch (flags) { switch (flags) {
case TCI_SRCFONTSIG: case TCI_SRCFONTSIG:
@ -1912,7 +1916,9 @@ DWORD WINAPI GetFontLanguageInfo(HDC hdc)
/************************************************************************* /*************************************************************************
* GetFontData [GDI32.@] Retrieve data for TrueType font * GetFontData [GDI32.@]
*
* Retrieve data for TrueType font.
* *
* RETURNS * RETURNS
* *

View File

@ -1389,7 +1389,7 @@ DWORD WINAPI GdiSeeGdiDo16( WORD wReqType, WORD wParam1, WORD wParam2,
return GDI_HeapSel; return GDI_HeapSel;
default: default:
WARN("(wReqType=%04x): Unknown\n", wReqType); WARN("(wReqType=%04x): Unknown\n", wReqType);
return (DWORD)-1; return ~0UL;
} }
} }

View File

@ -437,8 +437,8 @@ HMETAFILE16 WINAPI CopyMetaFile16( HMETAFILE16 hSrcMetaFile, LPCSTR lpFilename)
*/ */
HMETAFILE WINAPI CopyMetaFileW( HMETAFILE WINAPI CopyMetaFileW(
HMETAFILE hSrcMetaFile, /* [in] handle of metafile to copy */ HMETAFILE hSrcMetaFile, /* [in] handle of metafile to copy */
LPCWSTR lpFilename /* [in] filename if copying to a file */ LPCWSTR lpFilename /* [in] filename if copying to a file */)
) { {
METAHEADER *mh = MF_GetMetaHeader( hSrcMetaFile ); METAHEADER *mh = MF_GetMetaHeader( hSrcMetaFile );
METAHEADER *mh2 = NULL; METAHEADER *mh2 = NULL;
HANDLE hFile; HANDLE hFile;
@ -731,8 +731,8 @@ BOOL WINAPI EnumMetaFile(
HDC hdc, HDC hdc,
HMETAFILE hmf, HMETAFILE hmf,
MFENUMPROC lpEnumFunc, MFENUMPROC lpEnumFunc,
LPARAM lpData LPARAM lpData)
) { {
METAHEADER *mhTemp = NULL, *mh = MF_GetMetaHeader(hmf); METAHEADER *mhTemp = NULL, *mh = MF_GetMetaHeader(hmf);
METARECORD *mr; METARECORD *mr;
HANDLETABLE *ht; HANDLETABLE *ht;
@ -1364,7 +1364,9 @@ HMETAFILE WINAPI SetMetaFileBitsEx(
} }
/***************************************************************** /*****************************************************************
* GetMetaFileBitsEx (GDI32.@) Get raw metafile data * GetMetaFileBitsEx (GDI32.@)
*
* Get raw metafile data.
* *
* Copies the data from metafile _hmf_ into the buffer _buf_. * Copies the data from metafile _hmf_ into the buffer _buf_.
* If _buf_ is zero, returns size of buffer required. Otherwise, * If _buf_ is zero, returns size of buffer required. Otherwise,
@ -1373,8 +1375,8 @@ HMETAFILE WINAPI SetMetaFileBitsEx(
UINT WINAPI GetMetaFileBitsEx( UINT WINAPI GetMetaFileBitsEx(
HMETAFILE hmf, /* [in] metafile */ HMETAFILE hmf, /* [in] metafile */
UINT nSize, /* [in] size of buf */ UINT nSize, /* [in] size of buf */
LPVOID buf /* [out] buffer to receive raw metafile data */ LPVOID buf /* [out] buffer to receive raw metafile data */)
) { {
METAHEADER *mh = MF_GetMetaHeader(hmf); METAHEADER *mh = MF_GetMetaHeader(hmf);
UINT mfSize; UINT mfSize;

View File

@ -143,7 +143,9 @@ static void PALETTE_ValidateFlags(PALETTEENTRY* lpPalE, int size)
/*********************************************************************** /***********************************************************************
* CreatePalette [GDI32.@] Creates a logical color palette * CreatePalette [GDI32.@]
*
* Creates a logical color palette.
* *
* RETURNS * RETURNS
* Success: Handle to logical palette * Success: Handle to logical palette
@ -176,16 +178,18 @@ HPALETTE WINAPI CreatePalette(
/*********************************************************************** /***********************************************************************
* CreateHalftonePalette [GDI32.@] Creates a halftone palette * CreateHalftonePalette [GDI32.@]
*
* Creates a halftone palette.
* *
* RETURNS * RETURNS
* Success: Handle to logical halftone palette * Success: Handle to logical halftone palette
* Failure: 0 * Failure: 0
* *
* FIXME: This simply creates the halftone palette dirived from runing * FIXME: This simply creates the halftone palette derived from running
* tests on an windows NT machine. this is assuming a color depth * tests on an windows NT machine. this is assuming a color depth
* of greater that 256 color. On a 256 color device the halftone * of greater that 256 color. On a 256 color device the halftone
* palette will be differnt and this funtion will be incorrect * palette will be different and this function will be incorrect
*/ */
HPALETTE WINAPI CreateHalftonePalette( HPALETTE WINAPI CreateHalftonePalette(
HDC hdc) /* [in] Handle to device context */ HDC hdc) /* [in] Handle to device context */
@ -271,7 +275,9 @@ HPALETTE WINAPI CreateHalftonePalette(
/*********************************************************************** /***********************************************************************
* GetPaletteEntries [GDI32.@] Retrieves palette entries * GetPaletteEntries [GDI32.@]
*
* Retrieves palette entries.
* *
* RETURNS * RETURNS
* Success: Number of entries from logical palette * Success: Number of entries from logical palette
@ -321,7 +327,9 @@ UINT WINAPI GetPaletteEntries(
/*********************************************************************** /***********************************************************************
* SetPaletteEntries [GDI32.@] Sets color values for range in palette * SetPaletteEntries [GDI32.@]
*
* Sets color values for range in palette.
* *
* RETURNS * RETURNS
* Success: Number of entries that were set * Success: Number of entries that were set
@ -360,7 +368,9 @@ UINT WINAPI SetPaletteEntries(
/*********************************************************************** /***********************************************************************
* ResizePalette [GDI32.@] Resizes logical palette * ResizePalette [GDI32.@]
*
* Resizes logical palette.
* *
* RETURNS * RETURNS
* Success: TRUE * Success: TRUE
@ -416,7 +426,9 @@ BOOL WINAPI ResizePalette(
/*********************************************************************** /***********************************************************************
* AnimatePalette [GDI32.@] Replaces entries in logical palette * AnimatePalette [GDI32.@]
*
* Replaces entries in logical palette.
* *
* RETURNS * RETURNS
* Success: TRUE * Success: TRUE
@ -475,7 +487,9 @@ UINT WINAPI SetSystemPaletteUse(
/*********************************************************************** /***********************************************************************
* GetSystemPaletteUse [GDI32.@] Gets state of system palette * GetSystemPaletteUse [GDI32.@]
*
* Gets state of system palette.
* *
* RETURNS * RETURNS
* Current state of system palette * Current state of system palette
@ -488,7 +502,9 @@ UINT WINAPI GetSystemPaletteUse(
/*********************************************************************** /***********************************************************************
* GetSystemPaletteEntries [GDI32.@] Gets range of palette entries * GetSystemPaletteEntries [GDI32.@]
*
* Gets range of palette entries.
* *
* RETURNS * RETURNS
* Success: Number of entries retrieved from palette * Success: Number of entries retrieved from palette
@ -516,7 +532,9 @@ UINT WINAPI GetSystemPaletteEntries(
/*********************************************************************** /***********************************************************************
* GetNearestPaletteIndex [GDI32.@] Gets palette index for color * GetNearestPaletteIndex [GDI32.@]
*
* Gets palette index for color.
* *
* NOTES * NOTES
* Should index be initialized to CLR_INVALID instead of 0? * Should index be initialized to CLR_INVALID instead of 0?
@ -558,7 +576,9 @@ UINT WINAPI GetNearestPaletteIndex(
/*********************************************************************** /***********************************************************************
* GetNearestColor [GDI32.@] Gets a system color to match * GetNearestColor [GDI32.@]
*
* Gets a system color to match.
* *
* RETURNS * RETURNS
* Success: Color from system palette that corresponds to given color * Success: Color from system palette that corresponds to given color
@ -770,7 +790,9 @@ BOOL16 WINAPI IsDCCurrentPalette16(HDC16 hDC)
/*********************************************************************** /***********************************************************************
* SelectPalette [GDI32.@] Selects logical palette into DC * SelectPalette [GDI32.@]
*
* Selects logical palette into DC.
* *
* RETURNS * RETURNS
* Success: Previous logical palette * Success: Previous logical palette
@ -786,7 +808,9 @@ HPALETTE WINAPI SelectPalette(
/*********************************************************************** /***********************************************************************
* RealizePalette [GDI32.@] Maps palette entries to system palette * RealizePalette [GDI32.@]
*
* Maps palette entries to system palette.
* *
* RETURNS * RETURNS
* Success: Number of entries in logical palette * Success: Number of entries in logical palette
@ -803,7 +827,9 @@ typedef HWND (WINAPI *WindowFromDC_funcptr)( HDC );
typedef BOOL (WINAPI *RedrawWindow_funcptr)( HWND, const RECT *, HRGN, UINT ); typedef BOOL (WINAPI *RedrawWindow_funcptr)( HWND, const RECT *, HRGN, UINT );
/********************************************************************** /**********************************************************************
* UpdateColors [GDI32.@] Remaps current colors to logical palette * UpdateColors [GDI32.@]
*
* Remaps current colors to logical palette.
* *
* RETURNS * RETURNS
* Success: TRUE * Success: TRUE