[Octave-bug-tracker] [bug #61310] Please document fsolve "info" output -2

[Daniel Hatton]

URL:
  <https://savannah.gnu.org/bugs/?61310>

                 Summary: Please document fsolve "info" output -2
                 Project: GNU Octave
            Submitted by: danhatton
            Submitted on: Fri 08 Oct 2021 10:22:10 AM UTC
                Category: Octave Function
                Severity: 3 - Normal
                Priority: 5 - Normal
              Item Group: Feature Request
                  Status: None
             Assigned to: None
         Originator Name: Daniel Hatton
        Originator Email: 
             Open/Closed: Open
                 Release: dev
         Discussion Lock: Any
        Operating System: Any

    _______________________________________________________

Details:

Lines 349-364 of scripts/optimization/fsolve.m (current default branch) make
it possible for the "info" output of fsolve to take the value -2.  However,
this is not among the values of the "info" output whose meanings are
documented in the fsolve function reference.  From inspection of the source
code, it looks like its meaning is something to do with the largest element of
the Jacobian being too small for the relevant floating-point number
implementation to tell it apart from zero, but I suspect I haven't understood
all the details or implications.  Can someone document the -2 output, please?




    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?61310>

_______________________________________________
  Message sent via Savannah
  https://savannah.gnu.org/