Some doc fixes.

gtkd-developers · Jan 30, 2016 · b49250e · b49250e
1 parent 67fe0ec
commit b49250e
Show file tree

Hide file tree

Showing 7 changed files with 16 additions and 9 deletions.
diff --git a/src/gdk/Cursor.d b/src/gdk/Cursor.d
@@ -138,6 +138,7 @@ public class Cursor : ObjectG
 	 * - ![](default_cursor.png) "default"
 	 * - ![](help_cursor.png) "help"
 	 * - ![](pointer_cursor.png) "pointer"
+	 * - ![](pointer_cursor.png) "context-menu"
 	 * - ![](progress_cursor.png) "progress"
 	 * - ![](wait_cursor.png) "wait"
 	 * - ![](cell_cursor.png) "cell"

diff --git a/src/gdk/Pixbuf.d b/src/gdk/Pixbuf.d
@@ -76,8 +76,9 @@ public Pixbuf getFromSurface(Surface surface, int srcX, int srcY, int width, int
  * This allows you to efficiently read individual pixels on the client side.
  *
  * This function will create an RGB pixbuf with 8 bits per channel with
- * the same size specified by the @width and @height arguments. The pixbuf
- * will contain an alpha channel if the @window contains one.
+ * the size specified by the @width and @height arguments scaled by the
+ * scale factor of @window. The pixbuf will contain an alpha channel if
+ * the @window contains one.
  *
  * If the window is off the screen, then there is no image data in the
  * obscured/offscreen regions to be placed in the pixbuf. The contents of

diff --git a/src/gtk/CellLayoutIF.d b/src/gtk/CellLayoutIF.d
@@ -187,7 +187,8 @@ public interface CellLayoutIF{
 	 * if called on a #GtkCellArea or might be %NULL if no #GtkCellArea
 	 * is used by @cell_layout.
 	 *
-	 * Return: the cell area used by @cell_layout.
+	 * Return: the cell area used by @cell_layout,
+	 *     or %NULL in case no cell area is used.
 	 *
 	 * Since: 3.0
 	 */

diff --git a/src/gtk/CellLayoutT.d b/src/gtk/CellLayoutT.d
@@ -197,7 +197,8 @@ public template CellLayoutT(TStruct)
 	 * if called on a #GtkCellArea or might be %NULL if no #GtkCellArea
 	 * is used by @cell_layout.
 	 *
-	 * Return: the cell area used by @cell_layout.
+	 * Return: the cell area used by @cell_layout,
+	 *     or %NULL in case no cell area is used.
 	 *
 	 * Since: 3.0
 	 */

diff --git a/src/gtk/FlowBox.d b/src/gtk/FlowBox.d
@@ -179,7 +179,8 @@ public class FlowBox : Container, OrientableIF
 	 *     idx = the position of the child
 	 *
 	 * Return: the child widget, which will
-	 *     always be a #GtkFlowBoxChild
+	 *     always be a #GtkFlowBoxChild or %NULL in case no child widget
+	 *     with the given index exists.
 	 *
 	 * Since: 3.12
 	 */
@@ -543,8 +544,8 @@ public class FlowBox : Container, OrientableIF
 	 * gtk_flow_box_child_changed()) and when gtk_flow_box_invalidate_sort()
 	 * is called.
 	 *
-	 * + * Note that using a sort function is incompatible with using a model
-	 * + * (see gtk_list_box_bind_model()).
+	 * Note that using a sort function is incompatible with using a model
+	 * (see gtk_flow_box_bind_model()).
 	 *
 	 * Params:
 	 *     sortFunc = the sort function

diff --git a/src/gtk/ListBox.d b/src/gtk/ListBox.d
@@ -244,7 +244,8 @@ public class ListBox : Container
 	 * Params:
 	 *     y = position
 	 *
-	 * Return: the row
+	 * Return: the row or %NULL
+	 *     in case no row exists for the given y coordinate.
 	 *
 	 * Since: 3.10
 	 */

diff --git a/src/gtkc/gtktypes.d b/src/gtkc/gtktypes.d
@@ -5019,7 +5019,8 @@ struct GtkCellLayoutIface
 	 *
 	 * Params:
 	 *     cellLayout = a #GtkCellLayout
-	 * Return: the cell area used by @cell_layout.
+	 * Return: the cell area used by @cell_layout,
+	 *     or %NULL in case no cell area is used.
 	 */
 	extern(C) GtkCellArea* function(GtkCellLayout* cellLayout) getArea;
 }