Helix SwarmHelix Swarm
Loading...

labelsync.html

  • //
  • guest/
  • perforce_software/
  • p4web/
  • main/
  • doc/
  • p4web/
  • help/
  • labelsync.html #1
  • View
  • Commits
  • Open Download .zip Download (4 KB) 
  1. <HTML><HEAD><TITLE>P4Web User Guide - Adding and Replacing Files in a Label</TITLE></HEAD><BODY><FONT SIZE=-1><B>P4Web Release 2012.1 User Guide</B></FONT><BR>
  2. <FONT SIZE=-1><B><A HREF="quickstart.html">[Getting Started]</A>&nbsp;&nbsp;<A HREF="howto.html">[How To...]</A>&nbsp;&nbsp;<A HREF="tips.html">[Browser Tips]</A>&nbsp;&nbsp;<A HREF="defs.html">[Glossary]</A>&nbsp;&nbsp;<A HREF="roadmap.html">[Road Map]</A>&nbsp;&nbsp;</B></FONT><BR>
  3. <H3>Adding and Replacing Files in a Label</H3>
  4.  
  5. <P>
  6. <P>
  7. There are essentially two steps to creating a label:
  8. <ol type=1>
  9. <li>Create the label spec, which defines the name of the label and <a href="defs.html#labelview">label view</a>.
  10. <li>Tag the files with that label using <B>Add/Replace files...</B>
  11. </ol>
  12. <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
  13. name. <P>
  14. <P>
  15.  
  16. For more information about labels, see <A HREF="label.html">Working with Labels</a>.
  17. <p>
  18. <h4>Add/Replace restrictions</h4>
  19. Bear in mind that you <i>cannot</i> use <B>Add/Replace files</B> to update a label if:
  20. <ul>
  21. <li>The label's <b>Owner:</b> field is not your userid. You can only update labels you own.
  22. <li>The label has its <b>Options:</b> field set to <i>locked</i>
  23. </ul>
  24. For more information about a label's fields, see <A HREF="editlabel.html">Creating and Editing Labels</A>.
  25. <p>
  26.  
  27. <h4>To Add/Replace files in a label</h4>
  28. <ol type=1>
  29. <li>Select the <b>Labels</b> tab.
  30. <li>Click on the name of the label to which you want to add or replace files.
  31. <li>Select <b>Add/Replace labels...</b> from the pulldown list.
  32. </ol>
  33. <b>On the Add/Replace Files page</b> 
  34. <ol>
  35. <li>Under <b>Revision:</b> select one of the following radio buttons:
  36. <ul>
  37. <li><b>Workspace Revision</b>:  tags the file revisions currently synced in your workspace with the label.
  38. <li><b>Head Revision</b>:  tags the file revisions that are currently the latest versions in the depot with the label.
  39. <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.
  40. </ul>
  41. <p>
  42. <li>Under <b>Options:</b> select one of the following radio buttons:
  43. <ul>
  44. <li><b>Replace label contents completely</b>:  specified files are added or replaced. Files previously in the label that do not match your
  45. specification are removed from the label.
  46. <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
  47. unaffected.
  48. <li><b>Remove files from label</b>:  removes the named files from the label.
  49. </ul>
  50. <p>
  51. <li>Under <b>Files:</b> you can specify or restrict the files to add or replace. Select one of the following options:
  52. <ul>
  53. <li><b>All files in label view</b>:   includes all files in this label's <A HREF="defs.html#labelview">label view</a>.
  54.       <li><b>Files in <i>[path]</i></b>: this option is only available when your 
  55.         current path is not the root of the depot tree. Select <b>and subdirectories</b> 
  56.         or <b>at this level only</b>, depending on which files you want to include. 
  57.             
  58.       <li><b>Files in this list</b>: includes only the files listed in the textbox. 
  59.         You must provide a full pathname for these files, and you can use <A HREF="defs.html#wildcard">wildcards</a>. 
  60.         Note that the files you specify must be in the label's view, or P4Web 
  61.         displays a "No such file" error. You can also specify revisions if you 
  62.         have selected the <b>Workspace Revision</b> option. 
  63.     </ul>
  64. <p>
  65. <li>When you have finished defining the parameters,
  66. click the <b>Preview Add/Replace</b> button to see the results before actually updating the label. If the
  67. command has the expected results, click your browser's "Back" button and click the <b>Add/Replace</b> button to proceed.
  68.  
  69. </ol>
  70.  
  71.  
  72.    <P>
  73.    <HR>
  74.    <FONT SIZE=-1><I>
  75.    Copyright 2012 <A HREF="http://www.perforce.com">Perforce Software</A>.
  76.    All rights reserved.
  77.    </I></FONT>
  78.    </BODY></HTML>
# Change User Description Committed
#1 21055 p4mdavies Add release notes and documentation. 8 years ago