Documentation: C API comments in include/

include/c/sk_path.h

Index: include/c/sk_path.h
diff --git a/include/c/sk_path.h b/include/c/sk_path.h
index d13a11219fcec01185449e25a8489f0215bdad24..6b4e83d3b2a69c4bfd2149a599265610a28ff3cc 100644
--- a/include/c/sk_path.h
+++ b/include/c/sk_path.h
@@ -20,20 +20,56 @@ typedef enum {
     CCW_SK_PATH_DIRECTION,
 } sk_path_direction_t;
 
+/** Create a new, empty path. */
 SK_API sk_path_t* sk_path_new();
+/** Release the memory used by a sk_path_t. */
 SK_API void sk_path_delete(sk_path_t*);
 
+/** Set the beginning of the next contour to the point (x,y). */
 SK_API void sk_path_move_to(sk_path_t*, float x, float y);
+/**
+    Add a line from the last point to the specified point (x,y). If no
+    sk_path_move_to() call has been made for this contour, the first
+    point is automatically set to (0,0).
+*/
 SK_API void sk_path_line_to(sk_path_t*, float x, float y);
+/**
+    Add a quadratic bezier from the last point, approaching control
+    point (x0,y0), and ending at (x1,y1). If no sk_path_move_to() call
+    has been made for this contour, the first point is automatically
+    set to (0,0).
+*/
 SK_API void sk_path_quad_to(sk_path_t*, float x0, float y0, float x1, float y1);
+/**
+    Add a conic curve from the last point, approaching control point
+    (x0,y01), and ending at (x1,y1) with weight w.  If no
+    sk_path_move_to() call has been made for this contour, the first
+    point is automatically set to (0,0).
+*/
 SK_API void sk_path_conic_to(sk_path_t*, float x0, float y0, float x1, float y1, float w);
+/**
+    Add a cubic bezier from the last point, approaching control points
+    (x0,y0) and (x1,y1), and ending at (x2,y2). If no
+    sk_path_move_to() call has been made for this contour, the first
+    point is automatically set to (0,0).
+*/
 SK_API void sk_path_cubic_to(sk_path_t*,
                              float x0, float y0,
                              float x1, float y1,
                              float x2, float y2);
+/**
+   Close the current contour. If the current point is not equal to the
+   first point of the contour, a line segment is automatically added.
+*/
 SK_API void sk_path_close(sk_path_t*);
 
+/**
+    Add a closed rectangle contour to the path.
+*/
 SK_API void sk_path_add_rect(sk_path_t*, const sk_rect_t*, sk_path_direction_t);
+/**
+    Add a closed oval contour to the path
+*/
 SK_API void sk_path_add_oval(sk_path_t*, const sk_rect_t*, sk_path_direction_t);
 
 /**