[jira] Created: (STDCXX-1048) rotate() description's example seems misleading or wrong

["Jim Bell (JIRA)" <ji...@apache.org>]

rotate() description's example seems misleading or wrong
--------------------------------------------------------

                 Key: STDCXX-1048
                 URL: https://issues.apache.org/jira/browse/STDCXX-1048
             Project: C++ Standard Library
          Issue Type: Improvement
          Components: Documentation
    Affects Versions: 4.2.1
            Reporter: Jim Bell
            Priority: Minor


rotate() description's example seems misleading at best. It says:

{quote}
Say that we have the sequence:

{{2 4 6 8 1 3 5}}

If we call rotate() with mid pointing to {{5}}, the two segments are

{{2 4 6 8}} and {{1 3 5}}
{quote}

To get the specified result, the mid must point to the fifth element, counting up from 1. But it would be more accurate to say "with mid pointing to {{advance(start, 4)}} ..." Further, the typeface for "5" makes it look like the item value 5, the last position on the original sequence list.



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