diff --git a/docs/reference/gio/gio.xml b/docs/reference/gio/gio.xml
index f2635d0b3..c348c43e5 100644
--- a/docs/reference/gio/gio.xml
+++ b/docs/reference/gio/gio.xml
@@ -374,7 +374,7 @@
,
- Monitor the file directly. This allows to capture changes made via hardlinks.
+ Monitor the file directly. This allows changes made via hardlinks to be captured.,
@@ -599,7 +599,7 @@
VALUE
- Allows to set a file attribute on a file.
+ Sets a file attribute on a file.File attributes can be specified with their GIO name, e.g
standard::icon. Note that not all GIO file attributes are writable.
Use the --query-writable option of the info command to list