ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From n...@apache.org
Subject cvs commit: jakarta-ant/docs/manual/OptionalTasks vss.html vssget.html vsshistory.html vsslabel.html
Date Sun, 29 Apr 2001 16:24:21 GMT
nico        01/04/29 09:24:21

  Modified:    docs/manual optionaltasklist.html
  Added:       docs/manual/OptionalTasks vss.html
  Removed:     docs/manual/OptionalTasks vssget.html vsshistory.html
                        vsslabel.html
  Log:
  - Merged VSS-Documentation into one file
  - Added documentation for vsscheckin and vsscheckout
  
  Revision  Changes    Path
  1.12      +1 -3      jakarta-ant/docs/manual/optionaltasklist.html
  
  Index: optionaltasklist.html
  ===================================================================
  RCS file: /home/cvs/jakarta-ant/docs/manual/optionaltasklist.html,v
  retrieving revision 1.11
  retrieving revision 1.12
  diff -u -r1.11 -r1.12
  --- optionaltasklist.html	2001/04/10 04:47:00	1.11
  +++ optionaltasklist.html	2001/04/29 16:24:20	1.12
  @@ -40,9 +40,7 @@
   <a href="OptionalTasks/telnet.html">Telnet</a><br>
   <a href="OptionalTasks/test.html">Test</a><br>
   <a href="Integration/VAJAntTool.html#tasks">Visual Age for Java Tasks</a><br>
  -<a href="OptionalTasks/vssget.html">VssGet</a><br>
  -<a href="OptionalTasks/vsshistory.html">VssHistory</a><br>
  -<a href="OptionalTasks/vsslabel.html">VssLabel</a><br>
  +<a href="OptionalTasks/vss.html#tasks">Microsoft Visual SourceSafe Tasks</a><br>
   <a href="OptionalTasks/xmlvalidate.html">XmlValidate</a><br>
   
   </body>
  
  
  
  1.1                  jakarta-ant/docs/manual/OptionalTasks/vss.html
  
  Index: vss.html
  ===================================================================
  <html>
  <head>
  <title>Microsoft Visual SourceSafe Tasks for ANT</title>
  </head>
  <body>
  <h1>Microsoft Visual SourceSafe Tasks User Manual</h1>
  <p>by</p>
  <ul>
      <li>Craig Cottingham</li>
      <li>Andrew Everitt</li>
      <li>Balazs Fejes 2</li>
      <li><a href="mailto:Glenn_Twiggs@bmc.com">Glenn_Twiggs@bmc.com</a></li>
      <li>Martin Poeschl (<a href="mailto:mpoeschl@marmot.at">mpoeschl@marmot.at</a>)</li>
      <li>Phillip Wells</li>
      <li>Jon Skeet (<a href="mailto:jon.skeet@peramon.com">jon.skeet@peramon.com</a>)</li>
   </ul>
  <p>2001/04/29</p>
  <hr>
  <h2>Contents</h2>
  <ul>
      <li><a href="#intro">Introduction</a></li>
      <li><a href="#tasks">The Tasks</a></li>
  </ul>
  <br>
  <h2><a name="intro">Introduction</a></h2>
  <p>These tasks provide an interface to the 
  <a href="http://msdn.microsoft.com/ssafe/default.asp" target="_top">Microsoft Visual
SourceSafe</a> SCM.
  The <code>org.apache.tools.ant.taskdefs.optional.vss</code> package consists
of a simple framework to support 
  vss functionality as well as some Ant tasks encapsulating frequently used vss commands.

  Although it is possible to use these commands on the desktop, 
  they were primarily intended to be used by automated build systems.</p>
  
  <h2><a name="tasks">The Tasks</a></h2>
  
  <table border="0" cellspacing="0" cellpadding="3">
      <tr>
          <td><a href="#vssget">vssget</a></td>
          <td>Retrieves a copy of the specified VSS file(s).</td>
      </tr>
      <tr>
          <td><a href="#vsslabel">vsslabel</a></td>
          <td>Assigns a label to the specified version or current version of a file
