[
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.
