Improve the sample comment.
diff --git a/DEVELOPERS-HINTS b/DEVELOPERS-HINTS
index e76a8da..3666d2f 100644
--- a/DEVELOPERS-HINTS
+++ b/DEVELOPERS-HINTS
@@ -222,17 +222,18 @@
/************************************************************
* PolyBezierTo (GDI32.269)
*
- * Draw many Bezier curves
+ * Draw many Bezier curves.
*
* RETURNS
- * nonzero on success or zero on faillure
+ * Success: Non-zero.
+ * Failure: FALSE. Use GetLastError() to find the error cause.
*
* BUGS
* Unimplemented
*/
- BOOL WINAPI PolyBezierTo(HDC hdc, /* handle to device context */
- LPCVOID p, /* ptr to array of Point structs */
- DWORD count /* nr of points in array */
+ BOOL WINAPI PolyBezierTo(HDC hdc, /* [In] Device context to draw to */
+ LPCVOID p, /* [In] Array of POINT structs */
+ DWORD count /* [In] Number of points in p */
)
{
/* tell the user they've got a substandard implementation */
@@ -515,5 +516,3 @@
3. http://www.sonic.net/~undoc/bookstore.html
4. In 1993 Dr. Dobbs Journal published a column called "Undocumented Corner".
-
-