--- a/scripts/plot/xlim.m
+++ b/scripts/plot/xlim.m
@@ -23,18 +23,17 @@
 ## @deftypefnx {Function File} {} xlim ("auto")
 ## @deftypefnx {Function File} {} xlim ("manual")
 ## @deftypefnx {Function File} {} xlim (@var{hax}, @dots{})
-## Query or set the limits of the x-axis of the current plot.
+## Query or set the limits of the x-axis for the current plot.
 ##
 ## Called without arguments @code{xlim} returns the x-axis limits of the
 ## current plot.  With the input query @qcode{"mode"}, return the current
-## x-limit calculation mode which is either @qcode{"auto"} or
-## @qcode{"manual"}.
+## x-limit calculation mode which is either @qcode{"auto"} or @qcode{"manual"}.
 ##
 ## If passed a 2-element vector [@var{x_lo} @var{x_hi}], the limits of the
-## x-axis are set to these values.
+## x-axis are set to these values and the mode is set to @qcode{"manual"}.
 ##
-## The current plotting mode can be set by passing either @qcode{"auto"} or
-## @qcode{"manual"} as the argument.
+## The current plotting mode can be changed by using either @qcode{"auto"}
+## or @qcode{"manual"} as the argument.
 ##
 ## If the first argument @var{hax} is an axes handle, then operate on
 ## this axis rather than the current axes returned by @code{gca}.