stdcxx-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Martin Sebor (JIRA)" <j...@apache.org>
Subject [jira] Updated: (STDCXX-1025) Documentation for ios_base::flags and ios_base::setf misleading
Date Thu, 20 Nov 2008 15:34:44 GMT

     [ https://issues.apache.org/jira/browse/STDCXX-1025?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]

Martin Sebor updated STDCXX-1025:
---------------------------------

           Component/s:     (was: Web Site)
                        Documentation
              Severity: Usability  (was: Incorrect Behavior)
     Affects Version/s: 4.2.1
         Fix Version/s: 4.2.2
              Assignee: Martin Sebor
    Remaining Estimate: 1h
     Original Estimate: 1h

> Documentation for ios_base::flags and ios_base::setf misleading
> ---------------------------------------------------------------
>
>                 Key: STDCXX-1025
>                 URL: https://issues.apache.org/jira/browse/STDCXX-1025
>             Project: C++ Standard Library
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 4.2.1
>            Reporter: Elmar Zander
>            Assignee: Martin Sebor
>            Priority: Minor
>             Fix For: 4.2.2
>
>   Original Estimate: 1h
>  Remaining Estimate: 1h
>
> The documentation says for boths "flags(fmtflags fmtfl)" and "setf(fmtflags fmtfl)" exactly
the same, which is not true:
> flags(fmtflags fmtfl); 
>       Saves the format control information, then sets it to fmtfl and returns the previously
saved value.
> setf(fmtflags fmtfl); 
>       Saves the format control information, then sets it to fmtfl and returns the previously
saved value.
> The documentation in the header file "ios_base.h" is indeed better. It states for flags:
> > This function overwrites all the format flags with @a fmtfl.
> while for setf it says:
> > This function sets additional flags in format control.  Flags that were previously
set remain set.
> BTW: The start of the sentences "Saves the format control information..." is confusing
anyway and not necessary for anyone using this interface. It's enough to know that the function
"returns the previously saved value".

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


Mime
View raw message