summaryrefslogtreecommitdiff
path: root/pango
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2021-02-19 08:21:46 -0500
committerMatthias Clasen <mclasen@redhat.com>2021-03-11 13:17:36 -0500
commitb2b50bb0e0b23d9ccb150b97100e93bd32019462 (patch)
treed6482a2e38cbdfbc6826e6fdde9f1bfe5aec5dd5 /pango
parentb26f56fd99d45b8973390fb3c48c1f903218472b (diff)
downloadpango-b2b50bb0e0b23d9ccb150b97100e93bd32019462.tar.gz
docs: Tweak tabs docs
Add summaries, convert markup, etc.
Diffstat (limited to 'pango')
-rw-r--r--pango/pango-tabs.c43
-rw-r--r--pango/pango-tabs.h2
2 files changed, 22 insertions, 23 deletions
diff --git a/pango/pango-tabs.c b/pango/pango-tabs.c
index 44ddc215..2c2717ee 100644
--- a/pango/pango-tabs.c
+++ b/pango/pango-tabs.c
@@ -19,14 +19,6 @@
* Boston, MA 02111-1307, USA.
*/
-/**
- * SECTION:tab-stops
- * @short_description:Structures for storing tab stops
- * @title:Tab Stops
- *
- * Functions in this section are used to deal with `PangoTabArray` objects
- * that can be used to set tab stop positions in a `PangoLayout`.
- */
#include "config.h"
#include "pango-tabs.h"
#include "pango-impl-utils.h"
@@ -47,8 +39,10 @@ struct _PangoTab
/**
* PangoTabArray:
*
- * A `PangoTabArray` struct contains an array
- * of tab stops. Each tab stop has an alignment and a position.
+ * A `PangoTabArray` contains an array of tab stops.
+ *
+ * `PangoTabArray` can be used to set tab stops in a `PangoLayout`.
+ * Each tab stop has an alignment and a position.
*/
struct _PangoTabArray
{
@@ -74,9 +68,10 @@ init_tabs (PangoTabArray *array, gint start, gint end)
* @initial_size: Initial number of tab stops to allocate, can be 0
* @positions_in_pixels: whether positions are in pixel units
*
- * Creates an array of @initial_size tab stops. Tab stops are specified in
- * pixel units if @positions_in_pixels is %TRUE, otherwise in Pango
- * units. All stops are initially at position 0.
+ * Creates an array of @initial_size tab stops.
+ *
+ * Tab stops are specified in pixel units if @positions_in_pixels is %TRUE,
+ * otherwise in Pango units. All stops are initially at position 0.
*
* Return value: the newly allocated `PangoTabArray`, which should
* be freed with [method@Pango.TabArray.free].
@@ -95,8 +90,7 @@ pango_tab_array_new (gint initial_size,
* optimization.
*/
array = g_slice_new (PangoTabArray);
- array->size = initial_size;
- array->allocated = initial_size;
+ array->size = initial_size; array->allocated = initial_size;
if (array->allocated > 0)
{
@@ -119,10 +113,10 @@ pango_tab_array_new (gint initial_size,
* @first_position: position of first tab stop
* @...: additional alignment/position pairs
*
- * This is a convenience function that creates a `PangoTabArray`
- * and allows you to specify the alignment and position of each
- * tab stop. You **must** provide an alignment and position for
- * @size tab stops.
+ * Creates * a `PangoTabArray` and allows you to specify the alignment
+ * and position of each tab stop.
+ *
+ * You **must** provide an alignment and position for @size tab stops.
*
* Return value: the newly allocated `PangoTabArray`, which should
* be freed with [method@Pango.TabArray.free].
@@ -235,7 +229,9 @@ pango_tab_array_get_size (PangoTabArray *tab_array)
* @tab_array: a `PangoTabArray`
* @new_size: new size of the array
*
- * Resizes a tab array. You must subsequently initialize any tabs
+ * Resizes a tab array.
+ *
+ * You must subsequently initialize any tabs
* that were added as a result of growing the array.
*/
void
@@ -270,6 +266,7 @@ pango_tab_array_resize (PangoTabArray *tab_array,
* @location: tab location in Pango units
*
* Sets the alignment and location of a tab stop.
+ *
* @alignment must always be %PANGO_TAB_LEFT in the current
* implementation.
*/
@@ -326,8 +323,10 @@ pango_tab_array_get_tab (PangoTabArray *tab_array,
* of tab positions, or %NULL
*
* If non-%NULL, @alignments and @locations are filled with allocated
- * arrays of length [method@Pango.TabArray.get_size]. You must free the
- * returned array.
+ * arrays.
+ *
+ * The arrays are of length [method@Pango.TabArray.get_size].
+ * You must free the returned array.
*/
void
pango_tab_array_get_tabs (PangoTabArray *tab_array,
diff --git a/pango/pango-tabs.h b/pango/pango-tabs.h
index 53d1e3fd..893132ed 100644
--- a/pango/pango-tabs.h
+++ b/pango/pango-tabs.h
@@ -32,7 +32,7 @@ typedef struct _PangoTabArray PangoTabArray;
* PangoTabAlign:
* @PANGO_TAB_LEFT: the tab stop appears to the left of the text.
*
- * A `PangoTabAlign` specifies where a tab stop appears relative to the text.
+ * `PangoTabAlign` specifies where a tab stop appears relative to the text.
*/
typedef enum
{