You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@subversion.apache.org by br...@apache.org on 2013/06/14 11:39:36 UTC

svn commit: r1493010 [13/16] - in /subversion/site/publish/docs: api/1.8/ api/1.8/search/ javahl/1.8/ javahl/1.8/org/apache/subversion/javahl/ javahl/1.8/org/apache/subversion/javahl/callback/ javahl/1.8/org/apache/subversion/javahl/types/ javahl/1.8/o...

Modified: subversion/site/publish/docs/api/1.8/svn__types_8h_source.html
URL: http://svn.apache.org/viewvc/subversion/site/publish/docs/api/1.8/svn__types_8h_source.html?rev=1493010&r1=1493009&r2=1493010&view=diff
==============================================================================
--- subversion/site/publish/docs/api/1.8/svn__types_8h_source.html (original)
+++ subversion/site/publish/docs/api/1.8/svn__types_8h_source.html Fri Jun 14 09:39:23 2013
@@ -155,1210 +155,1219 @@ var searchBox = new SearchBox("searchBox
 <a name="l00072"></a>00072 <span class="comment"> * Unaligned access on other machines (e.g. IA64) will trigger memory</span>
 <a name="l00073"></a>00073 <span class="comment"> * access faults or simply misbehave.</span>
 <a name="l00074"></a>00074 <span class="comment"> *</span>
-<a name="l00075"></a>00075 <span class="comment"> * @since New in 1.7.</span>
-<a name="l00076"></a>00076 <span class="comment"> */</span>
-<a name="l00077"></a>00077 <span class="preprocessor">#ifndef SVN_UNALIGNED_ACCESS_IS_OK</span>
-<a name="l00078"></a>00078 <span class="preprocessor"></span><span class="preprocessor"># if defined(_M_IX86) || defined(_M_X64) || defined(i386) || defined(__x86_64)</span>
-<a name="l00079"></a>00079 <span class="preprocessor"></span><span class="preprocessor">#  define SVN_UNALIGNED_ACCESS_IS_OK 1</span>
-<a name="l00080"></a>00080 <span class="preprocessor"></span><span class="preprocessor"># else</span>
-<a name="l00081"></a>00081 <span class="preprocessor"></span><span class="preprocessor">#  define SVN_UNALIGNED_ACCESS_IS_OK 0</span>
-<a name="l00082"></a>00082 <span class="preprocessor"></span><span class="preprocessor"># endif</span>
-<a name="l00083"></a>00083 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
-<a name="l00084"></a>00084 <span class="preprocessor"></span>
-<a name="l00085"></a>00085 
-<a name="l00086"></a>00086 <span class="comment"></span>
-<a name="l00087"></a>00087 <span class="comment">/** YABT:  Yet Another Boolean Type */</span>
-<a name="l00088"></a><a class="code" href="svn__types_8h.html#a22b35baddc4213c688d1bb12feea1024">00088</a> <span class="keyword">typedef</span> <span class="keywordtype">int</span> <a class="code" href="svn__types_8h.html#a22b35baddc4213c688d1bb12feea1024" title="Macro used to mark deprecated functions.">svn_boolean_t</a>;
-<a name="l00089"></a>00089 
-<a name="l00090"></a>00090 <span class="preprocessor">#ifndef TRUE</span>
-<a name="l00091"></a>00091 <span class="preprocessor"></span><span class="comment">/** uhh... true */</span>
-<a name="l00092"></a>00092 <span class="preprocessor">#define TRUE 1</span>
-<a name="l00093"></a>00093 <span class="preprocessor"></span><span class="preprocessor">#endif </span><span class="comment">/* TRUE */</span>
-<a name="l00094"></a>00094 
-<a name="l00095"></a>00095 <span class="preprocessor">#ifndef FALSE</span>
-<a name="l00096"></a>00096 <span class="preprocessor"></span><span class="comment">/** uhh... false */</span>
-<a name="l00097"></a>00097 <span class="preprocessor">#define FALSE 0</span>
-<a name="l00098"></a>00098 <span class="preprocessor"></span><span class="preprocessor">#endif </span><span class="comment">/* FALSE */</span>
-<a name="l00099"></a>00099 
+<a name="l00075"></a>00075 <span class="comment"> * Note: Some platforms may only support unaligned access for integers</span>
+<a name="l00076"></a>00076 <span class="comment"> * (PowerPC).  As a result this macro should only be used to determine</span>
+<a name="l00077"></a>00077 <span class="comment"> * if unaligned access is supported for integers.</span>
+<a name="l00078"></a>00078 <span class="comment"> *</span>
+<a name="l00079"></a>00079 <span class="comment"> * @since New in 1.7.</span>
+<a name="l00080"></a>00080 <span class="comment"> */</span>
+<a name="l00081"></a>00081 <span class="preprocessor">#ifndef SVN_UNALIGNED_ACCESS_IS_OK</span>
+<a name="l00082"></a>00082 <span class="preprocessor"></span><span class="preprocessor"># if defined(_M_IX86) || defined(i386) \</span>
+<a name="l00083"></a>00083 <span class="preprocessor">     || defined(_M_X64) || defined(__x86_64) \</span>
+<a name="l00084"></a>00084 <span class="preprocessor">     || defined(__powerpc__) || defined(__ppc__)</span>
+<a name="l00085"></a>00085 <span class="preprocessor"></span><span class="preprocessor">#  define SVN_UNALIGNED_ACCESS_IS_OK 1</span>
+<a name="l00086"></a>00086 <span class="preprocessor"></span><span class="preprocessor"># else</span>
+<a name="l00087"></a>00087 <span class="preprocessor"></span><span class="preprocessor">#  define SVN_UNALIGNED_ACCESS_IS_OK 0</span>
+<a name="l00088"></a>00088 <span class="preprocessor"></span><span class="preprocessor"># endif</span>
+<a name="l00089"></a>00089 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
+<a name="l00090"></a>00090 <span class="preprocessor"></span>
+<a name="l00091"></a>00091 
+<a name="l00092"></a>00092 <span class="comment"></span>
+<a name="l00093"></a>00093 <span class="comment">/** YABT:  Yet Another Boolean Type */</span>
+<a name="l00094"></a><a class="code" href="svn__types_8h.html#a22b35baddc4213c688d1bb12feea1024">00094</a> <span class="keyword">typedef</span> <span class="keywordtype">int</span> <a class="code" href="svn__types_8h.html#a22b35baddc4213c688d1bb12feea1024" title="Macro used to mark deprecated functions.">svn_boolean_t</a>;
+<a name="l00095"></a>00095 
+<a name="l00096"></a>00096 <span class="preprocessor">#ifndef TRUE</span>
+<a name="l00097"></a>00097 <span class="preprocessor"></span><span class="comment">/** uhh... true */</span>
+<a name="l00098"></a>00098 <span class="preprocessor">#define TRUE 1</span>
+<a name="l00099"></a>00099 <span class="preprocessor"></span><span class="preprocessor">#endif </span><span class="comment">/* TRUE */</span>
 <a name="l00100"></a>00100 
-<a name="l00101"></a>00101 <span class="comment"></span>
-<a name="l00102"></a>00102 <span class="comment">/** Subversion error object.</span>
-<a name="l00103"></a>00103 <span class="comment"> *</span>
-<a name="l00104"></a>00104 <span class="comment"> * Defined here, rather than in svn_error.h, to avoid a recursive @#include</span>
-<a name="l00105"></a>00105 <span class="comment"> * situation.</span>
-<a name="l00106"></a>00106 <span class="comment"> */</span>
-<a name="l00107"></a><a class="code" href="structsvn__error__t.html">00107</a> <span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="structsvn__error__t.html" title="Subversion error object.">svn_error_t</a>
-<a name="l00108"></a>00108 {<span class="comment"></span>
-<a name="l00109"></a>00109 <span class="comment">  /** APR error value; possibly an SVN_ custom error code (see</span>
-<a name="l00110"></a>00110 <span class="comment">   * `svn_error_codes.h&#39; for a full listing).</span>
-<a name="l00111"></a>00111 <span class="comment">   */</span>
-<a name="l00112"></a><a class="code" href="structsvn__error__t.html#a595d7e41f682979d66e32062c46155d9">00112</a>   apr_status_t <a class="code" href="structsvn__error__t.html#a595d7e41f682979d66e32062c46155d9" title="APR error value; possibly an SVN_ custom error code (see `svn_error_codes.h&#39; for a full listing)...">apr_err</a>;
-<a name="l00113"></a>00113 <span class="comment"></span>
-<a name="l00114"></a>00114 <span class="comment">  /** Details from the producer of error.</span>
-<a name="l00115"></a>00115 <span class="comment">   *</span>
-<a name="l00116"></a>00116 <span class="comment">   * Note that if this error was generated by Subversion&#39;s API, you&#39;ll</span>
-<a name="l00117"></a>00117 <span class="comment">   * probably want to use svn_err_best_message() to get a single</span>
-<a name="l00118"></a>00118 <span class="comment">   * descriptive string for this error chain (see the @a child member)</span>
-<a name="l00119"></a>00119 <span class="comment">   * or svn_handle_error2() to print the error chain in full.  This is</span>
-<a name="l00120"></a>00120 <span class="comment">   * because Subversion&#39;s API functions sometimes add many links to</span>
-<a name="l00121"></a>00121 <span class="comment">   * the error chain that lack details (used only to produce virtual</span>
-<a name="l00122"></a>00122 <span class="comment">   * stack traces).  (Use svn_error_purge_tracing() to remove those</span>
-<a name="l00123"></a>00123 <span class="comment">   * trace-only links from the error chain.)</span>
-<a name="l00124"></a>00124 <span class="comment">   */</span>
-<a name="l00125"></a><a class="code" href="structsvn__error__t.html#a2644a98be02ca1aa123cc66d87a2ce5a">00125</a>   <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="structsvn__error__t.html#a2644a98be02ca1aa123cc66d87a2ce5a" title="Details from the producer of error.">message</a>;
-<a name="l00126"></a>00126 <span class="comment"></span>
-<a name="l00127"></a>00127 <span class="comment">  /** Pointer to the error we &quot;wrap&quot; (may be @c NULL).  Via this</span>
-<a name="l00128"></a>00128 <span class="comment">   * member, individual error object can be strung together into an</span>
-<a name="l00129"></a>00129 <span class="comment">   * &quot;error chain&quot;.</span>
+<a name="l00101"></a>00101 <span class="preprocessor">#ifndef FALSE</span>
+<a name="l00102"></a>00102 <span class="preprocessor"></span><span class="comment">/** uhh... false */</span>
+<a name="l00103"></a>00103 <span class="preprocessor">#define FALSE 0</span>
+<a name="l00104"></a>00104 <span class="preprocessor"></span><span class="preprocessor">#endif </span><span class="comment">/* FALSE */</span>
+<a name="l00105"></a>00105 
+<a name="l00106"></a>00106 
+<a name="l00107"></a>00107 <span class="comment"></span>
+<a name="l00108"></a>00108 <span class="comment">/** Subversion error object.</span>
+<a name="l00109"></a>00109 <span class="comment"> *</span>
+<a name="l00110"></a>00110 <span class="comment"> * Defined here, rather than in svn_error.h, to avoid a recursive @#include</span>
+<a name="l00111"></a>00111 <span class="comment"> * situation.</span>
+<a name="l00112"></a>00112 <span class="comment"> */</span>
+<a name="l00113"></a><a class="code" href="structsvn__error__t.html">00113</a> <span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="structsvn__error__t.html" title="Subversion error object.">svn_error_t</a>
+<a name="l00114"></a>00114 {<span class="comment"></span>
+<a name="l00115"></a>00115 <span class="comment">  /** APR error value; possibly an SVN_ custom error code (see</span>
+<a name="l00116"></a>00116 <span class="comment">   * `svn_error_codes.h&#39; for a full listing).</span>
+<a name="l00117"></a>00117 <span class="comment">   */</span>
+<a name="l00118"></a><a class="code" href="structsvn__error__t.html#a595d7e41f682979d66e32062c46155d9">00118</a>   apr_status_t <a class="code" href="structsvn__error__t.html#a595d7e41f682979d66e32062c46155d9" title="APR error value; possibly an SVN_ custom error code (see `svn_error_codes.h&#39; for a full listing)...">apr_err</a>;
+<a name="l00119"></a>00119 <span class="comment"></span>
+<a name="l00120"></a>00120 <span class="comment">  /** Details from the producer of error.</span>
+<a name="l00121"></a>00121 <span class="comment">   *</span>
+<a name="l00122"></a>00122 <span class="comment">   * Note that if this error was generated by Subversion&#39;s API, you&#39;ll</span>
+<a name="l00123"></a>00123 <span class="comment">   * probably want to use svn_err_best_message() to get a single</span>
+<a name="l00124"></a>00124 <span class="comment">   * descriptive string for this error chain (see the @a child member)</span>
+<a name="l00125"></a>00125 <span class="comment">   * or svn_handle_error2() to print the error chain in full.  This is</span>
+<a name="l00126"></a>00126 <span class="comment">   * because Subversion&#39;s API functions sometimes add many links to</span>
+<a name="l00127"></a>00127 <span class="comment">   * the error chain that lack details (used only to produce virtual</span>
+<a name="l00128"></a>00128 <span class="comment">   * stack traces).  (Use svn_error_purge_tracing() to remove those</span>
+<a name="l00129"></a>00129 <span class="comment">   * trace-only links from the error chain.)</span>
 <a name="l00130"></a>00130 <span class="comment">   */</span>
-<a name="l00131"></a><a class="code" href="structsvn__error__t.html#a63401baa8097d37b422642747a23adea">00131</a>   <span class="keyword">struct </span><a class="code" href="structsvn__error__t.html" title="Subversion error object.">svn_error_t</a> *<a class="code" href="structsvn__error__t.html#a63401baa8097d37b422642747a23adea" title="Pointer to the error we &quot;wrap&quot; (may be NULL).">child</a>;
+<a name="l00131"></a><a class="code" href="structsvn__error__t.html#a2644a98be02ca1aa123cc66d87a2ce5a">00131</a>   <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="structsvn__error__t.html#a2644a98be02ca1aa123cc66d87a2ce5a" title="Details from the producer of error.">message</a>;
 <a name="l00132"></a>00132 <span class="comment"></span>
-<a name="l00133"></a>00133 <span class="comment">  /** The pool in which this error object is allocated.  (If</span>
-<a name="l00134"></a>00134 <span class="comment">   * Subversion&#39;s APIs are used to manage error chains, then this pool</span>
-<a name="l00135"></a>00135 <span class="comment">   * will contain the whole error chain of which this object is a</span>
-<a name="l00136"></a>00136 <span class="comment">   * member.) */</span>
-<a name="l00137"></a><a class="code" href="structsvn__error__t.html#a4021c8fa197b34b8f7e93a4d1b58db2f">00137</a>   apr_pool_t *<a class="code" href="structsvn__error__t.html#a4021c8fa197b34b8f7e93a4d1b58db2f" title="The pool in which this error object is allocated.">pool</a>;
+<a name="l00133"></a>00133 <span class="comment">  /** Pointer to the error we &quot;wrap&quot; (may be @c NULL).  Via this</span>
+<a name="l00134"></a>00134 <span class="comment">   * member, individual error object can be strung together into an</span>
+<a name="l00135"></a>00135 <span class="comment">   * &quot;error chain&quot;.</span>
+<a name="l00136"></a>00136 <span class="comment">   */</span>
+<a name="l00137"></a><a class="code" href="structsvn__error__t.html#a63401baa8097d37b422642747a23adea">00137</a>   <span class="keyword">struct </span><a class="code" href="structsvn__error__t.html" title="Subversion error object.">svn_error_t</a> *<a class="code" href="structsvn__error__t.html#a63401baa8097d37b422642747a23adea" title="Pointer to the error we &quot;wrap&quot; (may be NULL).">child</a>;
 <a name="l00138"></a>00138 <span class="comment"></span>
-<a name="l00139"></a>00139 <span class="comment">  /** Source file where the error originated (iff @c SVN_DEBUG;</span>
-<a name="l00140"></a>00140 <span class="comment">   * undefined otherwise).</span>
-<a name="l00141"></a>00141 <span class="comment">   */</span>
-<a name="l00142"></a><a class="code" href="structsvn__error__t.html#a4443418f5cc672a279fc8dc230e441d8">00142</a>   <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="structsvn__error__t.html#a4443418f5cc672a279fc8dc230e441d8" title="Source file where the error originated (iff SVN_DEBUG; undefined otherwise).">file</a>;
-<a name="l00143"></a>00143 <span class="comment"></span>
-<a name="l00144"></a>00144 <span class="comment">  /** Source line where the error originated (iff @c SVN_DEBUG;</span>
-<a name="l00145"></a>00145 <span class="comment">   * undefined otherwise).</span>
-<a name="l00146"></a>00146 <span class="comment">   */</span>
-<a name="l00147"></a><a class="code" href="structsvn__error__t.html#a4d28c854ae1bf82c925c337d05986a9a">00147</a>   <span class="keywordtype">long</span> <a class="code" href="structsvn__error__t.html#a4d28c854ae1bf82c925c337d05986a9a" title="Source line where the error originated (iff SVN_DEBUG; undefined otherwise).">line</a>;
-<a name="l00148"></a>00148 
-<a name="l00149"></a>00149 } <a class="code" href="svn__types_8h.html#aee5cf08f356d7506dcd929a7f2e51aa0" title="Subversion error object.">svn_error_t</a>;
-<a name="l00150"></a>00150 
-<a name="l00151"></a>00151 
-<a name="l00152"></a>00152 
-<a name="l00153"></a>00153 <span class="comment">/* See svn_version.h.</span>
-<a name="l00154"></a>00154 <span class="comment">   Defined here to avoid including svn_version.h from all public headers. */</span>
-<a name="l00155"></a>00155 <span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="structsvn__version__t.html" title="Version information.">svn_version_t</a> <a class="code" href="structsvn__version__t.html" title="Version information.">svn_version_t</a>;
+<a name="l00139"></a>00139 <span class="comment">  /** The pool in which this error object is allocated.  (If</span>
+<a name="l00140"></a>00140 <span class="comment">   * Subversion&#39;s APIs are used to manage error chains, then this pool</span>
+<a name="l00141"></a>00141 <span class="comment">   * will contain the whole error chain of which this object is a</span>
+<a name="l00142"></a>00142 <span class="comment">   * member.) */</span>
+<a name="l00143"></a><a class="code" href="structsvn__error__t.html#a4021c8fa197b34b8f7e93a4d1b58db2f">00143</a>   apr_pool_t *<a class="code" href="structsvn__error__t.html#a4021c8fa197b34b8f7e93a4d1b58db2f" title="The pool in which this error object is allocated.">pool</a>;
+<a name="l00144"></a>00144 <span class="comment"></span>
+<a name="l00145"></a>00145 <span class="comment">  /** Source file where the error originated (iff @c SVN_DEBUG;</span>
+<a name="l00146"></a>00146 <span class="comment">   * undefined otherwise).</span>
+<a name="l00147"></a>00147 <span class="comment">   */</span>
+<a name="l00148"></a><a class="code" href="structsvn__error__t.html#a4443418f5cc672a279fc8dc230e441d8">00148</a>   <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="structsvn__error__t.html#a4443418f5cc672a279fc8dc230e441d8" title="Source file where the error originated (iff SVN_DEBUG; undefined otherwise).">file</a>;
+<a name="l00149"></a>00149 <span class="comment"></span>
+<a name="l00150"></a>00150 <span class="comment">  /** Source line where the error originated (iff @c SVN_DEBUG;</span>
+<a name="l00151"></a>00151 <span class="comment">   * undefined otherwise).</span>
+<a name="l00152"></a>00152 <span class="comment">   */</span>
+<a name="l00153"></a><a class="code" href="structsvn__error__t.html#a4d28c854ae1bf82c925c337d05986a9a">00153</a>   <span class="keywordtype">long</span> <a class="code" href="structsvn__error__t.html#a4d28c854ae1bf82c925c337d05986a9a" title="Source line where the error originated (iff SVN_DEBUG; undefined otherwise).">line</a>;
+<a name="l00154"></a>00154 
+<a name="l00155"></a>00155 } <a class="code" href="svn__types_8h.html#aee5cf08f356d7506dcd929a7f2e51aa0" title="Subversion error object.">svn_error_t</a>;
 <a name="l00156"></a>00156 
 <a name="l00157"></a>00157 
-<a name="l00158"></a>00158 <span class="comment"></span>
-<a name="l00159"></a>00159 <span class="comment">/** @defgroup APR_ARRAY_compat_macros APR Array Compatibility Helper Macros</span>
-<a name="l00160"></a>00160 <span class="comment"> * These macros are provided by APR itself from version 1.3.</span>
-<a name="l00161"></a>00161 <span class="comment"> * Definitions are provided here for when using older versions of APR.</span>
-<a name="l00162"></a>00162 <span class="comment"> * @{</span>
-<a name="l00163"></a>00163 <span class="comment"> */</span>
-<a name="l00164"></a>00164 <span class="comment"></span>
-<a name="l00165"></a>00165 <span class="comment">/** index into an apr_array_header_t */</span>
-<a name="l00166"></a>00166 <span class="preprocessor">#ifndef APR_ARRAY_IDX</span>
-<a name="l00167"></a>00167 <span class="preprocessor"></span><span class="preprocessor">#define APR_ARRAY_IDX(ary,i,type) (((type *)(ary)-&gt;elts)[i])</span>
-<a name="l00168"></a>00168 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
-<a name="l00169"></a>00169 <span class="preprocessor"></span><span class="comment"></span>
-<a name="l00170"></a>00170 <span class="comment">/** easier array-pushing syntax */</span>
-<a name="l00171"></a>00171 <span class="preprocessor">#ifndef APR_ARRAY_PUSH</span>
-<a name="l00172"></a>00172 <span class="preprocessor"></span><span class="preprocessor">#define APR_ARRAY_PUSH(ary,type) (*((type *)apr_array_push(ary)))</span>
-<a name="l00173"></a>00173 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
-<a name="l00174"></a>00174 <span class="preprocessor"></span><span class="comment"></span>
-<a name="l00175"></a>00175 <span class="comment">/** @} */</span>
-<a name="l00176"></a>00176 
-<a name="l00177"></a>00177 
-<a name="l00178"></a>00178 <span class="comment"></span>
-<a name="l00179"></a>00179 <span class="comment">/** @defgroup apr_hash_utilities APR Hash Table Helpers</span>
-<a name="l00180"></a>00180 <span class="comment"> * These functions enable the caller to dereference an APR hash table index</span>
-<a name="l00181"></a>00181 <span class="comment"> * without type casts or temporary variables.</span>
-<a name="l00182"></a>00182 <span class="comment"> *</span>
-<a name="l00183"></a>00183 <span class="comment"> * ### These are private, and may go away when APR implements them natively.</span>
-<a name="l00184"></a>00184 <span class="comment"> * @{</span>
-<a name="l00185"></a>00185 <span class="comment"> */</span>
-<a name="l00186"></a>00186 <span class="comment"></span>
-<a name="l00187"></a>00187 <span class="comment">/** Return the key of the hash table entry indexed by @a hi. */</span>
-<a name="l00188"></a>00188 <span class="keyword">const</span> <span class="keywordtype">void</span> *
-<a name="l00189"></a>00189 <a class="code" href="group__apr__hash__utilities.html#ga728a256d97b3f3c119be4e5be4de7ca8" title="Return the key of the hash table entry indexed by hi.">svn__apr_hash_index_key</a>(<span class="keyword">const</span> apr_hash_index_t *hi);
-<a name="l00190"></a>00190 <span class="comment"></span>
-<a name="l00191"></a>00191 <span class="comment">/** Return the key length of the hash table entry indexed by @a hi. */</span>
-<a name="l00192"></a>00192 apr_ssize_t
-<a name="l00193"></a>00193 <a class="code" href="group__apr__hash__utilities.html#ga431e010ff94fce46fff281e459839175" title="Return the key length of the hash table entry indexed by hi.">svn__apr_hash_index_klen</a>(<span class="keyword">const</span> apr_hash_index_t *hi);
-<a name="l00194"></a>00194 <span class="comment"></span>
-<a name="l00195"></a>00195 <span class="comment">/** Return the value of the hash table entry indexed by @a hi. */</span>
-<a name="l00196"></a>00196 <span class="keywordtype">void</span> *
-<a name="l00197"></a>00197 <a class="code" href="group__apr__hash__utilities.html#ga3f2a528a9aa2b73a18bfaac0b69c349d" title="Return the value of the hash table entry indexed by hi.">svn__apr_hash_index_val</a>(<span class="keyword">const</span> apr_hash_index_t *hi);
-<a name="l00198"></a>00198 <span class="comment"></span>
-<a name="l00199"></a>00199 <span class="comment">/** @} */</span>
-<a name="l00200"></a>00200 
-<a name="l00201"></a>00201 
-<a name="l00202"></a>00202 <span class="comment"></span>
-<a name="l00203"></a>00203 <span class="comment">/** On Windows, APR_STATUS_IS_ENOTDIR includes several kinds of</span>
-<a name="l00204"></a>00204 <span class="comment"> * invalid-pathname error but not ERROR_INVALID_NAME, so we include it.</span>
-<a name="l00205"></a>00205 <span class="comment"> * We also include ERROR_DIRECTORY as that was not included in apr versions</span>
-<a name="l00206"></a>00206 <span class="comment"> * before 1.4.0 and this fix is not backported */</span>
-<a name="l00207"></a>00207 <span class="comment">/* ### These fixes should go into APR. */</span>
-<a name="l00208"></a>00208 <span class="preprocessor">#ifndef WIN32</span>
-<a name="l00209"></a><a class="code" href="svn__types_8h.html#a2bbb6c247a5eca01e1e264e4c2e6319c">00209</a> <span class="preprocessor"></span><span class="preprocessor">#define SVN__APR_STATUS_IS_ENOTDIR(s)  APR_STATUS_IS_ENOTDIR(s)</span>
-<a name="l00210"></a>00210 <span class="preprocessor"></span><span class="preprocessor">#else</span>
-<a name="l00211"></a>00211 <span class="preprocessor"></span><span class="preprocessor">#define SVN__APR_STATUS_IS_ENOTDIR(s)  (APR_STATUS_IS_ENOTDIR(s) \</span>
-<a name="l00212"></a>00212 <span class="preprocessor">                      || ((s) == APR_OS_START_SYSERR + ERROR_DIRECTORY) \</span>
-<a name="l00213"></a>00213 <span class="preprocessor">                      || ((s) == APR_OS_START_SYSERR + ERROR_INVALID_NAME))</span>
-<a name="l00214"></a>00214 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
-<a name="l00215"></a>00215 <span class="preprocessor"></span><span class="comment"></span>
-<a name="l00216"></a>00216 <span class="comment">/** @} */</span>
-<a name="l00217"></a>00217 
-<a name="l00218"></a>00218 
-<a name="l00219"></a>00219 <span class="comment"></span>
-<a name="l00220"></a>00220 <span class="comment">/** The various types of nodes in the Subversion filesystem. */</span>
-<a name="l00221"></a><a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9a">00221</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> <a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9a" title="The various types of nodes in the Subversion filesystem.">svn_node_kind_t</a>
-<a name="l00222"></a>00222 {<span class="comment"></span>
-<a name="l00223"></a>00223 <span class="comment">  /** absent */</span>
-<a name="l00224"></a><a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9aae4066898ada99c4a3bc94e80aabe78b5">00224</a>   <a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9aae4066898ada99c4a3bc94e80aabe78b5" title="absent">svn_node_none</a>,
-<a name="l00225"></a>00225 <span class="comment"></span>
-<a name="l00226"></a>00226 <span class="comment">  /** regular file */</span>
-<a name="l00227"></a><a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9aaa95e604c61f68662a3baed477db64083">00227</a>   <a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9aaa95e604c61f68662a3baed477db64083" title="regular file">svn_node_file</a>,
-<a name="l00228"></a>00228 <span class="comment"></span>
-<a name="l00229"></a>00229 <span class="comment">  /** directory */</span>
-<a name="l00230"></a><a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9aaba05e448cccf503e25be6506d7bf9a5b">00230</a>   <a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9aaba05e448cccf503e25be6506d7bf9a5b" title="directory">svn_node_dir</a>,
+<a name="l00158"></a>00158 
+<a name="l00159"></a>00159 <span class="comment">/* See svn_version.h.</span>
+<a name="l00160"></a>00160 <span class="comment">   Defined here to avoid including svn_version.h from all public headers. */</span>
+<a name="l00161"></a>00161 <span class="keyword">typedef</span> <span class="keyword">struct </span><a class="code" href="structsvn__version__t.html" title="Version information.">svn_version_t</a> <a class="code" href="structsvn__version__t.html" title="Version information.">svn_version_t</a>;
+<a name="l00162"></a>00162 
+<a name="l00163"></a>00163 
+<a name="l00164"></a>00164 <span class="comment"></span>
+<a name="l00165"></a>00165 <span class="comment">/** @defgroup APR_ARRAY_compat_macros APR Array Compatibility Helper Macros</span>
+<a name="l00166"></a>00166 <span class="comment"> * These macros are provided by APR itself from version 1.3.</span>
+<a name="l00167"></a>00167 <span class="comment"> * Definitions are provided here for when using older versions of APR.</span>
+<a name="l00168"></a>00168 <span class="comment"> * @{</span>
+<a name="l00169"></a>00169 <span class="comment"> */</span>
+<a name="l00170"></a>00170 <span class="comment"></span>
+<a name="l00171"></a>00171 <span class="comment">/** index into an apr_array_header_t */</span>
+<a name="l00172"></a>00172 <span class="preprocessor">#ifndef APR_ARRAY_IDX</span>
+<a name="l00173"></a>00173 <span class="preprocessor"></span><span class="preprocessor">#define APR_ARRAY_IDX(ary,i,type) (((type *)(ary)-&gt;elts)[i])</span>
+<a name="l00174"></a>00174 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
+<a name="l00175"></a>00175 <span class="preprocessor"></span><span class="comment"></span>
+<a name="l00176"></a>00176 <span class="comment">/** easier array-pushing syntax */</span>
+<a name="l00177"></a>00177 <span class="preprocessor">#ifndef APR_ARRAY_PUSH</span>
+<a name="l00178"></a>00178 <span class="preprocessor"></span><span class="preprocessor">#define APR_ARRAY_PUSH(ary,type) (*((type *)apr_array_push(ary)))</span>
+<a name="l00179"></a>00179 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
+<a name="l00180"></a>00180 <span class="preprocessor"></span><span class="comment"></span>
+<a name="l00181"></a>00181 <span class="comment">/** @} */</span>
+<a name="l00182"></a>00182 
+<a name="l00183"></a>00183 
+<a name="l00184"></a>00184 <span class="comment"></span>
+<a name="l00185"></a>00185 <span class="comment">/** @defgroup apr_hash_utilities APR Hash Table Helpers</span>
+<a name="l00186"></a>00186 <span class="comment"> * These functions enable the caller to dereference an APR hash table index</span>
+<a name="l00187"></a>00187 <span class="comment"> * without type casts or temporary variables.</span>
+<a name="l00188"></a>00188 <span class="comment"> *</span>
+<a name="l00189"></a>00189 <span class="comment"> * ### These are private, and may go away when APR implements them natively.</span>
+<a name="l00190"></a>00190 <span class="comment"> * @{</span>
+<a name="l00191"></a>00191 <span class="comment"> */</span>
+<a name="l00192"></a>00192 <span class="comment"></span>
+<a name="l00193"></a>00193 <span class="comment">/** Return the key of the hash table entry indexed by @a hi. */</span>
+<a name="l00194"></a>00194 <span class="keyword">const</span> <span class="keywordtype">void</span> *
+<a name="l00195"></a>00195 <a class="code" href="group__apr__hash__utilities.html#ga728a256d97b3f3c119be4e5be4de7ca8" title="Return the key of the hash table entry indexed by hi.">svn__apr_hash_index_key</a>(<span class="keyword">const</span> apr_hash_index_t *hi);
+<a name="l00196"></a>00196 <span class="comment"></span>
+<a name="l00197"></a>00197 <span class="comment">/** Return the key length of the hash table entry indexed by @a hi. */</span>
+<a name="l00198"></a>00198 apr_ssize_t
+<a name="l00199"></a>00199 <a class="code" href="group__apr__hash__utilities.html#ga431e010ff94fce46fff281e459839175" title="Return the key length of the hash table entry indexed by hi.">svn__apr_hash_index_klen</a>(<span class="keyword">const</span> apr_hash_index_t *hi);
+<a name="l00200"></a>00200 <span class="comment"></span>
+<a name="l00201"></a>00201 <span class="comment">/** Return the value of the hash table entry indexed by @a hi. */</span>
+<a name="l00202"></a>00202 <span class="keywordtype">void</span> *
+<a name="l00203"></a>00203 <a class="code" href="group__apr__hash__utilities.html#ga3f2a528a9aa2b73a18bfaac0b69c349d" title="Return the value of the hash table entry indexed by hi.">svn__apr_hash_index_val</a>(<span class="keyword">const</span> apr_hash_index_t *hi);
+<a name="l00204"></a>00204 <span class="comment"></span>
+<a name="l00205"></a>00205 <span class="comment">/** @} */</span>
+<a name="l00206"></a>00206 
+<a name="l00207"></a>00207 
+<a name="l00208"></a>00208 <span class="comment"></span>
+<a name="l00209"></a>00209 <span class="comment">/** On Windows, APR_STATUS_IS_ENOTDIR includes several kinds of</span>
+<a name="l00210"></a>00210 <span class="comment"> * invalid-pathname error but not ERROR_INVALID_NAME, so we include it.</span>
+<a name="l00211"></a>00211 <span class="comment"> * We also include ERROR_DIRECTORY as that was not included in apr versions</span>
+<a name="l00212"></a>00212 <span class="comment"> * before 1.4.0 and this fix is not backported */</span>
+<a name="l00213"></a>00213 <span class="comment">/* ### These fixes should go into APR. */</span>
+<a name="l00214"></a>00214 <span class="preprocessor">#ifndef WIN32</span>
+<a name="l00215"></a><a class="code" href="svn__types_8h.html#a2bbb6c247a5eca01e1e264e4c2e6319c">00215</a> <span class="preprocessor"></span><span class="preprocessor">#define SVN__APR_STATUS_IS_ENOTDIR(s)  APR_STATUS_IS_ENOTDIR(s)</span>
+<a name="l00216"></a>00216 <span class="preprocessor"></span><span class="preprocessor">#else</span>
+<a name="l00217"></a>00217 <span class="preprocessor"></span><span class="preprocessor">#define SVN__APR_STATUS_IS_ENOTDIR(s)  (APR_STATUS_IS_ENOTDIR(s) \</span>
+<a name="l00218"></a>00218 <span class="preprocessor">                      || ((s) == APR_OS_START_SYSERR + ERROR_DIRECTORY) \</span>
+<a name="l00219"></a>00219 <span class="preprocessor">                      || ((s) == APR_OS_START_SYSERR + ERROR_INVALID_NAME))</span>
+<a name="l00220"></a>00220 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
+<a name="l00221"></a>00221 <span class="preprocessor"></span><span class="comment"></span>
+<a name="l00222"></a>00222 <span class="comment">/** @} */</span>
+<a name="l00223"></a>00223 
+<a name="l00224"></a>00224 
+<a name="l00225"></a>00225 <span class="comment"></span>
+<a name="l00226"></a>00226 <span class="comment">/** The various types of nodes in the Subversion filesystem. */</span>
+<a name="l00227"></a><a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9a">00227</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> <a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9a" title="The various types of nodes in the Subversion filesystem.">svn_node_kind_t</a>
+<a name="l00228"></a>00228 {<span class="comment"></span>
+<a name="l00229"></a>00229 <span class="comment">  /** absent */</span>
+<a name="l00230"></a><a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9aae4066898ada99c4a3bc94e80aabe78b5">00230</a>   <a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9aae4066898ada99c4a3bc94e80aabe78b5" title="absent">svn_node_none</a>,
 <a name="l00231"></a>00231 <span class="comment"></span>
-<a name="l00232"></a>00232 <span class="comment">  /** something&#39;s here, but we don&#39;t know what */</span>
-<a name="l00233"></a><a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9aa8fa9327ee73e41216ad586867fea4b94">00233</a>   <a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9aa8fa9327ee73e41216ad586867fea4b94" title="something&#39;s here, but we don&#39;t know what">svn_node_unknown</a>,
+<a name="l00232"></a>00232 <span class="comment">  /** regular file */</span>
+<a name="l00233"></a><a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9aaa95e604c61f68662a3baed477db64083">00233</a>   <a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9aaa95e604c61f68662a3baed477db64083" title="regular file">svn_node_file</a>,
 <a name="l00234"></a>00234 <span class="comment"></span>
-<a name="l00235"></a>00235 <span class="comment">  /**</span>
-<a name="l00236"></a>00236 <span class="comment">   * symbolic link</span>
-<a name="l00237"></a>00237 <span class="comment">   * @note This value is not currently used by the public API.</span>
-<a name="l00238"></a>00238 <span class="comment">   * @since New in 1.8.</span>
-<a name="l00239"></a>00239 <span class="comment">   */</span>
-<a name="l00240"></a><a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9aa0b9a7eb2f3ac9ed565874a083f136a62">00240</a>   <a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9aa0b9a7eb2f3ac9ed565874a083f136a62" title="symbolic link">svn_node_symlink</a>
-<a name="l00241"></a>00241 } <a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9a" title="The various types of nodes in the Subversion filesystem.">svn_node_kind_t</a>;
-<a name="l00242"></a>00242 <span class="comment"></span>
-<a name="l00243"></a>00243 <span class="comment">/** Return a constant string expressing @a kind as an English word, e.g.,</span>
-<a name="l00244"></a>00244 <span class="comment"> * &quot;file&quot;, &quot;dir&quot;, etc.  The string is not localized, as it may be used for</span>
-<a name="l00245"></a>00245 <span class="comment"> * client&lt;-&gt;server communications.  If the kind is not recognized, return</span>
-<a name="l00246"></a>00246 <span class="comment"> * &quot;unknown&quot;.</span>
-<a name="l00247"></a>00247 <span class="comment"> *</span>
-<a name="l00248"></a>00248 <span class="comment"> * @since New in 1.6.</span>
-<a name="l00249"></a>00249 <span class="comment"> */</span>
-<a name="l00250"></a>00250 <span class="keyword">const</span> <span class="keywordtype">char</span> *
-<a name="l00251"></a>00251 <a class="code" href="svn__types_8h.html#a908f230efa1571ead34bb883e7a3c924" title="Return a constant string expressing kind as an English word, e.g., &quot;file&quot;, &quot;dir&quot;, etc...">svn_node_kind_to_word</a>(<a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9a" title="The various types of nodes in the Subversion filesystem.">svn_node_kind_t</a> kind);
-<a name="l00252"></a>00252 <span class="comment"></span>
-<a name="l00253"></a>00253 <span class="comment">/** Return the appropriate node_kind for @a word.  @a word is as</span>
-<a name="l00254"></a>00254 <span class="comment"> * returned from svn_node_kind_to_word().  If @a word does not</span>
-<a name="l00255"></a>00255 <span class="comment"> * represent a recognized kind or is @c NULL, return #svn_node_unknown.</span>
-<a name="l00256"></a>00256 <span class="comment"> *</span>
-<a name="l00257"></a>00257 <span class="comment"> * @since New in 1.6.</span>
-<a name="l00258"></a>00258 <span class="comment"> */</span>
-<a name="l00259"></a>00259 <a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9a" title="The various types of nodes in the Subversion filesystem.">svn_node_kind_t</a>
-<a name="l00260"></a>00260 <a class="code" href="svn__types_8h.html#a0647da15a0f8c919b370c9c940832b33" title="Return the appropriate node_kind for word.">svn_node_kind_from_word</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *word);
-<a name="l00261"></a>00261 
-<a name="l00262"></a>00262 <span class="comment"></span>
-<a name="l00263"></a>00263 <span class="comment">/** Generic three-state property to represent an unknown value for values</span>
-<a name="l00264"></a>00264 <span class="comment"> * that are just like booleans.  The values have been set deliberately to</span>
-<a name="l00265"></a>00265 <span class="comment"> * make tristates disjoint from #svn_boolean_t.</span>
-<a name="l00266"></a>00266 <span class="comment"> *</span>
-<a name="l00267"></a>00267 <span class="comment"> * @note It is unsafe to use apr_pcalloc() to allocate these, since &#39;0&#39; is</span>
-<a name="l00268"></a>00268 <span class="comment"> * not a valid value.</span>
-<a name="l00269"></a>00269 <span class="comment"> *</span>
-<a name="l00270"></a>00270 <span class="comment"> * @since New in 1.7. */</span>
-<a name="l00271"></a><a class="code" href="svn__types_8h.html#a833b517afeac9ae9b345e47e0d85ea5d">00271</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> <a class="code" href="svn__types_8h.html#a833b517afeac9ae9b345e47e0d85ea5d" title="Generic three-state property to represent an unknown value for values that are just like booleans...">svn_tristate_t</a>
-<a name="l00272"></a>00272 {
-<a name="l00273"></a>00273   svn_tristate_false = 2,
-<a name="l00274"></a>00274   svn_tristate_true,
-<a name="l00275"></a>00275   svn_tristate_unknown
-<a name="l00276"></a>00276 } <a class="code" href="svn__types_8h.html#a833b517afeac9ae9b345e47e0d85ea5d" title="Generic three-state property to represent an unknown value for values that are just like booleans...">svn_tristate_t</a>;
-<a name="l00277"></a>00277 <span class="comment"></span>
-<a name="l00278"></a>00278 <span class="comment">/** Return a constant string &quot;true&quot;, &quot;false&quot; or NULL representing the value of</span>
-<a name="l00279"></a>00279 <span class="comment"> * @a tristate.</span>
-<a name="l00280"></a>00280 <span class="comment"> *</span>
-<a name="l00281"></a>00281 <span class="comment"> * @since New in 1.7.</span>
-<a name="l00282"></a>00282 <span class="comment"> */</span>
-<a name="l00283"></a>00283 <span class="keyword">const</span> <span class="keywordtype">char</span> *
-<a name="l00284"></a>00284 <a class="code" href="svn__types_8h.html#a49e104ce0a3b8400810477072799dc78" title="Return a constant string &quot;true&quot;, &quot;false&quot; or NULL representing the value of tristate.">svn_tristate__to_word</a>(<a class="code" href="svn__types_8h.html#a833b517afeac9ae9b345e47e0d85ea5d" title="Generic three-state property to represent an unknown value for values that are just like booleans...">svn_tristate_t</a> tristate);
-<a name="l00285"></a>00285 <span class="comment"></span>
-<a name="l00286"></a>00286 <span class="comment">/** Return the appropriate tristate for @a word. If @a word is &quot;true&quot;, returns</span>
-<a name="l00287"></a>00287 <span class="comment"> * #svn_tristate_true; if @a word is &quot;false&quot;, returns #svn_tristate_false,</span>
-<a name="l00288"></a>00288 <span class="comment"> * for all other values (including NULL) returns #svn_tristate_unknown.</span>
+<a name="l00235"></a>00235 <span class="comment">  /** directory */</span>
+<a name="l00236"></a><a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9aaba05e448cccf503e25be6506d7bf9a5b">00236</a>   <a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9aaba05e448cccf503e25be6506d7bf9a5b" title="directory">svn_node_dir</a>,
+<a name="l00237"></a>00237 <span class="comment"></span>
+<a name="l00238"></a>00238 <span class="comment">  /** something&#39;s here, but we don&#39;t know what */</span>
+<a name="l00239"></a><a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9aa8fa9327ee73e41216ad586867fea4b94">00239</a>   <a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9aa8fa9327ee73e41216ad586867fea4b94" title="something&#39;s here, but we don&#39;t know what">svn_node_unknown</a>,
+<a name="l00240"></a>00240 <span class="comment"></span>
+<a name="l00241"></a>00241 <span class="comment">  /**</span>
+<a name="l00242"></a>00242 <span class="comment">   * symbolic link</span>
+<a name="l00243"></a>00243 <span class="comment">   * @note This value is not currently used by the public API.</span>
+<a name="l00244"></a>00244 <span class="comment">   * @since New in 1.8.</span>
+<a name="l00245"></a>00245 <span class="comment">   */</span>
+<a name="l00246"></a><a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9aa0b9a7eb2f3ac9ed565874a083f136a62">00246</a>   <a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9aa0b9a7eb2f3ac9ed565874a083f136a62" title="symbolic link">svn_node_symlink</a>
+<a name="l00247"></a>00247 } <a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9a" title="The various types of nodes in the Subversion filesystem.">svn_node_kind_t</a>;
+<a name="l00248"></a>00248 <span class="comment"></span>
+<a name="l00249"></a>00249 <span class="comment">/** Return a constant string expressing @a kind as an English word, e.g.,</span>
+<a name="l00250"></a>00250 <span class="comment"> * &quot;file&quot;, &quot;dir&quot;, etc.  The string is not localized, as it may be used for</span>
+<a name="l00251"></a>00251 <span class="comment"> * client&lt;-&gt;server communications.  If the kind is not recognized, return</span>
+<a name="l00252"></a>00252 <span class="comment"> * &quot;unknown&quot;.</span>
+<a name="l00253"></a>00253 <span class="comment"> *</span>
+<a name="l00254"></a>00254 <span class="comment"> * @since New in 1.6.</span>
+<a name="l00255"></a>00255 <span class="comment"> */</span>
+<a name="l00256"></a>00256 <span class="keyword">const</span> <span class="keywordtype">char</span> *
+<a name="l00257"></a>00257 <a class="code" href="svn__types_8h.html#a908f230efa1571ead34bb883e7a3c924" title="Return a constant string expressing kind as an English word, e.g., &quot;file&quot;, &quot;dir&quot;, etc...">svn_node_kind_to_word</a>(<a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9a" title="The various types of nodes in the Subversion filesystem.">svn_node_kind_t</a> kind);
+<a name="l00258"></a>00258 <span class="comment"></span>
+<a name="l00259"></a>00259 <span class="comment">/** Return the appropriate node_kind for @a word.  @a word is as</span>
+<a name="l00260"></a>00260 <span class="comment"> * returned from svn_node_kind_to_word().  If @a word does not</span>
+<a name="l00261"></a>00261 <span class="comment"> * represent a recognized kind or is @c NULL, return #svn_node_unknown.</span>
+<a name="l00262"></a>00262 <span class="comment"> *</span>
+<a name="l00263"></a>00263 <span class="comment"> * @since New in 1.6.</span>
+<a name="l00264"></a>00264 <span class="comment"> */</span>
+<a name="l00265"></a>00265 <a class="code" href="svn__types_8h.html#ac3ca125707a8ca1289c73236b5ce7f9a" title="The various types of nodes in the Subversion filesystem.">svn_node_kind_t</a>
+<a name="l00266"></a>00266 <a class="code" href="svn__types_8h.html#a0647da15a0f8c919b370c9c940832b33" title="Return the appropriate node_kind for word.">svn_node_kind_from_word</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *word);
+<a name="l00267"></a>00267 
+<a name="l00268"></a>00268 <span class="comment"></span>
+<a name="l00269"></a>00269 <span class="comment">/** Generic three-state property to represent an unknown value for values</span>
+<a name="l00270"></a>00270 <span class="comment"> * that are just like booleans.  The values have been set deliberately to</span>
+<a name="l00271"></a>00271 <span class="comment"> * make tristates disjoint from #svn_boolean_t.</span>
+<a name="l00272"></a>00272 <span class="comment"> *</span>
+<a name="l00273"></a>00273 <span class="comment"> * @note It is unsafe to use apr_pcalloc() to allocate these, since &#39;0&#39; is</span>
+<a name="l00274"></a>00274 <span class="comment"> * not a valid value.</span>
+<a name="l00275"></a>00275 <span class="comment"> *</span>
+<a name="l00276"></a>00276 <span class="comment"> * @since New in 1.7. */</span>
+<a name="l00277"></a><a class="code" href="svn__types_8h.html#a833b517afeac9ae9b345e47e0d85ea5d">00277</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> <a class="code" href="svn__types_8h.html#a833b517afeac9ae9b345e47e0d85ea5d" title="Generic three-state property to represent an unknown value for values that are just like booleans...">svn_tristate_t</a>
+<a name="l00278"></a>00278 {<span class="comment"></span>
+<a name="l00279"></a>00279 <span class="comment">  /** state known to be false (the constant does not evaulate to false) */</span>
+<a name="l00280"></a><a class="code" href="svn__types_8h.html#a833b517afeac9ae9b345e47e0d85ea5daf93ff7e8df3d4891ffbbed9e6c5cbb88">00280</a>   <a class="code" href="svn__types_8h.html#a833b517afeac9ae9b345e47e0d85ea5daf93ff7e8df3d4891ffbbed9e6c5cbb88" title="state known to be false (the constant does not evaulate to false)">svn_tristate_false</a> = 2,<span class="comment"></span>
+<a name="l00281"></a>00281 <span class="comment">  /** state known to be true */</span>
+<a name="l00282"></a><a class="code" href="svn__types_8h.html#a833b517afeac9ae9b345e47e0d85ea5dab561d3a1193424ef74ff1813e4fe9e82">00282</a>   <a class="code" href="svn__types_8h.html#a833b517afeac9ae9b345e47e0d85ea5dab561d3a1193424ef74ff1813e4fe9e82" title="state known to be true">svn_tristate_true</a>,<span class="comment"></span>
+<a name="l00283"></a>00283 <span class="comment">  /** state could be true or false */</span>
+<a name="l00284"></a><a class="code" href="svn__types_8h.html#a833b517afeac9ae9b345e47e0d85ea5da4f52e9ee42abbd7a4d40ee8eef23cdf2">00284</a>   <a class="code" href="svn__types_8h.html#a833b517afeac9ae9b345e47e0d85ea5da4f52e9ee42abbd7a4d40ee8eef23cdf2" title="state could be true or false">svn_tristate_unknown</a>
+<a name="l00285"></a>00285 } <a class="code" href="svn__types_8h.html#a833b517afeac9ae9b345e47e0d85ea5d" title="Generic three-state property to represent an unknown value for values that are just like booleans...">svn_tristate_t</a>;
+<a name="l00286"></a>00286 <span class="comment"></span>
+<a name="l00287"></a>00287 <span class="comment">/** Return a constant string &quot;true&quot;, &quot;false&quot; or NULL representing the value of</span>
+<a name="l00288"></a>00288 <span class="comment"> * @a tristate.</span>
 <a name="l00289"></a>00289 <span class="comment"> *</span>
 <a name="l00290"></a>00290 <span class="comment"> * @since New in 1.7.</span>
 <a name="l00291"></a>00291 <span class="comment"> */</span>
