[nautilus-actions] Fix reference manual

[Pierre Wieser <pwieser src gnome org>]

commit 60dfbf10d906a67a2fec807627026daf237f70f2
Author: Pierre Wieser <pwieser trychlos org>
Date:   Thu Feb 24 00:55:25 2011 +0100

    Fix reference manual

 docs/reference/nautilus-actions-sections.txt |   16 +++----
 src/core/na-object.c                         |   58 +++++++++++++++++---------
 2 files changed, 44 insertions(+), 30 deletions(-)
---
diff --git a/docs/reference/nautilus-actions-sections.txt b/docs/reference/nautilus-actions-sections.txt
index 6b3f684..d2459e6 100644
--- a/docs/reference/nautilus-actions-sections.txt
+++ b/docs/reference/nautilus-actions-sections.txt
@@ -281,7 +281,7 @@ NA_FACTORY_OBJECT_CONDITIONS_GROUP
 NAFO_DATA_BASENAMES
 NAFO_DATA_MATCHCASE
 NAFO_DATA_MIMETYPES
-NAFO_DATA_ALL_MIMETYPES
+NAFO_DATA_MIMETYPES_IS_ALL
 NAFO_DATA_ISFILE
 NAFO_DATA_ISDIR
 NAFO_DATA_MULTIPLE
@@ -310,12 +310,11 @@ NAObjectClass
 na_object_object_reset_origin
 na_object_object_ref
 na_object_object_unref
-na_object_object_copy
 na_object_object_dump
 na_object_object_dump_norec
 na_object_object_dump_tree
 na_object_object_check_status_rec
-na_object_object_get_hierarchy
+na_object_get_hierarchy
 na_object_free_hierarchy
 na_object_object_debug_invalid
 
@@ -369,7 +368,6 @@ NA_OBJECT_ITEM
 NA_IS_OBJECT_ITEM
 NAObjectItem
 NAItemTarget
-na_object_item_are_equal
 na_object_item_is_finally_writable
 na_object_item_set_writability_status
 na_object_item_get_item
@@ -516,9 +514,11 @@ NA_ICONTEXT_GET_INTERFACE
 NAIContext
 NAIContextInterfacePrivate
 NAIContextInterface
+na_icontext_are_equal
+na_icontext_check_mimetypes
+na_icontext_copy
 na_icontext_is_candidate
 na_icontext_is_valid
-na_icontext_is_all_mimetypes
 na_icontext_read_done
 na_icontext_set_scheme
 na_icontext_set_only_desktop
@@ -546,11 +546,10 @@ na_object_set_modified
 na_object_reset_origin
 na_object_set_writability_status
 na_object_is_finally_writable
-na_object_copy
+na_object_check_mimetypes
 na_object_dump
 na_object_dump_norec
 na_object_dump_tree
-na_object_get_hierarchy
 na_object_ref
 na_object_unref
 na_object_debug_invalid
@@ -629,9 +628,6 @@ na_object_get_execute_as
 na_object_set_path
 na_object_set_parameters
 na_object_set_working_dir
-na_object_set_isfile
-na_object_set_isdir
-na_object_set_multiple
 na_object_set_execution_mode
 na_object_set_startup_notify
 na_object_set_startup_class
diff --git a/src/core/na-object.c b/src/core/na-object.c
index 74b8126..e9ce5af 100644
--- a/src/core/na-object.c
+++ b/src/core/na-object.c
@@ -333,33 +333,51 @@ iduplicable_is_valid( const NAIDuplicable *object )
  * Internally set some properties which may be requested later. This
  * two-steps check-request let us optimize some work in the UI.
  *
+ * <literallayout>
  * na_object_object_check_status_rec( object )
  *  +- na_iduplicable_check_status( object )
  *      +- get_origin( object )
  *      +- modified_status = v_are_equal( origin, object )
- *         +-> interface <structfield>NAObjectClass::are_equal</structfield>
- *             which happens to be iduplicable_are_equal( a, b )
- *              +- v_are_equal( a, b )
- *                  +- NAObjectAction::are_equal()
- *                      +- na_factory_object_are_equal()
- *                      +- check NAObjectActionPrivate data
- *                      +- call parent class
- *                         +- NAObjectItem::are_equal()
- *                             +- check NAObjectItemPrivate data
- *                             +- call parent class
- *                                 +- NAObjectId::are_equal()
- *
+ *      |  +-> interface <structfield>NAObjectClass::are_equal</structfield>
+ *      |      which happens to be iduplicable_are_equal( a, b )
+ *      |       +- v_are_equal( a, b )
+ *      |           +- NAObjectAction::are_equal()
+ *      |               +- na_factory_object_are_equal()
+ *      |               +- check NAObjectActionPrivate data
+ *      |               +- call parent class
+ *      |                  +- NAObjectItem::are_equal()
+ *      |                      +- check NAObjectItemPrivate data
+ *      |                      +- call parent class
+ *      |                          +- NAObjectId::are_equal()
+ *      |
  *      +- valid_status = v_is_valid( object )             -> interface <structfield>NAObjectClass::is_valid</structfield>
- *
- * Note that the recursivity is managed here, so that we can be sure
- * that edition status of children is actually checked before those of
- * the parent.
- *
- * As of 3.1.0:
- * - when the modification status of a NAObjectProfile changes, then its
- *   NAObjectAction parent is rechecked;
- * - when the validity status of an object is changed, then its parent is
- *   also rechecked.
+ * </literallayout>
+ *
+ *   Note that the recursivity is managed here, so that we can be sure
+ *   that edition status of children is actually checked before those of
+ *   the parent.
+ *
+ * <formalpara>
+ *  <title>
+ *   As of 3.1.0:
+ *  </title>
+ *  <para>
+ *   <itemizedlist>
+ *    <listitem>
+ *     <para>
+ *      when the modification status of a NAObjectProfile changes, then its
+ *      NAObjectAction parent is rechecked;
+ *     </para>
+ *    </listitem>
+ *    <listitem>
+ *     <para>
+ *      when the validity status of an object is changed, then its parent is
+ *      also rechecked.
+ *     </para>
+ *    </listitem>
+ *   </itemizedlist>
+ *  </para>
+ * </formalpara>
  *
  * Since: 2.30
  */