editlabel.html #1

<TITLE>Creating and Editing Labels</TITLE>

<p>
A <a href="defs?help#label">label</a> provides a means for marking a particular set of file
revisions for later access. The <i>label spec</i> defines the label's name and its label view. For
more information about labels, see <a href="label?help">Working with Labels</a>.
<p>


<B>Creating a label spec</B>
<br>
There are a couple of ways to create a label spec in P4Web.
<blockquote> <b><A NAME=createbrowser></a>To create a new label spec in P4Web:,</b> 
  <ol type=1>
    <li>Select the <b>Labels</b> tab. 
    <li>Click on the <B>Create label spec</B> link at the top of the page.
<li>Enter a name for the label spec in the <B>Label</B> field.
<li> Edit the remaining fields as described <a href="editlabel?help#labeldesc">below</a>.
<li> When you are finished, click the <b>Save</b> button.
</ol>

  <b><A NAME=createtemplate>To create a label spec using another label spec as a 
  template:</a></b> 
  <P>
<ol type=1>
<li>Select the <bLabels> tab.
<li>Click on the label that you want to use as a template.
    <li>Select <b>Use label as template...</b> from the <b>Action</b> menu. 
    <li>Edit the fields as described <a href="editlabel?help#labeldesc">below</a>.
<li> When you are finished, click the <b>Save</b> button.
</ol>
<p>
</blockquote>

<B>Editing a label spec</B>
<br>
<blockquote>
<ol type=1>
<li>Select the <b>Labels</b> tab.
    <li>Click the label that you want to edit. 
        <li>Select <B>Edit label spec...</B> from the Action menu. 
    <li>Edit the label spec as desired, using the field descriptions <a href="editlabel?help#labeldesc">
below</a>.
<li>When you have finished editing the label spec, click the <b>Save</b> button.
</ol>
</blockquote>

<P><A NAME=labeldesc><B>Label spec field descriptions</B></A> <br>
  The label spec consists of the following values: 
<table width="66%" border="1" cellpadding="1">
  <tr> 
    <td><b>Field</b></td>
    <td><b>Description</b></td>
  </tr>
  <tr> 
    <td><b>Label</b></td>
    <td>The unique name of this label. </td>
  </tr>
  <tr> 
    <td><b>Update</b></td>
    <td>Shows the date when this label spec was last modified. </td>
  </tr>
  <tr> 
    <td><b>Access</b></td>
    <td>The date and time the label was last accessed. </td>
  </tr>
  <tr> 
    <td><b>Owner</b></td>
    <td>The label's owner. By default, the user who created the label. Only the 
      owner of a label can <a href="labelsync?help">update its contents</a>. </td>
  </tr>
  <tr> 
    <td><b>Description</b></td>
    <td>Optional information that can be used to describe this label spec. </td>
  </tr>
  <tr> 
    <td><b>Options</b></td>
    <td>Can either be <i>locked</i> or <i>unlocked</i>. If the label is locked, 
      its contents cannot be <a href="labelsync?help">changed</a>. </td>
  </tr>
  <tr> 
    <td><b>View</b></td>
    <td>A list of depot files that can be included in this label. No files are 
      actually included until you sync the label. </td>
  </tr>
</table>