[nautilus-sendto] Some gtk-doc cleanups

[Bastien Nocera <hadess src gnome org>]

commit dae7823734654ac1af8befe9154073a6eaa7b1e7
Author: Bastien Nocera <hadess hadess net>
Date:   Thu Jan 21 15:13:33 2010 +0000

    Some gtk-doc cleanups

 docs/nautilus-sendto/Makefile.am        |    6 ++++++
 src/nautilus-sendto-plugin.h            |    9 +++++++++
 src/plugins/evolution/e-contact-entry.c |   24 ++++++++++++------------
 3 files changed, 27 insertions(+), 12 deletions(-)
---
diff --git a/docs/nautilus-sendto/Makefile.am b/docs/nautilus-sendto/Makefile.am
index c898040..dbe9c3b 100644
--- a/docs/nautilus-sendto/Makefile.am
+++ b/docs/nautilus-sendto/Makefile.am
@@ -92,3 +92,9 @@ EXTRA_DIST += version.xml.in
 # Comment this out if you want your docs-status tested during 'make check'
 #TESTS = $(GTKDOC_CHECK)
 
+if ENABLE_GTK_DOC
+TESTS_ENVIRONMENT = cd $(srcdir) &&  
+TESTS = $(GTKDOC_CHECK)
+endif
+
+
diff --git a/src/nautilus-sendto-plugin.h b/src/nautilus-sendto-plugin.h
index 5109cf4..216f051 100644
--- a/src/nautilus-sendto-plugin.h
+++ b/src/nautilus-sendto-plugin.h
@@ -29,6 +29,15 @@
 #include <gmodule.h>
 #include <gtk/gtk.h>
 
+/**
+ * SECTION:nautilus-sendto-plugin
+ * @short_description: nautilus-sento plug-in
+ * @stability: Stable
+ * @include: bluetooth-plugin.h
+ *
+ * Plug-ins can be used to extend nautilus-sendto.
+ **/
+
 typedef struct _NstPluginInfo NstPluginInfo;
 typedef struct _NstPlugin NstPlugin;
 
diff --git a/src/plugins/evolution/e-contact-entry.c b/src/plugins/evolution/e-contact-entry.c
index bd0d739..41388e2 100644
--- a/src/plugins/evolution/e-contact-entry.c
+++ b/src/plugins/evolution/e-contact-entry.c
@@ -85,7 +85,7 @@ struct EContactEntryPriv {
   GDestroyNotify display_destroy;
 };
 
-/**
+/*
  * Struct containing details of the sources we are searching.
  */
 typedef struct _EntryLookup {
@@ -96,7 +96,7 @@ typedef struct _EntryLookup {
   EBookView *bookview;
 } EntryLookup;
 
-/**
+/*
  * List store columns.
  */
 enum {
@@ -116,7 +116,7 @@ static guint entry_height (GtkWidget *widget);
 static const char* stringify_ebook_error (const EBookStatus status);
 static void e_contact_entry_item_free (EContactEntyItem *item);
 
-/**
+/*
  * The entry was activated.  Take the first contact found and signal the user.
  */
 static void
@@ -164,7 +164,7 @@ entry_activate_cb (EContactEntry *entry, gpointer user_data)
   }
 }
 
-/**
+/*
  * A contact was selected in the completion drop-down, so send a signal.
  */
 static gboolean
@@ -235,7 +235,7 @@ e_contact_entry_display_func (EContact *contact)
 
 /* This is the maximum number of entries that GTK+ will show */
 #define MAX_ENTRIES 15
-/**
+/*
  * Callback from the EBookView that more contacts matching the query have been found. Add these to
  * the model if we still want more contacts, or stop the view.
  */
@@ -332,7 +332,7 @@ view_contacts_added_cb (EBook *book, GList *contacts, gpointer user_data)
   }
 }
 
-/**
+/*
  * The query on the EBookView has completed.
  */
 static void
@@ -348,7 +348,7 @@ view_completed_cb (EBookView *book_view, EBookViewStatus status, gpointer user_d
   g_object_unref (lookup->bookview);
 }
 
-/**
+/*
  * The EBookView to lookup the completions with has been created.
  */
 static void
@@ -779,7 +779,7 @@ lookup_entry_free (EntryLookup *lookup)
   g_free (lookup);
 }
 
-/**
+/*
  * Split a string of tokens separated by whitespace into an array of tokens.
  */
 static GArray *
@@ -809,7 +809,7 @@ split_query_string (const gchar *str)
   return parts;
 }
 
-/**
+/*
  * Create a query which looks for the specified string in a contact's full name, email addresses and
  * nick name.
  */
@@ -847,7 +847,7 @@ create_query (EContactEntry *entry, const char* s)
   return query;
 }
 
-/**
+/*
  * Given a widget, determines the height that text will normally be drawn.
  */
 static guint
@@ -861,7 +861,7 @@ entry_height (GtkWidget *widget)
   return bound;
 }
 
-/**
+/*
  * Free a EContactEntyItem struct.
  */
 static void
@@ -872,7 +872,7 @@ e_contact_entry_item_free (EContactEntyItem *item)
   g_free (item);
 }
 
-/**
+/*
  * Return a string representing a given EBook status code.
  */
 static const char*