diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index c5190c635c..6551ff6b90 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -2800,10 +2800,10 @@
      DEPENDS = "bar"
                     </literallayout>
                     The practical effect of the previous assignment is that
-                    all files installed by <filename>bar</filename> will be
-                    available in the appropriate staging sysroot given by the
+                    all files installed by bar will be available in the
+                    appropriate staging sysroot, given by the
                     <link linkend='var-STAGING_DIR'><filename>STAGING_DIR*</filename></link>
-                    variables by the time the
+                    variables, by the time the
                     <link linkend='ref-tasks-configure'><filename>do_configure</filename></link>
                     task for <filename>foo</filename> runs.
                     This mechanism is implemented by having