TimeRange.intersect name is cryptic
@manish
Submitted by Manish Sinha Assigned to zeitgeist-bugs@lists.freedesktop.org
Description
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.
Version: 0.9.x