[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