Code review comment for lp:~rainct/libzeitgeist/776651-doc

Revision history for this message
Siegfried Gevatter (rainct) wrote :

Good catch. Didn't remember how weird our move events are :P.

How about this?

/**
 * zeitgeist_subject_get_current_uri:
 * @subject: The subject to get the current_uri from
 *
 * Get the current_uri of a subject.
 *
 * This is the updated URI taking into account possible relocations of the resource.
 * It is illegal to insert an event with subjects having a `current_uri' different
 * than their `uri'.
 *
 * A special case is events with #ZEITGEIST_ZG_MOVE_EVENT interpretation. In this
 * case, `current_uri' is the destination to which `uri' is being moved, and they
 * are expected to be different.
 *
 * Returns: The current_uri of @subject.
 *
 * Since: 0.3.14
 */

« Back to merge proposal