Reporter API cleanup for 1.0

(Relax: I'm just proposing a docstring change.)

Right now, the reporter API does not impose constraints on the order
of reports, except for this cryptic comment about set_path:

   * This will *override* any previous @c set_path() calls made on parent
   * paths. @a path is relative to the URL specified in @c open().

The svn_repos reporter implementation will below out if you don't
start with a set_path("", rev, start_empty) call, but this is not
documented anywhere.

I'd like to document that reports have to be sent in depth-first
order, beginning with a specified rev for the root path, first because
that's how we do it now, and second because it gives us the option of
storing the report into a temporary file and then processing the
temporary file in a streamy fashion.

Objections?

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Sat Dec 27 15:43:15 2003