[svnbook] r4087 committed - Read-thru edits....
Daniel Shahaf
d.s at daniel.shahaf.name
Fri Sep 9 10:45:21 CDT 2011
svnbook at googlecode.com wrote on Fri, Sep 09, 2011 at 15:02:04 +0000:
> + <!--
> =============================================================== -->
> + <sect2 id="svn.developer.usingapi.funcsbatons">
> + <title>Functions and Batons</title>
> +
> + <para>To facilite <quote>streamy</quote> (asyncronous) behavior
asynchronous
> + and provide consumers of the Subversion C API with hooks for
> + handling information in customizable ways, many functions in
> + the API accept pairs of parameters: a pointer to a callback
> + function, and a pointer to a blob of memory called
> + a <firstterm>baton</firstterm> that carries context
> + information for that callback function. Batons are typically
> + C structures with additional information that the callback
> + function needs but which is not given directly to the callback
> + function by the driving API function.</para>
> +
> + <warning>
> + <para>Run user-provided paths
> + through <function>svn_path_canonicalize()</function> before
* @deprecated Provided for backward compatibility with the 1.6 API.
* New code should use svn_dirent_canonicalize(), svn_uri_canonicalize(),
* svn_relpath_canonicalize() or svn_fspath__canonicalize().
> + passing them to other API functions. Failure to do so can
> + trigger assertions in the underlying Subversion C library
> + which translate into rather immediate and unceremonious
a rather
> + program abortion.</para>
> + </warning>
More information about the svnbook-dev
mailing list