Author: julianfoad
Date: Mon Dec 17 19:29:08 2012
New Revision: 1423103
URL: http://svn.apache.org/viewvc?rev=1423103&view=rev
Log:
* subversion/include/svn_subst.h
(svn_subst_build_keywords2): Clarify what null inputs mean.
Modified:
subversion/trunk/subversion/include/svn_subst.h
Modified: subversion/trunk/subversion/include/svn_subst.h
URL:
http://svn.apache.org/viewvc/subversion/trunk/subversion/include/svn_subst.h?rev=1423103&r1=1423102&r2=1423103&view=diff
==============================================================================
--- subversion/trunk/subversion/include/svn_subst.h (original)
+++ subversion/trunk/subversion/include/svn_subst.h Mon Dec 17 19:29:08 2012
@@ -128,8 +128,14 @@ typedef struct svn_subst_keywords_t
* given a @a keywords_string (the contents of the svn:keywords
* property for the file in question), the revision @a rev, the @a url,
* the @a date the file was committed on, and the @a author of the last
- * commit. Any of these can be @c NULL to indicate that the information is
- * not present, or @c 0 for @a date.
+ * commit.
+ *
+ * Any of the inputs @a rev, @a url, @a date and @a author can be @c NULL,
+ * or @c 0 for @a date, to indicate that the information is not present.
+ * Each piece of information that is not present expands to the empty
+ * string wherever it appears in an expanded keyword value. (This can
+ * result in multiple adjacent spaces in the expansion of a multi-valued
+ * keyword such as "Id".)
*
* Hash keys are of type <tt>const char *</tt>.
* Hash values are of type <tt>svn_string_t *</tt>.
