You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@subversion.apache.org by ju...@apache.org on 2011/05/11 21:56:12 UTC

svn commit: r1102054 - /subversion/trunk/subversion/libsvn_ra_serf/ra_serf.h

Author: julianfoad
Date: Wed May 11 19:56:12 2011
New Revision: 1102054

URL: http://svn.apache.org/viewvc?rev=1102054&view=rev
Log:
* subversion/libsvn_ra_serf/ra_serf.h
  (svn_ra_serf__get_ver_prop_string, svn_ra_serf__get_ver_prop,
   svn_ra_serf__get_prop_string, svn_ra_serf__get_prop,
   svn_ra_serf__set_prop): Improve doc strings.

Modified:
    subversion/trunk/subversion/libsvn_ra_serf/ra_serf.h

Modified: subversion/trunk/subversion/libsvn_ra_serf/ra_serf.h
URL: http://svn.apache.org/viewvc/subversion/trunk/subversion/libsvn_ra_serf/ra_serf.h?rev=1102054&r1=1102053&r2=1102054&view=diff
==============================================================================
--- subversion/trunk/subversion/libsvn_ra_serf/ra_serf.h (original)
+++ subversion/trunk/subversion/libsvn_ra_serf/ra_serf.h Wed May 11 19:56:12 2011
@@ -974,33 +974,35 @@ svn_ra_serf__set_bare_props(void *baton,
                             const svn_string_t *val,
                             apr_pool_t *pool);
 
-/* Get PROPS for PATH at REV revision with a NS:NAME. */
+/* Return the property value for PATH at REV revision with a NS:NAME.
+ * PROPS is a four-level nested hash: (svn_revnum_t => char *path =>
+ * char *ns => char *name => svn_string_t *). */
 const svn_string_t *
 svn_ra_serf__get_ver_prop_string(apr_hash_t *props,
                                  const char *path, svn_revnum_t rev,
                                  const char *ns, const char *name);
 
-/* Wraps svn_ra_serf__get_ver_prop_string(). */
+/* Same as svn_ra_serf__get_ver_prop_string(), but returns a C string. */
 const char *
 svn_ra_serf__get_ver_prop(apr_hash_t *props,
                           const char *path, svn_revnum_t rev,
                           const char *ns, const char *name);
 
-/* Same as get_ver_prop_string, but for the unknown revision */
+/* Same as svn_ra_serf__get_ver_prop_string(), but for the unknown revision. */
 const svn_string_t *
 svn_ra_serf__get_prop_string(apr_hash_t *props,
                              const char *path,
                              const char *ns,
                              const char *name);
 
-/* Same as get_ver_prop, but for the unknown revision */
+/* Same as svn_ra_serf__get_ver_prop(), but for the unknown revision. */
 const char *
 svn_ra_serf__get_prop(apr_hash_t *props,
                       const char *path,
                       const char *ns,
                       const char *name);
 
-/* Same as set_rev_prop, but sets it for the unknown revision. */
+/* Same as svn_ra_serf__set_rev_prop(), but for the unknown revision. */
 void
 svn_ra_serf__set_prop(apr_hash_t *props, const char *path,
                       const char *ns, const char *name,