Documentation: Remove/fix mentions of 0 when we mean something else.

2008-03-28  Murray Cumming  <murrayc@murrayc.com>

* gio/src/file.hg:
* gio/src/outputstream.hg: Documentation: Remove/fix mentions of 0 when 
we mean something else.

svn path=/trunk/; revision=644

3 files changed, 20 insertions, 17 deletions

diff --git a/ChangeLog b/ChangeLog
index b9e9a11b..22df62f1 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2008-03-28  Murray Cumming  <murrayc@murrayc.com>
+
+	* gio/src/file.hg:
+	* gio/src/outputstream.hg: Documentation: Remove/fix mentions of 0 when 
+	we mean something else.
+
 2008-03-24  Jonathon Jongsma  <jjongsma@gnome.org>
 
 	* gio/src/desktopappinfo.hg:
diff --git a/gio/src/file.hg b/gio/src/file.hg
index df41b91a..c447b04e 100644
--- a/gio/src/file.hg
+++ b/gio/src/file.hg
@@ -290,8 +290,7 @@ public:
    *
    * @param cancellable A Cancellable object which can be used to cancel the operation.
    * @param flags a set of FileCreateFlags.
-   * @return A FileOutputStream for the newly created file, or 
-   * <tt>0</tt> on error.
+   * @return A FileOutputStream for the newly created file.
    */
 #ifdef GLIBMM_EXCEPTIONS_ENABLED
   Glib::RefPtr<FileOutputStream> create_file(const Glib::RefPtr<Cancellable>& cancellable, FileCreateFlags flags = FILE_CREATE_NONE);
@@ -318,8 +317,7 @@ public:
    * filesystem the file is on.
    *
    * @param flags a set of FileCreateFlags.
-   * @return A FileOutputStream for the newly created file, or 
-   * <tt>0</tt> on error.
+   * @return A FileOutputStream for the newly created file.
    */
 #ifdef GLIBMM_EXCEPTIONS_ENABLED
   Glib::RefPtr<FileOutputStream> create_file(FileCreateFlags flags = FILE_CREATE_NONE);
@@ -644,7 +642,7 @@ public:
    * (the total size of the filesystem in bytes), FILE_ATTRIBUTE_FILESYSTEM_FREE (number of
    * bytes availible), and FILE_ATTRIBUTE_FILESYSTEM_TYPE (type of the filesystem).
    * 
-   * If @a cancellable  is not <tt>0</tt>, then the operation can be cancelled by
+   * The operation can be cancelled by
    * triggering the cancellable object from another thread. If the operation
    * was cancelled, a Gio::Error with CANCELLED will be thrown. 
    * 
@@ -801,7 +799,7 @@ public:
    * @param cancellable A Cancellable object.
    * @param attributes An attribute query string.
    * @param flags A set of FileQueryInfoFlags.
-   * @return A FileEnumerator if successful, <tt>0</tt> on error.
+   * @return A FileEnumerator if successful.
    */
 #ifdef GLIBMM_EXCEPTIONS_ENABLED
   Glib::RefPtr<FileEnumerator> enumerate_children(const Glib::RefPtr<Cancellable>& cancellable, const std::string& attributes = "*", FileQueryInfoFlags flags = FILE_QUERY_INFO_NONE);
@@ -828,7 +826,7 @@ public:
    *
    * @param attributes An attribute query string.
    * @param flags A set of FileQueryInfoFlags.
-   * @return A FileEnumerator if successful, <tt>0</tt> on error.
+   * @return A FileEnumerator if successful.
    */
 #ifdef GLIBMM_EXCEPTIONS_ENABLED
   Glib::RefPtr<FileEnumerator> enumerate_children(const std::string& attributes = "*", FileQueryInfoFlags flags = FILE_QUERY_INFO_NONE);
@@ -1570,7 +1568,6 @@ public:
    * @param cancellable A Cancellable object.
    * @param flags A set of FileMonitorFlags.
    * @return A FileMonitor for the file.
-   * or <tt>0</tt> on error.
    */
 #ifdef GLIBMM_EXCEPTIONS_ENABLED
   Glib::RefPtr<FileMonitor> monitor_directory(const Glib::RefPtr<Cancellable>& cancellable, FileMonitorFlags flags = FILE_MONITOR_NONE);
