diff --git a/gio/gasyncresult.c b/gio/gasyncresult.c
index 3d9848c13..b14669792 100644
--- a/gio/gasyncresult.c
+++ b/gio/gasyncresult.c
@@ -102,15 +102,15 @@
* always called, even in the case of a cancelled operation. On cancellation
* the result is a %G_IO_ERROR_CANCELLED error.
*
- * I/O
- * priority Many I/O-related asynchronous
- * operations have a priority parameter, which is used in certain
- * cases to determine the order in which operations are executed.
- * They are not used to determine system-wide I/O scheduling.
- * Priorities are integers, with lower numbers indicating higher priority.
- * It is recommended to choose priorities between %G_PRIORITY_LOW and
- * %G_PRIORITY_HIGH, with %G_PRIORITY_DEFAULT as a default.
- **/
+ *
+ * Many I/O-related asynchronous operations have a priority parameter,
+ * which is used in certain cases to determine the order in which
+ * operations are executed. They are not used to determine system-wide
+ * I/O scheduling. Priorities are integers, with lower numbers indicating
+ * higher priority. It is recommended to choose priorities between
+ * %G_PRIORITY_LOW and %G_PRIORITY_HIGH, with %G_PRIORITY_DEFAULT
+ * as a default.
+ */
typedef GAsyncResultIface GAsyncResultInterface;
G_DEFINE_INTERFACE (GAsyncResult, g_async_result, G_TYPE_OBJECT)
diff --git a/gio/gfile.c b/gio/gfile.c
index 9dab65bba..c24bf3854 100644
--- a/gio/gfile.c
+++ b/gio/gfile.c
@@ -137,12 +137,12 @@
* g_file_eject_mountable_with_operation() to eject a mountable file.
*
*
- * entity tag
+ *
* One notable feature of #GFiles are entity tags, or "etags" for
* short. Entity tags are somewhat like a more abstract version of the
- * traditional mtime, and can be used to quickly determine if the file has
- * been modified from the version on the file system. See the HTTP 1.1
- * specification
+ * traditional mtime, and can be used to quickly determine if the file
+ * has been modified from the version on the file system. See the
+ * HTTP 1.1 specification
* for HTTP Etag headers, which are a very similar concept.
*
**/