or project.</td>
      </tr>
      <tr>
          <td><a href="#vsshistory">vsshistory</a></td>
          <td>Shows the history of a file or project in VSS.</td>
      </tr>
      <tr>
          <td><a href="#vsscheckin">vsscheckin</a></td>
          <td>Updates VSS with changes made to a checked out file, and unlocks the VSS
master copy.</td>
      </tr>
      <tr>
          <td><a href="#vsscheckout">vsscheckout</a></td>
          <td>Copies a file from the current project to the current folder, for the
purpose of editing.</td>
      </tr>
  </table>
  
  <hr>
  <h2>Task Descriptions</h2>
  
  <!-- VSSGET -->
  
  <h2><a name="vssget">VssGet</a></h2>
  <h3>Description</h3>
  Task to perform GET commands to Microsoft Visual SourceSafe.
  <p>If you specify two or more attributes from version, date and 
  label only one will be used in the order version, date, label.</p>
  <h3>Parameters</h3>
  <table border="1" cellpadding="2" cellspacing="0">
    <tr>
      <th>Attribute</th>
      <th>Values</th>
      <th>Required</th>
    </tr>
    <tr>
       <td>vsspath</td>
       <td>SourceSafe path which specifies the project/file(s) you wish to 
           perform the action on. You should not specify the leading dollar-sign - 
           it is prepended by Ant automatically.</td>
       <td>Yes</td>
    </tr>
    <tr>
       <td>login</td>
       <td>username[,password] - The username and password needed to get access
           to VSS. Note that you may need to specify both (if you have a password) - 
           Ant/VSS will hang if you leave the password out and VSS does not accept 
           login without a password. </td>
       <td>No</td>
    </tr>
    <tr>
       <td>localpath</td>
       <td>Override the working directory and get to the specified path</td>
       <td>No</td>
    </tr>
    <tr>
       <td>ssdir</td>
       <td>directory where <code>ss.exe</code> resides. By default the
           task expects it to be in the PATH.</td>
       <td>No</td>
    </tr>
    <tr>
       <td>serverPath</td>
       <td>directory where <code>srssafe.ini</code> resides.</td>
       <td>No</td>
    </tr>
    <tr>
       <td>writable</td>
       <td>true or false</td>
       <td>No</td>
    </tr>
    <tr>
       <td>recursive</td>
       <td>true or false</td>
       <td>No</td>
    </tr>
    <tr>
       <td>version</td>
       <td>a version number to get</td>
       <td rowspan="3">No, only one of these allowed</td>
    </tr>
    <tr>
       <td>date</td>
       <td>a date stamp to get at</td>
    </tr>
    <tr>
       <td>label</td>
       <td>a label to get for</td>
    </tr>
  </table>
  <p>Note that only one of version, date or label should be specified</p>
  <h3>Examples</h3>
  <blockquote>
  <pre>
  &lt;vssget localPath=&quot;C:\mysrc\myproject&quot;
          recursive=&quot;true&quot; 
          label=&quot;Release1&quot;
          login=&quot;me,mypassword&quot;
          vsspath=&quot;/source/aProject&quot;
          writable=&quot;true&quot;/&gt;
  </pre>
  </blockquote>
  <p>Does a get on the VSS-Project <i>$/source/myproject</i> using the username
  <i>me</i> and the password <i>mypassword</i>. It will recursively
