% -*- texinfo -*-
% @deftypefn {Function File} {} subplot (@var{rows}, @var{cols}, @var{index})
% @deftypefnx {Function File} {} subplot (@var{rcn})
% Set up a plot grid with @var{cols} by @var{rows} subwindows and plot
% in location given by @var{index}.
%
% If only one argument is supplied, then it must be a three digit value
% specifying the location in digits 1 (rows) and 2 (columns) and the plot
% index in digit 3.
%
% The plot index runs row-wise. First all the columns in a row are filled
% and then the next row is filled.
%
% For example, a plot with 2 by 3 grid will have plot indices running as
% follows:
% @tex
% \vskip 10pt
% \hfil\vbox{\offinterlineskip\hrule
% \halign{\vrule%&\qquad\hfil%\hfil\qquad\vrule\cr
% height13pt&1&2&3\cr height12pt&&\cr\noalign{\hrule}
% height13pt&4&5&6\cr height12pt&&\cr\noalign{\hrule}}}
% \hfil
% \vskip 10pt
% @end tex
% @ifnottex
% @display
% @example
% @group
%
% +-----+-----+-----+
% | 1 | 2 | 3 |
% +-----+-----+-----+
% | 4 | 5 | 6 |
% +-----+-----+-----+
% @end group
% @end example
% @end display
% @end ifnottex
% @seealso{plot}
% @end deftypefn