Indentation fixes, some rewriting of docs to conform to gtk-doc standard.
authorOwen Taylor <otaylor@redhat.com>
Mon, 5 Nov 2001 01:35:30 +0000 (01:35 +0000)
committerOwen Taylor <otaylor@src.gnome.org>
Mon, 5 Nov 2001 01:35:30 +0000 (01:35 +0000)
Sun Nov  4 20:29:31 2001  Owen Taylor  <otaylor@redhat.com>

        * glib/gdir.[ch]: Indentation fixes, some rewriting of docs to
        conform to gtk-doc standard.

        * glib/gdir.[ch] (g_dir_close): Remove the boolean
        return value. What would you do if closing failed?
        What would the user do if you printed a warning
        message "closing directory %d failed"?

ChangeLog
ChangeLog.pre-2-0
ChangeLog.pre-2-10
ChangeLog.pre-2-12
ChangeLog.pre-2-2
ChangeLog.pre-2-4
ChangeLog.pre-2-6
ChangeLog.pre-2-8
glib/gdir.c
glib/gdir.h

index 739b926907c2280622fc0ef06c142cd82e95321e..79cf83c53f9611d9ce4049e0a1e9b00537403954 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,13 @@
+Sun Nov  4 20:29:31 2001  Owen Taylor  <otaylor@redhat.com>
+
+       * glib/gdir.[ch]: Indentation fixes, some rewriting of docs to
+       conform to gtk-doc standard.
+
+       * glib/gdir.[ch] (g_dir_close): Remove the boolean 
+       return value. What would you do if closing failed?
+       What would the user do if you printed a warning
+       message "closing directory %d failed"?
+
 2001-11-04  Hans Breuer  <hans@breuer.org>
 
        * glib/gdir.[hc] : (new files) simplified wrapper around dirent 
index 739b926907c2280622fc0ef06c142cd82e95321e..79cf83c53f9611d9ce4049e0a1e9b00537403954 100644 (file)
@@ -1,3 +1,13 @@
+Sun Nov  4 20:29:31 2001  Owen Taylor  <otaylor@redhat.com>
+
+       * glib/gdir.[ch]: Indentation fixes, some rewriting of docs to
+       conform to gtk-doc standard.
+
+       * glib/gdir.[ch] (g_dir_close): Remove the boolean 
+       return value. What would you do if closing failed?
+       What would the user do if you printed a warning
+       message "closing directory %d failed"?
+
 2001-11-04  Hans Breuer  <hans@breuer.org>
 
        * glib/gdir.[hc] : (new files) simplified wrapper around dirent 
index 739b926907c2280622fc0ef06c142cd82e95321e..79cf83c53f9611d9ce4049e0a1e9b00537403954 100644 (file)
@@ -1,3 +1,13 @@
+Sun Nov  4 20:29:31 2001  Owen Taylor  <otaylor@redhat.com>
+
+       * glib/gdir.[ch]: Indentation fixes, some rewriting of docs to
+       conform to gtk-doc standard.
+
+       * glib/gdir.[ch] (g_dir_close): Remove the boolean 
+       return value. What would you do if closing failed?
+       What would the user do if you printed a warning
+       message "closing directory %d failed"?
+
 2001-11-04  Hans Breuer  <hans@breuer.org>
 
        * glib/gdir.[hc] : (new files) simplified wrapper around dirent 
index 739b926907c2280622fc0ef06c142cd82e95321e..79cf83c53f9611d9ce4049e0a1e9b00537403954 100644 (file)
@@ -1,3 +1,13 @@
+Sun Nov  4 20:29:31 2001  Owen Taylor  <otaylor@redhat.com>
+
+       * glib/gdir.[ch]: Indentation fixes, some rewriting of docs to
+       conform to gtk-doc standard.
+
+       * glib/gdir.[ch] (g_dir_close): Remove the boolean 
+       return value. What would you do if closing failed?
+       What would the user do if you printed a warning
+       message "closing directory %d failed"?
+
 2001-11-04  Hans Breuer  <hans@breuer.org>
 
        * glib/gdir.[hc] : (new files) simplified wrapper around dirent 
index 739b926907c2280622fc0ef06c142cd82e95321e..79cf83c53f9611d9ce4049e0a1e9b00537403954 100644 (file)
@@ -1,3 +1,13 @@
+Sun Nov  4 20:29:31 2001  Owen Taylor  <otaylor@redhat.com>
+
+       * glib/gdir.[ch]: Indentation fixes, some rewriting of docs to
+       conform to gtk-doc standard.
+
+       * glib/gdir.[ch] (g_dir_close): Remove the boolean 
+       return value. What would you do if closing failed?
+       What would the user do if you printed a warning
+       message "closing directory %d failed"?
+
 2001-11-04  Hans Breuer  <hans@breuer.org>
 
        * glib/gdir.[hc] : (new files) simplified wrapper around dirent 
index 739b926907c2280622fc0ef06c142cd82e95321e..79cf83c53f9611d9ce4049e0a1e9b00537403954 100644 (file)
@@ -1,3 +1,13 @@
+Sun Nov  4 20:29:31 2001  Owen Taylor  <otaylor@redhat.com>
+
+       * glib/gdir.[ch]: Indentation fixes, some rewriting of docs to
+       conform to gtk-doc standard.
+
+       * glib/gdir.[ch] (g_dir_close): Remove the boolean 
+       return value. What would you do if closing failed?
+       What would the user do if you printed a warning
+       message "closing directory %d failed"?
+
 2001-11-04  Hans Breuer  <hans@breuer.org>
 
        * glib/gdir.[hc] : (new files) simplified wrapper around dirent 