@@ -1583,7 +1580,6 @@ public:
    * 
    * @param flags A set of FileMonitorFlags.
    * @return A FileMonitor for the file.
-   * or <tt>0</tt> on error.
    */
 #ifdef GLIBMM_EXCEPTIONS_ENABLED
   Glib::RefPtr<FileMonitor> monitor_directory(FileMonitorFlags flags = FILE_MONITOR_NONE);
@@ -1766,7 +1762,7 @@ public:
 
   /** Replaces the contents of the file with @a contents of @a length bytes.
    *  
-   * If @a etag is specified (not <tt>0</tt>) any existing file must have that etag, or
+   * If @a etag is specified (not an empty string) any existing file must have that etag, or
    * a Gio::Error with WRONG_ETAG will be thrown.
    * 
    * If @a make_backup is <tt>true</tt>, this function will attempt to make a backup of the file.
@@ -1795,7 +1791,7 @@ public:
 
   /** Replaces the contents of the file with @a contents of @a length bytes.
    *  
-   * If @a etag is specified (not <tt>0</tt>) any existing file must have that etag, or
+   * If @a etag is specified (not an empty string) any existing file must have that etag, or
    * a Gio::Error with WRONG_ETAG will be thrown.
    * 
    * If @a make_backup is <tt>true</tt>, this function will attempt to make a backup of the file.
@@ -1819,7 +1815,7 @@ public:
 
   /** Replaces the contents of the file with @a contents.
    *  
-   * If @a etag is specified (not <tt>0</tt>) any existing file must have that etag, or
+   * If @a etag is specified (not an empty string) any existing file must have that etag, or
    * a Gio::Error with WRONG_ETAG will be thrown.
    * 
    * If @a make_backup is <tt>true</tt>, this function will attempt to make a backup of the file.
@@ -1847,7 +1843,7 @@ public:
 
   /** Replaces the contents of the file with @a contents.
    *  
-   * If @a etag is specified (not <tt>0</tt>) any existing file must have that etag, or
+   * If @a etag is specified (not an empty string) any existing file must have that etag, or
    * a Gio::Error with WRONG_ETAG will be thrown.
    * 
    * If @a make_backup is <tt>true</tt>, this function will attempt to make a backup of the file.
@@ -1870,6 +1866,9 @@ public:
   _IGNORE(g_file_replace_contents)
 
 
+  //TODO: Add replace_contents() without the etags?
+
+
  /** Starts an asynchronous replacement of the file with the given 
   * @a contents of @a length bytes. @a etag will replace the document's 
   * current entity tag.
diff --git a/gio/src/outputstream.hg b/gio/src/outputstream.hg
index 5cd803c1..a5bf35b3 100644
--- a/gio/src/outputstream.hg
+++ b/gio/src/outputstream.hg
@@ -226,11 +226,10 @@ public:
    * 
    * This function is optional for inherited classes.
    * 
-   * If @a cancellable  is not <tt>0</tt>, then the operation can be cancelled by
+   * The operation can be cancelled by
    * triggering the cancellable object from another thread. If the operation
    * was cancelled, a Gio::Error with CANCELLED will be thrown.
    * @param cancellable Optional cancellable object.
-   * @param error Location to store the error occuring, or <tt>0</tt> to ignore.
    * @return <tt>true</tt> on success, <tt>false</tt> on error.
    */
   #ifdef GLIBMM_EXCEPTIONS_ENABLED
@@ -265,7 +264,7 @@ public:
    * is important to check and report the error to the user, otherwise
    * there might be a loss of data as all data might not be written.
    * 
-   * If @a cancellable  is not <tt>0</tt>, then the operation can be cancelled by
+   * The operation can be cancelled by
    * triggering the cancellable object from another thread. If the operation
    * was cancelled, a Gio::Error with CANCELLED will be thrown.
    * Cancelling a close will still leave the stream closed, but there some streams
@@ -273,7 +272,6 @@ public:
    * cancellation (as with any error) there is no guarantee that all written
    * data will reach the target.
    * @param cancellable Optional cancellable object.
-   * @param error Location to store the error occuring, or <tt>0</tt> to ignore.
    * @return <tt>true</tt> on success, <tt>false</tt> on failure.
    */
   #ifdef GLIBMM_EXCEPTIONS_ENABLED