DragonNest/Common/SVNLib/doc/group__Add.html
2024-12-19 09:48:26 +08:00

274 lines
17 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<title>Subversion: Begin versioning files/directories in a working copy.</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.5.6 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
<li><a href="pages.html"><span>Related&nbsp;Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li>
<form action="search.php" method="get">
<table cellspacing="0" cellpadding="0" border="0">
<tr>
<td><label>&nbsp;<u>S</u>earch&nbsp;for&nbsp;</label></td>
<td><input type="text" name="query" value="" size="20" accesskey="s"/></td>
</tr>
</table>
</form>
</li>
</ul>
</div>
</div>
<div class="contents">
<h1>Begin versioning files/directories in a working copy.<br>
<small>
[<a class="el" href="group__clnt__wc.html">Client working copy management</a>]</small>
</h1><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="structsvn__error__t.html">svn_error_t</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__Add.html#gf3dad04d9841b82ed3e15c01c815701b">svn_client_add4</a> (const char *path, <a class="el" href="svn__types_8h.html#21dd8b080111fa6fb5d59156299f3a2c">svn_depth_t</a> depth, <a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a> force, <a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a> no_ignore, <a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a> add_parents, <a class="el" href="structsvn__client__ctx__t.html">svn_client_ctx_t</a> *ctx, apr_pool_t *pool)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Schedule a working copy <em>path</em> for addition to the repository. <a href="#gf3dad04d9841b82ed3e15c01c815701b"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="structsvn__error__t.html">svn_error_t</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__Add.html#g663ba842814592227853452f2508dd05">svn_client_add3</a> (const char *path, <a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a> recursive, <a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a> force, <a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a> no_ignore, <a class="el" href="structsvn__client__ctx__t.html">svn_client_ctx_t</a> *ctx, apr_pool_t *pool)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Similar to <a class="el" href="group__Add.html#gf3dad04d9841b82ed3e15c01c815701b" title="Schedule a working copy path for addition to the repository.">svn_client_add4()</a>, but with <em>add_parents</em> always set to FALSE and <em>depth</em> set according to <em>recursive:</em> if TRUE, then <em>depth</em> is <code>svn_depth_infinity</code>, if FALSE, then <code>svn_depth_empty</code>. <a href="#g663ba842814592227853452f2508dd05"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="structsvn__error__t.html">svn_error_t</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__Add.html#g2631116d4eef41db38488031f4a297d6">svn_client_add2</a> (const char *path, <a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a> recursive, <a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a> force, <a class="el" href="structsvn__client__ctx__t.html">svn_client_ctx_t</a> *ctx, apr_pool_t *pool)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Similar to <a class="el" href="group__Add.html#g663ba842814592227853452f2508dd05" title="Similar to svn_client_add4(), but with add_parents always set to FALSE and depth...">svn_client_add3()</a>, but with <em>no_ignore</em> always set to FALSE. <a href="#g2631116d4eef41db38488031f4a297d6"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="structsvn__error__t.html">svn_error_t</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__Add.html#gf195ea9edb1abcf4439f9b60a8cece2b">svn_client_add</a> (const char *path, <a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a> recursive, <a class="el" href="structsvn__client__ctx__t.html">svn_client_ctx_t</a> *ctx, apr_pool_t *pool)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Similar to <a class="el" href="group__Add.html#g2631116d4eef41db38488031f4a297d6" title="Similar to svn_client_add3(), but with no_ignore always set to FALSE.">svn_client_add2()</a>, but with <em>force</em> always set to FALSE. <a href="#gf195ea9edb1abcf4439f9b60a8cece2b"></a><br></td></tr>
</table>
<hr><h2>Function Documentation</h2>
<a class="anchor" name="gf195ea9edb1abcf4439f9b60a8cece2b"></a><!-- doxytag: member="svn_client.h::svn_client_add" ref="gf195ea9edb1abcf4439f9b60a8cece2b" args="(const char *path, svn_boolean_t recursive, svn_client_ctx_t *ctx, apr_pool_t *pool)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structsvn__error__t.html">svn_error_t</a>* svn_client_add </td>
<td>(</td>
<td class="paramtype">const char *&nbsp;</td>
<td class="paramname"> <em>path</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a>&nbsp;</td>
<td class="paramname"> <em>recursive</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structsvn__client__ctx__t.html">svn_client_ctx_t</a> *&nbsp;</td>
<td class="paramname"> <em>ctx</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_pool_t *&nbsp;</td>
<td class="paramname"> <em>pool</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Similar to <a class="el" href="group__Add.html#g2631116d4eef41db38488031f4a297d6" title="Similar to svn_client_add3(), but with no_ignore always set to FALSE.">svn_client_add2()</a>, but with <em>force</em> always set to FALSE.
<p>
<dl compact><dt><b><a class="el" href="deprecated.html#_deprecated000029">Deprecated:</a></b></dt><dd>Provided for backward compatibility with the 1.0 API. </dd></dl>
</div>
</div><p>
<a class="anchor" name="g2631116d4eef41db38488031f4a297d6"></a><!-- doxytag: member="svn_client.h::svn_client_add2" ref="g2631116d4eef41db38488031f4a297d6" args="(const char *path, svn_boolean_t recursive, svn_boolean_t force, svn_client_ctx_t *ctx, apr_pool_t *pool)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structsvn__error__t.html">svn_error_t</a>* svn_client_add2 </td>
<td>(</td>
<td class="paramtype">const char *&nbsp;</td>
<td class="paramname"> <em>path</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a>&nbsp;</td>
<td class="paramname"> <em>recursive</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a>&nbsp;</td>
<td class="paramname"> <em>force</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structsvn__client__ctx__t.html">svn_client_ctx_t</a> *&nbsp;</td>
<td class="paramname"> <em>ctx</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_pool_t *&nbsp;</td>
<td class="paramname"> <em>pool</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Similar to <a class="el" href="group__Add.html#g663ba842814592227853452f2508dd05" title="Similar to svn_client_add4(), but with add_parents always set to FALSE and depth...">svn_client_add3()</a>, but with <em>no_ignore</em> always set to FALSE.
<p>
<dl compact><dt><b><a class="el" href="deprecated.html#_deprecated000028">Deprecated:</a></b></dt><dd>Provided for backward compatibility with the 1.2 API. </dd></dl>
</div>
</div><p>
<a class="anchor" name="g663ba842814592227853452f2508dd05"></a><!-- doxytag: member="svn_client.h::svn_client_add3" ref="g663ba842814592227853452f2508dd05" args="(const char *path, svn_boolean_t recursive, svn_boolean_t force, svn_boolean_t no_ignore, svn_client_ctx_t *ctx, apr_pool_t *pool)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structsvn__error__t.html">svn_error_t</a>* svn_client_add3 </td>
<td>(</td>
<td class="paramtype">const char *&nbsp;</td>
<td class="paramname"> <em>path</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a>&nbsp;</td>
<td class="paramname"> <em>recursive</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a>&nbsp;</td>
<td class="paramname"> <em>force</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a>&nbsp;</td>
<td class="paramname"> <em>no_ignore</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structsvn__client__ctx__t.html">svn_client_ctx_t</a> *&nbsp;</td>
<td class="paramname"> <em>ctx</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_pool_t *&nbsp;</td>
<td class="paramname"> <em>pool</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Similar to <a class="el" href="group__Add.html#gf3dad04d9841b82ed3e15c01c815701b" title="Schedule a working copy path for addition to the repository.">svn_client_add4()</a>, but with <em>add_parents</em> always set to FALSE and <em>depth</em> set according to <em>recursive:</em> if TRUE, then <em>depth</em> is <code>svn_depth_infinity</code>, if FALSE, then <code>svn_depth_empty</code>.
<p>
<dl compact><dt><b><a class="el" href="deprecated.html#_deprecated000027">Deprecated:</a></b></dt><dd>Provided for backward compatibility with the 1.3 API. </dd></dl>
</div>
</div><p>
<a class="anchor" name="gf3dad04d9841b82ed3e15c01c815701b"></a><!-- doxytag: member="svn_client.h::svn_client_add4" ref="gf3dad04d9841b82ed3e15c01c815701b" args="(const char *path, svn_depth_t depth, svn_boolean_t force, svn_boolean_t no_ignore, svn_boolean_t add_parents, svn_client_ctx_t *ctx, apr_pool_t *pool)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structsvn__error__t.html">svn_error_t</a>* svn_client_add4 </td>
<td>(</td>
<td class="paramtype">const char *&nbsp;</td>
<td class="paramname"> <em>path</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="svn__types_8h.html#21dd8b080111fa6fb5d59156299f3a2c">svn_depth_t</a>&nbsp;</td>
<td class="paramname"> <em>depth</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a>&nbsp;</td>
<td class="paramname"> <em>force</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a>&nbsp;</td>
<td class="paramname"> <em>no_ignore</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="svn__types_8h.html#22b35baddc4213c688d1bb12feea1024">svn_boolean_t</a>&nbsp;</td>
<td class="paramname"> <em>add_parents</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="structsvn__client__ctx__t.html">svn_client_ctx_t</a> *&nbsp;</td>
<td class="paramname"> <em>ctx</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">apr_pool_t *&nbsp;</td>
<td class="paramname"> <em>pool</em></td><td>&nbsp;</td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Schedule a working copy <em>path</em> for addition to the repository.
<p>
If <em>depth</em> is <code>svn_depth_empty</code>, add just <em>path</em> and nothing below it. If <code>svn_depth_files</code>, add <em>path</em> and any file children of <em>path</em>. If <code>svn_depth_immediates</code>, add <em>path</em>, any file children, and any immediate subdirectories (but nothing underneath those subdirectories). If <code>svn_depth_infinity</code>, add <em>path</em> and everything under it fully recursively.<p>
<em>path's</em> parent must be under revision control already (unless <em>add_parents</em> is TRUE), but <em>path</em> is not. If <em>recursive</em> is set, then assuming <em>path</em> is a directory, all of its contents will be scheduled for addition as well.<p>
If <em>force</em> is not set and <em>path</em> is already under version control, return the error <code>SVN_ERR_ENTRY_EXISTS</code>. If <em>force</em> is set, do not error on already-versioned items. When used on a directory in conjunction with the <em>recursive</em> flag, this has the effect of scheduling for addition unversioned files and directories scattered deep within a versioned tree.<p>
If <em>ctx-&gt;notify_func2</em> is non-NULL, then for each added item, call <em>ctx-&gt;notify_func2</em> with <em>ctx-&gt;notify_baton2</em> and the path of the added item.<p>
If <em>no_ignore</em> is FALSE, don't add files or directories that match ignore patterns.<p>
If <em>add_parents</em> is TRUE, recurse up <em>path's</em> directory and look for a versioned directory. If found, add all intermediate paths between it and <em>path</em>. If not found, return <code>SVN_ERR_CLIENT_NO_VERSIONED_PARENTS</code>.<p>
<dl class="user" compact><dt><b>Important:</b></dt><dd>This is a *scheduling* operation. No changes will happen to the repository until a commit occurs. This scheduling can be removed with <a class="el" href="group__Revert.html#gcb44f78571979944837d1ad9967bec5e" title="Restore the pristine version of a working copy paths, effectively undoing any local...">svn_client_revert2()</a>.</dd></dl>
<dl class="since" compact><dt><b>Since:</b></dt><dd>New in 1.5. </dd></dl>
</div>
</div><p>
</div>
<hr size="1"><address style="text-align: right;"><small>Generated on Fri Oct 24 16:18:29 2008 for Subversion by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.6 </small></address>
</body>
</html>