libsmartcols: (docs) add missing 'since' tags

Signed-off-by: Karel Zak <kzak@redhat.com>

diff --git a/libsmartcols/docs/libsmartcols-docs.xml b/libsmartcols/docs/libsmartcols-docs.xml
index 607ab2e7c11bd79715e10715d4ac3c800bbbf31c..bd0d76659a4051c7713c47cf2c3f7e5c165ad24a 100644 (file)
--- a/libsmartcols/docs/libsmartcols-docs.xml
+++ b/libsmartcols/docs/libsmartcols-docs.xml
@@ -9,7 +9,7 @@
     <title>libsmartcols Reference Manual</title>
     <releaseinfo>for libsmartcols version &version;</releaseinfo>
     <copyright>
-      <year>2014-2016</year>
+      <year>2014-2017</year>
       <holder>Karel Zak &lt;kzak@redhat.com&gt;</holder>
     </copyright>
   </bookinfo>
@@ -61,4 +61,8 @@ available from https://www.kernel.org/pub/linux/utils/util-linux/.
     <title>Index of new symbols in 2.29</title>
     <xi:include href="xml/api-index-2.29.xml"><xi:fallback /></xi:include>
   </index>
+  <index role="2.30">
+    <title>Index of new symbols in 2.30</title>
+    <xi:include href="xml/api-index-2.30.xml"><xi:fallback /></xi:include>
+  </index>
 </book>

diff --git a/libsmartcols/src/cell.c b/libsmartcols/src/cell.c
index 04e9bfc203eae9992f6b5c83cbe4aa3c4e71e65d..783bac2ebbfe61274cb4e13704b6cd72a058aa6e 100644 (file)
--- a/libsmartcols/src/cell.c
+++ b/libsmartcols/src/cell.c
@@ -218,6 +218,8 @@ int scols_cell_get_flags(const struct libscols_cell *ce)
  * scols_cell_get_alignment:
  * @ce: a pointer to a struct libscols_cell instance
  *
+ * Since: 2.30
+ *
  * Returns: SCOLS_CELL_FL_{RIGHT,CELNTER,LEFT}
  */
 int scols_cell_get_alignment(const struct libscols_cell *ce)

diff --git a/libsmartcols/src/line.c b/libsmartcols/src/line.c
index 134bf2d8e8cbdc444c7b6f71494f882fb8402fb4..aa339ce38e09e21d41213ddbb2b0020318869988 100644 (file)
--- a/libsmartcols/src/line.c
+++ b/libsmartcols/src/line.c
@@ -315,6 +315,10 @@ int scols_line_next_child(struct libscols_line *ln,
  *
  * The function is designed to detect circular dependencies between @ln and
  * @parent. It checks if @ln is not any (grand) parent in the @parent's tree.
+ *
+ * Since: 2.30
+ *
+ * Returns: 0 or 1
  */
 int scols_line_is_ancestor(struct libscols_line *ln, struct libscols_line *parent)
 {

diff --git a/libsmartcols/src/table.c b/libsmartcols/src/table.c
index 50288d6067e1b6e0022e973766db8f1c380df461..a64a6b2a2a7b8c0da4a54b1d373e7dbfa165a42a 100644 (file)
--- a/libsmartcols/src/table.c
+++ b/libsmartcols/src/table.c
@@ -257,9 +257,11 @@ int scols_table_remove_columns(struct libscols_table *tb)
  * @pre: column before the column
  * @cl: colum to move
  *
- * Move the @cl behind @pre. The the @pre is NULL then the @col is the fist
+ * Move the @cl behind @pre. If the @pre is NULL then the @col is the first
  * column in the table.
  *
+ * Since: 2.30
+ *
  * Returns: 0, a negative number in case of an error.
  */
 int scols_table_move_column(struct libscols_table *tb,
@@ -1338,6 +1340,8 @@ static struct libscols_line *move_line_and_children(struct libscols_line *ln, st
  * Reorders lines in the table by parent->child relation. Note that order of
  * the lines in the table is independent on the tree hierarchy.
  *
+ * Since: 2.30
+ *
  * Returns: 0, a negative value in case of an error.
  */
 int scols_sort_table_by_tree(struct libscols_table *tb)