get the files 
  which are labeled <i>Release1</i> and write them to the local directory
  <i>C:\mysrc\myproject</i>. The local files will be writable.</p>
  <hr>
  
  <!-- VSSLABEL -->
  
  <h2><a name="vsslabel">VssLabel</a></h2>
  <h3>Description</h3>
  Task to perform LABEL commands to Microsoft Visual SourceSafe.
  <p>Assigns a label to the specified version or current version of a file or
  project.</p>
  <h3>Parameters</h3>
  <table border="1" cellpadding="2" cellspacing="0">
     <tr>
       <th>Attribute</th>
       <th>Values</th>
       <th>Required</th>
     </tr>
    <tr>
       <td>vsspath</td>
       <td>SourceSafe path which specifies the project/file(s) you wish to 
           perform the action on. You should not specify the leading dollar-sign - 
           it is prepended by Ant automatically.</td>
       <td>Yes</td>
    </tr>
    <tr>
       <td>login</td>
       <td>username[,password] - The username and password needed to get access
           to VSS. Note that you may need to specify both (if you have a password) - 
           Ant/VSS will hang if you leave the password out and VSS does not accept 
           login without a password. </td>
       <td>No</td>
    </tr>
    <tr>
       <td>ssdir</td>
       <td>directory where <code>ss.exe</code> resides. By default the
           task expects it to be in the PATH.</td>
       <td>No</td>
    </tr>
    <tr>
       <td>serverPath</td>
       <td>directory where <code>srssafe.ini</code> resides.</td>
       <td>No</td>
    </tr>
     <tr>
        <td>label</td>
        <td>A label to apply to the hierarchy</td>
        <td>Yes</td>
     </tr>
     <tr>
        <td>version</td>
        <td>An existing file or project version to label. By default the current
        version is labelled.</td>
        <td>No</td>
     </tr>
     <tr>
        <td>comment</td>
        <td>The comment to use for this label. Empty or '-' for no comment.</td>
        <td>No</td>
     </tr>
  </table>
  <h3>Examples</h3>
  <blockquote>
  <pre>
  &lt;vsslabel vsspath=&quot;/source/aProject&quot;
            login=&quot;me,mypassword&quot;
            label=&quot;Release1&quot;/&gt;
  </pre>
  </blockquote>
  <p>Labels the current version of the VSS project <i>$/source/aProject</i>
with
  the label <i>Release1</i> using the username <i>me</i> and the password

  <i>mypassword</i>.
  </p>
  <blockquote>
  <pre>
  &lt;vsslabel vsspath=&quot;/source/aProject/myfile.txt&quot;
            version=&quot;4&quot;
            label=&quot;1.03.004&quot;/&gt;
  </pre>
  </blockquote>
  <p>Labels version 4 of the VSS file <i>$/source/aProject/myfile.txt</i>
with the
  label <i>1.03.004</i>. If this version already has a label, the operation (and
  the build) will fail.
  </p>
  <hr>
  
  <!-- VSSHISTORY -->
  
  <h2><a name="vsshistory">VssHistory</a></h2>
  <h3>Description</h3>
  Task to perform HISTORY commands to Microsoft Visual SourceSafe.
  <h3>Parameters</h3>
  <table border="1" cellpadding="2" cellspacing="0">
    <tr> 
      <th>Attribute</th>
      <th>Values</th>
      <th>Required</th>
    </tr>
    <tr>
       <td>vsspath</td>
       <td>SourceSafe path which specifies the project/file(s) you wish to 
           perform the action on. You should not specify the leading dollar-sign - 
           it is prepended by Ant automatically.</td>
       <td>Yes</td>
    </tr>
    <tr>
       <td>login</td>
       <td>username[,password] - The username and password needed to get access
           to VSS. Note that you may need to specify both (if you have a password) - 
           Ant/VSS will hang if you leave the password out and VSS does not accept 
           login without a password. </td>
       <td>No</td>
    </tr>
    <tr>
       <td>ssdir</td>
       <td>directory where <code>ss.exe</code> resides. By default the
           task expects it to be in the PATH.</td>
       <td>No</td>
    </tr>
    <tr>
       <td>serverPath</td>
       <td>directory where <code>srssafe.ini</code> resides.</td>
       <td>No</td>
    </tr>
    <tr> 
      <td>fromDate</td>
      <td>Start date for comparison</td>
      <td>See below</td>
    </tr>
    <tr> 
      <td>toDate</td>
      <td>Start date for comparison</td>
      <td>See below</td>
    </tr>
    <tr>
      <td>dateFormat</td>
      <td>Format of dates in fromDate and toDate. Used when calculating dates with 
        the numdays attribute. This string uses the formatting rules of SimpleDateFormat.

        Defaults to DateFormat.SHORT.</td>
      <td>No</td>
    </tr>
    <tr> 
      <td>fromLabel</td>
      <td>Start label for comparison</td>
      <td>No</td>
    </tr>
    <tr> 
      <td>toLabel</td>
      <td>Start label for comparison</td>
      <td>No</td>
    </tr>
    <tr> 
      <td>numdays</td>
      <td>The number of days for comparison.</td>
      <td>See below</td>
    </tr>
    <tr> 
      <td>output</td>
      <td>File to write the diff.</td>
      <td>No</td>
    </tr>
    <tr> 
      <td>recursive</td>
      <td>true or false</td>
      <td>No</td>
    </tr> 
    <tr> 
      <td>style</td>
      <td>brief, codediff, default or nofile. The default is default.</td>
      <td>No</td>
    </tr> 
  </table>
  
  <h4>Specifying the time-frame</h4>
  <p>There are different ways to specify what time-frame you wish to evaluate:</p>
  <ul>
    <li>Changes between two dates: Specify both <code>fromDate</code> and
