[gtk+] gtk-builder-tool: Improve docs

[Matthias Clasen <matthiasc src gnome org>]

commit da3f2eea7c0601b61209722fe897466afba5010c
Author: Matthias Clasen <mclasen redhat com>
Date:   Sat May 2 10:12:54 2015 -0400

    gtk-builder-tool: Improve docs

 docs/reference/gtk/gtk-builder-tool.xml |   10 +++++++---
 1 files changed, 7 insertions(+), 3 deletions(-)
---
diff --git a/docs/reference/gtk/gtk-builder-tool.xml b/docs/reference/gtk/gtk-builder-tool.xml
index a06a0af..f89c8e1 100644
--- a/docs/reference/gtk/gtk-builder-tool.xml
+++ b/docs/reference/gtk/gtk-builder-tool.xml
@@ -40,6 +40,10 @@
   <command>gtk-builder-tool</command> can perform various operations
   on GtkBuilder .ui files.
 </para>
+<para>
+  You should always test the modified .ui files produced by gtk-builder-tool
+  before using them in production.
+</para>
 </refsect1>
 
 <refsect1><title>Commands</title>
@@ -47,16 +51,16 @@
   <variablelist>
     <varlistentry>
     <term><option>validate</option></term>
-      <listitem><para>Validate the .ui file and report errors to stderr.</para></listitem>
+      <listitem><para>Validates the .ui file and report errors to stderr.</para></listitem>
     </varlistentry>
     <varlistentry>
     <term><option>simplify</option></term>
-      <listitem><para>Simplify the .ui file by removing properties that
+      <listitem><para>Simplifies the .ui file by removing properties that
       are set to their default values and write the resulting XML to stdout.</para></listitem>
     </varlistentry>
     <varlistentry>
     <term><option>enumerate</option></term>
-      <listitem><para>List all the named objects that are created in the .ui file.</para></listitem>
+      <listitem><para>Lists all the named objects that are created in the .ui file.</para></listitem>
     </varlistentry>
   </variablelist>
 </refsect1>