[libxslt] Misc doc fixes

[Nick Wellnhofer <nwellnhof src gnome org>]

commit 21967a0eb088edcbed8f6067ca2dd41911699ff1
Author: Nick Wellnhofer <wellnhofer aevum de>
Date:   Tue Nov 29 16:37:39 2016 +0100

    Misc doc fixes

 doc/apibuild.py      |    1 +
 doc/newapi.xsl       |    2 +-
 doc/symbols.xml      |    3 +++
 libxslt/attributes.c |    4 ++--
 libxslt/variables.h  |   26 ++++++++++++++++++++++++++
 5 files changed, 33 insertions(+), 3 deletions(-)
---
diff --git a/doc/apibuild.py b/doc/apibuild.py
index df1d66b..bc12f01 100755
--- a/doc/apibuild.py
+++ b/doc/apibuild.py
@@ -47,6 +47,7 @@ ignored_words = {
   "X_IN_Y": (5, "macro function builder"),
   "XSLT_ITEM_COMMON_FIELDS": (0, "Special macro"),
   "CALLBACK": (0, "macro keyword"),
+  "LIBXSLT_ATTR_FORMAT": (5, "macro for gcc printf args checking extension"),
 }
 
 def escape(raw):
diff --git a/doc/newapi.xsl b/doc/newapi.xsl
index 5664e71..79545be 100644
--- a/doc/newapi.xsl
+++ b/doc/newapi.xsl
@@ -471,7 +471,7 @@
       <xsl:with-param name="text" select="info"/>
     </xsl:call-template>
     </p>
-    <xsl:if test="arg | return">
+    <xsl:if test="arg | return/@info">
       <div class="variablelist"><table border="0"><col align="left"/><tbody>
       <xsl:for-each select="arg">
         <tr>
diff --git a/doc/symbols.xml b/doc/symbols.xml
index e1bbb38..02ccf58 100644
--- a/doc/symbols.xml
+++ b/doc/symbols.xml
@@ -314,4 +314,7 @@
     <symbol file="xsltlocale">xsltFreeLocales</symbol>
     <symbol file="xsltutils">xsltXPathCompileFlags</symbol>
   </release>
+  <release version="1.1.30">
+    <symbol file="xsltInternals">xsltFlagRVTs</symbol>
+  </release>
 </symbols>
diff --git a/libxslt/attributes.c b/libxslt/attributes.c
index 9165ab1..5958ef3 100644
--- a/libxslt/attributes.c
+++ b/libxslt/attributes.c
@@ -742,9 +742,9 @@ xsltResolveStylesheetAttributeSet(xsltStylesheetPtr style) {
 /**
  * xsltAttribute:
  * @ctxt:  a XSLT process context
- * @node:  the current node in the source tree
+ * @contextNode:  the current node in the source tree
  * @inst:  the xsl:attribute element
- * @comp:  precomputed information
+ * @castedComp:  precomputed information
  *
  * Process the xslt attribute node on the source node
  */
diff --git a/libxslt/variables.h b/libxslt/variables.h
index f80eeab..24acf8d 100644
--- a/libxslt/variables.h
+++ b/libxslt/variables.h
@@ -38,9 +38,35 @@ extern "C" {
  * Flags for memory management of RVTs
  */
 
+/**
+ * XSLT_RVT_LOCAL:
+ *
+ * RVT is destroyed after the current instructions ends.
+ */
 #define XSLT_RVT_LOCAL       ((void *)1)
+
+/**
+ * XSLT_RVT_VARIABLE:
+ *
+ * RVT is part of a local variable and destroyed after the variable goes out
+ * of scope.
+ */
 #define XSLT_RVT_VARIABLE    ((void *)2)
+
+/**
+ * XSLT_RVT_FUNC_RESULT:
+ *
+ * RVT is part of results returned with func:result. The RVT won't be
+ * destroyed after exiting a template and will be reset to XSLT_RVT_LOCAL or
+ * XSLT_RVT_VARIABLE in the template that receives the return value.
+ */
 #define XSLT_RVT_FUNC_RESULT ((void *)3)
+
+/**
+ * XSLT_RVT_GLOBAL:
+ *
+ * RVT is part of a global variable.
+ */
 #define XSLT_RVT_GLOBAL      ((void *)4)
 
 /*