[prev in list] [next in list] [prev in thread] [next in thread] 

List:       apache-stdcxx-issues
Subject:    [jira] Created: (STDCXX-1048) rotate() description's example seems
From:       "Jim Bell (JIRA)" <jira () apache ! org>
Date:       2010-03-30 23:56:27
Message-ID: 260413444.592841269993387307.JavaMail.jira () brutus ! apache ! org
[Download RAW message or body]

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.


[prev in list] [next in list] [prev in thread] [next in thread]