-<a name="l00292"></a>00292 <a class="code" href="svn__types_8h.html#a833b517afeac9ae9b345e47e0d85ea5d" title="Generic three-state property to represent an unknown value for values that are just like booleans...">svn_tristate_t</a>
-<a name="l00293"></a>00293 <a class="code" href="svn__types_8h.html#a3d89994fb865d23765e8e437ccca093a" title="Return the appropriate tristate for word.">svn_tristate__from_word</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> * word);
-<a name="l00294"></a>00294 
-<a name="l00295"></a>00295 
-<a name="l00296"></a>00296 <span class="comment"></span>
-<a name="l00297"></a>00297 <span class="comment">/** About Special Files in Subversion</span>
+<a name="l00292"></a>00292 <span class="keyword">const</span> <span class="keywordtype">char</span> *
+<a name="l00293"></a>00293 <a class="code" href="svn__types_8h.html#a49e104ce0a3b8400810477072799dc78" title="Return a constant string &quot;true&quot;, &quot;false&quot; or NULL representing the value of tristate.">svn_tristate__to_word</a>(<a class="code" href="svn__types_8h.html#a833b517afeac9ae9b345e47e0d85ea5d" title="Generic three-state property to represent an unknown value for values that are just like booleans...">svn_tristate_t</a> tristate);
+<a name="l00294"></a>00294 <span class="comment"></span>
+<a name="l00295"></a>00295 <span class="comment">/** Return the appropriate tristate for @a word. If @a word is &quot;true&quot;, returns</span>
+<a name="l00296"></a>00296 <span class="comment"> * #svn_tristate_true; if @a word is &quot;false&quot;, returns #svn_tristate_false,</span>
+<a name="l00297"></a>00297 <span class="comment"> * for all other values (including NULL) returns #svn_tristate_unknown.</span>
 <a name="l00298"></a>00298 <span class="comment"> *</span>
-<a name="l00299"></a>00299 <span class="comment"> * Subversion denotes files that cannot be portably created or</span>
-<a name="l00300"></a>00300 <span class="comment"> * modified as &quot;special&quot; files (svn_node_special).  It stores these</span>
-<a name="l00301"></a>00301 <span class="comment"> * files in the repository as a plain text file with the svn:special</span>
-<a name="l00302"></a>00302 <span class="comment"> * property set.  The file contents contain: a platform-specific type</span>
-<a name="l00303"></a>00303 <span class="comment"> * string, a space character, then any information necessary to create</span>
-<a name="l00304"></a>00304 <span class="comment"> * the file on a supported platform.  For example, if a symbolic link</span>
-<a name="l00305"></a>00305 <span class="comment"> * were being represented, the repository file would have the</span>
-<a name="l00306"></a>00306 <span class="comment"> * following contents:</span>
+<a name="l00299"></a>00299 <span class="comment"> * @since New in 1.7.</span>
+<a name="l00300"></a>00300 <span class="comment"> */</span>
+<a name="l00301"></a>00301 <a class="code" href="svn__types_8h.html#a833b517afeac9ae9b345e47e0d85ea5d" title="Generic three-state property to represent an unknown value for values that are just like booleans...">svn_tristate_t</a>
+<a name="l00302"></a>00302 <a class="code" href="svn__types_8h.html#a3d89994fb865d23765e8e437ccca093a" title="Return the appropriate tristate for word.">svn_tristate__from_word</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> * word);
+<a name="l00303"></a>00303 
+<a name="l00304"></a>00304 
+<a name="l00305"></a>00305 <span class="comment"></span>
+<a name="l00306"></a>00306 <span class="comment">/** About Special Files in Subversion</span>
 <a name="l00307"></a>00307 <span class="comment"> *</span>
-<a name="l00308"></a>00308 <span class="comment"> * &quot;link /path/to/link/target&quot;</span>
-<a name="l00309"></a>00309 <span class="comment"> *</span>
-<a name="l00310"></a>00310 <span class="comment"> * Where &#39;link&#39; is the identifier string showing that this special</span>
-<a name="l00311"></a>00311 <span class="comment"> * file should be a symbolic link and &#39;/path/to/link/target&#39; is the</span>
-<a name="l00312"></a>00312 <span class="comment"> * destination of the symbolic link.</span>
-<a name="l00313"></a>00313 <span class="comment"> *</span>
-<a name="l00314"></a>00314 <span class="comment"> * Special files are stored in the text-base exactly as they are</span>
-<a name="l00315"></a>00315 <span class="comment"> * stored in the repository.  The platform specific files are created</span>
-<a name="l00316"></a>00316 <span class="comment"> * in the working copy at EOL/keyword translation time using</span>
-<a name="l00317"></a>00317 <span class="comment"> * svn_subst_copy_and_translate2().  If the current platform does not</span>
-<a name="l00318"></a>00318 <span class="comment"> * support a specific special file type, the file is copied into the</span>
-<a name="l00319"></a>00319 <span class="comment"> * working copy as it is seen in the repository.  Because of this,</span>
-<a name="l00320"></a>00320 <span class="comment"> * users of other platforms can still view and modify the special</span>
-<a name="l00321"></a>00321 <span class="comment"> * files, even if they do not have their unique properties.</span>
+<a name="l00308"></a>00308 <span class="comment"> * Subversion denotes files that cannot be portably created or</span>
+<a name="l00309"></a>00309 <span class="comment"> * modified as &quot;special&quot; files (svn_node_special).  It stores these</span>
+<a name="l00310"></a>00310 <span class="comment"> * files in the repository as a plain text file with the svn:special</span>
+<a name="l00311"></a>00311 <span class="comment"> * property set.  The file contents contain: a platform-specific type</span>
+<a name="l00312"></a>00312 <span class="comment"> * string, a space character, then any information necessary to create</span>
+<a name="l00313"></a>00313 <span class="comment"> * the file on a supported platform.  For example, if a symbolic link</span>
+<a name="l00314"></a>00314 <span class="comment"> * were being represented, the repository file would have the</span>
+<a name="l00315"></a>00315 <span class="comment"> * following contents:</span>
+<a name="l00316"></a>00316 <span class="comment"> *</span>
+<a name="l00317"></a>00317 <span class="comment"> * &quot;link /path/to/link/target&quot;</span>
+<a name="l00318"></a>00318 <span class="comment"> *</span>
+<a name="l00319"></a>00319 <span class="comment"> * Where &#39;link&#39; is the identifier string showing that this special</span>
+<a name="l00320"></a>00320 <span class="comment"> * file should be a symbolic link and &#39;/path/to/link/target&#39; is the</span>
+<a name="l00321"></a>00321 <span class="comment"> * destination of the symbolic link.</span>
 <a name="l00322"></a>00322 <span class="comment"> *</span>
-<a name="l00323"></a>00323 <span class="comment"> * New types of special files can be added by:</span>
-<a name="l00324"></a>00324 <span class="comment"> *  1. Implementing a platform-dependent routine to create a uniquely</span>
-<a name="l00325"></a>00325 <span class="comment"> *     named special file and one to read the special file in</span>
-<a name="l00326"></a>00326 <span class="comment"> *     libsvn_subr/io.c.</span>
-<a name="l00327"></a>00327 <span class="comment"> *  2. Creating a new textual name similar to</span>
-<a name="l00328"></a>00328 <span class="comment"> *     SVN_SUBST__SPECIAL_LINK_STR in libsvn_subr/subst.c.</span>
-<a name="l00329"></a>00329 <span class="comment"> *  3. Handling the translation/detranslation case for the new type in</span>
-<a name="l00330"></a>00330 <span class="comment"> *     create_special_file and detranslate_special_file, using the</span>
-<a name="l00331"></a>00331 <span class="comment"> *     routines from 1.</span>
-<a name="l00332"></a>00332 <span class="comment"> */</span>
-<a name="l00333"></a>00333 
-<a name="l00334"></a>00334 
-<a name="l00335"></a>00335 <span class="comment"></span>
-<a name="l00336"></a>00336 <span class="comment">/** A revision number. */</span>
-<a name="l00337"></a><a class="code" href="svn__types_8h.html#af16427ed53d30f27da225c56552d2a89">00337</a> <span class="keyword">typedef</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> <a class="code" href="svn__types_8h.html#af16427ed53d30f27da225c56552d2a89" title="About Special Files in Subversion.">svn_revnum_t</a>;
-<a name="l00338"></a>00338 <span class="comment"></span>
-<a name="l00339"></a>00339 <span class="comment">/** Valid revision numbers begin at 0 */</span>
-<a name="l00340"></a><a class="code" href="svn__types_8h.html#a07208246e0c138a99f2bc0a8f50ea1e1">00340</a> <span class="preprocessor">#define SVN_IS_VALID_REVNUM(n) ((n) &gt;= 0)</span>
-<a name="l00341"></a>00341 <span class="preprocessor"></span><span class="comment"></span>
-<a name="l00342"></a>00342 <span class="comment">/** The &#39;official&#39; invalid revision num */</span>
-<a name="l00343"></a><a class="code" href="svn__types_8h.html#a8857d4630bf116eaba54a1b65d43ad92">00343</a> <span class="preprocessor">#define SVN_INVALID_REVNUM ((svn_revnum_t) -1)</span>
-<a name="l00344"></a>00344 <span class="preprocessor"></span><span class="comment"></span>
-<a name="l00345"></a>00345 <span class="comment">/** Not really invalid...just unimportant -- one day, this can be its</span>
-<a name="l00346"></a>00346 <span class="comment"> * own unique value, for now, just make it the same as</span>
-<a name="l00347"></a>00347 <span class="comment"> * #SVN_INVALID_REVNUM.</span>
-<a name="l00348"></a>00348 <span class="comment"> */</span>
-<a name="l00349"></a><a class="code" href="svn__types_8h.html#a4510a289ee3537201a463aa5d7fc5891">00349</a> <span class="preprocessor">#define SVN_IGNORED_REVNUM ((svn_revnum_t) -1)</span>
+<a name="l00323"></a>00323 <span class="comment"> * Special files are stored in the text-base exactly as they are</span>
+<a name="l00324"></a>00324 <span class="comment"> * stored in the repository.  The platform specific files are created</span>
+<a name="l00325"></a>00325 <span class="comment"> * in the working copy at EOL/keyword translation time using</span>
+<a name="l00326"></a>00326 <span class="comment"> * svn_subst_copy_and_translate2().  If the current platform does not</span>
+<a name="l00327"></a>00327 <span class="comment"> * support a specific special file type, the file is copied into the</span>
+<a name="l00328"></a>00328 <span class="comment"> * working copy as it is seen in the repository.  Because of this,</span>
+<a name="l00329"></a>00329 <span class="comment"> * users of other platforms can still view and modify the special</span>
+<a name="l00330"></a>00330 <span class="comment"> * files, even if they do not have their unique properties.</span>
+<a name="l00331"></a>00331 <span class="comment"> *</span>
+<a name="l00332"></a>00332 <span class="comment"> * New types of special files can be added by:</span>
+<a name="l00333"></a>00333 <span class="comment"> *  1. Implementing a platform-dependent routine to create a uniquely</span>
+<a name="l00334"></a>00334 <span class="comment"> *     named special file and one to read the special file in</span>
+<a name="l00335"></a>00335 <span class="comment"> *     libsvn_subr/io.c.</span>
+<a name="l00336"></a>00336 <span class="comment"> *  2. Creating a new textual name similar to</span>
+<a name="l00337"></a>00337 <span class="comment"> *     SVN_SUBST__SPECIAL_LINK_STR in libsvn_subr/subst.c.</span>
+<a name="l00338"></a>00338 <span class="comment"> *  3. Handling the translation/detranslation case for the new type in</span>
+<a name="l00339"></a>00339 <span class="comment"> *     create_special_file and detranslate_special_file, using the</span>
+<a name="l00340"></a>00340 <span class="comment"> *     routines from 1.</span>
+<a name="l00341"></a>00341 <span class="comment"> */</span>
+<a name="l00342"></a>00342 
+<a name="l00343"></a>00343 
+<a name="l00344"></a>00344 <span class="comment"></span>
+<a name="l00345"></a>00345 <span class="comment">/** A revision number. */</span>
+<a name="l00346"></a><a class="code" href="svn__types_8h.html#af16427ed53d30f27da225c56552d2a89">00346</a> <span class="keyword">typedef</span> <span class="keywordtype">long</span> <span class="keywordtype">int</span> <a class="code" href="svn__types_8h.html#af16427ed53d30f27da225c56552d2a89" title="About Special Files in Subversion.">svn_revnum_t</a>;
+<a name="l00347"></a>00347 <span class="comment"></span>
+<a name="l00348"></a>00348 <span class="comment">/** Valid revision numbers begin at 0 */</span>
+<a name="l00349"></a><a class="code" href="svn__types_8h.html#a07208246e0c138a99f2bc0a8f50ea1e1">00349</a> <span class="preprocessor">#define SVN_IS_VALID_REVNUM(n) ((n) &gt;= 0)</span>
 <a name="l00350"></a>00350 <span class="preprocessor"></span><span class="comment"></span>
