[Pkg-octave-devel] Bug#398935: octave2.9: doc bug in plot.m

[Francesco Potorti`]

Package: octave2.9
Version: 2.9.9-5
Severity: minor
File: /usr/share/octave/2.9.9/m/plot/plot.m

This is a long-standing documentation bug in Octave, and applies to
octave 2.1 as well.

Here is a patch to plot.m.  The first part corrects the bug.  The second
part simplifies reading the color keys.

diff -pu /tmp/plot.m /tmp/plot.patched.m
--- /tmp/plot.m	2006-11-16 16:57:38.000000000 +0100
+++ /tmp/plot.patched.m	2006-11-16 17:08:02.000000000 +0100
@@ -52,13 +52,13 @@
 ## the elements, starting with 1.
 ##
 ## @item
-## If the first argument is a vector and the second is a matrix, the
-## the vector is plotted versus the columns (or rows) of the matrix.
+## If the @var{x} is a vector and @var{y} is a matrix, the
+## the columns (or rows) of @var{y} are plotted versus @var{x}.
 ## (using whichever combination matches, with columns tried first.)
 ##
 ## @item
-## If the first argument is a matrix and the second is a vector, the
-## the columns (or rows) of the matrix are plotted versus the vector.
+## 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
@@ -107,9 +107,9 @@
 ## valid in combination with the @code{@@} or @code{-@@} specifiers.
 ##
 ## @item @var{c}
-## If @var{c} is one of @code{"k"}, @code{"r"}, @code{"g"}, @code{"b"},
-## @code{"m"}, @code{"c"}, or @code{"w"}, it is interpreted as the plot
-## color (black, red, green, blue, magenta, cyan, or white).
+## 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.

Diff finished at Thu Nov 16 17:08:54


-- System Information:
Debian Release: 4.0
  APT prefers testing
  APT policy: (990, 'testing'), (500, 'testing-proposed-updates')
Architecture: amd64 (x86_64)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.6.15-1-amd64-k8-smp
Locale: LANG=C, LC_CTYPE=it_IT at euro (charmap=ISO-8859-15)

Versions of packages octave2.9 depends on:
ii  fftw3                    3.1.2-1         library for computing Fast Fourier
ii  lapack3 [liblapack.so.3] 3.0.20000531a-6 library of linear algebra routines
ii  libc6                    2.3.6.ds1-7     GNU C Library: Shared libraries
ii  libgcc1                  1:4.1.1-19      GCC support library
ii  libgfortran1             4.1.1-19        Runtime library for GNU Fortran ap
ii  libglpk0                 4.11-2          linear programming kit (shared lib
ii  libhdf5-serial-1.6.5-0 [ 1.6.5-3         Hierarchical Data Format 5 (HDF5) 
ii  libncurses5              5.5-5           Shared libraries for terminal hand
ii  libpcre3                 6.7-1           Perl 5 Compatible Regular Expressi
ii  libreadline5             5.2-1           GNU readline and history libraries
ii  libstdc++6               4.1.1-19        The GNU Standard C++ Library v3
ii  libufsparse              1.2-7           collection of libraries for comput
ii  refblas3 [libblas.so.3]  1.2-8           Basic Linear Algebra Subroutines 3
ii  texinfo                  4.8.dfsg.1-3    Documentation system for on-line i
ii  zlib1g                   1:1.2.3-13      compression library - runtime

octave2.9 recommends no packages.

-- no debconf information