[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Octave-bug-tracker] [bug #34661] Confusing: equivalent to `x.''.

From: Clem
Subject: [Octave-bug-tracker] [bug #34661] Confusing: equivalent to `x.''.
Date: Wed, 26 Oct 2011 21:15:10 +0000
User-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_6_8) AppleWebKit/534.50 (KHTML, like Gecko) Version/5.1 Safari/534.50


                 Summary: Confusing:  equivalent to `x.''.
                 Project: GNU Octave
            Submitted by: clemwang
            Submitted on: Wed 26 Oct 2011 09:15:09 PM GMT
                Category: None
                Severity: 3 - Normal
                Priority: 5 - Normal
              Item Group: Documentation
                  Status: None
             Assigned to: None
         Originator Name: Clem
        Originator Email: 
             Open/Closed: Open
         Discussion Lock: Any
                 Release: 3.4.0
        Operating System: Mac OS



Fortunately, I already know what the transpose function does, but if I didn't,
the Octave help for the transpose() function would be confusing.  You should
not use quotes to quote an expression that uses quotes   Similarly, the use of
a period as end-of-sentence indicator near a dot symbol is a bad idea:

help transpose
`transpose' is a built-in function

 -- Built-in Function:  transpose (X)
     Return the transpose of X.  This function is equivalent to `x.''.

     See also: ctranspose

I know that
is equivalent to:

A person new to Octave and Linear Algebra could misunderstand that line to say
transpose(x) is:


or even:

(double quote instead of two single quotes).

I suspect that this has ramifications to the style used in the Octave help. 
Another confusing use of quotes and periods is with help times

This function is equivalent to `x .* y'.

I think examples would be nice too.


Reply to this item at:


  Message sent via/by Savannah

reply via email to

[Prev in Thread] Current Thread [Next in Thread]