Cleanup pass on documentation that was dumping garbage into doxygen output.

(bzr r10696)

6 files changed, 31 insertions, 25 deletions

diff --git a/src/io/base64stream.h b/src/io/base64stream.h
index 7bfe73e5f..554a92fe2 100644
--- a/src/io/base64stream.h
+++ b/src/io/base64stream.h
@@ -1,13 +1,15 @@
-#ifndef __INKSCAPE_IO_BASE64STREAM_H__
-#define __INKSCAPE_IO_BASE64STREAM_H__
+#ifndef SEEN_INKSCAPE_IO_BASE64STREAM_H
+#define SEEN_INKSCAPE_IO_BASE64STREAM_H
 
 /**
+ * @file
  * Base64-enabled input and output streams
  *
  * This class allows easy encoding and decoding
  * of Base64 data with a stream interface, hiding
  * the implementation from the user.
- *
+ */
+/*
  * Authors:
  *   Bob Jamison <rjamison@titan.com>
  *
@@ -119,4 +121,4 @@ private:
 } // namespace Inkscape
 
 
-#endif /* __INKSCAPE_IO_BASE64STREAM_H__ */
+#endif // SEEN_INKSCAPE_IO_BASE64STREAM_H
diff --git a/src/io/gzipstream.h b/src/io/gzipstream.h
index adaf50967..4debbfca9 100644
--- a/src/io/gzipstream.h
+++ b/src/io/gzipstream.h
@@ -1,12 +1,14 @@
-#ifndef __INKSCAPE_IO_GZIPSTREAM_H__
-#define __INKSCAPE_IO_GZIPSTREAM_H__
+#ifndef SEEN_INKSCAPE_IO_GZIPSTREAM_H
+#define SEEN_INKSCAPE_IO_GZIPSTREAM_H
 /**
- * Zlib-enabled input and output streams
+ * @file
+ * Zlib-enabled input and output streams.
  *
  * This is a thin wrapper of libz calls, in order
  * to provide a simple interface to our developers
  * for gzip input and output.
- *
+ */
+/*
  * Authors:
  *   Bob Jamison <rjamison@titan.com>
  *
diff --git a/src/io/inkscapestream.h b/src/io/inkscapestream.h
index 9358b4d51..a766e16e0 100644
--- a/src/io/inkscapestream.h
+++ b/src/io/inkscapestream.h
@@ -1,8 +1,6 @@
-#ifndef __INKSCAPE_IO_INKSCAPESTREAM_H__
-#define __INKSCAPE_IO_INKSCAPESTREAM_H__
-/**
- * Our base basic stream classes.  
- *
+#ifndef SEEN_INKSCAPE_IO_INKSCAPESTREAM_H
+#define SEEN_INKSCAPE_IO_INKSCAPESTREAM_H
+/*
  * Authors:
  *   Bob Jamison <rjamison@titan.com>
  *
@@ -667,4 +665,4 @@ void pipeStream(InputStream &source, OutputStream &dest);
 } // namespace Inkscape
 
 
-#endif /* __INKSCAPE_IO_INKSCAPESTREAM_H__ */
+#endif // SEEN_INKSCAPE_IO_INKSCAPESTREAM_H
diff --git a/src/io/resource.h b/src/io/resource.h
index be3ff21b7..36fe5f81e 100644
--- a/src/io/resource.h
+++ b/src/io/resource.h
@@ -1,6 +1,4 @@
-/** \file
- * Inkscape::IO::Resource - simple resource API
- *
+/*
  * Copyright 2006 MenTaLguY <mental@rydia.net>
  *
  * This program is free software; you can redistribute it and/or
@@ -21,6 +19,9 @@ namespace Inkscape {
 
 namespace IO {
 
+/**
+ * simple resource API
+ */
 namespace Resource {
 
 enum Type {
diff --git a/src/io/uristream.h b/src/io/uristream.h
index d62065976..67d2f34d7 100644
--- a/src/io/uristream.h
+++ b/src/io/uristream.h
@@ -1,9 +1,11 @@
-#ifndef __INKSCAPE_IO_URISTREAM_H__
-#define __INKSCAPE_IO_URISTREAM_H__
+#ifndef SEEN_INKSCAPE_IO_URISTREAM_H
+#define SEEN_INKSCAPE_IO_URISTREAM_H
 /**
+ * @file
  * This should be the only way that we provide sources/sinks
  * to any input/output stream.
- *
+ */
+/*
  * Authors:
  *   Bob Jamison <rjamison@titan.com>
  *
@@ -170,4 +172,4 @@ private:
 } // namespace Inkscape
 
 
-#endif /* __INKSCAPE_IO_URISTREAM_H__ */
+#endif // SEEN_INKSCAPE_IO_URISTREAM_H
diff --git a/src/io/xsltstream.h b/src/io/xsltstream.h
index 32d9d12f8..03621c7fd 100644
--- a/src/io/xsltstream.h
+++ b/src/io/xsltstream.h
@@ -1,9 +1,10 @@
-#ifndef __INKSCAPE_IO_XSLTSTREAM_H__
-#define __INKSCAPE_IO_XSLTSTREAM_H__
+#ifndef SEEN_INKSCAPE_IO_XSLTSTREAM_H
+#define SEEN_INKSCAPE_IO_XSLTSTREAM_H
 /**
+ * @file
  * Xslt-enabled input and output streams
- *
- *
+ */
+/*
  * Authors:
  *   Bob Jamison <ishmalius@gmail.com>
  *