Documentation accuracy fixes.

2007-12-02  A. Walton  <awalton@svn.gnome.org>

	* gfile.c:
	* gfileattribute.c:
	Documentation accuracy fixes.

svn path=/trunk/; revision=6014

diff --git a/gio/ChangeLog b/gio/ChangeLog
index 466ad5b..9271495 100644 (file)
--- a/gio/ChangeLog
+++ b/gio/ChangeLog
@@ -1,3 +1,9 @@
+2007-12-02  A. Walton  <awalton@svn.gnome.org>
+
+       * gfile.c:
+       * gfileattribute.c:
+       Documentation accuracy fixes.
+
 2007-12-01  Behdad Esfahbod  <behdad@gnome.org>
 
        * gioenumtypes.c.template: Fix typo.

diff --git a/gio/gfile.c b/gio/gfile.c
index f92ddfb..501cc8c 100644 (file)
--- a/gio/gfile.c
+++ b/gio/gfile.c
@@ -235,10 +235,10 @@ g_file_base_init (gpointer g_class)
  * g_file_is_native:
  * @file: input #GFile.
  *
- * Checks to see if a file is native to the system.
+ * Checks to see if a file is native to the platform.
  *
- * Returns: %TRUE if file is native. (If the file is native
- * to the system, e.g. located in file:///).
+ * Returns: %TRUE if file is native. (If the #GFile<!---->'s expressed in 
+ * the platform-native filename format, e.g. "C:\Windows", "/usr/bin/").
  **/
 gboolean
 g_file_is_native (GFile *file)
@@ -377,7 +377,7 @@ g_file_get_uri (GFile *file)
  * g_file_get_parse_name:
  * @file: input #GFile.
  *
- * Gets the parsed name for the #GFile.
+ * Gets the UTF-8 parsed name for the #GFile.
  *
  * Returns: a string containing the #GFile's parsed name, 
  *     or %NULL if given #GFile is invalid. The returned 

diff --git a/gio/gfileattribute.c b/gio/gfileattribute.c
index facdf38..d9492be 100644 (file)
--- a/gio/gfileattribute.c
+++ b/gio/gfileattribute.c
@@ -69,11 +69,8 @@
  * <row><entry>"std"</entry><entry>The "Standard" namespace. General file
  * information that any application may need should be put in this namespace. 
  * Examples include the file's name, type, and size.</entry></row> 
- * <row><entry>"etag"</entry><entry>The "Entity Tag" namespace. 
- * GIO use "entity tags" to quickly determine if a file has been modified
- * from the version on the file system. Entity tags are globally unique 
- * identifiers, and should always be sent with the current revision of a 
- * file. An example of a key in this namespace is "value", which contains 
+ * <row><entry>"etag"</entry><entry>The <link linkend="gfile-etag">"Entity Tag"</link> 
+ * namespace. Currently, the only key in this namespace is "value", which contains 
  * the value of the current entity tag.</entry></row>
  * <row><entry>"id"</entry><entry>The "Identification" namespace. This 
  * namespace is used by file managers and applications that list directories