Mercurial > hg > octave-max
changeset 6895:76e3d985ae56
[project @ 2007-09-13 18:22:38 by jwe]
line wrap: on
line diff
--- a/scripts/ChangeLog +++ b/scripts/ChangeLog @@ -1,3 +1,8 @@ +2007-09-13 John W. Eaton <jwe@octave.org> + + * plot/__default_colormap__.m: Delete. + * plot/Makefile (SOURCES): Remove from the list. + 2007-09-10 David Bateman <dbateman@free.fr> * plot/__go_draw_axes__.m: Allow gnuplot 4.0 with patches, but
--- a/scripts/image/colormap.m +++ b/scripts/image/colormap.m @@ -27,10 +27,11 @@ ## contain red, green, and blue intensities respectively. All entries ## should be between 0 and 1 inclusive. The new colormap is returned. ## -## @code{colormap ("default")} restores the default colormap (a gray scale -## colormap with 64 entries). The default colormap is returned. +## @code{colormap ("default")} restores the default colormap (the +## @code{jet} map with 64 entries). The default colormap is returned. ## ## With no arguments, @code{colormap} returns the current color map. +## @seealso{jet} ## @end deftypefn ## Author: Tony Richardson <arichard@stark.cc.oh.us> @@ -49,7 +50,7 @@ if (ischar (map)) if (strcmp (map, "default")) - map = __default_colormap__ (); + map = jet (64); else map = feval (map); endif
--- a/scripts/plot/Makefile.in +++ b/scripts/plot/Makefile.in @@ -23,7 +23,6 @@ SOURCES = \ __axis_label__.m \ __bar__.m \ - __default_colormap__.m \ __default_plot_options__.m \ __errcomm__.m \ __errplot__.m \
--- a/scripts/plot/__axis_label__.m +++ b/scripts/plot/__axis_label__.m @@ -17,10 +17,7 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- -## @deftypefn {Function File} {} __axis_label__ (@var{caller}, @var{text}) -## Utility function for @code{xlabel}, @code{ylabel}, and @code{zlabel}. -## @end deftypefn +## Undocumented internal function. ## Author: jwe
--- a/scripts/plot/__bar__.m +++ b/scripts/plot/__bar__.m @@ -17,11 +17,7 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- -## @deftypefn {Function File} {} __bar__ (@dots{}) -## Support function for @code{bar} and @code{hbar}. -## @seealso{bar, hbar} -## @end deftypefn +## Undocumented internal function. ## Author: jwe
deleted file mode 100644 --- a/scripts/plot/__default_colormap__.m +++ /dev/null @@ -1,33 +0,0 @@ -## Copyright (C) 2007 John W. Eaton -## -## This file is part of Octave. -## -## Octave is free software; you can redistribute it and/or modify it -## under the terms of the GNU General Public License as published by -## the Free Software Foundation; either version 2, or (at your option) -## any later version. -## -## Octave is distributed in the hope that it will be useful, but -## WITHOUT ANY WARRANTY; without even the implied warranty of -## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -## General Public License for more details. -## -## You should have received a copy of the GNU General Public License -## along with Octave; see the file COPYING. If not, write to the Free -## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA -## 02110-1301, USA. - -## -*- texinfo -*- -## @deftypefn {Function File} {} __default_colormap__ () -## Return the default colormap. -## @end deftypefn - -## Author: jwe - -function cmap = __default_colormap__ () - - gr = [0:63]'; - - cmap = [ gr, gr, gr ] / 63; - -endfunction
--- a/scripts/plot/__default_plot_options__.m +++ b/scripts/plot/__default_plot_options__.m @@ -17,11 +17,7 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- -## @deftypefn {Function File} {} __default_plot_options__ () -## Return a default options structure for __pltopt__. -## @seealso{__pltopt__} -## @end deftypefn +## Undocumented internal function. ## Author: jwe
--- a/scripts/plot/__errcomm__.m +++ b/scripts/plot/__errcomm__.m @@ -17,12 +17,7 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- -## @deftypefn {Function File} {} __errcomm__ (@var{args}) -## Common argument handling code for all error plots (errorbar, loglogerr, -## semilogyerr, semilogxerr). -## @seealso{errorbar, semilogxerr, semilogyerr, loglogerr, __pltopt__} -## @end deftypefn +## Undocumented internal function. ## Created: 20.02.2001 ## Author: Teemu Ikonen <tpikonen@pcu.helsinki.fi>
--- a/scripts/plot/__errplot__.m +++ b/scripts/plot/__errplot__.m @@ -17,17 +17,7 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- -## @deftypefn {Function File} {} __errplot__ (@var{args}) -## Really plot errorbar plots. User interface in function errorbar. -## -## @example -## __errplot__ (@var{arg1}, @var{arg2}, ..., @var{fmt}) -## @end example -## -## @seealso{semilogx, semilogy, loglog, polar, mesh, contour, __pltopt__, -## bar, stairs, errorbar, xlabel, ylabel, title} -## @end deftypefn +## Undocumented internal function. ## Created: 18.7.2000 ## Author: Teemu Ikonen <tpikonen@pcu.helsinki.fi>
--- a/scripts/plot/__gnuplot_version__.m +++ b/scripts/plot/__gnuplot_version__.m @@ -17,12 +17,11 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- -## @deftypefn {Function File} {@var{version} =} __gnuplot_version__ (@var{gplt_exe}) +## Undocumented internal function. + ## Return the version of gnuplot we are using. Note that we do not ## attempt to handle the case of the user switching to different ## versions of gnuplot during the same session. -## @end deftypefn function version = __gnuplot_version__ ()
--- a/scripts/plot/__go_close_all__.m +++ b/scripts/plot/__go_close_all__.m @@ -17,11 +17,7 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- -## @deftypefn {Function File} {} __go_close_all__ () -## Internal function to close all figures. -## @seealso{drawnow} -## @end deftypefn +## Undocumented internal function. ## Author: jwe
--- a/scripts/plot/__go_draw_axes__.m +++ b/scripts/plot/__go_draw_axes__.m @@ -17,10 +17,7 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- -## @deftypefn {Function File} {} __go_draw_axes__ (@var{axis_obj}, @var{plot_stream}) -## Display the axes @var{axis_obj} on @var{plot_stream}. -## @end deftypefn +## Undocumented internal function. ## Author: jwe
--- a/scripts/plot/__go_draw_figure__.m +++ b/scripts/plot/__go_draw_figure__.m @@ -17,10 +17,7 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- -## @deftypefn {Function File} {} __go_draw_figure__ (f) -## Display the figure @var{f}. -## @end deftypefn +## Undocumented internal function. ## Author: jwe
--- a/scripts/plot/__line__.m +++ b/scripts/plot/__line__.m @@ -17,12 +17,11 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- -## @deftypefn {Function File} {} __line__ (@var{p}, @var{x}, @var{y}) -## @deftypefnx {Function File} {} line (@var{p}, @var{x}, @var{y}, @var{z}) -## Create line object from @var{x} and @var{y} with parent @var{p}. +## Undocumented internal function. + +## __line__ (p, x, y, z) +## Create line object from x, y, and z with parent p. ## Return handle to line object. -## @end deftypefn ## Author: jwe
--- a/scripts/plot/__next_line_color__.m +++ b/scripts/plot/__next_line_color__.m @@ -17,10 +17,9 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- -## @deftypefn {Function File} {} __next_line_color__ (@var{reset}) +## Undocumented internal function. + ## Return the next line color in the rotation. -## @end deftypefn ## Author: jwe
--- a/scripts/plot/__patch__.m +++ b/scripts/plot/__patch__.m @@ -17,11 +17,11 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- -## @deftypefn {Function File} {} __patch__ (@var{p}, @var{x}, @var{y}, @var{c}) -## Create patch object from @var{x} and @var{y} with color @var{c} and parent @var{p}. +## Undocumented internal function. + +## __patch__ (p, x, y, c) +## Create patch object from x and y with color c and parent p. ## Return handle to patch object. -## @end deftypefn ## Author: Kai Habel
--- a/scripts/plot/__plr1__.m +++ b/scripts/plot/__plr1__.m @@ -17,9 +17,7 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- -## @deftypefn {Function File} {} __plr1__ (@var{h}, @var{theta}, @var{fmt}) -## @end deftypefn +## Undocumented internal function. ## Author: jwe
--- a/scripts/plot/__plr2__.m +++ b/scripts/plot/__plr2__.m @@ -17,9 +17,7 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- -## @deftypefn {Function File} {} __plr2__ (@var{h}, @var{theta}, @var{rho}, @var{fmt}) -## @end deftypefn +## Undocumented internal function. ## Author: jwe
--- a/scripts/plot/__plt1__.m +++ b/scripts/plot/__plt1__.m @@ -17,9 +17,7 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- -## @deftypefn {Function File} {} __plt1__ (@var{h}, @var{x1}, @var{options}, @var{properties}) -## @end deftypefn +## Undocumented internal function. ## Author: jwe
--- a/scripts/plot/__plt2__.m +++ b/scripts/plot/__plt2__.m @@ -17,9 +17,7 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- -## @deftypefn {Function File} {} __plt2__ (@var{h}, @var{x1}, @var{x2}, @var{options}, @var{properties}) -## @end deftypefn +## Undocumented internal function. ## Author: jwe
--- a/scripts/plot/__plt2mm__.m +++ b/scripts/plot/__plt2mm__.m @@ -17,9 +17,7 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- -## @deftypefn {Function File} {} __plt2mm__ (@var{h}, @var{x}, @var{y}, @var{options}, @var{properties}) -## @end deftypefn +## Undocumented internal function. ## Author: jwe
--- a/scripts/plot/__plt2mv__.m +++ b/scripts/plot/__plt2mv__.m @@ -17,9 +17,7 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- -## @deftypefn {Function File} {} __plt2mv__ (@var{h}, @var{x}, @var{y}, @var{options}, @var{properties}) -## @end deftypefn +## Undocumented internal function. ## Author: jwe
--- a/scripts/plot/__plt2ss__.m +++ b/scripts/plot/__plt2ss__.m @@ -17,9 +17,7 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- -## @deftypefn {Function File} {} __plt2ss__ (@var{h}, @var{x}, @var{y}, @var{options}, @var{properties}) -## @end deftypefn +## Undocumented internal function. ## Author: jwe
--- a/scripts/plot/__plt2vm__.m +++ b/scripts/plot/__plt2vm__.m @@ -17,9 +17,7 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- -## @deftypefn {Function File} {} __plt2vm__ (@var{h}, @var{x}, @var{y}, @var{options}, @var{properties}) -## @end deftypefn +## Undocumented internal function. ## Author: jwe
--- a/scripts/plot/__plt2vv__.m +++ b/scripts/plot/__plt2vv__.m @@ -17,9 +17,7 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- -## @deftypefn {Function File} {} __plt2vv__ (@var{h}, @var{x}, @var{y}, @var{options}, @var{properties}) -## @end deftypefn +## Undocumented internal function. ## Author: jwe
--- a/scripts/plot/__plt__.m +++ b/scripts/plot/__plt__.m @@ -17,9 +17,7 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- -## @deftypefn {Function File} {} __plt__ (@code{caller}, @dots{}) -## @end deftypefn +## Undocumented internal function. ## Author: jwe
--- a/scripts/plot/__plt_get_axis_arg__.m +++ b/scripts/plot/__plt_get_axis_arg__.m @@ -17,9 +17,7 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- -## @deftypefn {Function File} {[@var{h}, @var{remaining_args}} plot (@var{args}) -## @end deftypefn +## Undocumented internal function. ## Author: jwe
--- a/scripts/plot/__pltopt1__.m +++ b/scripts/plot/__pltopt1__.m @@ -17,11 +17,9 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- -## @deftypefn {Function File} {} __pltopt1__ (@var{caller}, @var{opt}) +## Undocumented internal function. + ## Really decode plot option strings. -## @seealso{__pltopt__} -## @end deftypefn ## Author: Rick Niles <niles@axp745.gsfc.nasa.gov> ## Adapted-By: jwe
--- a/scripts/plot/__pltopt__.m +++ b/scripts/plot/__pltopt__.m @@ -17,8 +17,10 @@ ## Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA ## 02110-1301, USA. -## -*- texinfo -*- +## Undocumented internal function. + ## @deftypefn {Function File} {} __pltopt__ (@var{caller}, @var{opt}) +## ## Decode plot option strings. ## ## @var{opt} can currently be some combination of the following: @@ -82,9 +84,6 @@ ## ## The legend may be fixed to include the name of the variable ## plotted in some future version of Octave. -## -## @seealso{__pltopt1__} -## @end deftypefn ## Author: jwe
--- a/scripts/plot/bar.m +++ b/scripts/plot/bar.m @@ -20,7 +20,7 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {@var{h} =} bar (@var{x}, @var{y}, @var{style}) ## @deftypefnx {Function File} {[@var{xb}, @var{yb}] =} bar (@dots{}) -## Given two vectors of x-y data, @code{bar} produces a bar graph. +## Given two vectors of x-y data, @code{bar} produce a bar graph. ## ## If only one argument is given, it is taken as a vector of y-values ## and the x coordinates are taken to be the indices of the elements. @@ -47,8 +47,7 @@ ## ## @noindent ## are equivalent. -## @seealso{hbar, plot, semilogx, semilogy, loglog, polar, mesh, contour, -## stairs, xlabel, ylabel, title} +## @seealso{hbar, plot} ## @end deftypefn ## Author: jwe
--- a/scripts/plot/barh.m +++ b/scripts/plot/barh.m @@ -20,7 +20,7 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {@var{h} =} barh (@var{x}, @var{y}, @var{style}) ## @deftypefnx {Function File} {[@var{xb}, @var{yb}] =} barh (@dots{}) -## Given two vectors of x-y data, @code{bar} produces a horizontal bar graph. +## Given two vectors of x-y data, @code{bar} produce a horizontal bar graph. ## ## If only one argument is given, it is taken as a vector of y-values ## and the x coordinates are taken to be the indices of the elements. @@ -47,8 +47,7 @@ ## ## @noindent ## are equivalent. -## @seealso{bar, plot, semilogx, semilogy, loglog, polar, mesh, contour, -## stairs, xlabel, ylabel, title} +## @seealso{bar, plot} ## @end deftypefn ## Author: jwe
--- a/scripts/plot/clf.m +++ b/scripts/plot/clf.m @@ -20,6 +20,7 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {} clf () ## Clear the current figure. +## @seealso{close, delete} ## @end deftypefn ## Author: jwe
--- a/scripts/plot/close.m +++ b/scripts/plot/close.m @@ -22,7 +22,10 @@ ## @deftypefnx {Command} {} close (@var{n}) ## @deftypefnx {Command} {} close all ## @deftypefnx {Command} {} close all hidden -## Close the plot window(s). +## Close figure window(s) by calling the function specified by the +## @code{"closerequestfcn"} property for each figure. By default, the +## function @code{closereq} is used. +## @seealso{closereq} ## @end deftypefn ## Author: jwe
--- a/scripts/plot/closereq.m +++ b/scripts/plot/closereq.m @@ -19,7 +19,9 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {} closereq () -## Close the current figure. +## Close the current figure and delete all graphics objects associated +## with it. +## @seealso{close, delete} ## @end deftypefn ## Author: jwe
--- a/scripts/plot/contour.m +++ b/scripts/plot/contour.m @@ -22,11 +22,10 @@ ## @deftypefnx {Function File} {@var{c} =} contour (@var{z}, @var{vn}) ## @deftypefnx {Function File} {@var{c} =} contour (@var{x}, @var{y}, @var{z}) ## @deftypefnx {Function File} {@var{c} =} contour (@var{x}, @var{y}, @var{z}, @var{vn}) -## ## Plot level curves (contour lines) of the matrix @var{z}, using the ## contour matrix @var{c} computed by @code{contourc} from the same -## arguments; see the latter for their interpretation. @var{c} is only -## returned if requested. For example: +## arguments; see the latter for their interpretation. The set of +## contour levels, @var{c}, is only returned if requested. For example: ## ## @example ## @group
--- a/scripts/plot/contourc.m +++ b/scripts/plot/contourc.m @@ -108,8 +108,8 @@ endif ## Now call __contourc__ for the real work... - c=__contourc__(x,y,z,vv); - if nargout==2, + c = __contourc__ (x, y, z, vv); + if (nargout == 2) lev = vv; endif
--- a/scripts/plot/drawnow.m +++ b/scripts/plot/drawnow.m @@ -19,7 +19,11 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {} drawnow () -## Display the current graphics. +## Update and display the current graphics. +## +## Octave automatically calls drawnow just before printing a prompt, +## when @code{sleep} or @code{pause} is called, or while waiting for +## command-line input. ## @end deftypefn ## Author: jwe
--- a/scripts/plot/errorbar.m +++ b/scripts/plot/errorbar.m @@ -49,11 +49,11 @@ ## corresponding columns of @var{x} and errorbars are drawn from ## the corresponding columns of error parameters. ## -## If @var{fmt} is missing, yerrorbars ("~") plot style -## is assumed. +## If @var{fmt} is missing, yerrorbars ("~") plot style is assumed. +## ## If the @var{fmt} argument is supplied, it is interpreted as in -## normal plots (See __pltopt__). In addition the following -## plot styles are supported by errorbar: +## normal plots. In addition the following plot styles are supported by +## errorbar: ## ## @table @samp ## @item ~ @@ -73,36 +73,36 @@ ## ## @item #~> ## Set boxxyerrorbars plot style. -## ## @end table ## ## Examples: ## ## @example -## errorbar(@var{x}, @var{y}, @var{ex}, ">") +## errorbar (@var{x}, @var{y}, @var{ex}, ">") ## @end example ## -## xerrorbar plot of @var{y} versus @var{x} with @var{x} errorbars drawn from -## @var{x}-@var{ex} to @var{x}+@var{ex}. +## produces an xerrorbar plot of @var{y} versus @var{x} with @var{x} +## errorbars drawn from @var{x}-@var{ex} to @var{x}+@var{ex}. ## ## @example -## errorbar(@var{x}, @var{y1}, @var{ey}, "~", @var{x}, @var{y2}, @var{ly}, @var{uy}) +## errorbar (@var{x}, @var{y1}, @var{ey}, "~", +## @var{x}, @var{y2}, @var{ly}, @var{uy}) ## @end example ## -## Two yerrorbar plots with @var{y1} and @var{y2} versus @var{x}. +## produces yerrorbar plots with @var{y1} and @var{y2} versus @var{x}. ## Errorbars for @var{y1} are drawn from @var{y1}-@var{ey} to ## @var{y1}+@var{ey}, errorbars for @var{y2} from @var{y2}-@var{ly} to ## @var{y2}+@var{uy}. ## ## @example -## errorbar(@var{x}, @var{y}, @var{lx}, @var{ux}, @var{ly}, @var{uy}, "~>") +## errorbar (@var{x}, @var{y}, @var{lx}, @var{ux}, +## @var{ly}, @var{uy}, "~>") ## @end example ## -## xyerrorbar plot of @var{y} versus @var{x} where @var{x} errorbars -## are drawn from @var{x}-@var{lx} to @var{x}+@var{ux} and @var{y} errorbars -## from @var{y}-@var{ly} to @var{y}+@var{uy}. -## @seealso{semilogx, semilogy, loglog, polar, mesh, contour, __pltopt__, -## bar, stairs, xlabel, ylabel, title} +## produces an xyerrorbar plot of @var{y} versus @var{x} in which +## @var{x} errorbars are drawn from @var{x}-@var{lx} to @var{x}+@var{ux} +## and @var{y} errorbars from @var{y}-@var{ly} to @var{y}+@var{uy}. +## @seealso{semilogxerr, semilogyerr, loglogerr} ## @end deftypefn ## Created: 18.7.2000
--- a/scripts/plot/figure.m +++ b/scripts/plot/figure.m @@ -18,10 +18,13 @@ ## 02110-1301, USA. ## -*- texinfo -*- -## @deftypefn {Function File} {} figure (@var{n}, @var{p}, @var{v}, @dots{}) +## @deftypefn {Function File} {} figure (@var{n}) +## @deftypefnx {Function File} {} figure (@var{n}, @var{property}, @var{value}, @dots{}) ## Set the current plot window to plot window @var{n}. If no arguments are -## specified, the next available window number is chosen. Parameters @var{p} -## and settings @var{v} can be given in pairs if @var{n} is specified. +## specified, the next available window number is chosen. +## +## Multiple property-value pairs may be specified for the figure, but they +## must appear in pairs. ## @end deftypefn ## Author: jwe, Bill Denney
--- a/scripts/plot/fplot.m +++ b/scripts/plot/fplot.m @@ -21,15 +21,15 @@ ## @deftypefn {Function File} {} fplot (@var{fn}, @var{limits}) ## @deftypefnx {Function File} {} fplot (@var{fn}, @var{limits}, @var{tol}) ## @deftypefnx {Function File} {} fplot (@var{fn}, @var{limits}, @var{n}) -## @deftypefnx {Function File} {} fplot (@dots{}, @var{LineSpec}) +## @deftypefnx {Function File} {} fplot (@dots{}, @var{fmt}) ## Plot a function @var{fn}, within the defined limits. @var{fn} ## an be either a string, a function handle or an inline function. ## The limits of the plot are given by @var{limits} of the form ## @code{[@var{xlo}, @var{xhi}]} or @code{[@var{xlo}, @var{xhi}, ## @var{ylo}, @var{yhi}]}. @var{tol} is the default tolerance to use for the ## plot, and if @var{tol} is an integer it is assumed that it defines the -## number points to use in the plot. The @var{LineSpec} is passed to the plot -## command. +## number points to use in the plot. The @var{fmt} argument is passed +## to the plot command. ## ## @example ## fplot ("cos", [0, 2*pi])
--- a/scripts/plot/gca.m +++ b/scripts/plot/gca.m @@ -19,7 +19,21 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {} gca () -## Return the current axis handle. +## Return a handle to the current axis object. If no axis object +## exists, create one and return its handle. The handle may then be +## used to examine or set properties of the axes. For example, +## +## @example +## @group +## ax = gca (); +## set (ax, "position", [0.5, 0.5, 0.5, 0.5]); +## @end group +## @end example +## +## @noindent +## creates an empty axes object, then changes its location and size in +## the figure window. +## @seealso{get, set} ## @end deftypefn ## Author: jwe
--- a/scripts/plot/gcf.m +++ b/scripts/plot/gcf.m @@ -19,7 +19,23 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {} gcf () -## Return the current figure handle. +## Return the current figure handle. If a figure does not exist, create +## one and return its handle. The handle may then be used to examine or +## set properties of the figure. For example, +## +## @example +## @group +## fplot (@@sin, [-10, 10]); +## fig = gcf (); +## set (fig, "visible", "off"); +## @end group +## @end example +## +## @noindent +## plots a sine wave, finds the handle of the current figure, and then +## makes that figure invisible. Setting the visible property of the +## figure to @code{"on"} will cause it to be displayed again. +## @seealso{get, set} ## @end deftypefn ## Author: jwe, Bill Denney
--- a/scripts/plot/grid.m +++ b/scripts/plot/grid.m @@ -24,12 +24,11 @@ ## The argument may be either @code{"on"} or @code{"off"}. If it is ## omitted, the current grid state is toggled. ## -## If @var{arg} is @code{"minor"} then the minor grid is toggled. When +## If @var{arg} is @code{"minor"} then the minor grid is toggled. When ## using a minor grid a second argument @var{arg2} is allowed, which can ## be either @code{"on"} or @code{"off"} to explicitly set the state of ## the minor grid. -## @seealso{plot, semilogx, semilogy, loglog, polar, mesh, contour, -## bar, stairs, xlabel, ylabel, title} +## @seealso{plot} ## @end deftypefn ## Author: jwe
--- a/scripts/plot/isfigure.m +++ b/scripts/plot/isfigure.m @@ -19,8 +19,8 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {} isfigure (@var{h}) -## Return 1 if @var{h} is a graphics handle that contains a figure -## object and 0 otherwise. +## Return true if @var{h} is a graphics handle that contains a figure +## object and false otherwise. ## @end deftypefn ## Author: jwe
--- a/scripts/plot/ishold.m +++ b/scripts/plot/ishold.m @@ -19,8 +19,8 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {} ishold -## Return 1 if the next line will be added to the current plot, or 0 if -## the plot device will be cleared before drawing the next line. +## Return true if the next line will be added to the current plot, or +## false if the plot device will be cleared before drawing the next line. ## @end deftypefn function retval = ishold ()
--- a/scripts/plot/legend.m +++ b/scripts/plot/legend.m @@ -27,13 +27,14 @@ ## @deftypefnx {Function File} {} legend (@var{cell}, @var{pos}) ## @deftypefnx {Function File} {} legend ('@var{func}') ## -## Legend puts a legend on the current plot using the specified strings -## as labels. Use independant strings (@var{st1}, @var{st2}, @dots{}), a -## matrix of strings (@var{matstr}), or a cell array of strings (@var{cell}) to -## specify legends. Legend works on line graphs, bar graphs, etc. -## Be sure to call plot before calling legend. +## Display a legend for the current axes using the specified strings +## as labels. Legend entries may be specified as individual character +## string arguments, a character array, or a cell array of character +## strings. Legend works on line graphs, bar graphs, etc. A plot must +## exist before legend is called. ## -## @var{pos} optionally places the legend in the specified location: +## The optional parameter @var{pos} specifies the location of the legend +## as follows: ## ## @multitable @columnfractions 0.1 0.1 0.8 ## @item @tab -1 @tab @@ -53,18 +54,18 @@ ## Some specific functions are directely avaliable using @var{func}: ## ## @table @code -## @item show +## @item "show" ## Show legends from the plot -## @item hide +## @item "hide" ## @itemx off ## Hide legends from the plot -## @item boxon +## @item "boxon" ## Draw a box around legends -## @item boxoff +## @item "boxoff" ## Withdraw the box around legends -## @item left +## @item "left" ## Text is to the left of the keys -## @item right +## @item "right" ## Text is to the right of the keys ## @end table ## @end deftypefn
--- a/scripts/plot/line.m +++ b/scripts/plot/line.m @@ -21,9 +21,13 @@ ## @deftypefn {Function File} {} line () ## @deftypefnx {Function File} {} line (@var{x}, @var{y}) ## @deftypefnx {Function File} {} line (@var{x}, @var{y}, @var{z}) -## @deftypefnx {Function File} {} line (@var{x}, @var{y}, @var{z}, @var{opts}) +## @deftypefnx {Function File} {} line (@var{x}, @var{y}, @var{z}, @var{property}, @var{value}, @dots{}) ## Create line object from @var{x} and @var{y} and insert in current -## axes object. Return handle to line object. +## axes object. Return a handle (or vector of handles) to the line +## objects created. +## +## Multiple property-value pairs may be specified for the line, but they +## must appear in pairs. ## @end deftypefn ## Author: jwe
--- a/scripts/plot/loglog.m +++ b/scripts/plot/loglog.m @@ -19,11 +19,10 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {} loglog (@var{args}) -## Make a two-dimensional plot using log scales for both axes. See the -## description of @code{plot} for a description of the arguments that -## @code{loglog} will accept. -## @seealso{plot, semilogy, loglog, polar, mesh, contour, bar, stairs, -## xlabel, ylabel, title} +## Produce a two-dimensional plot using log scales for both axes. See +## the description of @code{plot} for a description of the arguments +## that @code{loglog} will accept. +## @seealso{plot, semilogx, semilogy} ## @end deftypefn ## Author: jwe
--- a/scripts/plot/loglogerr.m +++ b/scripts/plot/loglogerr.m @@ -19,8 +19,8 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {} loglogerr (@var{args}) -## This function produces two-dimensional plots on double logarithm axis -## with errorbars. Many different combinations of arguments are possible. +## Produce two-dimensional plots on double logarithm axis with +## errorbars. Many different combinations of arguments are possible. ## The most used form is ## ## @example @@ -32,8 +32,7 @@ ## with errors in the @var{y}-scale defined by @var{ey} and the plot ## format defined by @var{fmt}. See errorbar for available formats and ## additional information. -## @seealso{errorbar, semilogxerr, semilogyerr, polar, mesh, contour, -## __pltopt__, bar, stairs, xlabel, ylabel, title} +## @seealso{errorbar, semilogxerr, semilogyerr} ## @end deftypefn ## Created: 20.2.2001
--- a/scripts/plot/ndgrid.m +++ b/scripts/plot/ndgrid.m @@ -20,10 +20,11 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {[@var{y1}, @var{y2}, @dots{}, @var{y}n] =} ndgrid (@var{x1}, @var{x2}, @dots{}, @var{x}n) ## @deftypefnx {Function File} {[@var{y1}, @var{y2}, @dots{}, @var{y}n] =} ndgrid (@var{x}) -## Given n vectors @var{x1}, @dots{} @var{x}n, ndgrid returns n arrays of dimension n. -## The elements of the ith output argument contains the elements of the vector -## @var{x}i repeated over all dimensions different from the ith dimension. -## Calling ndgrid with only one input argument @var{x} is equivalent of calling ndgrid with +## Given n vectors @var{x1}, @dots{} @var{x}n, @code{ndgrid} returns +## n arrays of dimension n. The elements of the ith output argument +## contains the elements of the vector @var{x}i repeated over all +## dimensions different from the ith dimension. Calling ndgrid with +## only one input argument @var{x} is equivalent of calling ndgrid with ## all n input arguments equal to @var{x}: ## ## [@var{y1}, @var{y2}, @dots{}, @var{y}n] = ndgrid (@var{x}, @dots{}, @var{x})
--- a/scripts/plot/newplot.m +++ b/scripts/plot/newplot.m @@ -19,6 +19,8 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {} newplot () +## Prepare graphics engine to produce a new plot. This function should +## be called at the beginning of all high-level plotting functions. ## @end deftypefn function newplot ()
--- a/scripts/plot/orient.m +++ b/scripts/plot/orient.m @@ -19,9 +19,9 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {} orient (@var{orientation}) -## Set default print orientation. Valid values for @var{orientation} -## include @code{"landscape"} and @code{"portrait"}. If called with no -## arguments, return the default print orientation. +## Set the default print orientation. Valid values for +## @var{orientation} include @code{"landscape"} and @code{"portrait"}. +## If called with no arguments, return the default print orientation. ## @end deftypefn ## Author: Paul Kienzle
--- a/scripts/plot/patch.m +++ b/scripts/plot/patch.m @@ -21,10 +21,12 @@ ## @deftypefn {Function File} {} patch () ## @deftypefnx {Function File} {} patch (@var{x}, @var{y}, @var{c}) ## @deftypefnx {Function File} {} patch (@var{x}, @var{y}, @var{c}, @var{opts}) -## Create patch object from @var{x} and @var{y} with color @var{c} and insert in current -## axes object. Return handle to patch object. -## For an uniform colored patch, @var{c} can be given as [r, g, b]-vector, scalar value refering -## to the current colormap, or string value (e.g. "r" or "red"). +## Create patch object from @var{x} and @var{y} with color @var{c} and +## insert in the current axes object. Return handle to patch object. +## +## For a uniform colored patch, @var{c} can be given as an RGB vector, +## scalar value referring to the current colormap, or string value (for +## example, "r" or "red"). ## @end deftypefn ## Author: jwe
--- a/scripts/plot/peaks.m +++ b/scripts/plot/peaks.m @@ -50,8 +50,9 @@ ## @seealso{mesh} ## @end deftypefn -## Expression for peaks function was taken from the following paper: -## http://www.control.hut.fi/Kurssit/AS-74.115/Material/GENALGgoga.pdf +## Expression for the peaks function was taken from the following paper: +## http://www.control.hut.fi/Kurssit/AS-74.115/Material/GENALGgoga.pdf + function [X_out, Y_out, Z_out] = peaks (x, y) if nargin == 0
--- a/scripts/plot/plot.m +++ b/scripts/plot/plot.m @@ -18,9 +18,13 @@ ## 02110-1301, USA. ## -*- texinfo -*- -## @deftypefn {Function File} {} plot (@var{args}) -## This function produces two-dimensional plots. Many different -## combinations of arguments are possible. The simplest form is +## @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}) @@ -37,20 +41,26 @@ ## If more than one argument is given, they are interpreted as ## ## @example -## plot (@var{x}, @var{y}, @var{fmt}, @dots{}) +## plot (@var{y}, @var{property}, @var{value}, @dots{}) ## @end example ## ## @noindent -## or as +## or ## ## @example ## plot (@var{x}, @var{y}, @var{property}, @var{value}, @dots{}) ## @end example ## ## @noindent -## where @var{y}, @var{fmt}, @var{property} and @var{value} are optional, -## and any number of argument sets may appear. The @var{x} and @var{y} -## values are interpreted as follows: +## 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 @@ -81,6 +91,10 @@ ## 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. @@ -123,28 +137,12 @@ ## style. ## @end table ## -## The color line styles have the following meanings on terminals that -## support color. -## -## @example -## Number Gnuplot colors (lines)points style -## 1 red * -## 2 green + -## 3 blue o -## 4 magenta x -## 5 cyan house -## 6 brown there exists -## @end example -## -## The @var{fmt} argument can also be used to assign key titles. +## 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. ## -## If a @var{property} is given it must be followed by @var{value}. The -## property value pairs are applied to the lines drawn by @code{plot}. -## ## Here are some plot examples: ## ## @example @@ -172,8 +170,8 @@ ## ## 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, __pltopt__ -## bar, stairs, errorbar, xlabel, ylabel, title, print} +## @seealso{semilogx, semilogy, loglog, polar, mesh, contour, bar, +## stairs, errorbar, xlabel, ylabel, title, print} ## @end deftypefn ## Author: jwe
--- a/scripts/plot/plot3.m +++ b/scripts/plot/plot3.m @@ -19,30 +19,30 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {} plot3 (@var{args}) -## -## This function produces three-dimensional plots. Many different -## combinations of arguments are possible. The simplest form is +## Produce three-dimensional plots. Many different combinations of +## arguments are possible. The simplest form is ## ## @example ## plot3 (@var{x}, @var{y}, @var{z}) ## @end example ## ## @noindent -## where the arguments are taken to be the vertices of the points to be -## plotted in three dimensions. If all arguments are vectors of the same -## length, then a single continuous line is drawn. If all arguments are -## matrices, then each column of the matrices is treated as a seperate -## line. No attempt is made to transpose the arguments to make the -## number of rows match. +## in which the arguments are taken to be the vertices of the points to +## be plotted in three dimensions. If all arguments are vectors of the +## same length, then a single continuous line is drawn. If all arguments +## are matrices, then each column of the matrices is treated as a +## seperate line. No attempt is made to transpose the arguments to make +## the number of rows match. ## -## Additionally, only two arguments can be given as +## If only two arguments are given, as ## ## @example ## plot3 (@var{x}, @var{c}) ## @end example ## -## where the real and imaginary parts of the second argument are used as -## the @var{y} and @var{z} coordinates, respectively. +## @noindent +## the real and imaginary parts of the second argument are used +## as the @var{y} and @var{z} coordinates, respectively. ## ## If only one argument is given, as ## @@ -50,44 +50,37 @@ ## plot3 (@var{c}) ## @end example ## +## @noindent ## the real and imaginary parts of the argument are used as the @var{y} ## and @var{z} values, and they are plotted versus their index. ## -## To save a plot, in one of several image formats such as PostScript -## or PNG, use the @code{print} command. -## -## See @code{__pltopt__} for a description of the optional format -## argument. -## -## Arguments can also be given in groups of three as +## Arguments may also be given in groups of three as ## ## @example ## plot3 (@var{x1}, @var{y1}, @var{z1}, @var{x2}, @var{y2}, @var{z2}, @dots{}) ## @end example ## ## @noindent -## where each set of three arguments is treated as a seperate line or +## in which each set of three arguments is treated as a seperate line or ## set of lines in three dimensions. ## -## To plot multiple one- or two-argument groups, separate each group with an -## empty format string, as +## To plot multiple one- or two-argument groups, separate each group +## with an empty format string, as ## ## @example -## plot3 (@var{x1}, @var{c1}, '', @var{c2}, '', @dots{}) +## plot3 (@var{x1}, @var{c1}, "", @var{c2}, "", @dots{}) ## @end example ## -## An example of the use of plot3 is +## An example of the use of @code{plot3} is ## ## @example ## @group ## z = [0:0.05:5]; -## plot3(cos(2*pi*z), sin(2*pi*z), z, ";helix;"); -## plot3(z, exp(2i*pi*z), ";complex sinusoid;"); +## plot3 (cos(2*pi*z), sin(2*pi*z), z, ";helix;"); +## plot3 (z, exp(2i*pi*z), ";complex sinusoid;"); ## @end group ## @end example -## -## @seealso{plot, semilogx, semilogy, loglog, polar, mesh, contour, __pltopt__ -## bar, stairs, errorbar, xlabel, ylabel, title, print} +## @seealso{plot} ## @end deftypefn ## Author: Paul Kienzle
--- a/scripts/plot/polar.m +++ b/scripts/plot/polar.m @@ -23,8 +23,7 @@ ## @var{rho}. ## ## The optional third argument specifies the line type. -## @seealso{plot, semilogx, semilogy, loglog, mesh, contour, bar, -## stairs, xlabel, ylabel, title} +## @seealso{plot} ## @end deftypefn ## Author: jwe
--- a/scripts/plot/print.m +++ b/scripts/plot/print.m @@ -20,7 +20,6 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {} print (@var{filename}, @var{options}) -## ## Print a graph, or save it to a file ## ## @var{filename} defines the file name of the output file. If no
--- a/scripts/plot/semilogx.m +++ b/scripts/plot/semilogx.m @@ -19,11 +19,10 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {} semilogx (@var{args}) -## Make a two-dimensional plot using a log scale for the @var{x} axis. See -## the description of @code{plot} for a description of the arguments -## that @code{semilogx} will accept. -## @seealso{plot, semilogy, loglog, polar, mesh, contour, bar, stairs, -## xlabel, ylabel, title} +## Produce a two-dimensional plot using a log scale for the @var{x} +## axis. See the description of @code{plot} for a description of the +## arguments that @code{semilogx} will accept. +## @seealso{plot, semilogy, loglog} ## @end deftypefn ## Author: jwe
--- a/scripts/plot/semilogxerr.m +++ b/scripts/plot/semilogxerr.m @@ -19,9 +19,9 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {} semilogxerr (@var{args}) -## This function produces two-dimensional plots on a semilogarithm axis -## with errorbars. Many different combinations of arguments are possible. -## The most used form is +## Produce two-dimensional plots on a semilogarithm axis with errorbars. +## Many different combinations of arguments are possible. The most used +## form is ## ## @example ## semilogxerr (@var{x}, @var{y}, @var{ey}, @var{fmt}) @@ -32,8 +32,7 @@ ## with errors in the @var{y}-scale defined by @var{ey} and the plot ## format defined by @var{fmt}. See errorbar for available formats and ## additional information. -## @seealso{errorbar, loglogerr semilogyerr, polar, mesh, contour, __pltopt__, -## bar, stairs, xlabel, ylabel, title} +## @seealso{errorbar, loglogerr semilogyerr} ## @end deftypefn ## Created: 20.2.2001
--- a/scripts/plot/semilogy.m +++ b/scripts/plot/semilogy.m @@ -19,11 +19,10 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {} semilogy (@var{args}) -## Make a two-dimensional plot using a log scale for the @var{y} axis. See -## the description of @code{plot} for a description of the arguments -## that @code{semilogy} will accept. -## @seealso{plot, semilogx, loglog, polar, mesh, contour, bar, stairs, -## xlabel, ylabel, title} +## Produce a two-dimensional plot using a log scale for the @var{y} +## axis. See the description of @code{plot} for a description of the +## arguments that @code{semilogy} will accept. +## @seealso{plot, semilogx, loglog} ## @end deftypefn ## Author: jwe
--- a/scripts/plot/semilogyerr.m +++ b/scripts/plot/semilogyerr.m @@ -19,9 +19,9 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {} semilogyerr (@var{args}) -## This function produces two-dimensional plots on a semilogarithm axis -## with errorbars. Many different combinations of arguments are possible. -## The most used form is +## Produce two-dimensional plots on a semilogarithm axis with errorbars. +## Many different combinations of arguments are possible. The most used +## form is ## ## @example ## semilogyerr (@var{x}, @var{y}, @var{ey}, @var{fmt}) @@ -30,10 +30,9 @@ ## @noindent ## which produces a semi-logarithm plot of @var{y} versus @var{x} ## with errors in the @var{y}-scale defined by @var{ey} and the plot -## format defined by @var{fmt}. See errorbar for available formats and +## format defined by @var{fmt}. See errorbar for available formats and ## additional information. -## @seealso{errorbar, loglogerr semilogxerr, polar, mesh, contour, __pltopt__, -## bar, stairs, xlabel, ylabel, title} +## @seealso{errorbar, loglogerr semilogxerr} ## @end deftypefn ## Created: 20.2.2001
--- a/scripts/plot/shg.m +++ b/scripts/plot/shg.m @@ -19,11 +19,9 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {} shg -## ## Show the graph window. Currently, this is the same as executing ## @code{drawnow}. -## @seealso{plot, semilogx, semilogy, loglog, polar, mesh, contour, -## bar, stairs, xlabel, ylabel} +## @seealso{drawnow, figure} ## @end deftypefn ## Author: jwe
--- a/scripts/plot/sombrero.m +++ b/scripts/plot/sombrero.m @@ -19,11 +19,13 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {} sombrero (@var{n}) -## Draw a `sombrero' in three dimensions using @var{n} grid lines. The -## function plotted is +## Produce the familiar three-dimensional sombrero plot using @var{n} +## grid lines. If @var{n} is omitted, a value of 41 is assumed. +## +## The function plotted is ## ## @example -## z = sin (sqrt (x^2 + y^2)) / (sqrt (x^2 + y^2)) +## z = sin (sqrt (x^2 + y^2)) / (sqrt (x^2 + y^2)) ## @end example ## @seealso{mesh, meshgrid} ## @end deftypefn
--- a/scripts/plot/stairs.m +++ b/scripts/plot/stairs.m @@ -19,7 +19,7 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {} stairs (@var{x}, @var{y}) -## Given two vectors of x-y data, bar produces a `stairstep' plot. +## Produce a stairstep plot. The arguments may be vectors or matrices. ## ## If only one argument is given, it is taken as a vector of y-values ## and the x coordinates are taken to be the indices of the elements. @@ -35,8 +35,10 @@ ## and ## ## @example +## @group ## [xs, ys] = stairs (x, y); ## plot (xs, ys); +## @end group ## @end example ## ## @noindent
--- a/scripts/plot/stem.m +++ b/scripts/plot/stem.m @@ -21,7 +21,7 @@ ## @deftypefn {Function File} {@var{h} =} stem (@var{x}, @var{y}, @var{linespec}) ## Plot a stem graph and return the handles of the line and marker ## objects used to draw the stems. The default color is @code{"r"} -## (red). The default line style is @code{"-"} and the default marker is +## (red). The default line style is @code{"-"} and the default marker is ## @code{"o"}. ## ## For example, @@ -87,7 +87,6 @@ ## row holds the marker handles). ## ## Color definitions with rgb-triples are not valid! -## ## @seealso{bar, barh, plot} ## @end deftypefn
--- a/scripts/plot/text.m +++ b/scripts/plot/text.m @@ -20,9 +20,11 @@ ## -*- texinfo -*- ## @deftypefn {Function File} {@var{h} =} text (@var{x}, @var{y}, @var{label}) ## @deftypefnx {Function File} {@var{h} =} text (@var{x}, @var{y}, @var{z}, @var{label}) +## @deftypefnx {Function File} {@var{h} =} text (@var{x}, @var{y}, @var{label}, @var{p1}, @var{v1}, @dots{}) +## @deftypefnx {Function File} {@var{h} =} text (@var{x}, @var{y}, @var{z}, @var{label}, @var{p1}, @var{v1}, @dots{}) ## Create a text object with text @var{label} at position @var{x}, -## @var{y}, @var{z} on the current axes. The label may be followed by -## property-value pairs. +## @var{y}, @var{z} on the current axes. Property-value pairs following +## @var{label} may be used to specify the appearance of the text. ## @end deftypefn ## Author: jwe
--- a/scripts/plot/xlabel.m +++ b/scripts/plot/xlabel.m @@ -21,7 +21,7 @@ ## @deftypefn {Function File} {} xlabel (@var{string}) ## @deftypefnx {Function File} {} ylabel (@var{string}) ## @deftypefnx {Function File} {} zlabel (@var{string}) -## Specify x, y, and z axis labels for the plot. +## Specify x, y, and z axis labels for the current figure. ## @seealso{plot, semilogx, semilogy, loglog, polar, mesh, contour, ## bar, stairs, ylabel, title} ## @end deftypefn