-<a name="l00351"></a>00351 <span class="comment">/** Convert NULL-terminated C string @a str to a revision number. */</span>
-<a name="l00352"></a><a class="code" href="svn__types_8h.html#a57b4828e19737ceb8f42676dcbe41895">00352</a> <span class="preprocessor">#define SVN_STR_TO_REV(str) ((svn_revnum_t) atol(str))</span>
+<a name="l00351"></a>00351 <span class="comment">/** The &#39;official&#39; invalid revision num */</span>
+<a name="l00352"></a><a class="code" href="svn__types_8h.html#a8857d4630bf116eaba54a1b65d43ad92">00352</a> <span class="preprocessor">#define SVN_INVALID_REVNUM ((svn_revnum_t) -1)</span>
 <a name="l00353"></a>00353 <span class="preprocessor"></span><span class="comment"></span>
-<a name="l00354"></a>00354 <span class="comment">/**</span>
-<a name="l00355"></a>00355 <span class="comment"> * Parse NULL-terminated C string @a str as a revision number and</span>
-<a name="l00356"></a>00356 <span class="comment"> * store its value in @a rev.  If @a endptr is non-NULL, then the</span>
-<a name="l00357"></a>00357 <span class="comment"> * address of the first non-numeric character in @a str is stored in</span>
-<a name="l00358"></a>00358 <span class="comment"> * it.  If there are no digits in @a str, then @a endptr is set (if</span>
-<a name="l00359"></a>00359 <span class="comment"> * non-NULL), and the error #SVN_ERR_REVNUM_PARSE_FAILURE error is</span>
-<a name="l00360"></a>00360 <span class="comment"> * returned.  Negative numbers parsed from @a str are considered</span>
-<a name="l00361"></a>00361 <span class="comment"> * invalid, and result in the same error.</span>
-<a name="l00362"></a>00362 <span class="comment"> *</span>
-<a name="l00363"></a>00363 <span class="comment"> * @since New in 1.5.</span>
-<a name="l00364"></a>00364 <span class="comment"> */</span>
-<a name="l00365"></a>00365 <a class="code" href="structsvn__error__t.html" title="Subversion error object.">svn_error_t</a> *
-<a name="l00366"></a>00366 <a class="code" href="svn__types_8h.html#aeb14b5f3ca4e6d152419b8f2d81bf6c0" title="Parse NULL-terminated C string str as a revision number and store its value in rev.">svn_revnum_parse</a>(svn_revnum_t *rev,
-<a name="l00367"></a>00367                  <span class="keyword">const</span> <span class="keywordtype">char</span> *str,
-<a name="l00368"></a>00368                  <span class="keyword">const</span> <span class="keywordtype">char</span> **endptr);
-<a name="l00369"></a>00369 <span class="comment"></span>
-<a name="l00370"></a>00370 <span class="comment">/** Originally intended to be used in printf()-style functions to format</span>
-<a name="l00371"></a>00371 <span class="comment"> * revision numbers.  Deprecated due to incompatibilities with language</span>
-<a name="l00372"></a>00372 <span class="comment"> * translation tools (e.g. gettext).</span>
-<a name="l00373"></a>00373 <span class="comment"> *</span>
-<a name="l00374"></a>00374 <span class="comment"> * New code should use a bare &quot;%ld&quot; format specifier for formatting revision</span>
-<a name="l00375"></a>00375 <span class="comment"> * numbers.</span>
-<a name="l00376"></a>00376 <span class="comment"> *</span>
-<a name="l00377"></a>00377 <span class="comment"> * @deprecated Provided for backward compatibility with the 1.0 API.</span>
-<a name="l00378"></a>00378 <span class="comment"> */</span>
-<a name="l00379"></a><a class="code" href="svn__types_8h.html#a417741eb1f9b222dae237f6942a4b2f0">00379</a> <span class="preprocessor">#define SVN_REVNUM_T_FMT &quot;ld&quot;</span>
-<a name="l00380"></a>00380 <span class="preprocessor"></span>
-<a name="l00381"></a>00381 
-<a name="l00382"></a>00382 <span class="comment"></span>
-<a name="l00383"></a>00383 <span class="comment">/** The size of a file in the Subversion FS. */</span>
-<a name="l00384"></a><a class="code" href="svn__types_8h.html#a726e581898461c1d3e7dbdb16d99dad0">00384</a> <span class="keyword">typedef</span> apr_int64_t <a class="code" href="svn__types_8h.html#a726e581898461c1d3e7dbdb16d99dad0" title="The size of a file in the Subversion FS.">svn_filesize_t</a>;
-<a name="l00385"></a>00385 <span class="comment"></span>
-<a name="l00386"></a>00386 <span class="comment">/** The &#39;official&#39; invalid file size constant. */</span>
-<a name="l00387"></a><a class="code" href="svn__types_8h.html#a76973f4441098df9caf39ef911e5d9a6">00387</a> <span class="preprocessor">#define SVN_INVALID_FILESIZE ((svn_filesize_t) -1)</span>
-<a name="l00388"></a>00388 <span class="preprocessor"></span><span class="comment"></span>
-<a name="l00389"></a>00389 <span class="comment">/** In printf()-style functions, format file sizes using this. */</span>
-<a name="l00390"></a><a class="code" href="svn__types_8h.html#a517ca03658c247969d81c31b122c7f04">00390</a> <span class="preprocessor">#define SVN_FILESIZE_T_FMT APR_INT64_T_FMT</span>
-<a name="l00391"></a>00391 <span class="preprocessor"></span>
-<a name="l00392"></a>00392 <span class="preprocessor">#ifndef DOXYGEN_SHOULD_SKIP_THIS</span>
-<a name="l00393"></a>00393 <span class="preprocessor"></span><span class="comment">/* Parse a base-10 numeric string into a 64-bit unsigned numeric value. */</span>
-<a name="l00394"></a>00394 <span class="comment">/* NOTE: Private. For use by Subversion&#39;s own code only. See issue #1644. */</span>
-<a name="l00395"></a>00395 <span class="comment">/* FIXME: APR should supply a function to do this, such as &quot;apr_atoui64&quot;. */</span>
-<a name="l00396"></a>00396 <span class="preprocessor">#define svn__atoui64(X) ((apr_uint64_t) apr_atoi64(X))</span>
-<a name="l00397"></a>00397 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
-<a name="l00398"></a>00398 <span class="preprocessor"></span>
-<a name="l00399"></a>00399 
-<a name="l00400"></a>00400 <span class="comment"></span>
-<a name="l00401"></a>00401 <span class="comment">/** An enum to indicate whether recursion is needed. */</span>
-<a name="l00402"></a><a class="code" href="svn__types_8h.html#af81db79c4e4bbc2304dd95957bc9a905">00402</a> <span class="keyword">enum</span> <a class="code" href="svn__types_8h.html#af81db79c4e4bbc2304dd95957bc9a905" title="An enum to indicate whether recursion is needed.">svn_recurse_kind</a>
-<a name="l00403"></a>00403 {
-<a name="l00404"></a>00404   svn_nonrecursive = 1,
-<a name="l00405"></a>00405   svn_recursive
-<a name="l00406"></a>00406 };
-<a name="l00407"></a>00407 <span class="comment"></span>
-<a name="l00408"></a>00408 <span class="comment">/** The concept of depth for directories.</span>
-<a name="l00409"></a>00409 <span class="comment"> *</span>
-<a name="l00410"></a>00410 <span class="comment"> * @note This is similar to, but not exactly the same as, the WebDAV</span>
-<a name="l00411"></a>00411 <span class="comment"> * and LDAP concepts of depth.</span>
-<a name="l00412"></a>00412 <span class="comment"> *</span>
-<a name="l00413"></a>00413 <span class="comment"> * @since New in 1.5.</span>
-<a name="l00414"></a>00414 <span class="comment"> */</span>
-<a name="l00415"></a><a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2c">00415</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> <a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2c" title="The concept of depth for directories.">svn_depth_t</a>
-<a name="l00416"></a>00416 {
-<a name="l00417"></a>00417   <span class="comment">/* The order of these depths is important: the higher the number,</span>
-<a name="l00418"></a>00418 <span class="comment">     the deeper it descends.  This allows us to compare two depths</span>
-<a name="l00419"></a>00419 <span class="comment">     numerically to decide which should govern. */</span>
-<a name="l00420"></a>00420 <span class="comment"></span>
-<a name="l00421"></a>00421 <span class="comment">  /** Depth undetermined or ignored.  In some contexts, this means the</span>
-<a name="l00422"></a>00422 <span class="comment">      client should choose an appropriate default depth.  The server</span>
-<a name="l00423"></a>00423 <span class="comment">      will generally treat it as #svn_depth_infinity. */</span>
-<a name="l00424"></a><a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2cacf4538edb8e8823b0b9cdeaaac245ebf">00424</a>   <a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2cacf4538edb8e8823b0b9cdeaaac245ebf" title="Depth undetermined or ignored.">svn_depth_unknown</a>    = -2,
-<a name="l00425"></a>00425 <span class="comment"></span>
-<a name="l00426"></a>00426 <span class="comment">  /** Exclude (i.e., don&#39;t descend into) directory D.</span>
-<a name="l00427"></a>00427 <span class="comment">      @note In Subversion 1.5, svn_depth_exclude is *not* supported</span>
-<a name="l00428"></a>00428 <span class="comment">      anywhere in the client-side (libsvn_wc/libsvn_client/etc) code;</span>
-<a name="l00429"></a>00429 <span class="comment">      it is only supported as an argument to set_path functions in the</span>
-<a name="l00430"></a>00430 <span class="comment">      ra and repos reporters.  (This will enable future versions of</span>
-<a name="l00431"></a>00431 <span class="comment">      Subversion to run updates, etc, against 1.5 servers with proper</span>
-<a name="l00432"></a>00432 <span class="comment">      svn_depth_exclude behavior, once we get a chance to implement</span>
-<a name="l00433"></a>00433 <span class="comment">      client-side support for svn_depth_exclude.)</span>
-<a name="l00434"></a>00434 <span class="comment">  */</span>
-<a name="l00435"></a><a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2ca1bc611e0caf428575d07287adca72603">00435</a>   <a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2ca1bc611e0caf428575d07287adca72603" title="Exclude (i.e., don&#39;t descend into) directory D.">svn_depth_exclude</a>    = -1,
-<a name="l00436"></a>00436 <span class="comment"></span>
-<a name="l00437"></a>00437 <span class="comment">  /** Just the named directory D, no entries.  Updates will not pull in</span>
-<a name="l00438"></a>00438 <span class="comment">      any files or subdirectories not already present. */</span>
-<a name="l00439"></a><a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2ca8783254e886077b74a05341491fc353c">00439</a>   <a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2ca8783254e886077b74a05341491fc353c" title="Just the named directory D, no entries.">svn_depth_empty</a>      =  0,
-<a name="l00440"></a>00440 <span class="comment"></span>
-<a name="l00441"></a>00441 <span class="comment">  /** D + its file children, but not subdirs.  Updates will pull in any</span>
-<a name="l00442"></a>00442 <span class="comment">      files not already present, but not subdirectories. */</span>
-<a name="l00443"></a><a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2ca0c4df7073a6d268f0e26bbf961f35345">00443</a>   <a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2ca0c4df7073a6d268f0e26bbf961f35345" title="D + its file children, but not subdirs.">svn_depth_files</a>      =  1,
-<a name="l00444"></a>00444 <span class="comment"></span>
-<a name="l00445"></a>00445 <span class="comment">  /** D + immediate children (D and its entries).  Updates will pull in</span>
-<a name="l00446"></a>00446 <span class="comment">      any files or subdirectories not already present; those</span>
-<a name="l00447"></a>00447 <span class="comment">      subdirectories&#39; this_dir entries will have depth-empty. */</span>
-<a name="l00448"></a><a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2ca68873e015456e384e4f63f3bbd515c8a">00448</a>   <a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2ca68873e015456e384e4f63f3bbd515c8a" title="D + immediate children (D and its entries).">svn_depth_immediates</a> =  2,
+<a name="l00354"></a>00354 <span class="comment">/** Not really invalid...just unimportant -- one day, this can be its</span>
+<a name="l00355"></a>00355 <span class="comment"> * own unique value, for now, just make it the same as</span>
+<a name="l00356"></a>00356 <span class="comment"> * #SVN_INVALID_REVNUM.</span>
+<a name="l00357"></a>00357 <span class="comment"> */</span>
+<a name="l00358"></a><a class="code" href="svn__types_8h.html#a4510a289ee3537201a463aa5d7fc5891">00358</a> <span class="preprocessor">#define SVN_IGNORED_REVNUM ((svn_revnum_t) -1)</span>
+<a name="l00359"></a>00359 <span class="preprocessor"></span><span class="comment"></span>
+<a name="l00360"></a>00360 <span class="comment">/** Convert NULL-terminated C string @a str to a revision number. */</span>
+<a name="l00361"></a><a class="code" href="svn__types_8h.html#a57b4828e19737ceb8f42676dcbe41895">00361</a> <span class="preprocessor">#define SVN_STR_TO_REV(str) ((svn_revnum_t) atol(str))</span>
+<a name="l00362"></a>00362 <span class="preprocessor"></span><span class="comment"></span>
+<a name="l00363"></a>00363 <span class="comment">/**</span>
+<a name="l00364"></a>00364 <span class="comment"> * Parse NULL-terminated C string @a str as a revision number and</span>
+<a name="l00365"></a>00365 <span class="comment"> * store its value in @a rev.  If @a endptr is non-NULL, then the</span>
+<a name="l00366"></a>00366 <span class="comment"> * address of the first non-numeric character in @a str is stored in</span>
+<a name="l00367"></a>00367 <span class="comment"> * it.  If there are no digits in @a str, then @a endptr is set (if</span>
+<a name="l00368"></a>00368 <span class="comment"> * non-NULL), and the error #SVN_ERR_REVNUM_PARSE_FAILURE error is</span>
+<a name="l00369"></a>00369 <span class="comment"> * returned.  Negative numbers parsed from @a str are considered</span>
+<a name="l00370"></a>00370 <span class="comment"> * invalid, and result in the same error.</span>
+<a name="l00371"></a>00371 <span class="comment"> *</span>
+<a name="l00372"></a>00372 <span class="comment"> * @since New in 1.5.</span>
+<a name="l00373"></a>00373 <span class="comment"> */</span>
+<a name="l00374"></a>00374 <a class="code" href="structsvn__error__t.html" title="Subversion error object.">svn_error_t</a> *
+<a name="l00375"></a>00375 <a class="code" href="svn__types_8h.html#aeb14b5f3ca4e6d152419b8f2d81bf6c0" title="Parse NULL-terminated C string str as a revision number and store its value in rev.">svn_revnum_parse</a>(svn_revnum_t *rev,
+<a name="l00376"></a>00376                  <span class="keyword">const</span> <span class="keywordtype">char</span> *str,
+<a name="l00377"></a>00377                  <span class="keyword">const</span> <span class="keywordtype">char</span> **endptr);
+<a name="l00378"></a>00378 <span class="comment"></span>
+<a name="l00379"></a>00379 <span class="comment">/** Originally intended to be used in printf()-style functions to format</span>
+<a name="l00380"></a>00380 <span class="comment"> * revision numbers.  Deprecated due to incompatibilities with language</span>
+<a name="l00381"></a>00381 <span class="comment"> * translation tools (e.g. gettext).</span>
+<a name="l00382"></a>00382 <span class="comment"> *</span>
+<a name="l00383"></a>00383 <span class="comment"> * New code should use a bare &quot;%ld&quot; format specifier for formatting revision</span>
+<a name="l00384"></a>00384 <span class="comment"> * numbers.</span>
+<a name="l00385"></a>00385 <span class="comment"> *</span>
+<a name="l00386"></a>00386 <span class="comment"> * @deprecated Provided for backward compatibility with the 1.0 API.</span>
+<a name="l00387"></a>00387 <span class="comment"> */</span>
+<a name="l00388"></a><a class="code" href="svn__types_8h.html#a417741eb1f9b222dae237f6942a4b2f0">00388</a> <span class="preprocessor">#define SVN_REVNUM_T_FMT &quot;ld&quot;</span>
+<a name="l00389"></a>00389 <span class="preprocessor"></span>
+<a name="l00390"></a>00390 
+<a name="l00391"></a>00391 <span class="comment"></span>
+<a name="l00392"></a>00392 <span class="comment">/** The size of a file in the Subversion FS. */</span>
+<a name="l00393"></a><a class="code" href="svn__types_8h.html#a726e581898461c1d3e7dbdb16d99dad0">00393</a> <span class="keyword">typedef</span> apr_int64_t <a class="code" href="svn__types_8h.html#a726e581898461c1d3e7dbdb16d99dad0" title="The size of a file in the Subversion FS.">svn_filesize_t</a>;
+<a name="l00394"></a>00394 <span class="comment"></span>
+<a name="l00395"></a>00395 <span class="comment">/** The &#39;official&#39; invalid file size constant. */</span>
+<a name="l00396"></a><a class="code" href="svn__types_8h.html#a76973f4441098df9caf39ef911e5d9a6">00396</a> <span class="preprocessor">#define SVN_INVALID_FILESIZE ((svn_filesize_t) -1)</span>
+<a name="l00397"></a>00397 <span class="preprocessor"></span><span class="comment"></span>
+<a name="l00398"></a>00398 <span class="comment">/** In printf()-style functions, format file sizes using this. */</span>
+<a name="l00399"></a><a class="code" href="svn__types_8h.html#a517ca03658c247969d81c31b122c7f04">00399</a> <span class="preprocessor">#define SVN_FILESIZE_T_FMT APR_INT64_T_FMT</span>
+<a name="l00400"></a>00400 <span class="preprocessor"></span>
+<a name="l00401"></a>00401 <span class="preprocessor">#ifndef DOXYGEN_SHOULD_SKIP_THIS</span>
+<a name="l00402"></a>00402 <span class="preprocessor"></span><span class="comment">/* Parse a base-10 numeric string into a 64-bit unsigned numeric value. */</span>
+<a name="l00403"></a>00403 <span class="comment">/* NOTE: Private. For use by Subversion&#39;s own code only. See issue #1644. */</span>
+<a name="l00404"></a>00404 <span class="comment">/* FIXME: APR should supply a function to do this, such as &quot;apr_atoui64&quot;. */</span>
+<a name="l00405"></a>00405 <span class="preprocessor">#define svn__atoui64(X) ((apr_uint64_t) apr_atoi64(X))</span>
+<a name="l00406"></a>00406 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
+<a name="l00407"></a>00407 <span class="preprocessor"></span>
+<a name="l00408"></a>00408 
+<a name="l00409"></a>00409 <span class="comment"></span>
+<a name="l00410"></a>00410 <span class="comment">/** An enum to indicate whether recursion is needed. */</span>
+<a name="l00411"></a><a class="code" href="svn__types_8h.html#af81db79c4e4bbc2304dd95957bc9a905">00411</a> <span class="keyword">enum</span> <a class="code" href="svn__types_8h.html#af81db79c4e4bbc2304dd95957bc9a905" title="An enum to indicate whether recursion is needed.">svn_recurse_kind</a>
+<a name="l00412"></a>00412 {
+<a name="l00413"></a>00413   svn_nonrecursive = 1,
+<a name="l00414"></a>00414   svn_recursive
+<a name="l00415"></a>00415 };
+<a name="l00416"></a>00416 <span class="comment"></span>
+<a name="l00417"></a>00417 <span class="comment">/** The concept of depth for directories.</span>
+<a name="l00418"></a>00418 <span class="comment"> *</span>
+<a name="l00419"></a>00419 <span class="comment"> * @note This is similar to, but not exactly the same as, the WebDAV</span>
+<a name="l00420"></a>00420 <span class="comment"> * and LDAP concepts of depth.</span>
+<a name="l00421"></a>00421 <span class="comment"> *</span>
+<a name="l00422"></a>00422 <span class="comment"> * @since New in 1.5.</span>
+<a name="l00423"></a>00423 <span class="comment"> */</span>
+<a name="l00424"></a><a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2c">00424</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> <a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2c" title="The concept of depth for directories.">svn_depth_t</a>
+<a name="l00425"></a>00425 {
+<a name="l00426"></a>00426   <span class="comment">/* The order of these depths is important: the higher the number,</span>
+<a name="l00427"></a>00427 <span class="comment">     the deeper it descends.  This allows us to compare two depths</span>
+<a name="l00428"></a>00428 <span class="comment">     numerically to decide which should govern. */</span>
+<a name="l00429"></a>00429 <span class="comment"></span>
+<a name="l00430"></a>00430 <span class="comment">  /** Depth undetermined or ignored.  In some contexts, this means the</span>
+<a name="l00431"></a>00431 <span class="comment">      client should choose an appropriate default depth.  The server</span>
+<a name="l00432"></a>00432 <span class="comment">      will generally treat it as #svn_depth_infinity. */</span>
+<a name="l00433"></a><a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2cacf4538edb8e8823b0b9cdeaaac245ebf">00433</a>   <a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2cacf4538edb8e8823b0b9cdeaaac245ebf" title="Depth undetermined or ignored.">svn_depth_unknown</a>    = -2,
+<a name="l00434"></a>00434 <span class="comment"></span>
+<a name="l00435"></a>00435 <span class="comment">  /** Exclude (i.e., don&#39;t descend into) directory D.</span>
+<a name="l00436"></a>00436 <span class="comment">      @note In Subversion 1.5, svn_depth_exclude is *not* supported</span>
+<a name="l00437"></a>00437 <span class="comment">      anywhere in the client-side (libsvn_wc/libsvn_client/etc) code;</span>
+<a name="l00438"></a>00438 <span class="comment">      it is only supported as an argument to set_path functions in the</span>
+<a name="l00439"></a>00439 <span class="comment">      ra and repos reporters.  (This will enable future versions of</span>
+<a name="l00440"></a>00440 <span class="comment">      Subversion to run updates, etc, against 1.5 servers with proper</span>
+<a name="l00441"></a>00441 <span class="comment">      svn_depth_exclude behavior, once we get a chance to implement</span>
+<a name="l00442"></a>00442 <span class="comment">      client-side support for svn_depth_exclude.)</span>
+<a name="l00443"></a>00443 <span class="comment">  */</span>
+<a name="l00444"></a><a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2ca1bc611e0caf428575d07287adca72603">00444</a>   <a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2ca1bc611e0caf428575d07287adca72603" title="Exclude (i.e., don&#39;t descend into) directory D.">svn_depth_exclude</a>    = -1,
+<a name="l00445"></a>00445 <span class="comment"></span>
+<a name="l00446"></a>00446 <span class="comment">  /** Just the named directory D, no entries.  Updates will not pull in</span>
+<a name="l00447"></a>00447 <span class="comment">      any files or subdirectories not already present. */</span>
+<a name="l00448"></a><a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2ca8783254e886077b74a05341491fc353c">00448</a>   <a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2ca8783254e886077b74a05341491fc353c" title="Just the named directory D, no entries.">svn_depth_empty</a>      =  0,
 <a name="l00449"></a>00449 <span class="comment"></span>
-<a name="l00450"></a>00450 <span class="comment">  /** D + all descendants (full recursion from D).  Updates will pull</span>
-<a name="l00451"></a>00451 <span class="comment">      in any files or subdirectories not already present; those</span>
-<a name="l00452"></a>00452 <span class="comment">      subdirectories&#39; this_dir entries will have depth-infinity.</span>
-<a name="l00453"></a>00453 <span class="comment">      Equivalent to the pre-1.5 default update behavior. */</span>
-<a name="l00454"></a><a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2ca9c9a00ca9d05799d0d2a7646d4f0cbf2">00454</a>   <a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2ca9c9a00ca9d05799d0d2a7646d4f0cbf2" title="D + all descendants (full recursion from D).">svn_depth_infinity</a>   =  3
-<a name="l00455"></a>00455 
-<a name="l00456"></a>00456 } <a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2c" title="The concept of depth for directories.">svn_depth_t</a>;
-<a name="l00457"></a>00457 <span class="comment"></span>
-<a name="l00458"></a>00458 <span class="comment">/** Return a constant string expressing @a depth as an English word,</span>
-<a name="l00459"></a>00459 <span class="comment"> * e.g., &quot;infinity&quot;, &quot;immediates&quot;, etc.  The string is not localized,</span>
-<a name="l00460"></a>00460 <span class="comment"> * as it may be used for client&lt;-&gt;server communications.</span>
-<a name="l00461"></a>00461 <span class="comment"> *</span>
-<a name="l00462"></a>00462 <span class="comment"> * @since New in 1.5.</span>
-<a name="l00463"></a>00463 <span class="comment"> */</span>
-<a name="l00464"></a>00464 <span class="keyword">const</span> <span class="keywordtype">char</span> *
-<a name="l00465"></a>00465 <a class="code" href="svn__types_8h.html#aeb29079e6c46b52a92212b8e8f004ccb" title="Return a constant string expressing depth as an English word, e.g., &quot;infinity&quot;, &quot;immediates&quot;, etc.">svn_depth_to_word</a>(<a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2c" title="The concept of depth for directories.">svn_depth_t</a> depth);
+<a name="l00450"></a>00450 <span class="comment">  /** D + its file children, but not subdirs.  Updates will pull in any</span>
+<a name="l00451"></a>00451 <span class="comment">      files not already present, but not subdirectories. */</span>
+<a name="l00452"></a><a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2ca0c4df7073a6d268f0e26bbf961f35345">00452</a>   <a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2ca0c4df7073a6d268f0e26bbf961f35345" title="D + its file children, but not subdirs.">svn_depth_files</a>      =  1,
+<a name="l00453"></a>00453 <span class="comment"></span>
+<a name="l00454"></a>00454 <span class="comment">  /** D + immediate children (D and its entries).  Updates will pull in</span>
+<a name="l00455"></a>00455 <span class="comment">      any files or subdirectories not already present; those</span>
+<a name="l00456"></a>00456 <span class="comment">      subdirectories&#39; this_dir entries will have depth-empty. */</span>
+<a name="l00457"></a><a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2ca68873e015456e384e4f63f3bbd515c8a">00457</a>   <a class="code" href="svn__types_8h.html#a21dd8b080111fa6fb5d59156299f3a2ca68873e015456e384e4f63f3bbd515c8a" title="D + immediate children (D and its entries).">svn_depth_immediates</a> =  2,
+<a name="l00458"></a>00458 <span class="comment"></span>
+<a name="l00459"></a>00459 <span class="comment">  /** D + all descendants (full recursion from D).  Updates will pull</span>
+<a name="l00460"></a>00460 <span class="comment">      in any files or subdirectories not already present; those</span>
+<a name="l00461"></a>00461 <span class="comment">      subdirectories&#39; this_dir entries will have depth-infinity.</span>
+<a name="l00462"></a>00462 <span class="comment">      Equivalent to the pre-1.5 default update behavior. */</span>

[... 1615 lines stripped ...]