[Octave-bug-tracker] [bug #52723] unexpected space in matrix expression (brackets) in document

[anonymous]

URL:
  <http://savannah.gnu.org/bugs/?52723>

                 Summary: unexpected space in matrix expression (brackets) in
document
                 Project: GNU Octave
            Submitted by: None
            Submitted on: Fri 22 Dec 2017 03:22:30 AM UTC
                Category: Documentation
                Severity: 3 - Normal
                Priority: 5 - Normal
              Item Group: Documentation
                  Status: None
             Assigned to: None
         Originator Name: 
        Originator Email: address@hidden
             Open/Closed: Open
         Discussion Lock: Any
                 Release: 4.2.1
        Operating System: Any

    _______________________________________________________

Details:

The GNU convention to add a space between the function name
and the "(" may cause problem within the matrix expression "[ ]".
As described in Section 4.1 Matrices,
"[ sin (pi) ]" will result in an error
and instead we should use "[ (sin (pi)) ]" or "[ sin(pi) ]".

However, this case still appears in the document:
 Section 8.1.1, paragraph 2:
  "[ones (m-n, 1)]"
 Section 15.2.2.2, function ezmesh,ezmeshc,ezsurf,ezsurfc:
  "[FX (S, T), FY (S, T), FZ (S, T)]"
while the following seems to be correct:
 Section 21.2.1:
  "[D(1:n,n) * M; zeros(m-n, columns (M))]"
 Section 28.5:
  "x = 2 * pi * [0, (rand (1, 98)), 1]"
  "cc = [(eye (2)), (eye (2))]"
The above results are got from INFO version document with regexp

\[[^][]*\w+ \(


It seems that Section 8.1.1 also has other problems. I would try to give some
suggestion later.
Possible solution to Section 15.2.2.2:

diff -ur a/scripts/plot/draw/ezmeshc.m b/scripts/plot/draw/ezmeshc.m
--- a/scripts/plot/draw/ezmeshc.m
+++ b/scripts/plot/draw/ezmeshc.m
@@ -32,8 +32,8 @@
 ## @code{-2*pi <= @var{x} | @var{y} <= 2*pi} with 60 points in each
dimension.
 ##
 ## If three functions are passed, then plot the parametrically defined
-## function @address@hidden (@var{s}, @var{t}), @var{fy} (@var{s}, @var{t}),
-## @var{fz} (@var{s}, @var{t})]}.
+## function @address@hidden(@var{s}, @var{t}), @var{fy}(@var{s}, @var{t}),
+## @var{fz}(@var{s}, @var{t})]}.
 ##
 ## If @var{dom} is a two element vector, it represents the minimum and
maximum
 ## values of both @var{x} and @var{y}.  If @var{dom} is a four element
vector,
diff -ur a/scripts/plot/draw/ezmesh.m b/scripts/plot/draw/ezmesh.m
--- a/scripts/plot/draw/ezmesh.m
+++ b/scripts/plot/draw/ezmesh.m
@@ -32,8 +32,8 @@
 ## @code{-2*pi <= @var{x} | @var{y} <= 2*pi} with 60 points in each
dimension.
 ##
 ## If three functions are passed, then plot the parametrically defined
-## function @address@hidden (@var{s}, @var{t}), @var{fy} (@var{s}, @var{t}),
-## @var{fz} (@var{s}, @var{t})]}.
+## function @address@hidden(@var{s}, @var{t}), @var{fy}(@var{s}, @var{t}),
+## @var{fz}(@var{s}, @var{t})]}.
 ##
 ## If @var{dom} is a two element vector, it represents the minimum and
maximum
 ## values of both @var{x} and @var{y}.  If @var{dom} is a four element
vector,
diff -ur a/scripts/plot/draw/ezsurfc.m b/scripts/plot/draw/ezsurfc.m
--- a/scripts/plot/draw/ezsurfc.m
+++ b/scripts/plot/draw/ezsurfc.m
@@ -32,8 +32,8 @@
 ## @code{-2*pi <= @var{x} | @var{y} <= 2*pi} with 60 points in each
dimension.
 ##
 ## If three functions are passed, then plot the parametrically defined
-## function @address@hidden (@var{s}, @var{t}), @var{fy} (@var{s}, @var{t}),
-## @var{fz} (@var{s}, @var{t})]}.
+## function @address@hidden(@var{s}, @var{t}), @var{fy}(@var{s}, @var{t}),
+## @var{fz}(@var{s}, @var{t})]}.
 ##
 ## If @var{dom} is a two element vector, it represents the minimum and
maximum
 ## values of both @var{x} and @var{y}.  If @var{dom} is a four element
vector,
diff -ur a/scripts/plot/draw/ezsurf.m b/scripts/plot/draw/ezsurf.m
--- a/scripts/plot/draw/ezsurf.m
+++ b/scripts/plot/draw/ezsurf.m
@@ -32,8 +32,8 @@
 ## @code{-2*pi <= @var{x} | @var{y} <= 2*pi} with 60 points in each
dimension.
 ##
 ## If three functions are passed, then plot the parametrically defined
-## function @address@hidden (@var{s}, @var{t}), @var{fy} (@var{s}, @var{t}),
-## @var{fz} (@var{s}, @var{t})]}.
+## function @address@hidden(@var{s}, @var{t}), @var{fy}(@var{s}, @var{t}),
+## @var{fz}(@var{s}, @var{t})]}.
 ##
 ## If @var{dom} is a two element vector, it represents the minimum and
maximum
 ## values of both @var{x} and @var{y}.  If @var{dom} is a four element
vector,






    _______________________________________________________

Reply to this item at:

  <http://savannah.gnu.org/bugs/?52723>

_______________________________________________
  Message sent via/by Savannah
  http://savannah.gnu.org/