[Octave-bug-tracker] [bug #62725] "help fputs" has unclear reference to EOF

[Colin Macdonald]

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

                 Summary: "help fputs" has unclear reference to EOF
                 Project: GNU Octave
               Submitter: cbm
               Submitted: Fri 08 Jul 2022 08:06:50 PM UTC
                Category: Documentation
                Severity: 3 - Normal
                Priority: 5 - Normal
              Item Group: Documentation
                  Status: None
             Assigned to: None
         Originator Name: 
        Originator Email: 
             Open/Closed: Open
                 Release: dev
         Discussion Lock: Any
        Operating System: Any


    _______________________________________________________

Follow-up Comments:


-------------------------------------------------------
Date: Fri 08 Jul 2022 08:06:50 PM UTC By: Colin Macdonald <cbm>
`help fputs` says:


     Return a non-negative number on success or EOF on error.


This is probably clear to C programmers but likely confusing to Octave
programmers.  Maybe it should should say:


     Return a non-negative number on success or a negative value
     on error (specifically the C-code constant @code{EOF}, which
     is system dependent but often @code{"-1"}).


I'm not sure how to trigger a `fputs` failure to check this in practice...








    _______________________________________________________

Reply to this item at:

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

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