Author: brane
Date: Thu Feb 5 00:55:26 2015
New Revision: 1657453
URL: http://svn.apache.org/r1657453
Log:
On the reuse-ra-session branch: Update docstring; no functional change.
* subversion/include/private/svn_client_private.h
(svn_client__ra_session_release):
Document the limitations for calling this function.
Modified:
subversion/branches/reuse-ra-session/subversion/include/private/svn_client_private.h
Modified:
subversion/branches/reuse-ra-session/subversion/include/private/svn_client_private.h
URL:
http://svn.apache.org/viewvc/subversion/branches/reuse-ra-session/subversion/include/private/svn_client_private.h?rev=1657453&r1=1657452&r2=1657453&view=diff
==============================================================================
---
subversion/branches/reuse-ra-session/subversion/include/private/svn_client_private.h
(original)
+++
subversion/branches/reuse-ra-session/subversion/include/private/svn_client_private.h
Thu Feb 5 00:55:26 2015
@@ -152,7 +152,14 @@ svn_client__ra_session_from_path2(svn_ra
svn_client_ctx_t *ctx,
apr_pool_t *pool);
-/* Release repository access SESSION back to CTX session cache. */
+/* Release repository access SESSION back to CTX's session cache.
+
+ The caller *MUST* ensure that SESSION is in a valid state:
+ - it has a valid connection to the server;
+ - if using a stateful protocol (i.e., ra_svn), a new series
+ of commands can be safely begun;
+ - any previous errors did not make the session unusable.
+*/
svn_error_t *
svn_client__ra_session_release(svn_client_ctx_t *ctx,
svn_ra_session_t *session);
