Move gtk-doc stuff from docs/reference/tmpl/ to the C files themselves.

	* libsoup/*.c: Move gtk-doc stuff from docs/reference/tmpl/ to the
	C files themselves. Some updates.

	* docs/reference/Makefile.am: fix (kludge?) this up to not require
	tmpl/ to exist

	* docs/reference/client-howto.xml: 
	* docs/reference/server-howto.xml: update

svn path=/branches/libsoup-2.4/; revision=1018

1 files changed, 19 insertions, 0 deletions

diff --git a/libsoup/soup-auth.c b/libsoup/soup-auth.c
index 3e8b4a49..30792814 100644
--- a/libsoup/soup-auth.c
+++ b/libsoup/soup-auth.c
@@ -17,6 +17,25 @@
 #include "soup-headers.h"
 #include "soup-uri.h"
 
+/**
+ * SECTION:soup-auth
+ * @short_description: HTTP client-side authentication support
+ * @see_also: #SoupSession
+ *
+ * #SoupAuth objects store the authentication data associated with a
+ * given bit of web space. They are created automatically by
+ * #SoupSession.
+ **/
+
+/**
+ * SoupAuth:
+ *
+ * The abstract base class for handling authentication. Specific HTTP
+ * Authentication mechanisms are implemented by its subclasses, but
+ * applications never need to be aware of the specific subclasses
+ * being used.
+ **/
+
 typedef struct {
 	gboolean proxy;
 	char *host;