<code>toDate</code> </li>
    <li>Changes before a date: Specify <code>toDate</code></li>
    <li>Changes after a date: Specify <code>fromDate</code></li>
    <li>Changes X Days before a date: Specify <code>toDate</code> and (negative!)
<code>numDays</code></li>
    <li>Changes X Days after a date: Specify <code>fromDate</code> and <code>numDays</code></li>
  </ul>
  
  
  <h3>Examples</h3>
  <blockquote>
    <pre>
  &lt;vsshistory vsspath=&quot;/myProject&quot; recursive=&quot;true&quot;

              fromLabel=&quot;Release1&quot;
              toLabel=&quot;Release2&quot;/&gt;
  </pre>
  </blockquote>
  <p>Shows all changes between &quot;Release1&quot; and &quot;Release2&quot;.</p>
  
  <blockquote>
    <pre>
  &lt;vsshistory vsspath=&quot;/myProject&quot; recursive=&quot;true&quot;

              fromDate=&quot;01.01.2001&quot;
              toDate=&quot;31.03.2001&quot;/&gt;
  </pre>
  </blockquote>
  <p>Shows all changes between January 1st 2001 and March 31st 2001 (in Germany, date
must be specified according to your locale).</p>
  
  <blockquote> 
    <pre>
  &lt;tstamp&gt;
    &lt;format property=&quot;to.tstamp&quot; pattern=&quot;M-d-yy;h:mma&quot;
/&gt;
  &lt;/tstamp&gt;
  
  &lt;vsshistory vsspath=&quot;/myProject&quot; recursive=&quot;true&quot;

              numDays=&quot;-14&quot;
              dateFormat=&quot;M-d-yy;h:mma&quot;
              toDate=&quot;${to.tstamp}&quot;/&gt;
  </pre>
  </blockquote>
  <p>Shows all changes in the 14 days before today.</p>
  <hr>
  
  <!-- VSSCHECKIN -->
  
  <h2><a name="vsscheckin">VssCheckin</a></h2>
  <h3>Description</h3>
  Task to perform CHECKIN commands to Microsoft Visual SourceSafe.
  <h3>Parameters</h3>
  <table border="1" cellpadding="2" cellspacing="0">
    <tr>
      <th>Attribute</th>
      <th>Values</th>
      <th>Required</th>
    </tr>
    <tr>
       <td>vsspath</td>
       <td>SourceSafe path which specifies the project/file(s) you wish to 
           perform the action on. You should not specify the leading dollar-sign - 
           it is prepended by Ant automatically.</td>
       <td>Yes</td>
    </tr>
    <tr>
       <td>login</td>
       <td>username[,password] - The username and password needed to get access
           to VSS. Note that you may need to specify both (if you have a password) - 
           Ant/VSS will hang if you leave the password out and VSS does not accept 
           login without a password. </td>
       <td>No</td>
    </tr>
    <tr>
       <td>localpath</td>
       <td>Override the working directory and get to the specified path</td>
       <td>No</td>
    </tr>
    <tr>
       <td>ssdir</td>
       <td>directory where <code>ss.exe</code> resides. By default the
           task expects it to be in the PATH.</td>
       <td>No</td>
    </tr>
    <tr>
       <td>serverPath</td>
       <td>directory where <code>srssafe.ini</code> resides.</td>
       <td>No</td>
    </tr>
    <tr>
       <td>writable</td>
       <td>true or false</td>
       <td>No</td>
    </tr>
    <tr>
       <td>recursive</td>
       <td>true or false</td>
       <td>No</td>
    </tr>
    <tr>
       <td>comment</td>
       <td>Comment to use for the files that where checked in.</td>
       <td>No</td>
    </tr>
    <tr>
       <td>autoresponse</td>
       <td>'Y', 'N' or empty. Specify how to reply to questions from VSS.</td>
       <td>No</td>
    </tr>
  </table>
  
  <h3>Examples</h3>
  <blockquote>
  <pre>
  &lt;vsscheckin vsspath=&quot;/test/test*&quot;
              localpath=&quot;D:\build\&quot;
              comment=&quot;Modified by automatic build&quot;/&gt;
  </pre>
  </blockquote>
  <p>Checks in the file(s) named <i>test*</i> in the project <i>test</i>
