java left logo
java middle logo
java right logo
 

Home arrow Other API Tips arrow Ant arrow How to use Pvcs task
 
 
Main Menu
Home
Java Tutorials
Book Reviews
Java SE Tips
Java ME Tips
Java EE Tips
Other API Tips
Java Applications
Java Libraries
Java Games
Java Network
Java Forums
Java Blog




Most Visited Tips
Java SE Tips
Java ME Tips
Java EE Tips
Other API Tips
Java Applications
Java Libraries
Java Games
Book Reviews
Top Rated Tips
Java SE Tips
Java ME Tips
Java EE Tips
Other API Tips
Java Applications
Java Libraries
Java Games
Book Reviews


Statistics
Registered Users: 3899
Java SE Tips: 614
Java ME Tips: 202
Java EE Tips: 183
Other API Tips: 779
Java Applications: 298
Java Libraries: 209
Java Games: 16
Book Reviews:
 
 
 
How to use Pvcs task E-mail
User Rating: / 6
PoorBest 

Ant Pvcs Task User Manual

Note: Before using this task, the user running ant must have access to the commands of PVCS (get and pcli) and must have access to the repository. Note that the way to specify the repository is platform dependent so use property to specify location of repository.

by
  • Thomas Christensen ( This e-mail address is being protected from spam bots, you need JavaScript enabled to view it )
  • Don Jeffery ( This e-mail address is being protected from spam bots, you need JavaScript enabled to view it )
  • Jon Dickinson ( This e-mail address is being protected from spam bots, you need JavaScript enabled to view it )
Version 1.1 - 2001/06/27

Problems with UNC pathnames and the use of () in paths are fixed and an updateonly argument introduced.

Version 1.0 - 2001/01/31

Initial release.


Table of Contents


Introduction

The pvcs task allows the user of ant to extract the latest edition of the source code from a PVCS repository. PVCS is a version control system developed by Merant.
This version has been tested against PVCS version 6.5 and 6.6 under Windows and Solaris.

Pvcs Task

Description

The pvcs task is set to point at a PVCS repository and optionally a project within that repository, and can from that specification get the latest version of the files contained by the repository.

Parameters

Attribute Description Required
repository The location of the repository (see your PVCS manuals) Yes
pvcsproject The project within the PVCS repository to extract files from ("/" is root project and that is default if this attribute isn't specified) No
label Only files marked with this label are extracted. No
promotiongroup Only files within this promotion group are extracted. Using both the label and the promotiongroup tag will cause the files in the promotion group and with that label to be extracted. No
config path of a non default .cfg file. Can be given absolute or relative to ant's base directory. No
force If set to yes all files that exists and are writable are overwritten. Default no causes the files that are writable to be ignored. This stops the PVCS command get to stop asking questions! No
workspace By specifying a workspace, the files are extracted to that location. A PVCS workspace is a name for a location of the workfiles and isn't as such the location itself. You define the location for a workspace using the PVCS GUI clients. If this isn't specified the default workspace for the current user is used. No
pvcsbin On some systems the PVCS executables pcli and get are not found in the PATH. In such cases this attribute should be set to the bin directory of the PVCS installation containing the executables mentioned before. If this attribute isn't specified the tag expects the executables to be found using the PATH environment variable. No
ignorereturncode If set to true the return value from executing the pvcs commands are ignored. No
updateonly If set to true files are gotten only if newer than existing local files. No
filenameformat The format of your folder names in a format suitable for java.text.MessageFormat. Defaults to {0}-arc({1}). Repositories where the archive extension is not -arc should set this. No
linestart Used to parse the output of the pcli command. It defaults to "P:. The parser already knows about / and \\, this property is useful in cases where the repository is accessed on a Windows platform via a drive letter mapping. No
revision Retrieve the specified revision. No
userid Use the specified userid. No

Nested Elements

pvcsproject element

pvcs supports a nested <pvcsproject> element, that represents a project within the PVCS repository to extract files from. By nesting multiple <pvcsproject> elements under the <pvcs> task, multiple projects can be specified.

Parameters

Attribute Description Required
name The name of the pvcs project Yes

Examples

The following set-up extracts the latest version of the files in the pvcs repository.
  <!-- =================================================================== -->
  <!-- Get the latest version                                              -->
  <!-- =================================================================== -->

  <target name="getlatest">
    <pvcs repository="/mnt/pvcs" pvcsproject="/myprj"/>
  </target>

Now run:

ant getlatest

This will cause the following output to appear:

  getlatest:
  [pvcs] PVCS Version Manager (VMGUI) v6.6.10 (Build 870) for Windows NT/80x86
  [pvcs] Copyright 1985-2000 MERANT. All rights reserved.
  [pvcs] PVCS Version Manager (get) v6.6.10 (Build 870) for Windows NT/80x86
  [pvcs] Copyright 1985-2000 MERANT. All rights reserved.
  [pvcs] c:\myws\myprj\main.java <- C:\mypvcs\archives\myprj\main.java-arc
  [pvcs] rev 1.1
  [pvcs] c:\myws\myprj\apache\tool.java <- 
         C:\mypvcs\archives\myprj\apache\tools.java-arc
  [pvcs] rev 1.5

  BUILD SUCCESSFUL

  Total time: 19 seconds
This next example extracts the latest version of the files in the pvcs repository from two projects using nested <pvcsproject> elements.
  <!-- ===================================================================-->

  <!-- Get latest from myprj and myprj2                                   -->
  <!-- ===================================================================-->
  <target name="getlatest2">
    <pvcs repository="/mnt/pvcs">
      <pvcsproject name="/myprj"/>

      <pvcsproject name="/myprj2"/>
    </pvcs>
  </target>

Now run:

ant getlatest2

This will cause the following output to appear:

  getlatest2:
  [pvcs] PVCS Version Manager (VMGUI) v6.6.10 (Build 870) for Windows NT/80x86
  [pvcs] Copyright 1985-2000 MERANT.  All rights reserved.
  [pvcs] PVCS Version Manager (get) v6.6.10 (Build 870) for Windows NT/80x86
  [pvcs] Copyright 1985-2000 MERANT.  All rights reserved.
  [pvcs] c:\myws\myprj\main.java <- C:\mypvcs\archives\myprj\main.java-arc
  [pvcs] rev 1.1
  [pvcs] c:\myws\myprj\apache\tool.java <- 
         C:\mypvcs\archives\myprj\apache\tool.java-arc
  [pvcs] rev 1.5
  [pvcs] c:\myws\myprj2\apache\tool2.java <- 
         C:\mypvcs\archives\myprj2\apache\tool2.java-arc
  [pvcs] rev 1.2

  BUILD SUCCESSFUL

  Total time: 22 seconds

Source: Apache Ant


 Related Tips

 
< Prev   Next >

Page 1 of 0 ( 0 comments )

You can share your information about this topic using the form below!

Please do not post your questions with this form! Thanks.


Name (required)


E-Mail (required)

Your email will not be displayed on the site - only to our administrator
Homepage(optional)



Comment Enable HTML code : Yes No



 
       
         
     
 
 
 
   
 
 
java bottom left
java bottom middle
java bottom right
RSS 0.91 FeedRSS 1.0 FeedRSS 2.0 FeedATOM FeedOPML Feed

Home - About Us - Privacy Policy
Copyright 2005 - 2008 www.java-tips.org
Java is a trademark of Sun Microsystems, Inc.