% -*- texinfo -*-
% @deftypefn {Function File} {} plot (@var{y})
% @deftypefnx {Function File} {} plot (@var{x}, @var{y})
% @deftypefnx {Function File} {} plot (@var{x}, @var{y}, @var{property}, @var{value}, @dots{})
% @deftypefnx {Function File} {} plot (@var{x}, @var{y}, @var{fmt})
% @deftypefnx {Function File} {} plot (@var{h}, @dots{})
% Produces two-dimensional plots. Many different combinations of
% arguments are possible. The simplest form is
%
% @example
% plot (@var{y})
% @end example
%
% @noindent
% where the argument is taken as the set of @var{y} coordinates and the
% @var{x} coordinates are taken to be the indices of the elements,
% starting with 1.
%
% To save a plot, in one of several image formats such as PostScript
% or PNG, use the @code{print} command.
%
% If more than one argument is given, they are interpreted as
%
% @example
% plot (@var{y}, @var{property}, @var{value}, @dots{})
% @end example
%
% @noindent
% or
%
% @example
% plot (@var{x}, @var{y}, @var{property}, @var{value}, @dots{})
% @end example
%
% @noindent
% or
%
% @example
% plot (@var{x}, @var{y}, @var{fmt}, @dots{})
% @end example
%
% @noindent
% and so on. Any number of argument sets may appear. The @var{x} and
% @var{y} values are interpreted as follows:
%
% @itemize @bullet
% @item
% If a single data argument is supplied, it is taken as the set of @var{y}
% coordinates and the @var{x} coordinates are taken to be the indices of
% the elements, starting with 1.
%
% @item
% If the @var{x} is a vector and @var{y} is a matrix, then
% the columns (or rows) of @var{y} are plotted versus @var{x}.
% (using whichever combination matches, with columns tried first.)
%
% @item
% If the @var{x} is a matrix and @var{y} is a vector,
% @var{y} is plotted versus the columns (or rows) of @var{x}.
% (using whichever combination matches, with columns tried first.)
%
% @item
% If both arguments are vectors, the elements of @var{y} are plotted versus
% the elements of @var{x}.
%
% @item
% If both arguments are matrices, the columns of @var{y} are plotted
% versus the columns of @var{x}. In this case, both matrices must have
% the same number of rows and columns and no attempt is made to transpose
% the arguments to make the number of rows match.
%
% If both arguments are scalars, a single point is plotted.
% @end itemize
%
% Multiple property-value pairs may be specified, but they must appear
% in pairs. These arguments are applied to the lines drawn by
% @code{plot}.
%
% If the @var{fmt} argument is supplied, it is interpreted as
% follows. If @var{fmt} is missing, the default gnuplot line style
% is assumed.
%
% @table @samp
% @item -
% Set lines plot style (default).
%
% @item .
% Set dots plot style.
%
% @item @var{n}
% Interpreted as the plot color if @var{n} is an integer in the range 1 to
% 6.
%
% @item @var{nm}
% If @var{nm} is a two digit integer and @var{m} is an integer in the
% range 1 to 6, @var{m} is interpreted as the point style. This is only
% valid in combination with the @code{@@} or @code{-@@} specifiers.
%
% @item @var{c}
% If @var{c} is one of @code{'k'} (black), @code{'r'} (red), @code{'g'}
% (green), @code{'b'} (blue), @code{'m'} (magenta), @code{'c'} (cyan),
% or @code{'w'} (white), it is interpreted as the line plot color.
%
% @item ';title;'
% Here @code{'title'} is the label for the key.
%
% @item +
% @itemx *
% @itemx o
% @itemx x
% @itemx ^
% Used in combination with the points or linespoints styles, set the point
% style.
% @end table
%
% The @var{fmt} argument may also be used to assign key titles.
% To do so, include the desired title between semi-colons after the
% formatting sequence described above, e.g., '+3;Key Title;'
% Note that the last semi-colon is required and will generate an error if
% it is left out.
%
% Here are some plot examples:
%
% @example
% plot (x, y, '@@12', x, y2, x, y3, '4', x, y4, '+')
% @end example
%
% This command will plot @code{y} with points of type 2 (displayed as
% @samp{+}) and color 1 (red), @code{y2} with lines, @code{y3} with lines of
% color 4 (magenta) and @code{y4} with points displayed as @samp{+}.
%
% @example
% plot (b, '*', 'markersize', 3)
% @end example
%
% This command will plot the data in the variable @code{b},
% with points displayed as @samp{*} with a marker size of 3.
%
% @example
% @group
% t = 0:0.1:6.3;
% plot (t, cos(t), '-;cos(t);', t, sin(t), '+3;sin(t);');
% @end group
% @end example
%
% This will plot the cosine and sine functions and label them accordingly
% in the key.
%
% If the first argument is an axis handle, then plot into these axes,
% rather than the current axis handle returned by @code{gca}.
% @seealso{semilogx, semilogy, loglog, polar, mesh, contour, bar,
% stairs, errorbar, xlabel, ylabel, title, print}
% @end deftypefn