docs: use () instead of <function> tags

7 files changed, 8 insertions, 10 deletions

diff --git a/gtk/gtkbuildable.c b/gtk/gtkbuildable.c
index 3264e05fde..e23829ed18 100644
--- a/gtk/gtkbuildable.c
+++ b/gtk/gtkbuildable.c
@@ -29,8 +29,7 @@
  * The GtkBuildable interface is implemented by all widgets and
  * many of the non-widget objects that are provided by GTK+. The
  * main user of this interface is #GtkBuilder. There should be
- * very little need for applications to call any
- * <function>gtk_buildable_...</function> functions.
+ * very little need for applications to call any of these functions directly.
  *
  * <note><para>An object only needs to implement this interface if it needs
  * to extend the #GtkBuilder format or run any extra routines at deserialization time</para></note>
diff --git a/gtk/gtkbuilder.c b/gtk/gtkbuilder.c
index 01ae50d71d..81b8413cf2 100644
--- a/gtk/gtkbuilder.c
+++ b/gtk/gtkbuilder.c
@@ -91,10 +91,10 @@
  *
  * Typically, the specific kind of object represented by an &lt;object&gt;
  * element is specified by the "class" attribute. If the type has not been
- * loaded yet, GTK+ tries to find the <function>_get_type(<!-- -->)</function> from the
+ * loaded yet, GTK+ tries to find the _get_type(<!-- -->) from the
  * class name by applying heuristics. This works in most cases, but if
  * necessary, it is possible to specify the name of the
- * <function>_get_type(<!-- -->)</function> explictly with the "type-func" attribute.
+ * _get_type(<!-- -->) explictly with the "type-func" attribute.
  * As a special case, GtkBuilder allows to use an object that has been
  * constructed by a #GtkUIManager in another part of the UI definition by
  * specifying the id of the #GtkUIManager in the "constructor" attribute and the
diff --git a/gtk/gtkclipboard.c b/gtk/gtkclipboard.c
index 62baf6bf66..69d13c8ffa 100644
--- a/gtk/gtkclipboard.c
+++ b/gtk/gtkclipboard.c
@@ -821,7 +821,7 @@ text_clear_func (GtkClipboard *clipboard,
  * @clipboard: a #GtkClipboard object
  * @text:      a UTF-8 string.
  * @len:       length of @text, in bytes, or -1, in which case
- *             the length will be determined with <function>strlen()</function>.
+ *             the length will be determined with strlen().
  * 
  * Sets the contents of the clipboard to the given UTF-8 string. GTK+ will
  * make a copy of the text and take responsibility for responding
diff --git a/gtk/gtkcontainer.c b/gtk/gtkcontainer.c
index dfa2a17977..7f7e41e076 100644
--- a/gtk/gtkcontainer.c
+++ b/gtk/gtkcontainer.c
@@ -151,7 +151,7 @@
  *
  * Height for width requests are generally implemented in terms of a virtual allocation
  * of widgets in the input orientation. Assuming an height-for-width request mode, a container
- * would implement the <function>get_preferred_height_for_width(<!-- -->)</function> virtual function by first calling
+ * would implement the get_preferred_height_for_width(<!-- -->) virtual function by first calling
  * gtk_widget_get_preferred_width() for each of its children.
  *
  * For each potential group of children that are lined up horizontally, the values returned by
diff --git a/gtk/gtkfilechooser.c b/gtk/gtkfilechooser.c
index 0bee12305d..1b05cd097c 100644
--- a/gtk/gtkfilechooser.c
+++ b/gtk/gtkfilechooser.c
@@ -83,8 +83,7 @@
  * <note>
  *    This means that while you can pass the result of
  *    gtk_file_chooser_get_filename() to
- *    <function>open(2)</function> or
- *    <function>fopen(3)</function>, you may not be able to
+ *    open(2) or fopen(3), you may not be able to
  *    directly set it as the text of a #GtkLabel widget unless you
  *    convert it first to UTF-8, which all GTK+ widgets expect.
  *    You should use g_filename_to_utf8() to convert filenames
diff --git a/gtk/gtkmain.c b/gtk/gtkmain.c
index c1b08cf131..1f1e6bfa45 100644
--- a/gtk/gtkmain.c
+++ b/gtk/gtkmain.c
@@ -54,7 +54,7 @@
  * main loop and await more user input.
  * </para>
  * <example>
- * <title>Typical <function>main()</function> function for a GTK+ application</title>
+ * <title>Typical main() function for a GTK+ application</title>
  * <programlisting>
  * int
  * main (int argc, char **argv)
diff --git a/gtk/gtktreemodel.c b/gtk/gtktreemodel.c
index 58b000f021..dfc1503cbe 100644
--- a/gtk/gtktreemodel.c
+++ b/gtk/gtktreemodel.c
@@ -141,7 +141,7 @@
  *
  * This second example shows a quick way of iterating through a list
  * and getting a string and an integer from each row. The
- * <function>populate_model</function> function used below is not
+ * populate_model() function used below is not
  * shown, as it is specific to the #GtkListStore. For information on
  * how to write such a function, see the #GtkListStore documentation.
  *