labelsync.html #1

<TITLE>Adding and Replacing Files in a Label</TITLE>

<P>
<P>
There are essentially two steps to creating a label:
<ol type=1>
<li>Create the label spec, which defines the name of the label and <a href="defs?help#labelview">label view</a>.
<li>Tag the files with that label using <B>Add/Replace files...</B>
</ol>
<B>Add/Replace files...</B> tags a set of files with a label. Once you have tagged them, you can refer to a set of files by their label
name. <P>
<P>

For more information about labels, see <A HREF="label?help">Working with Labels</a>.
<p>
<h4>Add/Replace restrictions</h4>
Bear in mind that you <i>cannot</i> use <B>Add/Replace files</B> to update a label if:
<ul>
<li>The label's <b>Owner:</b> field is not your userid. You can only update labels you own.
<li>The label has its <b>Options:</b> field set to <i>locked</i>
</ul>
For more information about a label's fields, see <A HREF="editlabel?help">Creating and Editing Labels</A>.
<p>

<h4>To Add/Replace files in a label</h4>
<ol type=1>
<li>Select the <b>Labels</b> tab.
<li>Click on the name of the label to which you want to add or replace files.
<li>Select <b>Add/Replace labels...</b> from the pulldown list.
</ol>
<b>On the Add/Replace Files page</b> 
<ol>
<li>Under <b>Revision:</b> select one of the following radio buttons:
<ul>
<li><b>Workspace Revision</b>:  tags the file revisions currently synced in your workspace with the label.
<li><b>Head Revision</b>:  tags the file revisions that are currently the latest versions in the depot with the label.
<li><b>Label, Changelist or Date</b>:   enter a label name, a changelist number, or a date to tag files at revisions matching that criteria.
</ul>
<p>
<li>Under <b>Options:</b> select one of the following radio buttons:
<ul>
<li><b>Replace label contents completely</b>:  specified files are added or replaced. Files previously in the label that do not match your
specification are removed from the label.
<li><b>Add files to label</b>:  adds or replaces only the files that you specify. Labeled files that do not match your specifications are
unaffected.
<li><b>Remove files from label</b>:  removes the named files from the label.
</ul>
<p>
<li>Under <b>Files:</b> you can specify or restrict the files to add or replace. Select one of the following options:
<ul>
<li><b>All files in label view</b>:   includes all files in this label's <A HREF="defs?help#labelview">label view</a>.
      <li><b>Files in <i>[path]</i></b>: this option is only available when your 
        current path is not the root of the depot tree. Select <b>and subdirectories</b> 
        or <b>at this level only</b>, depending on which files you want to include. 
            
      <li><b>Files in this list</b>: includes only the files listed in the textbox. 
        You must provide a full pathname for these files, and you can use <A HREF="defs?help#wildcard">wildcards</a>. 
        Note that the files you specify must be in the label's view, or P4Web 
        displays a "No such file" error. You can also specify revisions if you 
        have selected the <b>Workspace Revision</b> option. 
    </ul>
<p>
<li>When you have finished defining the parameters,
click the <b>Preview Add/Replace</b> button to see the results before actually updating the label. If the
command has the expected results, click your browser's "Back" button and click the <b>Add/Replace</b> button to proceed.

</ol>