Perforce in FreeBSD Development

Scott Long


          

$FreeBSD: head/en_US.ISO8859-1/articles/p4-primer/article.xml 41130 2013-03-07 23:37:00Z gavin $

$FreeBSD: head/en_US.ISO8859-1/articles/p4-primer/article.xml 41130 2013-03-07 23:37:00Z gavin $

Legal Notice
Table of Contents
1 Introduction
2 Getting Started
3 Clients
4 Syncing
5 Branches
6 Integrations
7 Submit
8 Editing
9 Changes, Descriptions, and History
10 Diffs
11 Adding and Removing Files
12 Working with diffs
13 Renaming files
14 Interactions between FreeBSD Subversion and Perforce
15 Offline Operation
16 Notes for Google Summer of Code

1 Introduction

The FreeBSD project uses the Perforce version control system to manage experimental projects that are not ready for the main Subversion repository.

1.1 Availability, Documentation, and Resources

While Perforce is a commercial product, the client software for interacting with the server is freely available from Perforce. It can be easily installed on FreeBSD via the devel/p4 port or can be downloaded from the Perforce web site at http://www.perforce.com/perforce/loadprog.html, which also offers client applications for other OS's.

While there is a GUI client available, most people use the command line application called p4. This document is written from the point of view of using this command.

Detailed documentation is available online at http://www.perforce.com/perforce/technical.html.

Reading the “Perforce User's Guide” and “Perforce Command Reference” is highly recommended. The p4 application also contains an extensive amount of online help accessible via the p4 help command.

The FreeBSD Perforce server is hosted on perforce.freebsd.org, port 1666. The repository is browsable online at http://p4web.freebsd.org. Some portions of the repository are also automatically exported to a number of legacy CVSup servers.