% -*- texinfo -*-
% @deftypefn {Function File} {@var{xl} =} xlim
% @deftypefnx {Function File} {} xlim (@var{xl})
% @deftypefnx {Function File} {@var{m} =} xlim ('mode')
% @deftypefnx {Function File} {} xlim (@var{m})
% @deftypefnx {Function File} {} xlim (@var{h}, @dots{})
% Get or set the limits of the x-axis of the current plot. Called without
% arguments @code{xlim} returns the x-axis limits of the current plot.
% If passed a two element vector @var{xl}, the limits of the x-axis are set
% to this value.
%
% The current mode for calculation of the x-axis can be returned with a
% call @code{xlim ('mode')}, and can be either 'auto' or 'manual'. The
% current plotting mode can be set by passing either 'auto' or 'manual'
% as the argument.
%
% If passed an handle as the first argument, then operate on this handle
% rather than the current axes handle.
% @seealso{ylim, zlim, set, get, gca}
% @end deftypefn