Ravenbrook / Projects / Perforce Defect Tracking Integration

Perforce Defect Tracking Integration Project


Version 2.0 Product Sources

Richard Brooksby, Ravenbrook Limited, 2000-05-25

Modified by Robert Cowham, Vaccaperna Systems Ltd, 2004-03-18

1. Introduction

This document catalogues the product sources of the Perforce Defect Tracking Integration project. (See [RB 1999-05-20] for a discussion of master sources, versions, and releases.)

If you have downloaded the P4DTI Integration Kit and are planning to adapt or extend the system, start with the kit-readme.txt file.

This particular version has been modified by Robert Cowham, Vaccaperna Systems Ltd to work with PVCS (now Serena) Tracker, and is thus a customised version of the original files. For details about the Tracker integration see the Tracker Design Requirements.

This document will be modified as the product sources are developed.

The readership of this document is the project developers, but also anyone interested in the project.

This document is not confidential.

2. Product sources

The product sources are everything which is used to construct the product and everything which is developed as the product develops, and must therefore be branched and maintained in product versions.

code/ Product source code: replicator, etc.
design/ Design documents: architecture, replicator, etc.
manual/ Product manuals: User's Guide, Administrator's Guide, Advanced Administrator's Guide and Integrator's Guide.
packaging/ Product packaging: Linux RPM specification and Linux startup script.
procedure/ Procedures: building releases, testing releases, etc.
template/ Product template files for HTML documents, Python source files, etc.
test/ Product tests.
tool/ Development, build, and test tools.
readme.txt The readme.txt file that accompanies the product releases.
release-notes.txt The release notes that accompany the product releases.
license.txt The open source license under which the P4DTI is distributed.
kit-readme.txt The introduction to the P4DTI Integration Kit.

A. References

[RB 1999-05-20] "Product Quality through Change Management"; Richard Brooksby; Geodesic Systems; 1999-05-20; <URL: http://richard.brooksby.org/1999/05/20/pqtcm/>.

B. Document History

2000-05-25 RB Created as placeholder.
2000-08-30 GDR Added code/.
2000-10-17 RB Added procedure/.
2000-12-13 RB Added tool/ and test/.
2001-02-23 GDR Added release notes.
2001-03-02 RB Transferred copyright to Perforce under their license. Added reference to license.txt file.
2001-03-26 RB Added templates directory, product packaging directory. Directed developers to the Integrator's Guide. Brought various directory pointers up to date.
2001-03-27 RB Added the "kit-readme.txt" file.

This document is copyright © 2001 Perforce Software, Inc. All rights reserved.

Redistribution and use of this document in any form, with or without modification, is permitted provided that redistributions of this document retain the above copyright notice, this condition and the following disclaimer.

This document is provided by the copyright holders and contributors "as is" and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall the copyright holders and contributors be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this document, even if advised of the possibility of such damage.

$Id: //info.ravenbrook.com/project/p4dti/version/2.0/index.html#3 $

Ravenbrook / Projects / Perforce Defect Tracking Integration