using 
  the local directory <i>D:\build</i>.</p>
  <hr>
  
  <!-- VSSCHECKOUT -->
  
  <h2><a name="vsscheckout">VssCheckout</a></h2>
  <h3>Description</h3>
  Task to perform CHECKOUT commands to Microsoft Visual SourceSafe.
  <p>If you specify two or more attributes from version, date and 
  label only one will be used in the order version, date, label.</p>
  <h3>Parameters</h3>
  <table border="1" cellpadding="2" cellspacing="0">
    <tr>
      <th>Attribute</th>
      <th>Values</th>
      <th>Required</th>
    </tr>
    <tr>
       <td>vsspath</td>
       <td>SourceSafe path which specifies the project/file(s) you wish to 
           perform the action on. You should not specify the leading dollar-sign - 
           it is prepended by Ant automatically.</td>
       <td>Yes</td>
    </tr>
    <tr>
       <td>login</td>
       <td>username[,password] - The username and password needed to get access
           to VSS. Note that you may need to specify both (if you have a password) - 
           Ant/VSS will hang if you leave the password out and VSS does not accept 
           login without a password. </td>
       <td>No</td>
    </tr>
    <tr>
       <td>localpath</td>
       <td>Override the working directory and get to the specified path</td>
       <td>No</td>
    </tr>
    <tr>
       <td>ssdir</td>
       <td>directory where <code>ss.exe</code> resides. By default the
           task expects it to be in the PATH.</td>
       <td>No</td>
    </tr>
    <tr>
       <td>serverPath</td>
       <td>directory where <code>srssafe.ini</code> resides.</td>
       <td>No</td>
    </tr>
    <tr>
       <td>writable</td>
       <td>true or false</td>
       <td>No</td>
    </tr>
    <tr>
       <td>recursive</td>
       <td>true or false</td>
       <td>No</td>
    </tr>
    <tr>
       <td>version</td>
       <td>a version number to get</td>
       <td rowspan="3">No, only one of these allowed</td>
    </tr>
    <tr>
       <td>date</td>
       <td>a date stamp to get at</td>
    </tr>
    <tr>
       <td>label</td>
       <td>a label to get for</td>
    </tr>
  </table>
  
  <h3>Examples</h3>
  <blockquote>
  <pre>
  &lt;vsscheckout vsspath=&quot;/test&quot;
               localpath=&quot;D:\build&quot;
               recursive=&quot;true&quot;
               login=&quot;me,mypass&quot;
               autoResponse=&quot;Y&quot;/&gt;
  </pre>
  </blockquote>
  <p>Does a recursive checkout of the project test to the directory D:\build. 
  This will overwrite all files already checked out (caused by autoResponse set to &quot;Y&quot;).
  </p>
  <hr>
  
  <p align="center">Copyright &copy; 2000,2001 Apache Software Foundation. All rights
  Reserved.</p>
  </body>
  </html>
  
  
  

Mime
View raw message