[Octave-bug-tracker] [bug #56557] Formatted input documentation missing float info and location instructions unclear

[Nicholas Jankowski]

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

                 Summary: Formatted input documentation missing float info and
location instructions unclear
                 Project: GNU Octave
            Submitted by: nrjank
            Submitted on: Wed 26 Jun 2019 06:21:01 PM UTC
                Category: Documentation
                Severity: 3 - Normal
                Priority: 5 - Normal
              Item Group: Documentation
                  Status: None
             Assigned to: None
         Originator Name: Nicholas Jankowski
        Originator Email: 
             Open/Closed: Open
         Discussion Lock: Any
                 Release: 5.1.0
        Operating System: Any

    _______________________________________________________

Details:

two related documentation items here:

1 - In the help for fscanf, it says "See the Formatted Input section of the
GNU Octave manual for a complete description of the syntax of the template
string."

the "Formatted Input" doc page just has the docstrings for fscanf, scanf, and
sscanf, with fscanf telling you to "See the Formatted Input section of the GNU
Octave manual for a complete description of the syntax of the template string.
"  

seems a bit circular. the following pages contain information about an input
Template string spread over a few pages. Perhaps a link to the Input
Conversion Syntax or Table of Input Conversions page would be better? 

2 - on the Table of Input Conversions page, the line for float inputs 


‘%e’, ‘%f’, ‘%g’, ‘%E’, ‘%G’
Matches an optionally signed floating-point number. See Numeric Input
Conversions. 


the Numeric Input Conversions page only has the Int conversions description.
it stops before any of the float conversions, and the next page goes right to
the string input conversions.

Did the float info get stripped off of that page at some point?  google brings
up the 4.2.1 doc pages which show the same issue.  Is there an older version
that has the missing text description that can be copied back into the current
docs? or did they used to be on a different page? 




    _______________________________________________________

Reply to this item at:

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

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