index 739b926907c2280622fc0ef06c142cd82e95321e..79cf83c53f9611d9ce4049e0a1e9b00537403954 100644 (file)
@@ -1,3 +1,13 @@
+Sun Nov  4 20:29:31 2001  Owen Taylor  <otaylor@redhat.com>
+
+       * glib/gdir.[ch]: Indentation fixes, some rewriting of docs to
+       conform to gtk-doc standard.
+
+       * glib/gdir.[ch] (g_dir_close): Remove the boolean 
+       return value. What would you do if closing failed?
+       What would the user do if you printed a warning
+       message "closing directory %d failed"?
+
 2001-11-04  Hans Breuer  <hans@breuer.org>
 
        * glib/gdir.[hc] : (new files) simplified wrapper around dirent 
index 739b926907c2280622fc0ef06c142cd82e95321e..79cf83c53f9611d9ce4049e0a1e9b00537403954 100644 (file)
@@ -1,3 +1,13 @@
+Sun Nov  4 20:29:31 2001  Owen Taylor  <otaylor@redhat.com>
+
+       * glib/gdir.[ch]: Indentation fixes, some rewriting of docs to
+       conform to gtk-doc standard.
+
+       * glib/gdir.[ch] (g_dir_close): Remove the boolean 
+       return value. What would you do if closing failed?
+       What would the user do if you printed a warning
+       message "closing directory %d failed"?
+
 2001-11-04  Hans Breuer  <hans@breuer.org>
 
        * glib/gdir.[hc] : (new files) simplified wrapper around dirent 
index eab0a6c7dc124a1dbfa71ca0ab30bd6bc57fc722..14a8a994046d4b4439b4f5d2e05bd2eb4b8cc534 100644 (file)
 
 struct _GDir
 {
-  /*< private >*/
   DIR *dir;
 };
 
 /**
  * g_dir_open:
  * @path: the path to the directory you are interested in
- * @flags: for future binary compatible extensions 
- * @error: return location for a #GError
+ * @flags: Currently must be set to 0. Reserved for future use.
+ * @error: return location for a #GError, or %NULL.
+ *         If non-%NULL, an error will be set if and only if
+ *         g_dir_open_fails.
  *
- * Return value: a #GDir* on success, NULL if error is set
+ * Opens a directory for reading. The names of the files
+ * in the directory can then be retrieved using
+ * g_dir_get_name().
+ *
+ * Return value: a newly allocated #GDir on success, %NULL on failure.
+ *   If non-%NULL, you must free the result with g_dir_close()
+ *   when you are finished with it.
  **/
 GDir *
 g_dir_open (const gchar  *path,
@@ -63,8 +70,8 @@ g_dir_open (const gchar  *path,
   g_set_error (error,
                G_FILE_ERROR,
                g_file_error_from_errno (errno),
-               _("Error opening dir '%s': %s"),
-                 path, strerror (errno));
+               _("Error opening directory '%s': %s"),
+              path, strerror (errno));
 
   g_free (dir);
   return NULL;
@@ -74,17 +81,15 @@ g_dir_open (const gchar  *path,
  * g_dir_read_name:
  * @dir: a #GDir* created by g_dir_open()
  *
- * Iterator which delivers the next directory entries name
- * with each call. The '.' and '..' entries are omitted.
- *
- * BTW: using these functions will simplify porting of
- * your app, at least to Windows.
+ * Retrieves the name of the next entry in the directory.
+ * The '.' and '..' entries are omitted.
  *
- * Return value: The entries name or NULL if there are no 
- * more entries. Don't free this value!
+ * Return value: The entries name or %NULL if there are no 
+ *   more entries. The return value is owned by GLib and
+ *   must not be modified or freed.
  **/
 G_CONST_RETURN gchar*
-g_dir_read_name (GDir    *dir)
+g_dir_read_name (GDir *dir)
 {
   struct dirent *entry;
 
@@ -92,8 +97,8 @@ g_dir_read_name (GDir    *dir)
 
   entry = readdir (dir->dir);
   while (entry 
-         && (   0 == strcmp (entry->d_name, ".") 
-             || 0 == strcmp (entry->d_name, "..")))
+         && (0 == strcmp (entry->d_name, ".") ||
+             0 == strcmp (entry->d_name, "..")))
     entry = readdir (dir->dir);
 
   return entry->d_name;
@@ -119,18 +124,14 @@ g_dir_rewind (GDir *dir)
  * @dir: a #GDir* created by g_dir_open()
  *
  * Closes the directory and deallocates all related resources.
- *
- * Return value: TRUE on success, FALSE otherwise.
  **/
-gboolean
+void
 g_dir_close (GDir *dir)
 {
   int ret = 0;
 
   g_return_val_if_fail (dir != NULL, FALSE);
 
-  ret = closedir (dir->dir);
+  closedir (dir->dir);
   g_free (dir);
-
-  return !ret; 
 }
index 820619113b75a8084e9732b52ba421b175d00978..ff3358d4c9c5dfbe98e96054b030c3a9d39dc4df 100644 (file)
@@ -7,11 +7,12 @@ G_BEGIN_DECLS
 
 typedef struct _GDir GDir;
 
-GDir    *g_dir_open (const gchar *path, guint flags, GError **error);
-G_CONST_RETURN
-gchar   *g_dir_read_name (GDir *dir);
-void     g_dir_rewind (GDir *dir);
-gboolean g_dir_close (GDir *dir);
+GDir    *               g_dir_open      (const gchar  *path,
+                                        guint         flags,
+                                        GError      **error);
+G_CONST_RETURN gchar   *g_dir_read_name (GDir         *dir);
+void                    g_dir_rewind    (GDir         *dir);
+void                    g_dir_close     (GDir         *dir);
 
 G_END_DECLS