<html>
  <head>
    <meta content="text/html; charset=ISO-8859-1"
      http-equiv="Content-Type">
  </head>
  <body bgcolor="#FFFFFF" text="#000000">
    On 02/20/2012 11:16 AM, Daniel Monteiro Basso wrote:
    <blockquote
cite="mid:CAHn_q98GtJ+_U_tvSwZ9ZogJdhNzwqJfryE9aYR1z4+eGy+vMw@mail.gmail.com"
      type="cite">
      <div class="gmail_quote">On Mon, Feb 20, 2012 at 10:33 AM, Domino
        Marama <span dir="ltr"><<a moz-do-not-send="true"
            href="mailto:domino@dominodesigns.info">domino@dominodesigns.info</a>></span>
        wrote:<br>
        <blockquote class="gmail_quote" style="margin:0 0 0
          .8ex;border-left:1px #ccc solid;padding-left:1ex">
          <div bgcolor="#FFFFFF" text="#000000"> I think the confusion
            is because most people read _set as a verb, not a noun.. I'd
            prefer something more obviously a noun like
            .select_clump(True)<br>
          </div>
        </blockquote>
        <div><br>
          It is actually a verb: "select_set(bool): set selection and
          flush, attribute only sets."<br>
          <br>
          It is the Yoda way of expressing it, object-verb, that makes
          sense because Blender is written in Japanese (just kidding :p
          )<br>
        </div>
      </div>
    </blockquote>
    <br>
    So it's not SELECT (verb) a SET of things (noun)? <br>
    <br>
    I'd have thought selection_set would have matched the description
    then, but that doesn't clarify the flush behaviour. It's why I
    favoured clump as it implies you are selecting more than you think
    :)<br>
    <br>
    Flush is another term that'd need reading up on.. So the description
    isn't that useful anyway..<br>
    <br>
    <blockquote
cite="mid:CAHn_q98GtJ+_U_tvSwZ9ZogJdhNzwqJfryE9aYR1z4+eGy+vMw@mail.gmail.com"
      type="cite">
      <div class="gmail_quote">
        <div>But my objection is more about things that looks the same
          but do different things... I learn a lot about the API by
          looking at other people's code, and sometimes assumptions
          about what seems obvious (it looks the same it does the same)
          is reason for losing time wondering WhyTF the code doesn't
          work.<br>
        </div>
      </div>
      <br>
      <br>
    </blockquote>
    Well clump is obviously different so I'll take that as a +1 :p<br>
    <br>
    Just kidding, but something like:<br>
    <br>
    select_clump(bool): set item and related features selection state.<br>
    <br>
    seems pretty clear to me.. if "item" and "features" were specific to
    context, so "vertex", "edges & faces" etc it'd be totally clear
    without needing to dive for the api reference..<br>
  </body>
</html>