bugGNU Octave - Bugs: bug #51036, Missing documentation for some...


bug #51036: Missing documentation for some operators in operator index of manual

Submitted by:  Ernst Reissner <ernstreissner>
Submitted on:  Tue May 16 14:16:10 2017  
Category: DocumentationSeverity: 2 - Minor
Priority: 3 - LowItem Group: Documentation
Status: Need InfoAssigned to: None
Originator Name: ernst reissnerOpen/Closed: Open
Release: devOperating System: Any

Add a New Comment (Rich MarkupRich Markup):

You are not logged in

Please log in, so followups can be emailed to you.


(Jump to the original submission Jump to the original submission)

Tue May 23 19:03:30 2017, comment #9:

@mike: yes, splitting would be a good idea.

Ernst Reissner <ernstreissner>
Tue May 16 22:53:39 2017, comment #8:

Even better: shall I prepare a patch?

Ernst Reissner <ernstreissner>
Tue May 16 22:52:44 2017, comment #7:

@mike: I was lazy sorry.
Shall I split the bug report?

Ernst Reissner <ernstreissner>
Tue May 16 22:45:23 2017, comment #6:

I was confused that part of this bug report was about the Operator Index for the whole user manual, not just about the list of operators that can be overloaded. That is part of why I prefer to see one bug report for each very specific issue. These are two separate documentation issues IMHO.

I agree that the operator index is missing and should include references for these operators: .-, \=, *=, &=, and |=. Maybe the following elementwise-op-assignment operators as well: .+=, .-=, .=, ./=, .\=, .^=, and .**=.

Mike Miller <mtmiller>
Project Administrator
Tue May 16 22:30:10 2017, comment #5:

Just my opinion:
Either these are supported and documented or neither.
So, my comment #2 does not hit the point:
Mikes comment #2 does not either.

Ernst Reissner <ernstreissner>
Tue May 16 21:08:25 2017, comment #4:

I don't think Matlab has .+ or .- operators. I added those to Octave for symmetry.

John W. Eaton <jwe>
Project Administrator
Tue May 16 15:44:33 2017, comment #3:

Comment #2:
Yes Mike, but shall we copy the deficiencies of the matlab documentation?

Comment #1:
^= and so on is not missing in the table,
and i did not say that.
It is missing in the index.
Also in the index some page numbers are missing.

Ernst Reissner <ernstreissner>
Tue May 16 14:39:38 2017, comment #2:

Compare Octave's section 34.4.2 with this page from TMW:


They also do not mention here that + and .+ are the same operator, that information is relevant elsewhere.

Mike Miller <mtmiller>
Project Administrator
Tue May 16 14:38:17 2017, comment #1:

> ^=, \=, |= as += is present

There are no object methods to overload these assignment operators, they have no place in this table.

> Also page numbers in index incomplete.

What page numbers?

The purpose of this table is to describe the methods that must be defined to overload an operator in an object definition. The equivalence of certain operators to each other is discussed elsewhere in section 8.3.

Mike Miller <mtmiller>
Project Administrator
Tue May 16 14:16:10 2017, original submission:

Table 34.1:

missing operations ~ equivalent with ! and ~= equivalent with !=

Also .+ and .- which are the same as + and -

Also ** and .** equivalent with ^ and /^.

some of them are important as they are the operators
as can be found in matlab.

Also index is incomplete:

in index missing:

&= as += is present

.- as .+ is present

^=, \=, |= as += is present

Also page numbers in index incomplete.

Ernst Reissner <ernstreissner>


(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach File(s):

No files currently attached


Depends on the following items: None found

Items that depend on this one: None found


Carbon-Copy List
  • -unavailable- added by rik5 (Updated the item)
  • -unavailable- added by jwe (Posted a comment)
  • -unavailable- added by mtmiller (Posted a comment)
  • -unavailable- added by ernstreissner (Submitted the item)
  • -unavailable- added by ernstreissner

    Do you think this task is very important?
    If so, you can click here to add your encouragement to it.
    This task has 0 encouragements so far.

    Only project members can vote.


    Please enter the title of George Orwell's famous dystopian book (it's a date):



    Follow 5 latest changes.

    Date Changed By Updated Field Previous Value => Replaced By
    Fri May 26 00:19:46 2017rik5SummaryMissing operators =>Missing documentation for some operators in operator index of manual
    Tue May 16 14:38:17 2017mtmillerSeverity3 - Normal=>2 - Minor
      Priority5 - Normal=>3 - Low
      StatusNone=>Need Info
    Tue May 16 14:16:10 2017ernstreissnerCarbon-Copy-=>Added -unavailable-

    Back to the top

    Powered by Savane 3.1-cleanup1