[Octave-bug-tracker] [bug #50299] Java interface: Ordering and Headlines

[Ernst Reissner]

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

                 Summary: Java interface: Ordering and Headlines
                 Project: GNU Octave
            Submitted by: ernstreissner
            Submitted on: Tue 14 Feb 2017 10:09:10 AM UTC
                Category: Documentation
                Severity: 3 - Normal
                Priority: 5 - Normal
              Item Group: None
                  Status: None
             Assigned to: None
         Originator Name: Ernst Reissner
        Originator Email: 
             Open/Closed: Open
         Discussion Lock: Any
                 Release: 4.2.0
        Operating System: Any

    _______________________________________________________

Details:

The java interface is treated in Section A.4. 
The subsections are (in the order given): 
- A.4.1 Java Interface Functions
- A.4.2 Making Java Classes Available
- A.4.3 Creating an Instance of a Java Class
- A.4.4 Handling Java Memory Limitations

I think, A.4.2 should come first 
as it describes how to configure octave 
that any java-class can be found. 
You cannot apply any serious java interface function (described in A.4.1)
without that. 

The headline of Section A.4.4 is very misleading. 
The content is about passing parameters to the java virtual machine (JVM) 
and so the headline should be something like 
"Passing parameters to the java engine" 

Next one could read A.4.3 "Creating an instance of a Java Class". 
Here I would explain that the function javaObject 
invokes the constructor of the class with name given 
and parameters given. 
Also one should mention that octave double/int 
are automatically converted into according java types 
before passing to the constructor. 
Also java objects can be stored in octave variables. 

Actually, here a section is missing on type conversions 
between java and octave. 
Matlab provides extensive documentation here, 
which simply misses for octave. 

Section A.4.1 should be the final section 
summarizing the functions which form the java interface. 




    _______________________________________________________

Reply to this item at:

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

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