<html>
    <head>
      <base href="https://bugs.freedesktop.org/" />
    </head>
    <body><table border="1" cellspacing="0" cellpadding="8">
        <tr>
          <th>Priority</th>
          <td>medium
          </td>
        </tr>

        <tr>
          <th>Bug ID</th>
          <td><a class="bz_bug_link 
          bz_status_NEW "
   title="NEW --- - TimeRange.intersect name is cryptic"
   href="https://bugs.freedesktop.org/show_bug.cgi?id=62086">62086</a>
          </td>
        </tr>

        <tr>
          <th>Assignee</th>
          <td>zeitgeist-bugs@lists.freedesktop.org
          </td>
        </tr>

        <tr>
          <th>Summary</th>
          <td>TimeRange.intersect name is cryptic
          </td>
        </tr>

        <tr>
          <th>QA Contact</th>
          <td>zeitgeist-bugs@lists.freedesktop.org
          </td>
        </tr>

        <tr>
          <th>Severity</th>
          <td>normal
          </td>
        </tr>

        <tr>
          <th>Classification</th>
          <td>Unclassified
          </td>
        </tr>

        <tr>
          <th>OS</th>
          <td>All
          </td>
        </tr>

        <tr>
          <th>Reporter</th>
          <td>manishsinha@ubuntu.com
          </td>
        </tr>

        <tr>
          <th>Hardware</th>
          <td>Other
          </td>
        </tr>

        <tr>
          <th>Status</th>
          <td>NEW
          </td>
        </tr>

        <tr>
          <th>Version</th>
          <td>0.9.x
          </td>
        </tr>

        <tr>
          <th>Component</th>
          <td>libzeitgeist
          </td>
        </tr>

        <tr>
          <th>Product</th>
          <td>Zeitgeist
          </td>
        </tr></table>
      <p>
        <div>
        <pre>libzeitgeist-2.0 has a new method in libzeitgeist-2.0

public TimeRange? intersect (TimeRange time_range)
Check whether two time ranges are intersecting.

OPTION1: 
Either the doc should be

"Find the intersection of two TimeRange. If two TimeRange don't intersect, then
null is returned"

OR OPTION2:

the method should be

public bool does_intersect (TimeRange time_range)

if you want to keep the documentation since the documentation for this method
starts with "Check whether....", when you check, it should return a boolean
value.

-----------------

I guess the first one makes sense.</pre>
        </div>
      </p>
      <hr>
      <span>You are receiving this mail because:</span>
      
      <ul>
          <li>You are the QA Contact for the bug.</li>
          <li>You are the assignee for the bug.</li>
      </ul>
    </body>
</html>