ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject cvs commit: ant/proposal/sandbox/svn/docs svn.html
Date Fri, 11 Feb 2005 13:50:43 GMT
bodewig     2005/02/11 05:50:43

  Added:       proposal/sandbox/svn/docs svn.html
  Add initial task
  Revision  Changes    Path
  1.1                  ant/proposal/sandbox/svn/docs/svn.html
  Index: svn.html
  <meta http-equiv="Content-Language" content="en-us">
  <title>Subversion Task</title>
  <link rel="stylesheet" type="text/css" href="../stylesheets/antmanual.css">
  <h2><a name="svn">SVN</a></h2>
  <p>Handles packages/modules retrieved from a
  <a href="" target="_top">Subversion</a> repository.</p>
  <p><b>Important:</b> This task needs &quot;<code>svn</code>&quot;
on the path. If it isn't, you will get
  an error (such as error <code>2</code> on windows). If <code>&lt;svn&gt;</code>
doesn't work, try to execute <code>svn.exe</code>
  from the command line in the target directory in which you are working.
  <table border="1" cellpadding="2" cellspacing="0">
      <td valign="top"><b>Attribute</b></td>
      <td valign="top"><b>Description</b></td>
      <td align="center" valign="top"><b>Required</b></td>
      <td valign="top">subcommand</td>
      <td valign="top">the SVN subcommand to execute.</td>
      <td align="center" valign="top">No, default &quot;checkout&quot;.</td>
      <td valign="top">svnURL</td>
      <td valign="top">the URL the subcommand should apply to.</td>
      <td align="center" valign="top">No</td>
      <td valign="top">dest</td>
      <td valign="top">the directory where the checked out files should
      be placed.  Note that this is different from SVN's <code>-d</code> command
      switch as Ant will never shorten pathnames to avoid empty
      <td align="center" valign="top">No, default is project's basedir.</td>
      <td valign="top">revision</td>
      <td valign="top">the revision or date of the subcommand should apply to</td>
      <td align="center" valign="top">No</td>
      <td valign="top">quiet</td>
      <td valign="top">suppress informational messages. This is the same as <code>--quiet</code>
on the command line.</td>
      <td align="center" valign="top">No, default &quot;false&quot;</td>
      <td valign="top">dryrun</td>
      <td valign="top">report only, don't change any files.</td>
      <td align="center" valign="top">No, default to &quot;false&quot;</td>
      <td valign="top">output</td>
      <td valign="top">the file to direct standard output from the command.</td>
      <td align="center" valign="top">No, default output to ANT Log as <code>MSG_INFO</code>.</td>
      <td valign="top">error</td>
      <td valign="top">the file to direct standard error from the command.</td>
      <td align="center" valign="top">No, default error to ANT Log as <code>MSG_WARN</code>.</td>
      <td valign="top">append</td>
      <td valign="top">whether to append output/error when redirecting to a file.</td>
      <td align="center" valign="top">No, default to &quot;false&quot;.</td>
      <td valign="top">failonerror</td>
      <td valign="top">Stop the build process if the command exits with a
        return code other than <code>0</code>. Defaults to &quot;false&quot;</td>
      <td align="center" valign="top">No</td>
  <pre>  &lt;svn svnURL=&quot;;
  <p>checks out the URL
  &quot;; and
  stores the files in &quot;<code>${ws.dir}</code>&quot;.</p>
  <pre>  &lt;svn dest=&quot;${ws.dir}&quot; command=&quot;update&quot;/&gt;</pre>
  <p>updates the working copy that has previously been checked out into
  <pre>  &lt;svn command=&quot;-q diff&quot; output=&quot;patch.txt&quot;/&gt;</pre>
  <p>silently (<code>-q</code>) creates a file called <code>patch.txt</code>
which contains a unified diff which can be used as input to patch.
  The equivalent, using  <code>&lt;commandline&gt;</code> elements, is:
  &lt;svn output=&quot;patch&quot;&gt;
          &lt;argument value=&quot;-q&quot;/&gt;
          &lt;argument value=&quot;diff&quot;/&gt;
  &lt;svn output=&quot;patch&quot;&gt;
          &lt;argument line=&quot;-q diff -u -N&quot;/&gt;
  You may include as many <code>&lt;commandline&gt;</code> elements as
you like. 
  Each will inherit the <code>failonerror</code> and other &quot;global&quot;
  from the <code>&lt;svn&gt;</code> element.
  <pre>  &lt;svn command=&quot;update&quot;/&gt;</pre>
  <p>Updates from the head of repository creating any new directories as necessary.</p>
  <p>See <a href="" target="_top">Version
Control with Subversion</a> for details,
  specifically the <a href=""
target="_top">The Subversion Command Line Client: svn</a></p>
  <p align="center">Copyright &copy; 2005 The Apache Software
  Foundation.  All rights Reserved.</p>

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message