<HTML><HEAD><TITLE>P4Web User Guide - Working with Labels</TITLE></HEAD><BODY><FONT SIZE=-1><B>P4Web Release 2012.1 User Guide</B></FONT><BR>
<FONT SIZE=-1><B><A HREF="quickstart.html">[Getting Started]</A> <A HREF="howto.html">[How To...]</A> <A HREF="tips.html">[Browser Tips]</A> <A HREF="defs.html">[Glossary]</A> <A HREF="roadmap.html">[Road Map]</A> </B></FONT><BR>
<H3>Working with Labels</H3>
A <i>label</i> enables you to mark a set of file revisions for later access.
For example, release engineers can label the file revisions that comprise a particular
release of their program. The label can be assigned a meaningful name, like <tt>release2.0.1</tt>.
The label can be used for <A HREF="sync.html">syncing</a>, <A HREF="branch.html">branching</a>,
or comparing files.
<p> To create a label, you must:
<ol type=1>
<li>Create the label spec, which defines the name of the label and the <a href="defs.html#labelview">label
view</a>. The label view limits the files that can be tagged with the label.
<li>Perform an <a href="labelsync.html">Add/Replace files...</a> to apply the
label to specified file revisions.
</ol>
After you have created the label spec and tagged the revisions using <B>Add/Replace
files</B>, you can use that label to access those files at a later date. See <a href="editlabel.html">Creating
and Editing Labels</a> for additional information.
<p>
<b>Accessing labels</b>
<P> To list labels, click the <B>Labels</B> tab. To display only the labels that
contain tagged files in your current path, select the <b>Labels with files in
current path</b> checkbox and click <B>Filter</B>.
<p>
<b>Label Spec Detail</b>
<P> Clicking on a label name displays detailed information, including the label
spec's fields. For information about these fields, see <a href="editlabel.html">Creating
and Editing Labels</a>.
<P> To list the files tagged by the current label, including each file's path
in the depot, the filetype, and the revision number of the file, choose <b>View
files in label</b> from the <b>Action</b> menu
<p> From this page, you can use also use the <b>Action</b> menu to:
<ul>
<li><A HREF="editlabel.html">Edit</A> the label spec.
<li><A HREF="deletespec.html">Delete</A> the label spec.
<li><A HREF="labelsync.html">Add or Replace </A> files in a label.
<li> <A HREF="sync.html">Sync</A> the workspace to the files tagged with this label.
<li>Create a new label, using this label as a <A HREF="editlabel.html">template</A>.
</ul>
For information on creating a label without using a template, see <A HREF="editlabel.html">Creating
and Editing Label Specs</A>. <A NAME=changelist></a>
<h4>Why not use changelist numbers?</h4>
<p> <a href="label.html#changelist">Changelist numbers</a> are an alternative
to labels, if you need to refer to a group of files. Labels share certain important
characteristics with changelist numbers, as both refer to particular file sets,
and both refer to all the files in the set. But labels have some important advantages
over changelist numbers:
<ul>
<li>The file revisions tagged by a particular label can come from different changelists.
<li>A changelist number refers to the contents of all the files in the depot at
the time the changelist was submitted, but a label can refer to an arbitrary
set of files and revisions.
<li>The files and revisions tagged by a label can be changed at any point in the labels existence.
<li>Changelists are always referred to by Perforce-assigned numbers, but labels are named by the user.
</ul>
<P>
<HR>
<FONT SIZE=-1><I>
Copyright 2012 <A HREF="http://www.perforce.com">Perforce Software</A>.
All rights reserved.
</I></FONT>
</BODY></HTML>