Perforce Users Guide

  • View
    665

  • Download
    2

Embed Size (px)

Text of Perforce Users Guide

Perforce 2003.2 Users Guide

December 2003

This manual copyright 1997-2003 Perforce Software. All rights reserved. Perforce software and documentation is available from http://www.perforce.com. You may download and use Perforce programs, but you may not sell or redistribute them. You may download, print, copy, edit, and redistribute the documentation, but you may not sell it, or sell any documentation derived from it. You may not modify or attempt to reverse engineer the programs. Perforce programs and documents are available from our Web site as is. No warranty or support is provided. Warranties and support, along with higher capacity servers, are sold by Perforce Software. Perforce Software assumes no responsibility or liability for any errors or inaccuracies that may appear in this book. By downloading and using our programs and documents you agree to these terms. Perforce and Inter-File Branching are trademarks of Perforce Software. Perforce software includes software developed by the University of California, Berkeley and its contributors. All other brands or product names are trademarks or registered trademarks of their respective companies or organizations.

Table of ContentsPreface

About This Manual ..................................................... 11Administering Perforce?..................................................................................11 Please Give Us Feedback .................................................................................11

Chapter 1

Product Overview....................................................... 13Perforce Server and Perforce Client Programs.............................................14 Moving les between the clients and the server......................................14 File conicts...................................................................................................15 Labeling groups of les ...............................................................................15 Branching les ..............................................................................................15 Job tracking ...................................................................................................16 Change notication ......................................................................................16 Protections .....................................................................................................17 Other Perforce Clients......................................................................................17 P4Win .............................................................................................................17 P4Web.............................................................................................................17 Merge Tools .......................................................................................................17 P4 resolve.......................................................................................................18 P4WinMerge..................................................................................................18 Other merge utilities ....................................................................................18 Defect Tracking Systems ..................................................................................18 Perforce jobs ..................................................................................................18 P4DTI integrations with third-party defect trackers...............................19 Plug-Ins, reporting and tool integrations......................................................19 IDE Plug-ins ..................................................................................................19 P4Report and P4SQL ...................................................................................20 P4OFC ............................................................................................................20

Chapter 2

Connecting to the Perforce Server............................................................. 21Before you begin ...............................................................................................21 Setting up your environment to use Perforce...............................................21

Perforce 2003.2 Users Guide

3

Table of Contents

Telling Perforce clients where the server is.............................................. 22 Verifying the connection to the Perforce server ...................................... 23

Chapter 3

Perforce Basics: Quick Start.................................................................... 25Underlying concepts ....................................................................................... 25 File congurations used in the examples................................................. 25 Setting up a client workspace ........................................................................ 26 Naming the client workspace .................................................................... 26 Describing the client workspace to the Perforce server......................... 26 Copying depot les into your workspace .................................................... 28 Updating the depot with les from your workspace ................................. 29 Adding les to the depot............................................................................ 30 Editing les in the depot ............................................................................ 31 Deleting les from the depot ..................................................................... 32 Submitting with multiple operations ....................................................... 33 Backing out: reverting les to their unopened states ................................. 34 Basic reporting commands ............................................................................. 34

Chapter 4

Perforce Basics: The Details.................................................................... 37Description of the Client Workspace............................................................. 37 Wildcards .......................................................................................................... 38 Wildcards and p4 add ............................................................................. 38 Mapping the Depot to the Client Workspace .............................................. 38 Multiple depots............................................................................................ 39 Using views .................................................................................................. 39 Wildcards in views ...................................................................................... 41 Types of mappings ...................................................................................... 41 Editing Existing Client Specications........................................................... 44 Deleting an existing client specication................................................... 45 Client specication options........................................................................ 45 Multiple workspace roots for cross-platform work................................ 47 Line-ending conventions (CR/LF translation)........................................ 47 Referring to Files on the Command Line ..................................................... 48 Local syntax.................................................................................................. 48

4

Perforce 2003.2 Users Guide

Table of Contents

Perforce syntax..............................................................................................48 Providing les as arguments to commands .............................................49 Wildcards and Perforce syntax...................................................................50 Name and String Limitations..........................................................................50 Illegal characters in lenames and Perforce objects ................................50 Name and description lengths ...................................................................51 Specifying Older File Revisions......................................................................51 Using revision specications without lenames .....................................54 Revision Ranges................................................................................................54 File Types ...........................................................................................................55 Base le types................................................................................................56 Forms and Perforce Commands .....................................................................60 Reading forms from standard input; Writing forms to standard output..............................................................61 General Reporting Commands.......................................................................61

Chapter 5

Perforce Basics: Resolving File Conicts.............................................. 63RCS Format: How Perforce Stores File Revisions ........................................63 Only the differences between revisions are stored..................................63 Use of diff to determine le revision differences.................................65 Scheduling Resolves of Conicting Files ......................................................65 Why p4 sync to Schedule a Resolve? .........................................................65 How Do I Know When a Resolve is Needed?..............................................66 Performing Resolves of Conicting Files ......................................................66 File revisions used and generated by p4 resolve ..

View more >