% -*- texinfo -*-
% @deftypefn {Function File} {} axis (@var{limits})
% Set axis limits for plots.
%
% The argument @var{limits} should be a 2, 4, or 6 element vector. The
% first and second elements specify the lower and upper limits for the x
% axis. The third and fourth specify the limits for the y-axis, and the
% fifth and sixth specify the limits for the z-axis.
%
% Without any arguments, @code{axis} turns autoscaling on.
%
% With one output argument, @code{x = axis} returns the current axes
%
% The vector argument specifying limits is optional, and additional
% string arguments may be used to specify various axis properties. For
% example,
%
% @example
% axis ([1, 2, 3, 4], 'square');
% @end example
%
% @noindent
% forces a square aspect ratio, and
%
% @example
% axis ('labely', 'tic');
% @end example
%
% @noindent
% turns tic marks on for all axes and tic mark labels on for the y-axis
% only.
%
% @noindent
% The following options control the aspect ratio of the axes.
%
% @table @code
% @item 'square'
% Force a square aspect ratio.
% @item 'equal'
% Force x distance to equal y-distance.
% @item 'normal'
% Restore the balance.
% @end table
%
% @noindent
% The following options control the way axis limits are interpreted.
%
% @table @code
% @item 'auto'
% Set the specified axes to have nice limits around the data
% or all if no axes are specified.
% @item 'manual'
% Fix the current axes limits.
% @item 'tight'
% Fix axes to the limits of the data (not implemented).
% @end table
%
% @noindent
% The option @code{'image'} is equivalent to @code{'tight'} and
% @code{'equal'}.
%
% @noindent
% The following options affect the appearance of tic marks.
%
% @table @code
% @item 'on'
% Turn tic marks and labels on for all axes.
% @item 'off'
% Turn tic marks off for all axes.
% @item 'tic[xyz]'
% Turn tic marks on for all axes, or turn them on for the
% specified axes and off for the remainder.
% @item 'label[xyz]'
% Turn tic labels on for all axes, or turn them on for the
% specified axes and off for the remainder.
% @item 'nolabel'
% Turn tic labels off for all axes.
% @end table
% Note, if there are no tic marks for an axis, there can be no labels.
%
% @noindent
% The following options affect the direction of increasing values on
% the axes.
%
% @table @code
% @item 'ij'
% Reverse y-axis, so lower values are nearer the top.
% @item 'xy'
% Restore y-axis, so higher values are nearer the top.
% @end table
%
% If an axes handle is passed as the first argument, then operate on
% this axes rather than the current axes.
% @end deftypefn