plotyy

% -*- texinfo -*-
% @deftypefn {Function File} {} plotyy (@var{x1}, @var{y1}, @var{x2}, @var{y2})
% @deftypefnx {Function File} {} plotyy (@dots{}, @var{fun})
% @deftypefnx {Function File} {} plotyy (@dots{}, @var{fun1}, @var{fun2})
% @deftypefnx {Function File} {} plotyy (@var{h}, @dots{})
% @deftypefnx {Function File} {[@var{ax}, @var{h1}, @var{h2}] =} plotyy (@dots{})
% Plots two sets of data with independent y-axes.  The arguments @var{x1} and
% @var{y1} define the arguments for the first plot and @var{x1} and @var{y2}
% for the second. 
%
% By default the arguments are evaluated with 
% @code{feval (@@plot, @var{x}, @var{y})}.  However the type of plot can be
% modified with the @var{fun} argument, in which case the plots are
% generated by @code{feval (@var{fun}, @var{x}, @var{y})}.  @var{fun} can be 
% a function handle, an inline function or a string of a function name.
%
% The function to use for each of the plots can be independently defined 
% with @var{fun1} and @var{fun2}.
%
% If given, @var{h} defines the principal axis in which to plot the @var{x1}
% and @var{y1} data.  The return value @var{ax} is a two element vector with
% the axis handles of the two plots.  @var{h1} and @var{h2} are handles to
% the objects generated by the plot commands.
%
% @example
% @group
% x = 0:0.1:2*pi; 
% y1 = sin (x);
% y2 = exp (x - 1);
% ax = plotyy (x, y1, x - 1, y2, @@plot, @@semilogy);
% xlabel ('X');
% ylabel (ax(1), 'Axis 1');
% ylabel (ax(2), 'Axis 2');
% @end group
% @end example
% @end deftypefn