Helix SwarmHelix Swarm
Loading...

p4tasks.html

  • //
  • guest/
  • perforce_software/
  • p4ant/
  • main/
  • com.perforce.ant/
  • docs/
  • manual/
  • p4tasks.html #1
  • View
  • Commits
  • Open Download .zip Download (103 KB) 
  1. <html>
  2. <head>
  3. <link rel="stylesheet" type="text/css" href="p4style.css">
  4. <title>P4Ant Tasks</title>
  5. </head>
  6. <body>
  7. <h1>P4Ant User Guide</h1>
  8. <p>by</p>
  9. <ul>
  10.   <li>Perforce Support (<a href="mailto:support@perforce.com">support@perforce.com</a>)</li>
  11. </ul>
  12. <hr>
  13. <h2>Contents</h2>
  14. <ul>
  15.   <li><a href="#intro">Introduction</a></li>
  16.   <li><a href="#tasks">The Tasks</a></li>
  17.   <li><a href="#changes">Change History</a></li>
  18. </ul>
  19. <br>
  20. <h2><a name="intro">Introduction</a></h2>
  21. <p>The Apache Ant project currently provides a set of Perforce Tasks
  22. based on work by Les Hughes, Kirk Wylie, Matt Bishop and Antoine
  23. Levy-Lambert. We would like to acknowledge this work and thank the
  24. Apache Foundation and these dedicated developers for supporting Perforce
  25. users over the years. The P4Ant project is based on the P4Java API and
  26. as a result it is self-contained and does not require any third-party
  27. libraries or the Perforce command-line client. This integration supports
  28. many additional features including shelving and is distributed in both
  29. binary and source forms.</p>
  30. <p>The P4Ant tasks implement <a href="http://www.perforce.com"
  31.   target="_top">Perforce</a> commands using the Perforce Java API. These
  32. tasks are intended for build automation with Ant.</p>
  33.  
  34. <p><b>Note:</b> The P4Ant tasks are known to work with P4Java
  35. 2010.1+ (Perforce Java API), JDK 1.5.0+ and Ant 1.7.0+.</p>
  36.  
  37. <h2><a name="tasks">The Tasks</a></h2>
  38.  
  39. <table border="0" cellspacing="0" cellpadding="3">
  40.   <tr>
  41.     <td><b>Task</b></td>
  42.     <td><b>Description</b></td>
  43.   </tr>
  44.   <tr>
  45.     <td><a href="#p4jadd">P4JAdd</a></td>
  46.     <td>Open new files to add to the depot.</td>
  47.   </tr>
  48.   <tr>
  49.     <td><a href="#p4jchange">P4JChange</a></td>
  50.     <td>Create or edit a changelist description.</td>
  51.   </tr>
  52.   <tr>
  53.     <td><a href="#p4jchanges">P4JChanges</a></td>
  54.     <td>Display a list of pending and submitted changelists.</td>
  55.   </tr>
  56.   <tr>
  57.     <td><a href="#p4jcounter">P4JCounter</a></td>
  58.     <td>Display, set, or delete a counter.</td>
  59.   </tr>
  60.   <tr>
  61.     <td><a href="#p4jdelete">P4JDelete</a></td>
  62.     <td>Open an existing file to delete it from the depot.</td>
  63.   </tr>
  64.   <tr>
  65.     <td><a href="#p4jdiff2">P4JDiff2</a></td>
  66.     <td>Display diff (server side) of two depot files on the server.</td>
  67.   </tr>
  68.   <tr>
  69.     <td><a href="#p4jedit">P4JEdit</a></td>
  70.     <td>Open existing files for edit.</td>
  71.   </tr>
  72.   <tr>
  73.     <td><a href="#p4jfiles">P4JFiles</a></td>
  74.     <td>List files in the depot.</td>
  75.   </tr>
  76.   <tr>
  77.     <td><a href="#p4jfix">P4JFix</a></td>
  78.     <td>Mark jobs as being fixed by a changelist number.</td>
  79.   </tr>
  80.   <tr>
  81.     <td><a href="#p4jfstat">P4JFstat</a></td>
  82.     <td>Dump file info in the depot without accessing their contents.</td>
  83.   </tr>
  84.   <tr>
  85.     <td><a href="#p4jgrep">P4JGrep</a></td>
  86.     <td>Print lines in files that match a pattern.</td>
  87.   </tr>
  88.   <tr>
  89.     <td><a href="#p4jhave">P4JHave</a></td>
  90.     <td>List files and revisions that have been synced to the client
  91.     workspace.</td>
  92.   </tr>
  93.   <tr>
  94.     <td><a href="#p4jintegrate">P4JIntegrate</a></td>
  95.     <td>Stage change propagation from source files to target files.</td>
  96.   </tr>
  97.   <tr>
  98.     <td><a href="#p4jjob">P4JJob</a></td>
  99.     <td>Create or edit a job specification.</td>
  100.   </tr>
  101.   <tr>
  102.     <td><a href="#p4jjobs">P4JJobs</a></td>
  103.     <td>Display list of jobs.</td>
  104.   </tr>
  105.   <tr>
  106.     <td><a href="#p4jlabel">P4JLabel</a></td>
  107.     <td>Create a new label specification or edit an existing label
  108.     specification.</td>
  109.   </tr>
  110.   <tr>
  111.     <td><a href="#p4jlabelsync">P4JLabelsync</a></td>
  112.     <td>Synchronize a label with the contents of the current client
  113.     workspace.</td>
  114.   </tr>
  115.   <tr>
  116.     <td><a href="#p4jlock">P4JLock</a></td>
  117.     <td>Lock opened files against changelist submission.</td>
  118.   </tr>
  119.   <tr>
  120.     <td><a href="#p4jmove">P4JMove</a></td>
  121.     <td>Move files from one location to another.</td>
  122.   </tr>
  123.   <tr>
  124.     <td><a href="#p4jreopen">P4JReopen</a></td>
  125.     <td>Move opened files between changelists or change the files'
  126.     type.</td>
  127.   </tr>
  128.   <tr>
  129.     <td><a href="#p4jresolve">P4JResolve</a></td>
  130.     <td>Resolve conflicts between file revisions.</td>
  131.   </tr>
  132.   <tr>
  133.     <td><a href="#p4jrevert">P4JRevert</a></td>
  134.     <td>Discard changes from opened files.</td>
  135.   </tr>
  136.   <tr>
  137.     <td><a href="#p4jshelve">P4JShelve</a></td>
  138.     <td>Store files from a pending changelist in the depot, without
  139.     submitting them.</td>
  140.   </tr>
  141.   <tr>
  142.     <td><a href="#p4jsubmit">P4JSubmit</a></td>
  143.     <td>Commits a pending changelist of changes made to open files to
  144.     the depot.</td>
  145.   </tr>
  146.   <tr>
  147.     <td><a href="#p4jsync">P4JSync</a></td>
  148.     <td>Synchronize files from the depot into the client workspace.</td>
  149.   </tr>
  150.   <tr>
  151.     <td><a href="#p4jtag">P4JTag</a></td>
  152.     <td>Tag files with a label.</td>
  153.   </tr>
  154.   <tr>
  155.     <td><a href="#p4junlock">P4JUnlock</a></td>
  156.     <td>Release the lock on a file but leave the file open.</td>
  157.   </tr>
  158.   <tr>
  159.     <td><a href="#p4junshelve">P4JUnshelve</a></td>
  160.     <td>Restore shelved files from a pending change into the client
  161.     workspace.</td>
  162.   </tr>
  163. </table>
  164.  
  165. <h3>General Properties</h3>
  166. <p>P4Ant tasks require some basic properties. These settings are
  167. respectively retrieved through individual attributes, project-wide
  168. properties and environment variables.</p>
  169. <table border="1" cellpadding="2" cellspacing="0">
  170.   <tr>
  171.     <td valign="top"><b>Property</b></td>
  172.     <td valign="top"><b>Attribute</b></td>
  173.     <td valign="top"><b>Environment Variable</b></td>
  174.     <td valign="top"><b>Description</b></td>
  175.     <td valign="top"><b>Required</b></td>
  176.     <td align="center" valign="top"><b>Default</b></td>
  177.   </tr>
  178.   <tr>
  179.     <td valign="top">p4.port</td>
  180.     <td valign="top">port</td>
  181.     <td valign="top">P4PORT</td>
  182.     <td valign="top">Perforce server host and port number on which it
  183.     listens. Example, myp4server:1666</td>
  184.     <td valign="top">Yes</td>
  185.     <td valign="top">perforce:1666</td>
  186.   </tr>
  187.   <tr>
  188.     <td valign="top">p4.user</td>
  189.     <td valign="top">user</td>
  190.     <td valign="top">P4USER</td>
  191.     <td valign="top">Perforce user name.</td>
  192.     <td valign="top">Yes</td>
  193.     <td valign="top">User name on the host machine.</td>
  194.   </tr>
  195.   <tr>
  196.     <td valign="top">p4.passwd</td>
  197.     <td valign="top">passwd</td>
  198.     <td valign="top">P4PASSWD</td>
  199.     <td valign="top">Perforce user password.</td>
  200.     <td valign="top">No</td>
  201.     <td valign="top"></td>
  202.   </tr>
  203.   <tr>
  204.     <td valign="top">p4.client</td>
  205.     <td valign="top">client</td>
  206.     <td valign="top">P4CLIENT</td>
  207.     <td valign="top">Perforce client workspace.</td>
  208.     <td valign="top">Yes</td>
  209.     <td valign="top">Name of host machine.</td>
  210.   </tr>
  211.   <tr>
  212.     <td valign="top" align="center">--</td>
  213.     <td valign="top">files</td>
  214.     <td valign="top" align="center">--</td>
  215.     <td valign="top">File and revision specifiers separated by space.
  216.     If the path contains whitespace, it must be double-quoted.<br>
  217.     Local syntax: /staff/user/usercws/file.c@userlabel<br>
  218.     Depot syntax: //depot/source/module/file.c#8<br>
  219.     Depot syntax: //depot/source/module/...<br>
  220.     Client syntax: //usercws/file.c#have</td>
  221.     <td valign="top">No</td>
  222.     <td valign="top"></td>
  223.   </tr>
  224.   <tr>
  225.     <td valign="top" align="center">--</td>
  226.     <td valign="top">file</td>
  227.     <td valign="top" align="center">--</td>
  228.     <td valign="top">Nested file and revision specifiers.</td>
  229.     <td valign="top">No</td>
  230.     <td valign="top"></td>
  231.   </tr>
  232.   <tr>
  233.     <td valign="top" align="center">--</td>
  234.     <td valign="top">fileset</td>
  235.     <td valign="top" align="center">--</td>
  236.     <td valign="top">Files found in a directory tree starting in a
  237.     base directory and are matched by patterns.</td>
  238.     <td valign="top">No</td>
  239.     <td valign="top"></td>
  240.   </tr>
  241.   <tr>
  242.     <td valign="top" align="center">--</td>
  243.     <td valign="top">fields</td>
  244.     <td valign="top" align="center">--</td>
  245.     <td valign="top">Nested name-value pair fields for Perforce
  246.     specifications, such as job spec.</td>
  247.     <td valign="top">No</td>
  248.     <td valign="top"></td>
  249.   </tr>
  250. </table>
  251.  
  252. <p>Additionally, the following are general attributes you can
  253. specify. Many of the above properties can also be set using the
  254. "globaloption" attribute below.</p>
  255. <table border="1" cellpadding="2" cellspacing="0">
  256.   <tr>
  257.     <td valign="top"><b>Attribute</b></td>
  258.     <td valign="top"><b>Description</b></td>
  259.     <td valign="top"><b>Required</b></td>
  260.     <td align="center" valign="top"><b>Default</b></td>
  261.   </tr>
  262.   <tr>
  263.     <td valign="top">failonerror</td>
  264.     <td valign="top">Specifies whether to stop the build (<code>true</code>|<code>yes</code>|<code>on</code>)
  265.     or keep going (<code>false</code>|<code>no</code>|<code>off</code>) if
  266.     an error is returned from Perforce.</td>
  267.     <td valign="top">No</td>
  268.     <td valign="top">true</td>
  269.   </tr>
  270.   <tr>
  271.     <td valign="top">globaloption</td>
  272.     <td valign="top">Nested key-value pair global options for
  273.     Perforce server. Note: these global options will override the local
  274.     attributes. For example, &lt;globaloption key="password"
  275.     value="myp4passwd" /&gt; will override the local "passwd" attribute's
  276.     value.<br>
  277.     See the <a
  278.       href="http://www.perforce.com/perforce/doc.current/manuals/p4java-javadoc/constant-values.html"
  279.       target="_top">Constant Field Values</a> of the
  280.     "com.perforce.p4java.PropertyDefs" class for property keys.</td>
  281.     <td valign="top">No</td>
  282.     <td valign="top"></td>
  283.   </tr>
  284. </table>
  285.  
  286. <p>Defining your own Perforce server protocol-specific and usage
  287. properties files. Note: please consult Perforce support for details.</p>
  288. <table border="1" cellpadding="2" cellspacing="0">
  289.   <tr>
  290.     <td valign="top"><b>Attribute</b></td>
  291.     <td valign="top"><b>Description</b></td>
  292.     <td valign="top"><b>Required</b></td>
  293.     <td align="center" valign="top"><b>Default</b></td>
  294.   </tr>
  295.   <tr>
  296.     <td valign="top">protocolpropertiesfile</td>
  297.     <td valign="top">Specifies the location of the Perforce server
  298.     protocol-specific properties file. Note that these properties are
  299.     potentially accessed for each command.</td>
  300.     <td valign="top">No</td>
  301.     <td valign="top"></td>
  302.   </tr>
  303.   <tr>
  304.     <td valign="top">usagepropertiesfile<br>
  305.     </td>
  306.     <td valign="top">Specifies the location of the Perforce server
  307.     usage properties file. Note that these properties are potentially
  308.     accessed for each command.</td>
  309.     <td valign="top">No</td>
  310.     <td valign="top"></td>
  311.   </tr>
  312. </table>
  313.  
  314. <h3>Examples</h3>
  315. <p>Environment Variables:</p>
  316. <p>(UNIX csh)</p>
  317. <pre>setenv P4PORT myp4server:1666</pre>
  318. <p>(UNIX sh, bash, etc.)</p>
  319. <pre>P4USER=myp4user; export P4USER</pre>
  320. <p>Project Properties:</p>
  321. <pre>&lt;property name=&quot;p4.client&quot; value=&quot;myp4clientws&quot;/&gt;</pre>
  322. <p>Task Attributes:</p>
  323. <pre>
  324. &lt;p4[command]
  325.     port=&quot;myp4server:1666&quot;
  326.     user=&quot;myp4user&quot;
  327.     client=&quot;myp4clientws&quot;
  328.     .
  329.     .
  330.     .
  331. /&gt;
  332. </pre>
  333. <pre>
  334. &lt;p4[command] files=&quot;//depot/source/module/file.c#8&quot;&gt;
  335.     &lt;fileset dir=&quot;/staff/user/usercws&quot; id=&quot;user.source.files&quot;&gt;
  336.         &lt;include name=&quot;**/*.java&quot;/&gt;
  337.         &lt;exclude name=&quot;**/*.class&quot;/&gt;
  338.     &lt;/fileset&gt;
  339.     &lt;file path="//usercws/file.c#have"/&gt;
  340.     &lt;file path="//usercws/file2.c#3"/&gt;
  341.     .
  342.     .
  343.     .
  344. &lt;/p4[command]&gt;
  345. </pre>
  346. <pre>
  347. &lt;p4[command] &quot;&gt;
  348.     &lt;field name="Status" value="open"/&gt;
  349.     &lt;field name="Description" value="Java bug - JVM out of memory error."/&gt;
  350.     .
  351.     .
  352.     .
  353. &lt;/p4[command]&gt;
  354. </pre>
  355.  
  356. <p>Please refer to the <a
  357.   href="http://www.perforce.com/perforce/doc.current/manuals/cmdref/index.html"
  358.   target="_top">Perforce Command Reference</a> for more information
  359. regarding the Perforce commands.</p>
  360.  
  361. <hr>
  362. <h2>Task Descriptions</h2>
  363.  
  364. <h2><a name="p4jadd">P4JAdd</a></h2>
  365. <h3>Description:</h3>
  366. <p>Opens new files for adding to the depot. If the files exist on
  367. the client they are read to determine if they are text or binary. If the
  368. file type cannot be determined then it is assumed to be text.</p>
  369.  
  370. <h3>Parameters</h3>
  371. <table border="1" cellpadding="2" cellspacing="0">
  372.   <tr>
  373.     <td valign="top"><b>Attribute</b></td>
  374.     <td valign="top"><b>Description</b></td>
  375.     <td valign="top"><b>Required</b></td>
  376.     <td valign="top"><b>Default</b></td>
  377.     <td align="center" valign="top"><b>P4 Command</b></td>
  378.   </tr>
  379.   <tr>
  380.     <td valign="top">changelist</td>
  381.     <td valign="top">If given, the open files are associated with the
  382.     specified pending changelist number; otherwise the open files are
  383.     associated with the default changelist.</td>
  384.     <td valign="top">No</td>
  385.     <td valign="top">0 (default)</td>
  386.     <td valign="top" align="center">p4 add -c</td>
  387.   </tr>
  388.   <tr>
  389.     <td valign="top">noupdate</td>
  390.     <td valign="top">If true, it lists what would be opened for add
  391.     without actually changing any files or metadata.</td>
  392.     <td valign="top">No</td>
  393.     <td valign="top">false</td>
  394.     <td valign="top" align="center">p4 add -n</td>
  395.   </tr>
  396.   <tr>
  397.     <td valign="top">filetype</td>
  398.     <td valign="top">If null, it looks for a filetype using the
  399.     name-to-type mapping table managed by 'p4 typemap'. It senses the
  400.     filetype by examining the file's contents and execute permission bit.
  401.     If non-null, the files are added as that filetype.</td>
  402.     <td valign="top">No</td>
  403.     <td valign="top">null</td>
  404.     <td valign="top" align="center">p4 add -t</td>
  405.   </tr>
  406.   <tr>
  407.     <td valign="top">usewildcards</td>
  408.     <td valign="top">If true, filenames that contain wildcards are
  409.     permitted. Filenames added to the repository that contain these
  410.     special wildcard characters '@', '#', '%' or '*' will have those
  411.     characters formatted into ascii hexadecimal representation. The only
  412.     way of referring to those files once added will be to use the
  413.     formatted version, the local filesystem name will not be recognized.</td>
  414.     <td valign="top">No</td>
  415.     <td valign="top">false</td>
  416.     <td valign="top" align="center">p4 add -f</td>
  417.   </tr>
  418. </table>
  419.  
  420. <h3>Examples</h3>
  421. <p>Assigns a specific file type to a new file, overriding any
  422. settings in the typemap table.<br>
  423. <b>Note:</b> The "port", "user", "passwd" and "client" task attributes
  424. are set explicitly.</p>
  425. <pre>
  426. &lt;p4jadd
  427.     port=&quot;myp4server:1666&quot;
  428.     user=&quot;myp4user&quot;
  429.     passwd=&quot;myp4passwd&quot;
  430.     client=&quot;myp4clientws&quot;
  431.     files=&quot;file.pdf&quot;
  432.     filetype=&quot;binary&quot;
  433. /&gt;
  434. </pre>
  435. <p>Opens all the files within the user's current directory for add,
  436. and links these files to changelist "13".<br>
  437. <b>Note:</b> The "P4PORT", "P4USER", "P4PASSWD" and "P4CLIENT"
  438. environment variables are preset by the user.</p>
  439. <pre>
  440. &lt;p4jadd
  441.     files=&quot;*&quot;
  442.     changelist=&quot;13&quot;
  443. /&gt;
  444. </pre>
  445. <p>Opens all "*.c" files in the user's "~/src" directory for add;
  446. also opens the "README" file in the user's current working directory for
  447. add. These files are linked to the default changelist.</p>
  448. <pre>
  449. &lt;p4jadd&gt;
  450.     &lt;file path=&quot;README&quot;/&gt;
  451.     &lt;file path=&quot;~/src/*.c&quot;/&gt;
  452. &lt;/p4jadd&gt;
  453. </pre>
  454.  
  455. <h2><a name="p4jchange">P4JChange</a></h2>
  456. <h3>Description:</h3>
  457. <p>Create or edit a changelist description. With no argument,
  458. 'change' creates a new changelist. If a changelist number is given,
  459. 'change' edits an existing, pending changelist. The
  460. "deletependingchangelist" (-d flag) option discards a pending
  461. changelist, but only if it has no opened files and no pending fixes
  462. associated with it.</p>
  463.  
  464. <h3>Parameters</h3>
  465. <table border="1" cellpadding="2" cellspacing="0">
  466.   <tr>
  467.     <td valign="top"><b>Attribute</b></td>
  468.     <td valign="top"><b>Description</b></td>
  469.     <td valign="top"><b>Required</b></td>
  470.     <td valign="top"><b>Default</b></td>
  471.     <td align="center" valign="top"><b>P4 Command</b></td>
  472.   </tr>
  473.   <tr>
  474.     <td valign="top">description</td>
  475.     <td valign="top">Description of the changelist.</td>
  476.     <td valign="top">No</td>
  477.     <td valign="top">null</td>
  478.     <td valign="top" align="center"></td>
  479.   </tr>
  480.   <tr>
  481.     <td valign="top">deletependingchangelist</td>
  482.     <td valign="top">If true, the pending changelist will be deleted.</td>
  483.     <td valign="top">No</td>
  484.     <td valign="top">false</td>
  485.     <td valign="top" align="center">p4 change -d</td>
  486.   </tr>
  487.   <tr>
  488.     <td valign="top">changelist</td>
  489.     <td valign="top">The changelist to be modified or deleted.</td>
  490.     <td valign="top">No</td>
  491.     <td valign="top"></td>
  492.     <td valign="top" align="center"></td>
  493.   </tr>
  494.   <tr>
  495.     <td valign="top">property</td>
  496.     <td valign="top">The property to be set with the changelist
  497.     number.</td>
  498.     <td valign="top">No</td>
  499.     <td valign="top">p4.changelist</td>
  500.     <td valign="top" align="center"></td>
  501.   </tr>
  502. </table>
  503.  
  504. <h3>Examples</h3>
  505. <p>Create a new changelist.</p>
  506. <pre>
  507. &lt;p4jchange/&gt;
  508. </pre>
  509. <p>Delete changelist "29". This succeeds only if changelist "29" is
  510. pending and contains no files.</p>
  511. <pre>
  512. &lt;p4jchange
  513.     deletependingchangelist=&quot;true&quot;
  514.     changelist=&quot;29&quot;
  515. /&gt;
  516. </pre>
  517.  
  518. <h2><a name="p4jchanges">P4JChanges</a></h2>
  519. <h3>Description:</h3>
  520. <p>Display a list of pending and submitted changelists. If files are
  521. specified, it limits its report to changelists that affect those files.
  522. If the file specification includes a revision range, it limits its
  523. report to submitted changelists that affect those particular revisions.</p>
  524.  
  525. <h3>Parameters</h3>
  526. <table border="1" cellpadding="2" cellspacing="0">
  527.   <tr>
  528.     <td valign="top"><b>Attribute</b></td>
  529.     <td valign="top"><b>Description</b></td>
  530.     <td valign="top"><b>Required</b></td>
  531.     <td valign="top"><b>Default</b></td>
  532.     <td align="center" valign="top"><b>P4 Command</b></td>
  533.   </tr>
  534.   <tr>
  535.     <td valign="top">maxmostrecent</td>
  536.     <td valign="top">If positive, restrict the list to the specified
  537.     number of most recent changelists.</td>
  538.     <td valign="top">No</td>
  539.     <td valign="top">0</td>
  540.     <td valign="top" align="center">p4 changes -m max</td>
  541.   </tr>
  542.   <tr>
  543.     <td valign="top">clientname</td>
  544.     <td valign="top">If non-null, restrict the results to changelists
  545.     associated with the given client.</td>
  546.     <td valign="top">No</td>
  547.     <td valign="top">null</td>
  548.     <td valign="top" align="center">p4 changes -c client</td>
  549.   </tr>
  550.   <tr>
  551.     <td valign="top">username</td>
  552.     <td valign="top">If non-null, restrict the results to changelists
  553.     associated with the given user name.</td>
  554.     <td valign="top">No</td>
  555.     <td valign="top">null</td>
  556.     <td valign="top" align="center">p4 changes -u user</td>
  557.   </tr>
  558.   <tr>
  559.     <td valign="top">includeintegrated</td>
  560.     <td valign="top">If true, also include any changelists integrated
  561.     into the specified files (if any).</td>
  562.     <td valign="top">No</td>
  563.     <td valign="top">false</td>
  564.     <td valign="top" align="center">p4 changes -i</td>
  565.   </tr>
  566.   <tr>
  567.     <td valign="top">type</td>
  568.     <td valign="top">If not null, restrict output to pending, shelved
  569.     or submitted changelists.</td>
  570.     <td valign="top">No</td>
  571.     <td valign="top">null</td>
  572.     <td valign="top" align="center">p4 changes -s status</td>
  573.   </tr>
  574.   <tr>
  575.     <td valign="top">longdesc</td>
  576.     <td valign="top">If true, produce a non-truncated long version of
  577.     the description.</td>
  578.     <td valign="top">No</td>
  579.     <td valign="top">false</td>
  580.     <td valign="top" align="center">p4 changes -l</td>
  581.   </tr>
  582.   <tr>
  583.     <td valign="top">property</td>
  584.     <td valign="top">The property to be set with the list of the
  585.     changelist numbers.</td>
  586.     <td valign="top">No</td>
  587.     <td valign="top">p4.changelists</td>
  588.     <td valign="top" align="center"></td>
  589.   </tr>
  590. </table>
  591.  
  592. <h3>Examples</h3>
  593. <p>Show the last five submitted changelists that include any file
  594. under the project directory.</p>
  595. <pre>
  596. &lt;p4jchanges
  597.     maxmostrecent=&quot;5&quot;
  598.     files=&quot;//depot/project/...&quot;
  599. /&gt;
  600. </pre>
  601. <p>Show the last five submitted changelists from client workspace
  602. "eds_elm".</p>
  603. <pre>
  604. &lt;p4jchanges
  605.     maxmostrecent=&quot;5&quot;
  606.     clientname=&quot;eds_elm&quot;
  607. /&gt;
  608. </pre>
  609. <p>Show the last five submitted changelists from user "edk".</p>
  610. <pre>
  611. &lt;p4jchanges
  612.     maxmostrecent=&quot;5&quot;
  613.     username=&quot;edk&quot;
  614. /&gt;
  615. </pre>
  616. <p>Show any changelists that include file file.c, as mapped to the
  617. depot through the client view, during the month of May 2000.</p>
  618. <pre>
  619. &lt;p4jchanges
  620.     files=&quot;file.c@2000/05/01,2000/06/01&quot;
  621. /&gt;
  622. </pre>
  623.  
  624. <h2><a name="p4jcounter">P4JCounter</a></h2>
  625. <h3>Description:</h3>
  626. <p>Display, set, or delete a counter. The first form displays the
  627. value of the named counter. The second form sets the counter to the
  628. given value. The third form deletes the counter. This usually has the
  629. same effect as setting the counter to 0.</p>
  630.  
  631. <h3>Parameters</h3>
  632. <table border="1" cellpadding="2" cellspacing="0">
  633.   <tr>
  634.     <td valign="top"><b>Attribute</b></td>
  635.     <td valign="top"><b>Description</b></td>
  636.     <td valign="top"><b>Required</b></td>
  637.     <td valign="top"><b>Default</b></td>
  638.     <td align="center" valign="top"><b>P4 Command</b></td>
  639.   </tr>
  640.   <tr>
  641.     <td valign="top">name</td>
  642.     <td valign="top">The name of the counter.</td>
  643.     <td valign="top">Yes</td>
  644.     <td valign="top">null</td>
  645.     <td valign="top" align="center"></td>
  646.   </tr>
  647.   <tr>
  648.     <td valign="top">value</td>
  649.     <td valign="top">The new value for the counter.</td>
  650.     <td valign="top">No</td>
  651.     <td valign="top">null</td>
  652.     <td valign="top" align="center"></td>
  653.   </tr>
  654.   <tr>
  655.     <td valign="top">delete</td>
  656.     <td valign="top">If true, the counter will be deleted.</td>
  657.     <td valign="top">No</td>
  658.     <td valign="top">false</td>
  659.     <td valign="top" align="center">p4 counter -d</td>
  660.   </tr>
  661.   <tr>
  662.     <td valign="top">perforcecounter</td>
  663.     <td valign="top">If true, this is a Perforce internal counter.</td>
  664.     <td valign="top">No</td>
  665.     <td valign="top">false</td>
  666.     <td valign="top" align="center"></td>
  667.   </tr>
  668.   <tr>
  669.     <td valign="top">property</td>
  670.     <td valign="top">The property to be set with the value of the
  671.     counter.</td>
  672.     <td valign="top">No</td>
  673.     <td valign="top">p4.counter</td>
  674.     <td valign="top" align="center"></td>
  675.   </tr>
  676. </table>
  677.  
  678. <h3>Examples</h3>
  679. <p>Set the value of a counter named "mycounter" to the value "123".
  680. If the "mycounter" counter does not exist, it is created. Requires
  681. review access.</p>
  682. <pre>
  683. &lt;p4jcounter
  684.     name=&quot;mycounter&quot;
  685.     value=&quot;123&quot;
  686. /&gt;
  687. </pre>
  688. <p>Get the value of the "mycounter" counter and set it to the named
  689. "mycounter" property. If the "mycounter" counter does not exist, its
  690. value is displayed as 0. Requires list access.</p>
  691. <pre>
  692. &lt;p4jcounter
  693.     name=&quot;mycounter&quot;
  694.     property=&quot;p4.mycounter&quot;
  695. /&gt;
  696. </pre>
  697. <p>Delete the "mycounter" counter.</p>
  698. <pre>
  699. &lt;p4jcounter
  700.     delete=&quot;true&quot;
  701.     name=&quot;mycounter&quot;
  702. /&gt;
  703. </pre>
  704.  
  705. <h2><a name="p4jdelete">P4JDelete</a></h2>
  706. <h3>Description:</h3>
  707. <p>Opens files that currently exist in the depot for deletion. If
  708. the files are present on the client they are removed. If a pending
  709. changelist number is given the opened files are associated with that
  710. changelist, otherwise they are associated with the 'default' pending
  711. changelist.</p>
  712.  
  713. <h3>Parameters</h3>
  714. <table border="1" cellpadding="2" cellspacing="0">
  715.   <tr>
  716.     <td valign="top"><b>Attribute</b></td>
  717.     <td valign="top"><b>Description</b></td>
  718.     <td valign="top"><b>Required</b></td>
  719.     <td valign="top"><b>Default</b></td>
  720.     <td align="center" valign="top"><b>P4 Command</b></td>
  721.   </tr>
  722.   <tr>
  723.     <td valign="top">changelist</td>
  724.     <td valign="top">If positive, the deleted files are put into the
  725.     pending changelist identified (this changelist must have been
  726.     previously created for this to succeed). If zero or negative, the file
  727.     is opened in the 'default' (unnumbered) changelist.</td>
  728.     <td valign="top">No</td>
  729.     <td valign="top">0 (default)</td>
  730.     <td valign="top" align="center">p4 delete -c</td>
  731.   </tr>
  732.   <tr>
  733.     <td valign="top">noupdate</td>
  734.     <td valign="top">If true, don't actually do the deletes, just
  735.     return the files that would have been opened for deletion.</td>
  736.     <td valign="top">No</td>
  737.     <td valign="top">false</td>
  738.     <td valign="top" align="center">p4 delete -n</td>
  739.   </tr>
  740.   <tr>
  741.     <td valign="top">deletenonsyncedfiles</td>
  742.     <td valign="top">If true, it allows deleting of files that are
  743.     not synced into the client workspace.</td>
  744.     <td valign="top">No</td>
  745.     <td valign="top">false</td>
  746.     <td valign="top" align="center">p4 delete -v</td>
  747.   </tr>
  748. </table>
  749.  
  750. <h3>Examples</h3>
  751. <p>Opens the file called "README" in the depot's top level directory
  752. for deletion. The corresponding file within the client workspace is
  753. immediately deleted, but the file is not deleted from the depot until
  754. the default changelist is submitted.</p>
  755. <pre>
  756. &lt;p4jdelete
  757.     files=&quot;README&quot;
  758. /&gt;
  759. </pre>
  760. <p>Opens the "myfile" file in the current client workspace for
  761. deletion. The file is immediately removed from the client workspace, but
  762. won't be deleted from the depot until changelist "40" is sent to the
  763. server with the submit command.</p>
  764. <pre>
  765. &lt;p4jdelete
  766.     changelist=&quot;40&quot;
  767.     files=&quot;myfile&quot;
  768. /&gt;
  769. </pre>
  770.  
  771. <h2><a name="p4jdiff2">P4JDiff2</a></h2>
  772. <h3>Description:</h3>
  773. <p>Run diff (on the server) of two files in the depot. Both files
  774. may optionally include a revision specification; the default is to
  775. compare the head revision. Wildcards may be used, but they must match
  776. between file1 and file2. Note if using clients or labels as file
  777. arguments they must be preceded with a file path e.g. //...@mylabel
  778. //...@yourlabel.</p>
  779.  
  780. <h3>Parameters</h3>
  781. <table border="1" cellpadding="2" cellspacing="0">
  782.   <tr>
  783.     <td valign="top"><b>Attribute</b></td>
  784.     <td valign="top"><b>Description</b></td>
  785.     <td valign="top"><b>Required</b></td>
  786.     <td valign="top"><b>Default</b></td>
  787.     <td align="center" valign="top"><b>P4 Command</b></td>
  788.   </tr>
  789.   <tr>
  790.     <td valign="top">file1</td>
  791.     <td valign="top">The first depot file and revision specifier for
  792.     diff2.</td>
  793.     <td valign="top">No</td>
  794.     <td valign="top">null</td>
  795.     <td valign="top" align="center"></td>
  796.   </tr>
  797.   <tr>
  798.     <td valign="top">file2</td>
  799.     <td valign="top">The second depot file and revision specifier for
  800.     diff2.</td>
  801.     <td valign="top">No</td>
  802.     <td valign="top">null</td>
  803.     <td valign="top" align="center"></td>
  804.   </tr>
  805.   <tr>
  806.     <td valign="top">branch</td>
  807.     <td valign="top">If not null, it causes diff2 to use the branch
  808.     view to specify the pairs of files to compare. If file arguments are
  809.     also present, they can further limit the files and specify the
  810.     revisions for comparison. Note that if only one file is given, it
  811.     restricts the right-hand side of the branch view.</td>
  812.     <td valign="top">No</td>
  813.     <td valign="top">null</td>
  814.     <td valign="top" align="center">p4 diff2 -b branch</td>
  815.   </tr>
  816.   <tr>
  817.     <td valign="top">quiet</td>
  818.     <td valign="top">If true, suppresses the display of the header
  819.     lines of files whose content and types are identical and suppresses
  820.     the actual diff for all files.</td>
  821.     <td valign="top">No</td>
  822.     <td valign="top">false</td>
  823.     <td valign="top" align="center">p4 diff2 -q</td>
  824.   </tr>
  825.   <tr>
  826.     <td valign="top">includenontextdiffs</td>
  827.     <td valign="top">If true, diff even files with non-text (binary)
  828.     types.</td>
  829.     <td valign="top">No</td>
  830.     <td valign="top">false</td>
  831.     <td valign="top" align="center">p4 diff2 -t</td>
  832.   </tr>
  833.   <tr>
  834.     <td valign="top">gnudiffs</td>
  835.     <td valign="top">If true, use the GNU diff -u format and displays
  836.     only files that differ. See the "-u" option in the main diff2
  837.     documentation for an explanation.</td>
  838.     <td valign="top">No</td>
  839.     <td valign="top">false</td>
  840.     <td valign="top" align="center">p4 diff2 -u</td>
  841.   </tr>
  842.   <tr>
  843.     <td valign="top">rcsdiffs</td>
  844.     <td valign="top">If true, use RCS diff.</td>
  845.     <td valign="top">No</td>
  846.     <td valign="top">false</td>
  847.     <td valign="top" align="center">p4 diff2 -dn</td>
  848.   </tr>
  849.   <tr>
  850.     <td valign="top">diffcontext</td>
  851.     <td valign="top">If positive, specifies the number of context
  852.     diff lines; if zero, lets server pick context number; if negative, no
  853.     options are generated. Corresponds to -dc[n], with -dc generated for
  854.     diffcontext == 0, -dcn for diffcontext &gt; 0, where "n" is of course
  855.     the value of diffcontext.</td>
  856.     <td valign="top">No</td>
  857.     <td valign="top">-1</td>
  858.     <td valign="top" align="center">p4 diff2 -dc[n]</td>
  859.   </tr>
  860.   <tr>
  861.     <td valign="top">summarydiff</td>
  862.     <td valign="top">If true, perform summary diff.</td>
  863.     <td valign="top">No</td>
  864.     <td valign="top">false</td>
  865.     <td valign="top" align="center">p4 diff2 -ds</td>
  866.   </tr>
  867.   <tr>
  868.     <td valign="top">unifieddiff</td>
  869.     <td valign="top">If positive, specifies the number of unified
  870.     diff lines; if zero, lets server pick unified number; if negative, no
  871.     options are generated. Corresponds to -du[n], with -du generated for
  872.     unifieddiff == 0, -dun for unifieddiff &gt; 0, where "n" is of course
  873.     the value of unifieddiff.</td>
  874.     <td valign="top">No</td>
  875.     <td valign="top">-1</td>
  876.     <td valign="top" align="center">p4 diff2 -du[n]</td>
  877.   </tr>
  878.   <tr>
  879.     <td valign="top">ignorewhitespacechanges</td>
  880.     <td valign="top">If true, ignore whitespace changes.</td>
  881.     <td valign="top">No</td>
  882.     <td valign="top">false</td>
  883.     <td valign="top" align="center">p4 diff2 -db</td>
  884.   </tr>
  885.   <tr>
  886.     <td valign="top">ignorewhitespace</td>
  887.     <td valign="top">If true, ignore whitespace.</td>
  888.     <td valign="top">No</td>
  889.     <td valign="top">false</td>
  890.     <td valign="top" align="center">p4 diff2 -dw</td>
  891.   </tr>
  892.   <tr>
  893.     <td valign="top">ignorelineendings</td>
  894.     <td valign="top">If true, ignore line endings.</td>
  895.     <td valign="top">No</td>
  896.     <td valign="top">false</td>
  897.     <td valign="top" align="center">p4 diff2 -dl</td>
  898.   </tr>
  899. </table>
  900.  
  901. <h3>Examples</h3>
  902. <p>Compare the second revision of file file to its head revision,
  903. and display a summary of what chunks were added to, deleted from, or
  904. changed within the file.</p>
  905. <pre>
  906. &lt;p4jdiff2
  907.     file1=&quot;file#1&quot;
  908.     file2=&quot;file&quot;
  909.     summarydiff=&quot;true&quot;
  910. /&gt;
  911. </pre>
  912. <p>Diff the revision of file that was in the depot after changelist
  913. "34" was submitted against the revision in the depot at midnight on
  914. December 4, 1998.</p>
  915. <pre>
  916. &lt;p4jdiff2
  917.     file1=&quot;file@34&quot;
  918.     file2=&quot;file@1998/12/04&quot;
  919. /&gt;
  920. </pre>
  921. <p>Compare the head revisions of all files under the
  922. "//depot/rel1/..." path to the fourth revision of all files under the
  923. "//depot/rel2/..." path.</p>
  924. <pre>
  925. &lt;p4jdiff2
  926.     file1=&quot;//depot/rel1/...&quot;
  927.     file2=&quot;//depot/rel2/...#4&quot;
  928. /&gt;
  929. </pre>
  930. <p>Not allowed. The wildcards in each file pattern must match.</p>
  931. <pre>
  932. &lt;p4jdiff2
  933.     file1=&quot;/depot/rel1/*&quot;
  934.     file2=&quot;//depot/rel2/...&quot;
  935. /&gt;
  936. </pre>
  937. <p>Compare the second revision of the files under the
  938. "//depot/rel2/..." path to the files branched from it by branch mapping
  939. "branch2" at the revision they were at in changelist "50".</p>
  940. <pre>
  941. &lt;p4jdiff2
  942.     branch=&quot;branch2&quot;
  943.     file1=&quot;//depot/rel2/...#2&quot;
  944.     file2=&quot;@50&quot;
  945. /&gt;
  946. </pre>
  947.  
  948. <h2><a name="p4jedit">P4JEdit</a></h2>
  949. <h3>Description:</h3>
  950. <p>Open existing files for edit. The server notes that the current
  951. user on the current client has the files opened, and then changes the
  952. file permission from read-only to read/write.</p>
  953.  
  954. <h3>Parameters</h3>
  955. <table border="1" cellpadding="2" cellspacing="0">
  956.   <tr>
  957.     <td valign="top"><b>Attribute</b></td>
  958.     <td valign="top"><b>Description</b></td>
  959.     <td valign="top"><b>Required</b></td>
  960.     <td valign="top"><b>Default</b></td>
  961.     <td align="center" valign="top"><b>P4 Command</b></td>
  962.   </tr>
  963.   <tr>
  964.     <td valign="top">noupdate</td>
  965.     <td valign="top">If true, it lists what would be opened for edit
  966.     without actually changing any files or metadata.</td>
  967.     <td valign="top">No</td>
  968.     <td valign="top">false</td>
  969.     <td valign="top" align="center">p4 edit -n</td>
  970.   </tr>
  971.   <tr>
  972.     <td valign="top">bypassclientupdate</td>
  973.     <td valign="top">If true, bypasses the client file update. It can
  974.     be used to tell the server that files in a client workspace are
  975.     already editable, even if they are not present in the client view.
  976.     Typically this flag is used to correct the Perforce server when it is
  977.     wrong about the state of files on the client, use of this option can
  978.     confuse the server if you are wrong about the client's contents.</td>
  979.     <td valign="top">No</td>
  980.     <td valign="top">false</td>
  981.     <td valign="top" align="center">p4 edit -k</td>
  982.   </tr>
  983.   <tr>
  984.     <td valign="top">changelist</td>
  985.     <td valign="top">If given, the file is put into the pending
  986.     changelist; the changelist must have been previously created.
  987.     Otherwise the file is opened in the 'default' (unnumbered) changelist.</td>
  988.     <td valign="top">No</td>
  989.     <td valign="top">0 (default)</td>
  990.     <td valign="top" align="center">p4 edit -c</td>
  991.   </tr>
  992.   <tr>
  993.     <td valign="top">filetype</td>
  994.     <td valign="top">If non-null, the file is opened as that
  995.     filetype. Otherwise, the filetype of the previous revision is reused.
  996.     If the filetype given is a partial filetype, that partial filetype is
  997.     combined with the previous revision's filetype.</td>
  998.     <td valign="top">No</td>
  999.     <td valign="top">null</td>
  1000.     <td valign="top" align="center">p4 edit -t</td>
  1001.   </tr>
  1002. </table>
  1003.  
  1004. <h3>Examples</h3>
  1005. <p>Opens all files ending in ".txt" within the current directory's
  1006. doc subdirectory for edit. These files are linked to the default
  1007. changelist; these files are stored as type text with keyword expansion.</p>
  1008. <pre>
  1009. &lt;p4jedit
  1010.     filetype=&quot;text+k1&quot;
  1011.     files=&quot;doc/*.txt&quot;
  1012. /&gt;
  1013. </pre>
  1014. <p>Implements pessimistic locking (exclusive-open) for all files in
  1015. a depot. After this changelist is submitted, only one user at a time
  1016. will be able to edit files in the depot named depotname.</p>
  1017. <pre>
  1018. &lt;p4jedit
  1019.     filetype=&quot;+l&quot;
  1020.     files=&quot;//depotname/...&quot;
  1021. /&gt;
  1022. </pre>
  1023. <p>Opens all files anywhere within the current working directory's
  1024. file tree for edit. These files are examined to determine whether they
  1025. are text or binary, and changes to these files are linked to changelist
  1026. "14".</p>
  1027. <pre>
  1028. &lt;p4jedit
  1029.     files=&quot;...&quot;
  1030.     changelist=&quot;14&quot;
  1031. /&gt;
  1032. </pre>
  1033. <p>Open a file named "status@jan1.txt" for edit. Please see the
  1034. Perforce command reference documentation for details about how to
  1035. specify other characters reserved for use as Perforce wildcards.</p>
  1036. <pre>
  1037. &lt;p4jedit
  1038.     files=&quot;status%40jan1.txt&quot;
  1039. /&gt;
  1040. </pre>
  1041.  
  1042. <h2><a name="p4jfiles">P4JFiles</a></h2>
  1043. <h3>Description:</h3>
  1044. <p>List files in the depot. List files named or matching wild card
  1045. specification. Display shows depot file name, revision, file type,
  1046. change action and changelist number of the current head revision. If
  1047. client file names are given as arguments the view mapping is used to
  1048. list the corresponding depot files.</p>
  1049. <p>If the file argument has a revision, then all files as of that
  1050. revision are listed. If the file argument has a revision range, then
  1051. only files selected by that revision range are listed, and the highest
  1052. revision in the range is used for each file. Normally, the head revision
  1053. is listed.</p>
  1054.  
  1055. <h3>Parameters</h3>
  1056. <table border="1" cellpadding="2" cellspacing="0">
  1057.   <tr>
  1058.     <td valign="top"><b>Attribute</b></td>
  1059.     <td valign="top"><b>Description</b></td>
  1060.     <td valign="top"><b>Required</b></td>
  1061.     <td valign="top"><b>Default</b></td>
  1062.     <td align="center" valign="top"><b>P4 Command</b></td>
  1063.   </tr>
  1064.   <tr>
  1065.     <td valign="top">allrevs</td>
  1066.     <td valign="top">If true, displays all revisions within the
  1067.     specific range, rather than just the highest revision in the range.</td>
  1068.     <td valign="top">No</td>
  1069.     <td valign="top">false</td>
  1070.     <td valign="top" align="center">p4 files -a</td>
  1071.   </tr>
  1072. </table>
  1073.  
  1074. <h3>Examples</h3>
  1075. <p>Provides information about all files in the depot.</p>
  1076. <pre>
  1077. &lt;p4jfiles
  1078.     files=&quot;//depot/...&quot;
  1079. /&gt;
  1080. </pre>
  1081. <p>Provides information about all depot files visible through the
  1082. client view.</p>
  1083. <pre>
  1084. &lt;p4jfiles
  1085.     files=&quot;//clientname/...&quot;
  1086. /&gt;
  1087. </pre>
  1088. <p>Provides information about all depot file revisions that existed
  1089. on December 10, 2000.</p>
  1090. <pre>
  1091. &lt;p4jfiles
  1092.     files=&quot;@2000/12/10&quot;
  1093. /&gt;
  1094. </pre>
  1095. <p>Lists all files and revisions changed during business hours on
  1096. March 31, 2001.</p>
  1097. <pre>
  1098. &lt;p4jfiles
  1099.     files=&quot;@2001/03/31:08:00,@2001/03/31:17:00&quot;
  1100. /&gt;
  1101. </pre>
  1102. <p>Lists files and revisions under the "//depot/proj2/..." path that
  1103. are included in label "p2lab".</p>
  1104. <pre>
  1105. &lt;p4jfiles
  1106.     files=&quot;//depot/proj2/...@p2lab&quot;
  1107. /&gt;
  1108. </pre>
  1109. <p>Show information on the head revision of the "//depot/file.c"
  1110. file. (that is, the highest revision in the implied range of
  1111. "#1,#head").</p>
  1112. <pre>
  1113. &lt;p4jfiles
  1114.     files=&quot;//depot/file.c&quot;
  1115. /&gt;
  1116. </pre>
  1117. <p>Show information on every revision of the "//depot/file.c" file
  1118. (that is, all revisions in the implied range of "#1,#head").</p>
  1119. <pre>
  1120. &lt;p4jfiles
  1121.     allrevs=&quot;true&quot;
  1122.     files=&quot;//depot/file.c&quot;
  1123. /&gt;
  1124. </pre>
  1125.  
  1126. <h2><a name="p4jfix">P4JFix</a></h2>
  1127. <h3>Description:</h3>
  1128. <p>Mark jobs as being fixed by a changelist number. It marks each
  1129. named job as being fixed by the changelist number given. The changelist
  1130. may be either pending or, submitted and the jobs may still be opened or
  1131. already closed (fixed by another changelist).</p>
  1132. <p>If the changelist has already been submitted and the job is still
  1133. open then 'fix' marks the job closed. If the changelist has not been
  1134. submitted and the job is still open, the job will be marked closed when
  1135. the changelist is submitted. If the job is already closed, it is left
  1136. alone.</p>
  1137.  
  1138. <h3>Parameters</h3>
  1139. <table border="1" cellpadding="2" cellspacing="0">
  1140.   <tr>
  1141.     <td valign="top"><b>Attribute</b></td>
  1142.     <td valign="top"><b>Description</b></td>
  1143.     <td valign="top"><b>Required</b></td>
  1144.     <td valign="top"><b>Default</b></td>
  1145.     <td align="center" valign="top"><b>P4 Command</b></td>
  1146.   </tr>
  1147.   <tr>
  1148.     <td valign="top">jobs</td>
  1149.     <td valign="top">List of job IDs, separated by whitespace, for
  1150.     jobs that will have their status marked as "closed" or specified job
  1151.     status.</td>
  1152.     <td valign="top">Yes</td>
  1153.     <td valign="top">null</td>
  1154.     <td valign="top" align="center"></td>
  1155.   </tr>
  1156.   <tr>
  1157.     <td valign="top">changelist</td>
  1158.     <td valign="top">Changelist number to be used for marking each
  1159.     named job as being fixed. Initialize to default changelist.</td>
  1160.     <td valign="top">Yes</td>
  1161.     <td valign="top">0 (default)</td>
  1162.     <td valign="top" align="center">p4 fix -c</td>
  1163.   </tr>
  1164.   <tr>
  1165.     <td valign="top">status</td>
  1166.     <td valign="top">If not null, use this as the new status rather
  1167.     than "closed".</td>
  1168.     <td valign="top">No</td>
  1169.     <td valign="top">null</td>
  1170.     <td valign="top" align="center">p4 fix -s status</td>
  1171.   </tr>
  1172.   <tr>
  1173.     <td valign="top">delete</td>
  1174.     <td valign="top">If true, delete the specified fixes.</td>
  1175.     <td valign="top">No</td>
  1176.     <td valign="top">false</td>
  1177.     <td valign="top" align="center">p4 fix -d</td>
  1178.   </tr>
  1179. </table>
  1180.  
  1181. <h3>Examples</h3>
  1182. <p>Mark two jobs as being fixed by changelist "201". If changelist
  1183. "201" is still pending, the jobs' status is changed to closed when the
  1184. changelist is submitted.</p>
  1185. <pre>
  1186. &lt;p4jfix
  1187.     changelist=&quot;201&quot;
  1188.     jobs=&quot;job000141 job002034&quot;
  1189. /&gt;
  1190. </pre>
  1191. <p>Mark job "job002433" as suspended, rather than closed, when
  1192. changelist "201" is submitted.</p>
  1193. <pre>
  1194. &lt;p4jfix
  1195.     changelist=&quot;201&quot;
  1196.     status=&quot;suspended&quot;
  1197.     jobs=&quot;job002433&quot;
  1198. /&gt;
  1199. </pre>
  1200.  
  1201. <h2><a name="p4jfstat">P4JFstat</a></h2>
  1202. <h3>Description:</h3>
  1203. <p>Dumps information about each file, with each item of information
  1204. on a separate line.</p>
  1205.  
  1206. <h3>Parameters</h3>
  1207. <table border="1" cellpadding="2" cellspacing="0">
  1208.   <tr>
  1209.     <td valign="top"><b>Attribute</b></td>
  1210.     <td valign="top"><b>Description</b></td>
  1211.     <td valign="top"><b>Required</b></td>
  1212.     <td valign="top"><b>Default</b></td>
  1213.     <td align="center" valign="top"><b>P4 Command</b></td>
  1214.   </tr>
  1215.   <tr>
  1216.     <td valign="top">filterstring</td>
  1217.     <td valign="top">Limits the output to files satisfying the
  1218.     expression given.</td>
  1219.     <td valign="top">No</td>
  1220.     <td valign="top">null</td>
  1221.     <td valign="top" align="center">p4 fstat -F filter</td>
  1222.   </tr>
  1223.   <tr>
  1224.     <td valign="top">maxresults</td>
  1225.     <td valign="top">If greater than 0, limits output to the first
  1226.     'maxresults' number of files.</td>
  1227.     <td valign="top">No</td>
  1228.     <td valign="top">0</td>
  1229.     <td valign="top" align="center">p4 fstat -m</td>
  1230.   </tr>
  1231.   <tr>
  1232.     <td valign="top">reversesort</td>
  1233.     <td valign="top">Sorts the output in reverse order.</td>
  1234.     <td valign="top">No</td>
  1235.     <td valign="top">false</td>
  1236.     <td valign="top" align="center">p4 fstat -r</td>
  1237.   </tr>
  1238.   <tr>
  1239.     <td valign="top">sincechangelist</td>
  1240.     <td valign="top">Instructs fstat to display only files affected
  1241.     since the given changelist number.</td>
  1242.     <td valign="top">No</td>
  1243.     <td valign="top">-1 (unknown)</td>
  1244.     <td valign="top" align="center">p4 fstat -c</td>
  1245.   </tr>
  1246.   <tr>
  1247.     <td valign="top">affectedbychangelist</td>
  1248.     <td valign="top">Instructs fstat to display only files affected
  1249.     by the given changelist number.</td>
  1250.     <td valign="top">No</td>
  1251.     <td valign="top">-1 (unknown)</td>
  1252.     <td valign="top" align="center">p4 fstat -e</td>
  1253.   </tr>
  1254.   <tr>
  1255.     <td valign="top">sortbyfiletype</td>
  1256.     <td valign="top">Sort by filetype.</td>
  1257.     <td valign="top">No</td>
  1258.     <td valign="top">false</td>
  1259.     <td valign="top" align="center">p4 fstat -St</td>
  1260.   </tr>
  1261.   <tr>
  1262.     <td valign="top">sortbydate</td>
  1263.     <td valign="top">Sort by date.</td>
  1264.     <td valign="top">No</td>
  1265.     <td valign="top">false</td>
  1266.     <td valign="top" align="center">p4 fstat -Sd</td>
  1267.   </tr>
  1268.   <tr>
  1269.     <td valign="top">sortbyheadrev</td>
  1270.     <td valign="top">Sort by head revision.</td>
  1271.     <td valign="top">No</td>
  1272.     <td valign="top">false</td>
  1273.     <td valign="top" align="center">p4 fstat -Sr</td>
  1274.   </tr>
  1275.   <tr>
  1276.     <td valign="top">sortbyfilesize</td>
  1277.     <td valign="top">Sort by file size.</td>
  1278.     <td valign="top">No</td>
  1279.     <td valign="top">false</td>
  1280.     <td valign="top" align="center">p4 fstat -Ss</td>
  1281.   </tr>
  1282.   <tr>
  1283.     <td valign="top">mappedfiles</td>
  1284.     <td valign="top">Files mapped through the client view.</td>
  1285.     <td valign="top">No</td>
  1286.     <td valign="top">false</td>
  1287.     <td valign="top" align="center">p4 fstat -Rc</td>
  1288.   </tr>
  1289.   <tr>
  1290.     <td valign="top">syncedfiles</td>
  1291.     <td valign="top">Files synced to the client.</td>
  1292.     <td valign="top">No</td>
  1293.     <td valign="top">false</td>
  1294.     <td valign="top" align="center">p4 fstat -Rh</td>
  1295.   </tr>
  1296.   <tr>
  1297.     <td valign="top">openednotheadrevfiles</td>
  1298.     <td valign="top">Files opened not at the head revision.</td>
  1299.     <td valign="top">No</td>
  1300.     <td valign="top">false</td>
  1301.     <td valign="top" align="center">p4 fstat -Rn</td>
  1302.   </tr>
  1303.   <tr>
  1304.     <td valign="top">openedfiles</td>
  1305.     <td valign="top">Files opened.</td>
  1306.     <td valign="top">No</td>
  1307.     <td valign="top">false</td>
  1308.     <td valign="top" align="center">p4 fstat -Ro</td>
  1309.   </tr>
  1310.   <tr>
  1311.     <td valign="top">openedresolvedfiles</td>
  1312.     <td valign="top">Files opened that have been resolved.</td>
  1313.     <td valign="top">No</td>
  1314.     <td valign="top">false</td>
  1315.     <td valign="top" align="center">p4 fstat -Rr</td>
  1316.   </tr>
  1317.   <tr>
  1318.     <td valign="top">openedneedsresolvingfiles</td>
  1319.     <td valign="top">Files opened that need resolving.</td>
  1320.     <td valign="top">No</td>
  1321.     <td valign="top">false</td>
  1322.     <td valign="top" align="center">p4 fstat -Ru</td>
  1323.   </tr>
  1324.   <tr>
  1325.     <td valign="top">shelvedfiles</td>
  1326.     <td valign="top">Files shelved (requires 'affectedbychangelist').</td>
  1327.     <td valign="top">No</td>
  1328.     <td valign="top">false</td>
  1329.     <td valign="top" align="center">p4 fstat -Rs</td>
  1330.   </tr>
  1331.   <tr>
  1332.     <td valign="top">allrevs</td>
  1333.     <td valign="top">Output all revisions for the given files (this
  1334.     option suppresses other* and resolve* fields).</td>
  1335.     <td valign="top">No</td>
  1336.     <td valign="top">false</td>
  1337.     <td valign="top" align="center">p4 fstat -Of</td>
  1338.   </tr>
  1339.   <tr>
  1340.     <td valign="top">filesizedigest</td>
  1341.     <td valign="top">Output a file size and digest field for each
  1342.     revision (this may be expensive to compute).</td>
  1343.     <td valign="top">No</td>
  1344.     <td valign="top">false</td>
  1345.     <td valign="top" align="center">p4 fstat -Ol</td>
  1346.   </tr>
  1347.   <tr>
  1348.     <td valign="top">bothpathtypes</td>
  1349.     <td valign="top">Output the local file path in both Perforce
  1350.     syntax (//client/) as 'clientFile' and host form as 'path'.</td>
  1351.     <td valign="top">No</td>
  1352.     <td valign="top">false</td>
  1353.     <td valign="top" align="center">p4 fstat -Op</td>
  1354.   </tr>
  1355.   <tr>
  1356.     <td valign="top">pendingintegrationrecs</td>
  1357.     <td valign="top">Output pending integration record information
  1358.     for files opened on the current client.</td>
  1359.     <td valign="top">No</td>
  1360.     <td valign="top">false</td>
  1361.     <td valign="top" align="center">p4 fstat -Or</td>
  1362.   </tr>
  1363.   <tr>
  1364.     <td valign="top">excludelocalpath</td>
  1365.     <td valign="top">Exclude client-related data from output.</td>
  1366.     <td valign="top">No</td>
  1367.     <td valign="top">false</td>
  1368.     <td valign="top" align="center">p4 fstat -Os</td>
  1369.   </tr>
  1370. </table>
  1371.  
  1372. <h3>Examples</h3>
  1373. <p>Displays information on the "file.c" file.</p>
  1374. <pre>
  1375. &lt;p4jfstat
  1376.     files=&quot;file.c&quot;
  1377. /&gt;
  1378. </pre>
  1379. <p>Displays information on all ".c" files affected after the
  1380. checking-in of files under changelist "20".</p>
  1381. <pre>
  1382. &lt;p4jfstat
  1383.     files=&quot;*.c&quot;
  1384.     mappedfiles=&quot;true&quot;
  1385.     sincechangelist=&quot;20&quot;
  1386. /&gt;
  1387. </pre>
  1388. <p>No client workspace information lines (i.e. "clientFile") are
  1389. displayed.</p>
  1390. <pre>
  1391. &lt;p4jfstat
  1392.     files=&quot;*.c&quot;
  1393.     excludelocalpath=&quot;true&quot;
  1394. /&gt;
  1395. </pre>
  1396. <p>No client workspace information lines are displayed, but the file
  1397. size and digest lines are displayed.</p>
  1398. <pre>
  1399. &lt;p4jfstat
  1400.     files=&quot;*.c&quot;
  1401.     excludelocalpath=&quot;true&quot;
  1402.     filesizedigest=&quot;true&quot;
  1403. /&gt;
  1404. </pre>
  1405. <p>Display information on all text files under the
  1406. "//depot/main/..." path that are smaller than 1024 bytes in length.</p>
  1407. <pre>
  1408. &lt;p4jfstat
  1409.     files=&quot;//depot/main/...&quot;
  1410.     filterstring=&quot;fileSize &lt; 1024 &amp; headType=text&quot;
  1411.     filesizedigest=&quot;true&quot;
  1412. /&gt;
  1413. </pre>
  1414.  
  1415. <h2><a name="p4jgrep">P4JGrep</a></h2>
  1416. <h3>Description:</h3>
  1417. <p>Grep searches files for lines matching a given regular
  1418. expression; the expression (or pattern) can contain wildcards. The
  1419. parser used internally is based on V8 regexp and might not be compatible
  1420. with later parsers, however the majority of functionality is available.</p>
  1421. <p>If the file argument has a revision, then all files as of that
  1422. revision are searched. If the file argument has a revision range, then
  1423. only files selected by that revision range are listed, and the highest
  1424. revision in the range is used for each file. Normally, the head revision
  1425. is searched. See 'p4 help revisions' for help specifying revisions.</p>
  1426.  
  1427. <h3>Parameters</h3>
  1428. <table border="1" cellpadding="2" cellspacing="0">
  1429.   <tr>
  1430.     <td valign="top"><b>Attribute</b></td>
  1431.     <td valign="top"><b>Description</b></td>
  1432.     <td valign="top"><b>Required</b></td>
  1433.     <td valign="top"><b>Default</b></td>
  1434.     <td align="center" valign="top"><b>P4 Command</b></td>
  1435.   </tr>
  1436.   <tr>
  1437.     <td valign="top">pattern</td>
  1438.     <td valign="top">The patterns used are regular expressions
  1439.     comparable to those used in UNIX.</td>
  1440.     <td valign="top">Yes</td>
  1441.     <td valign="top">null</td>
  1442.     <td valign="top" align="center">p4 grep -e pattern</td>
  1443.   </tr>
  1444.   <tr>
  1445.     <td valign="top">allrevisions</td>
  1446.     <td valign="top">Search all revisions within the specified range,
  1447.     rather than only the highest revision in the range.</td>
  1448.     <td valign="top">No</td>
  1449.     <td valign="top">false</td>
  1450.     <td valign="top" align="center">p4 grep -a</td>
  1451.   </tr>
  1452.   <tr>
  1453.     <td valign="top">caseinsensitive</td>
  1454.     <td valign="top">Perform case-insensitive pattern matching. (By
  1455.     default, matching is case-sensitive.).</td>
  1456.     <td valign="top">No</td>
  1457.     <td valign="top">false</td>
  1458.     <td valign="top" align="center">p4 grep -i</td>
  1459.   </tr>
  1460.   <tr>
  1461.     <td valign="top">includelinenumbers</td>
  1462.     <td valign="top">Display a matching line number after the file
  1463.     revision number.</td>
  1464.     <td valign="top">No</td>
  1465.     <td valign="top">false</td>
  1466.     <td valign="top" align="center">p4 grep -n</td>
  1467.   </tr>
  1468.   <tr>
  1469.     <td valign="top">nonmatchinglines</td>
  1470.     <td valign="top">Display files with non-matching lines.</td>
  1471.     <td valign="top">No</td>
  1472.     <td valign="top">false</td>
  1473.     <td valign="top" align="center">p4 grep -v</td>
  1474.   </tr>
  1475.   <tr>
  1476.     <td valign="top">searchbinaries</td>
  1477.     <td valign="top">Treat binary files as text. (By default, only
  1478.     files of type text are selected for pattern matching.).</td>
  1479.     <td valign="top">No</td>
  1480.     <td valign="top">false</td>
  1481.     <td valign="top" align="center">p4 grep -t</td>
  1482.   </tr>
  1483.   <tr>
  1484.     <td valign="top">outputcontext</td>
  1485.     <td valign="top">Display num lines of output context. If zero,
  1486.     option is off.</td>
  1487.     <td valign="top">No</td>
  1488.     <td valign="top">0</td>
  1489.     <td valign="top" align="center">p4 grep -C num</td>
  1490.   </tr>
  1491.   <tr>
  1492.     <td valign="top">trailingcontext</td>
  1493.     <td valign="top">Display num lines of trailing context after
  1494.     matching lines. If zero, option is off.</td>
  1495.     <td valign="top">No</td>
  1496.     <td valign="top">0</td>
  1497.     <td valign="top" align="center">p4 grep -A num</td>
  1498.   </tr>
  1499.   <tr>
  1500.     <td valign="top">leadingcontext</td>
  1501.     <td valign="top">Display num lines of trailing context before
  1502.     matching lines. If zero, option is off.</td>
  1503.     <td valign="top">No</td>
  1504.     <td valign="top">0</td>
  1505.     <td valign="top" align="center">p4 grep -B num</td>
  1506.   </tr>
  1507.   <tr>
  1508.     <td valign="top">fixedpattern</td>
  1509.     <td valign="top">If true, interpret the pattern as a fixed
  1510.     string. If false, interpret the pattern as a regular expression. If
  1511.     true, corresponds to -F; if false, to -G.</td>
  1512.     <td valign="top">No</td>
  1513.     <td valign="top">false</td>
  1514.     <td valign="top" align="center">p4 grep -F or -G</td>
  1515.   </tr>
  1516. </table>
  1517.  
  1518. <h3>Examples</h3>
  1519. <p>Searches for files under the "//depot/java-project/..." path
  1520. matching pattern "*Complex*Entity.java".</p>
  1521. <pre>
  1522. &lt;p4jgrep
  1523.     files=&quot;//depot/java-project/...&quot;
  1524.     pattern=&quot;*Complex*Entity.java&quot;
  1525. /&gt;
  1526. </pre>
  1527. <p>Searches for all files case-insensitive pattern matching
  1528. "*baseball*.*".</p>
  1529. <pre>
  1530. &lt;p4jgrep
  1531.     files=&quot;//...&quot;
  1532.     caseinsensitive=&quot;true&quot;
  1533.     pattern=&quot;*baseball*.*&quot;
  1534. /&gt;
  1535. </pre>
  1536. <p>Searches for all files match a single character that is a letter,
  1537. number, or underscore. Interpret the pattern as a regular expression.</p>
  1538. <pre>
  1539. &lt;p4jgrep
  1540.     files=&quot;//...&quot;
  1541.     fixedpattern=&quot;false&quot;
  1542.     pattern=&quot;[A-Za-z0-9_]&quot;
  1543. /&gt;
  1544. </pre>
  1545.  
  1546. <h2><a name="p4jhave">P4JHave</a></h2>
  1547. <h3>Description:</h3>
  1548. <p>List files and revisions that have been synced to the client
  1549. workspace. List revisions of named files that were last synced from the
  1550. depot. If no file name is given list all files synced on this client.</p>
  1551.  
  1552. <h3>Parameters</h3>
  1553. <table border="1" cellpadding="2" cellspacing="0">
  1554.   <tr>
  1555.     <td valign="top"><b>Attribute</b></td>
  1556.     <td valign="top"><b>Description</b></td>
  1557.     <td valign="top"><b>Required</b></td>
  1558.     <td valign="top"><b>Default</b></td>
  1559.     <td align="center" valign="top"><b>P4 Command</b></td>
  1560.   </tr>
  1561. </table>
  1562.  
  1563. <h3>Examples</h3>
  1564. <p>Shows that the highest revision of the file has been copied to
  1565. the client workspace.</p>
  1566. <pre>
  1567. &lt;p4jhave
  1568.     files=&quot;//depot/name&quot;
  1569. /&gt;
  1570. </pre>
  1571. <p>Shows that the fourth revision is the revision currently in the
  1572. client workspace.</p>
  1573. <pre>
  1574. &lt;p4jhave
  1575.     files=&quot;//depot/name/...#4&quot;
  1576. /&gt;
  1577. </pre>
  1578.  
  1579. <h2><a name="p4jintegrate">P4JIntegrate</a></h2>
  1580. <h3>Description:</h3>
  1581. <p>Open files for branching or merging. 'integrate' stages change
  1582. propagation from source files to target files, opening the target files
  1583. in the client workspace. 'resolve' then merges content from the source
  1584. files into the opened target files, and 'submit' commits the opened
  1585. files to the depot. Integrations can be abandoned with 'revert'.</p>
  1586.  
  1587. <h3>Parameters</h3>
  1588. <table border="1" cellpadding="2" cellspacing="0">
  1589.   <tr>
  1590.     <td valign="top"><b>Attribute</b></td>
  1591.     <td valign="top"><b>Description</b></td>
  1592.     <td valign="top"><b>Required</b></td>
  1593.     <td valign="top"><b>Default</b></td>
  1594.     <td align="center" valign="top"><b>P4 Command</b></td>
  1595.   </tr>
  1596.   <tr>
  1597.     <td valign="top">fromfile</td>
  1598.     <td valign="top">Source file and revision specifiers separated by
  1599.     space. If the path contains whitespace, it must be double-quoted.</td>
  1600.     <td valign="top">Yes</td>
  1601.     <td valign="top">null</td>
  1602.     <td valign="top" align="center"></td>
  1603.   </tr>
  1604.   <tr>
  1605.     <td valign="top">tofile</td>
  1606.     <td valign="top">Target file and revision specifiers separated by
  1607.     space. If the path contains whitespace, it must be double-quoted.</td>
  1608.     <td valign="top">Yes</td>
  1609.     <td valign="top">null</td>
  1610.     <td valign="top" align="center"></td>
  1611.   </tr>
  1612.   <tr>
  1613.     <td valign="top">changelist</td>
  1614.     <td valign="top">If positive, the integrated files are opened in
  1615.     the numbered pending changelist instead of the default changelist.</td>
  1616.     <td valign="top">No</td>
  1617.     <td valign="top">0 (default)</td>
  1618.     <td valign="top" align="center">p4 integrate -c</td>
  1619.   </tr>
  1620.   <tr>
  1621.     <td valign="top">bidirectionalinteg</td>
  1622.     <td valign="top">Causes the branch view to work bidirectionally,
  1623.     where the scope of the command is limited to integrations whose 'from'
  1624.     files match fromfile[revRange]. With the fromfile arg being specified
  1625.     in the main method fromfile parameter.</td>
  1626.     <td valign="top">No</td>
  1627.     <td valign="top">false</td>
  1628.     <td valign="top" align="center">p4 integrate -b branch -s</td>
  1629.   </tr>
  1630.   <tr>
  1631.     <td valign="top">integratearounddeletedrevs</td>
  1632.     <td valign="top">If true, enable integrations around deleted
  1633.     revisions.</td>
  1634.     <td valign="top">No</td>
  1635.     <td valign="top">false</td>
  1636.     <td valign="top" align="center">p4 integrate -d</td>
  1637.   </tr>
  1638.   <tr>
  1639.     <td valign="top">rebranchsourceafterdelete</td>
  1640.     <td valign="top">If the target file has been deleted and the
  1641.     source file has changed, will re-branch the source file on top of the
  1642.     target file.</td>
  1643.     <td valign="top">No</td>
  1644.     <td valign="top">null</td>
  1645.     <td valign="top" align="center">p4 integrate -d -Dt</td>
  1646.   </tr>
  1647.   <tr>
  1648.     <td valign="top">deletetargetafterdelete</td>
  1649.     <td valign="top">If the source file has been deleted and the
  1650.     target file has changed, will delete the target file.</td>
  1651.     <td valign="top">No</td>
  1652.     <td valign="top">false</td>
  1653.     <td valign="top" align="center">p4 integrate -d -Ds</td>
  1654.   </tr>
  1655.   <tr>
  1656.     <td valign="top">integrateallafterreadd</td>
  1657.     <td valign="top">If the source file has been deleted and
  1658.     re-added, will attempt to integrate all outstanding revisions of the
  1659.     file, including those revisions prior to the delete. Normally
  1660.     'integrate' only considers revisions since the last add.</td>
  1661.     <td valign="top">No</td>
  1662.     <td valign="top">false</td>
  1663.     <td valign="top" align="center">p4 integrate -d -Di</td>
  1664.   </tr>
  1665.   <tr>
  1666.     <td valign="top">forceintegration</td>
  1667.     <td valign="top">Forces integrate to act without regard for
  1668.     previous integration history.</td>
  1669.     <td valign="top">No</td>
  1670.     <td valign="top">false</td>
  1671.     <td valign="top" align="center">p4 integrate -f</td>
  1672.   </tr>
  1673.   <tr>
  1674.     <td valign="top">usehaverev</td>
  1675.     <td valign="top">Causes the target files to be left at the
  1676.     revision currently on the client (the '#have' revision).</td>
  1677.     <td valign="top">No</td>
  1678.     <td valign="top">false</td>
  1679.     <td valign="top" align="center">p4 integrate -h</td>
  1680.   </tr>
  1681.   <tr>
  1682.     <td valign="top">dobaselessmerge</td>
  1683.     <td valign="top">Enables integration between files that have no
  1684.     integration history.</td>
  1685.     <td valign="top">No</td>
  1686.     <td valign="top">false</td>
  1687.     <td valign="top" align="center">p4 integrate -i</td>
  1688.   </tr>
  1689.   <tr>
  1690.     <td valign="top">displaybasedetails</td>
  1691.     <td valign="top">Display the base file name and revision which
  1692.     will be used in subsequent resolves if a resolve is needed.</td>
  1693.     <td valign="top">No</td>
  1694.     <td valign="top">false</td>
  1695.     <td valign="top" align="center">p4 integrate -o</td>
  1696.   </tr>
  1697.   <tr>
  1698.     <td valign="top">showactionsonly</td>
  1699.     <td valign="top">Display what integrations would be necessary but
  1700.     don't actually do them.</td>
  1701.     <td valign="top">No</td>
  1702.     <td valign="top">false</td>
  1703.     <td valign="top" align="center">p4 integrate -n</td>
  1704.   </tr>
  1705.   <tr>
  1706.     <td valign="top">reversemapping</td>
  1707.     <td valign="top">Reverse the mappings in the branch view, with
  1708.     the target files and source files exchanging place.</td>
  1709.     <td valign="top">No</td>
  1710.     <td valign="top">false</td>
  1711.     <td valign="top" align="center">p4 integrate -r</td>
  1712.   </tr>
  1713.   <tr>
  1714.     <td valign="top">propagatetype</td>
  1715.     <td valign="top">Propagate the source file's filetype to the
  1716.     target file.</td>
  1717.     <td valign="top">No</td>
  1718.     <td valign="top">false</td>
  1719.     <td valign="top" align="center">p4 integrate -t</td>
  1720.   </tr>
  1721.   <tr>
  1722.     <td valign="top">dontcopytoclient</td>
  1723.     <td valign="top">Don't copy newly branched files to the client.</td>
  1724.     <td valign="top">No</td>
  1725.     <td valign="top">false</td>
  1726.     <td valign="top" align="center">p4 integrate -v</td>
  1727.   </tr>
  1728.   <tr>
  1729.     <td valign="top">branch</td>
  1730.     <td valign="top">If not null, use this as the integration branch
  1731.     specification.</td>
  1732.     <td valign="top">No</td>
  1733.     <td valign="top">false</td>
  1734.     <td valign="top" align="center">p4 integrate -b branch</td>
  1735.   </tr>
  1736.   <tr>
  1737.     <td valign="top">maxfiles</td>
  1738.     <td valign="top">If positive, integrate only the first maxfiles
  1739.     files.</td>
  1740.     <td valign="top">No</td>
  1741.     <td valign="top">0</td>
  1742.     <td valign="top" align="center"></td>
  1743.   </tr>
  1744. </table>
  1745.  
  1746. <h3>Examples</h3>
  1747. <p>Branch or merge all files under the "//depot/dev/..." path to the
  1748. corresponding files under the "//depot/rel2/..." path. If there is no
  1749. corresponding file under the "//depot/rel2/..." path, this creates it.</p>
  1750. <pre>
  1751. &lt;p4jintegrate
  1752.     fromfile=&quot;//depot/dev/...&quot;
  1753.     tofile=&quot;//depot/rel2/...&quot;
  1754. /&gt;
  1755. </pre>
  1756. <p>Branch or merge all fromfiles contained in the branch view
  1757. "rel2br" into the corresponding tofiles as mapped through the branch
  1758. view.</p>
  1759. <pre>
  1760. &lt;p4jintegrate
  1761.     branch=&quot;rel2br&quot;
  1762. /&gt;
  1763. </pre>
  1764. <p>Branch or merge those fromfiles contained in the branch view
  1765. "rel2br" that map to the tofiles "//depot/rel2/headers/...".</p>
  1766. <pre>
  1767. &lt;p4jintegrate
  1768.     branch=&quot;rel2br&quot;
  1769.     tofile=&quot;//depot/rel2/headers/...&quot;
  1770. /&gt;
  1771. </pre>
  1772. <p>Branch or merge fromfile "//depot/rel2/README" from its tofile as
  1773. mapped through the branch view "rel2br".</p>
  1774. <pre>
  1775. &lt;p4jintegrate
  1776.     reversemapping=&quot;true&quot;
  1777.     branch=&quot;rel2br&quot;
  1778.     tofile=&quot;//depot/rel2/README&quot;
  1779. /&gt;
  1780. </pre>
  1781.  
  1782. <h2><a name="p4jjob">P4JJob</a></h2>
  1783. <h3>Description:</h3>
  1784. <p>Create or edit a job specification. A job is a defect,
  1785. enhancement, or other unit of intended work. When a new job is saved a
  1786. job name of the form jobNNNNNN is created. If a jobName is given that
  1787. named job will be created, or if the job already exists, it will be
  1788. modified.</p>
  1789. <p><b>Note:</b> The fields from the "field" nested elements will
  1790. override the values set on attributes, such as 'status', 'description',
  1791. etc.</p>
  1792. <h3>Parameters</h3>
  1793. <table border="1" cellpadding="2" cellspacing="0">
  1794.   <tr>
  1795.     <td valign="top"><b>Attribute</b></td>
  1796.     <td valign="top"><b>Description</b></td>
  1797.     <td valign="top"><b>Required</b></td>
  1798.     <td valign="top"><b>Default</b></td>
  1799.     <td align="center" valign="top"><b>P4 Command</b></td>
  1800.   </tr>
  1801.   <tr>
  1802.     <td valign="top">delete</td>
  1803.     <td valign="top">If true, the job will be deleted.</td>
  1804.     <td valign="top">No</td>
  1805.     <td valign="top">false</td>
  1806.     <td valign="top" align="center">p4 job -d</td>
  1807.   </tr>
  1808.   <tr>
  1809.     <td valign="top">name</td>
  1810.     <td valign="top">The job name of the form jobNNNNNN. 'new'
  1811.     generates a sequenced job number.</td>
  1812.     <td valign="top">No</td>
  1813.     <td valign="top">null</td>
  1814.     <td valign="top" align="center"></td>
  1815.   </tr>
  1816.   <tr>
  1817.     <td valign="top">status</td>
  1818.     <td valign="top">The job status. Either 'open', 'closed', or
  1819.     'suspended'. Can be changed.</td>
  1820.     <td valign="top">No</td>
  1821.     <td valign="top">null</td>
  1822.     <td valign="top" align="center"></td>
  1823.   </tr>
  1824.   <tr>
  1825.     <td valign="top">creator</td>
  1826.     <td valign="top">The user who created the job. Can be changed.</td>
  1827.     <td valign="top">No</td>
  1828.     <td valign="top">null</td>
  1829.     <td valign="top" align="center"></td>
  1830.   </tr>
  1831.   <tr>
  1832.     <td valign="top">description</td>
  1833.     <td valign="top">Comments about the job. Required for creating a
  1834.     job.</td>
  1835.     <td valign="top">No</td>
  1836.     <td valign="top">null</td>
  1837.     <td valign="top" align="center"></td>
  1838.   </tr>
  1839.   <tr>
  1840.     <td valign="top">property</td>
  1841.     <td valign="top">The property to be set with the job ID.</td>
  1842.     <td valign="top">No</td>
  1843.     <td valign="top">null</td>
  1844.     <td valign="top" align="center"></td>
  1845.   </tr>
  1846. </table>
  1847.  
  1848. <h3>Examples</h3>
  1849. <p>Create a new job with description "New Java bug" and status
  1850. "suspended". Note, the description will be overridden by the nested
  1851. element "field" name-value pairs. Therefore, the final description will
  1852. be "Override New Java bug description". The new job ID will be set to
  1853. the "p4.job" property.</p>
  1854. <pre>
  1855. &lt;p4jjob
  1856.     name=&quot;new&quot;
  1857.     description=&quot;New Java bug.&quot;&gt;
  1858.     &lt;field name="Status" value="suspended"/&gt;
  1859.     &lt;field name="Description" value="Override New Java bug description."/&gt;
  1860. &lt;/p4jjob&gt;
  1861. </pre>
  1862. <p>Change the status of a job to "close".</p>
  1863. <pre>
  1864. &lt;p4jjob
  1865.     name=&quot;job123&quot;
  1866.     status=&quot;closed&quot;
  1867. /&gt;
  1868. </pre>
  1869. <p>Delete a job.</p>
  1870. <pre>
  1871. &lt;p4jjob
  1872.     name=&quot;job123&quot;
  1873.     delete=&quot;true&quot;
  1874. /&gt;
  1875. </pre>
  1876.  
  1877. <h2><a name="p4jjobs">P4JJobs</a></h2>
  1878. <h3>Description:</h3>
  1879. <p>Reports the list of all jobs currently known to the system. If a
  1880. file (pattern) is given, only fixes for submitted changelists affecting
  1881. that file (or set of files) are listed. The file pattern may include
  1882. wildcards and/or a revision number range. See 'p4 help revisions' for
  1883. help specifying revisions.</p>
  1884.  
  1885. <h3>Parameters</h3>
  1886. <table border="1" cellpadding="2" cellspacing="0">
  1887.   <tr>
  1888.     <td valign="top"><b>Attribute</b></td>
  1889.     <td valign="top"><b>Description</b></td>
  1890.     <td valign="top"><b>Required</b></td>
  1891.     <td valign="top"><b>Default</b></td>
  1892.     <td align="center" valign="top"><b>P4 Command</b></td>
  1893.   </tr>
  1894.   <tr>
  1895.     <td valign="top">maxjobs</td>
  1896.     <td valign="top">If greater than zero, limit the output to the
  1897.     first maxjobs jobs.</td>
  1898.     <td valign="top">No</td>
  1899.     <td valign="top">0</td>
  1900.     <td valign="top" align="center">p4 jobs -m</td>
  1901.   </tr>
  1902.   <tr>
  1903.     <td valign="top">longdescriptions</td>
  1904.     <td valign="top">If true, return full descriptions, otherwise
  1905.     show only a subset (typically the first 128 characters, but this is
  1906.     not guaranteed).</td>
  1907.     <td valign="top">No</td>
  1908.     <td valign="top">false</td>
  1909.     <td valign="top" align="center">p4 jobs -l</td>
  1910.   </tr>
  1911.   <tr>
  1912.     <td valign="top">reverseorder</td>
  1913.     <td valign="top">If true, reverse the normal sort order.</td>
  1914.     <td valign="top">No</td>
  1915.     <td valign="top">false</td>
  1916.     <td valign="top" align="center">p4 jobs -r</td>
  1917.   </tr>
  1918.   <tr>
  1919.     <td valign="top">includeintegrated</td>
  1920.     <td valign="top">If true, include any fixes made by changelists
  1921.     integrated into the specified files.</td>
  1922.     <td valign="top">No</td>
  1923.     <td valign="top">false</td>
  1924.     <td valign="top" align="center">p4 jobs -i</td>
  1925.   </tr>
  1926.   <tr>
  1927.     <td valign="top">jobview</td>
  1928.     <td valign="top">If not null, this should be a string in format
  1929.     detailed by "p4 help jobview" used to restrict jobs to those
  1930.     satisfying the job view expression.</td>
  1931.     <td valign="top">No</td>
  1932.     <td valign="top">null</td>
  1933.     <td valign="top" align="center">p4 jobs -e</td>
  1934.   </tr>
  1935. </table>
  1936.  
  1937. <h3>Examples</h3>
  1938. <p>List all jobs attached to changelists that include revisions of
  1939. the "//depot/proj/file1.java" file.</p>
  1940. <pre>
  1941. &lt;p4jjobs
  1942.     files=&quot;//depot/proj/file1.java#1&quot;
  1943. /&gt;
  1944. </pre>
  1945. <p>List all jobs attached to changelists that include revisions of
  1946. the "//depot/proj/file1.java" file or revisions of files that were
  1947. integrated into the "//depot/proj/file1.java" file.</p>
  1948. <pre>
  1949. &lt;p4jjobs
  1950.     includeintegrated=&quot;true&quot;
  1951.     files=&quot;//depot/proj/file1.java&quot;
  1952. /&gt;
  1953. </pre>
  1954. <p>List all jobs that contain the word gui in any field.</p>
  1955. <pre>
  1956. &lt;p4jjobs
  1957.     jobview=&quot;gui&quot;
  1958. /&gt;
  1959. </pre>
  1960. <p>List all jobs that contain the word gui in any field and the word
  1961. joe in the "Submitted-By:" field.</p>
  1962. <pre>
  1963. &lt;p4jjobs
  1964.     jobview=&quot;gui Submitted-By=joe&quot;
  1965. /&gt;
  1966. </pre>
  1967. <p>List all jobs that have the word fast or quick in any field, and
  1968. that are linked to changelists that affected files under the
  1969. "//depot/proj/..." path.</p>
  1970. <pre>
  1971. &lt;p4jjobs
  1972.     jobview=&quot;fast|quick&quot;
  1973.     files=&quot;//depot/proj/...&quot;
  1974. /&gt;
  1975. </pre>
  1976.  
  1977. <h2><a name="p4jlabel">P4JLabel</a></h2>
  1978. <h3>Description:</h3>
  1979. <p>Create a new label specification or edit an existing label
  1980. specification. A name is required.</p>
  1981. <p>A label is a shorthand for referring to a collection of
  1982. revisions. See 'p4 help revisions' for information on using labels. A
  1983. label is either automatic or static.</p>
  1984. <p>An automatic label refers to the revisions given in the "View:"
  1985. and "Revision:" fields.</p>
  1986. <p>A static label refers to the revisions associated with the label
  1987. by the 'tag' or 'labelsync' commands. A static label cannot have a
  1988. Revision: field.</p>
  1989.  
  1990. <h3>Parameters</h3>
  1991. <table border="1" cellpadding="2" cellspacing="0">
  1992.   <tr>
  1993.     <td valign="top"><b>Attribute</b></td>
  1994.     <td valign="top"><b>Description</b></td>
  1995.     <td valign="top"><b>Required</b></td>
  1996.     <td valign="top"><b>Default</b></td>
  1997.     <td align="center" valign="top"><b>P4 Command</b></td>
  1998.   </tr>
  1999.   <tr>
  2000.     <td valign="top">name</td>
  2001.     <td valign="top">The name of label.</td>
  2002.     <td valign="top">Yes</td>
  2003.     <td valign="top">null</td>
  2004.     <td valign="top" align="center"></td>
  2005.   </tr>
  2006.   <tr>
  2007.     <td valign="top">description</td>
  2008.     <td valign="top">Description of the label.</td>
  2009.     <td valign="top">No</td>
  2010.     <td valign="top">null</td>
  2011.     <td valign="top" align="center"></td>
  2012.   </tr>
  2013.   <tr>
  2014.     <td valign="top">revision</td>
  2015.     <td valign="top">Revision specification for the label.</td>
  2016.     <td valign="top">No</td>
  2017.     <td valign="top">null</td>
  2018.     <td valign="top" align="center"></td>
  2019.   </tr>
  2020.   <tr>
  2021.     <td valign="top">locked</td>
  2022.     <td valign="top">Lock the label.</td>
  2023.     <td valign="top">No</td>
  2024.     <td valign="top">false</td>
  2025.     <td valign="top" align="center"></td>
  2026.   </tr>
  2027.   <tr>
  2028.     <td valign="top">delete</td>
  2029.     <td valign="top">Delete the label.</td>
  2030.     <td valign="top">No</td>
  2031.     <td valign="top">false</td>
  2032.     <td valign="top" align="center">p4 label -d</td>
  2033.   </tr>
  2034.   <tr>
  2035.     <td valign="top">force</td>
  2036.     <td valign="top">Force the update or deletion of a label.</td>
  2037.     <td valign="top">No</td>
  2038.     <td valign="top">false</td>
  2039.     <td valign="top" align="center">p4 label -f</td>
  2040.   </tr>
  2041. </table>
  2042.  
  2043. <h3>Examples</h3>
  2044. <p>Create a new label "proj1label".</p>
  2045. <pre>
  2046. &lt;p4jlabel
  2047.     name=&quot;proj1label&quot;
  2048. /&gt;
  2049. </pre>
  2050. <p>Create a new label "proj1label" and set it to "locked".</p>
  2051. <pre>
  2052. &lt;p4jlabel
  2053.     name=&quot;proj1label&quot;
  2054.     locked=&quot;true&quot;
  2055. /&gt;
  2056. </pre>
  2057.  
  2058. <h2><a name="p4jlabelsync">P4JLabelsync</a></h2>
  2059. <h3>Description:</h3>
  2060. <p>Synchronize a label with the current client contents. Labelsync
  2061. causes the named label to reflect the current contents of the client. It
  2062. records the last revision of each file taken onto the client. The
  2063. label's name can subsequently be used in a revision specification as
  2064. @label to refer to the revision of a file as stored in the label.</p>
  2065. <p>Without a file argument, labelsync causes the label to reflect
  2066. the contents of the whole client, by adding, deleting, and updating the
  2067. label. If a file is given, labelsync updates only that named file.</p>
  2068. <p>If the file argument includes a revision specification, then that
  2069. revision is used instead of the revision taken by the client. If the
  2070. revision specified is a deleted revision, then the label will include
  2071. that deleted revision. See 'p4 help revisions' for help specifying
  2072. revisions.</p>
  2073. <p>If the file argument includes a revision range specification,
  2074. then only files selected by the revision range are updated, and the
  2075. highest revision in the range is used.</p>
  2076.  
  2077. <h3>Parameters</h3>
  2078. <table border="1" cellpadding="2" cellspacing="0">
  2079.   <tr>
  2080.     <td valign="top"><b>Attribute</b></td>
  2081.     <td valign="top"><b>Description</b></td>
  2082.     <td valign="top"><b>Required</b></td>
  2083.     <td valign="top"><b>Default</b></td>
  2084.     <td align="center" valign="top"><b>P4 Command</b></td>
  2085.   </tr>
  2086.   <tr>
  2087.     <td valign="top">name</td>
  2088.     <td valign="top">The name of label.</td>
  2089.     <td valign="top">Yes</td>
  2090.     <td valign="top">null</td>
  2091.     <td valign="top" align="center">p4 labelsync -l label</td>
  2092.   </tr>
  2093.   <tr>
  2094.     <td valign="top">noupdate</td>
  2095.     <td valign="top">If true, lists how the label would be affected,
  2096.     but doesn't actually update the label.</td>
  2097.     <td valign="top">No</td>
  2098.     <td valign="top">false</td>
  2099.     <td valign="top" align="center">p4 labelsync -n</td>
  2100.   </tr>
  2101.   <tr>
  2102.     <td valign="top">addfiles</td>
  2103.     <td valign="top">If true, it causes labelsync to add the named
  2104.     file to the label; no files will be deleted from the label.</td>
  2105.     <td valign="top">No</td>
  2106.     <td valign="top">false</td>
  2107.     <td valign="top" align="center">p4 labelsync -a</td>
  2108.   </tr>
  2109.   <tr>
  2110.     <td valign="top">deletefiles</td>
  2111.     <td valign="top">If true, it deletes the named file from the
  2112.     label, regardless of revision.</td>
  2113.     <td valign="top">No</td>
  2114.     <td valign="top">false</td>
  2115.     <td valign="top" align="center">p4 labelsync -d</td>
  2116.   </tr>
  2117. </table>
  2118.  
  2119. <h3>Examples</h3>
  2120. <p>Sync the label "proj1label" with the client files under the
  2121. "//depot/proj1/..." path.</p>
  2122. <pre>
  2123. &lt;p4jlabelsync
  2124.     name=&quot;proj1label&quot;
  2125.     files=&quot;//depot/proj1/...&quot;
  2126. /&gt;
  2127. </pre>
  2128. <p>Sync the label "proj1label" with all of the client files.</p>
  2129. <pre>
  2130. &lt;p4jlabelsync
  2131.     name=&quot;proj1label&quot;
  2132. /&gt;
  2133. </pre>
  2134.  
  2135. <h2><a name="p4jlock">P4JLock</a></h2>
  2136. <h3>Description:</h3>
  2137. <p>Lock opened files against changelist submission.</p>
  2138. <p>The open files named are locked in the depot, preventing any user
  2139. other than the current user on the current client from submitting
  2140. changes to the files. If a file is already locked then the lock request
  2141. is rejected. If no file names are given then lock all files currently
  2142. open in the changelist number given or in the 'default' changelist if no
  2143. changelist number is given.</p>
  2144.  
  2145. <h3>Parameters</h3>
  2146. <table border="1" cellpadding="2" cellspacing="0">
  2147.   <tr>
  2148.     <td valign="top"><b>Attribute</b></td>
  2149.     <td valign="top"><b>Description</b></td>
  2150.     <td valign="top"><b>Required</b></td>
  2151.     <td valign="top"><b>Default</b></td>
  2152.     <td align="center" valign="top"><b>P4 Command</b></td>
  2153.   </tr>
  2154.   <tr>
  2155.     <td valign="top">changelist</td>
  2156.     <td valign="top">If positive, use the changelist given instead of
  2157.     the default changelist.</td>
  2158.     <td valign="top">No</td>
  2159.     <td valign="top">0 (default)</td>
  2160.     <td valign="top" align="center">p4 lock -c</td>
  2161.   </tr>
  2162. </table>
  2163.  
  2164. <h3>Examples</h3>
  2165. <p>Lock the file "//depot/projA/fast1.c" in the depot.</p>
  2166. <pre>
  2167. &lt;p4jlock
  2168.     files=&quot;//depot/projA/fast1.c&quot;
  2169. /&gt;
  2170. </pre>
  2171. <p>Lock all files under the "//depot/projA/..." path in the depot.</p>
  2172. <pre>
  2173. &lt;p4jlock
  2174.     files=&quot;//depot/projA/...&quot;
  2175. /&gt;
  2176. </pre>
  2177.  
  2178. <h2><a name="p4jmove">P4JMove</a></h2>
  2179. <h3>Description:</h3>
  2180. <p>Move files from one location to another.</p>
  2181. <p>Move takes an already opened file and moves it from one client
  2182. location to another, reopening it as a pending depot move. When the file
  2183. is submitted with 'submit', its depot file is moved accordingly.</p>
  2184. <p>Wildcards in fromFile and toFile must match. The fromFile must be
  2185. a file opened for add or edit.</p>
  2186. <p>'opened' lists pending moves. 'diff' can compare a moved client
  2187. file with its depot original, 'sync' can schedule an update of a moved
  2188. file, and 'resolve' can resolve the update.</p>
  2189. <p>A client file may be moved many times before it is submitted.
  2190. Moving a file back to its original location will undo a pending move,
  2191. leaving unsubmitted content intact. Using 'revert' will both undo the
  2192. move and revert the unsubmitted content.</p>
  2193. <h3>Parameters</h3>
  2194. <table border="1" cellpadding="2" cellspacing="0">
  2195.   <tr>
  2196.     <td valign="top"><b>Attribute</b></td>
  2197.     <td valign="top"><b>Description</b></td>
  2198.     <td valign="top"><b>Required</b></td>
  2199.     <td valign="top"><b>Default</b></td>
  2200.     <td align="center" valign="top"><b>P4 Command</b></td>
  2201.   </tr>
  2202.   <tr>
  2203.     <td valign="top">fromfile</td>
  2204.     <td valign="top">Source file and revision specifiers separated by
  2205.     space. If the path contains whitespace, it must be double-quoted.</td>
  2206.     <td valign="top">Yes</td>
  2207.     <td valign="top">null</td>
  2208.     <td valign="top" align="center"></td>
  2209.   </tr>
  2210.   <tr>
  2211.     <td valign="top">tofile</td>
  2212.     <td valign="top">Target file and revision specifiers separated by
  2213.     space. If the path contains whitespace, it must be double-quoted.</td>
  2214.     <td valign="top">Yes</td>
  2215.     <td valign="top">null</td>
  2216.     <td valign="top" align="center"></td>
  2217.   </tr>
  2218.   <tr>
  2219.     <td valign="top">changelist</td>
  2220.     <td valign="top">If specified, the files are opened in the
  2221.     numbered pending changelist instead of the 'default' changelist.</td>
  2222.     <td valign="top">No</td>
  2223.     <td valign="top">-1 (unknown)</td>
  2224.     <td valign="top" align="center">p4 move -c changelist</td>
  2225.   </tr>
  2226.   <tr>
  2227.     <td valign="top">listonly</td>
  2228.     <td valign="top">If true, don't actually perform the move, just
  2229.     return what would happen if the move was performed.</td>
  2230.     <td valign="top">No</td>
  2231.     <td valign="top">false</td>
  2232.     <td valign="top" align="center">p4 move -n</td>
  2233.   </tr>
  2234.   <tr>
  2235.     <td valign="top">force</td>
  2236.     <td valign="top">If true, force a move to an existing target
  2237.     file; the file must be synced and not opened. Note that the
  2238.     originating source file will no longer be synced to the client.</td>
  2239.     <td valign="top">No</td>
  2240.     <td valign="top">false</td>
  2241.     <td valign="top" align="center">p4 move -f</td>
  2242.   </tr>
  2243.   <tr>
  2244.     <td valign="top">noclientmove</td>
  2245.     <td valign="top">If true, bypasses the client file rename. This
  2246.     option can be used to tell the server that the user has already
  2247.     renamed a file on the client. The use of this option can confuse the
  2248.     server if you are wrong about the client's contents. Only works for
  2249.     2009.2 and later servers; earlier servers will produce a
  2250.     RequestException if you set this true.</td>
  2251.     <td valign="top">No</td>
  2252.     <td valign="top">false</td>
  2253.     <td valign="top" align="center">p4 move -k</td>
  2254.   </tr>
  2255.   <tr>
  2256.     <td valign="top">filetype</td>
  2257.     <td valign="top">If non-null, the file is reopened as that
  2258.     filetype. If the filetype given is a partial filetype, that partial
  2259.     filetype is combined with the current filetype.</td>
  2260.     <td valign="top">No</td>
  2261.     <td valign="top">null</td>
  2262.     <td valign="top" align="center">p4 move -t filetype</td>
  2263.   </tr>
  2264. </table>
  2265.  
  2266. <h3>Examples</h3>
  2267. <p>Assuming that "file1.c" is open for add or edit, move "file1.c"
  2268. to "file2.c".</p>
  2269. <pre>
  2270. &lt;p4jmove
  2271.     fromfile=&quot;file1.c&quot;
  2272.     tofile=&quot;file2.c&quot;
  2273. /&gt;
  2274. </pre>
  2275. <p>Moving open files from directory "d1" to directory "d2".</p>
  2276. <pre>
  2277. &lt;p4jmove
  2278.     fromfile=&quot;//depot/d1/...&quot;
  2279.     tofile=&quot;//depot/d2/...&quot;
  2280. /&gt;
  2281. </pre>
  2282.  
  2283. <h2><a name="p4jreopen">P4JReopen</a></h2>
  2284. <h3>Description:</h3>
  2285. <p>Move opened files between changelists or change the files' type.
  2286. Reopen takes an already opened file and reopens it for the current user,
  2287. optionally changing its changelist or filetype. The changelist must have
  2288. previously been created with 'change' or may be the 'default'
  2289. changelist.</p>
  2290. <h3>Parameters</h3>
  2291. <table border="1" cellpadding="2" cellspacing="0">
  2292.   <tr>
  2293.     <td valign="top"><b>Attribute</b></td>
  2294.     <td valign="top"><b>Description</b></td>
  2295.     <td valign="top"><b>Required</b></td>
  2296.     <td valign="top"><b>Default</b></td>
  2297.     <td align="center" valign="top"><b>P4 Command</b></td>
  2298.   </tr>
  2299.   <tr>
  2300.     <td valign="top">tochangelist</td>
  2301.     <td valign="top">If given, the file is moved to that changelist;
  2302.     that changelist must have been previously created. Otherwise the file
  2303.     is opened in the 'default' (unnumbered) changelist.</td>
  2304.     <td valign="top">No</td>
  2305.     <td valign="top">0 (default)</td>
  2306.     <td valign="top" align="center">p4 reopen -c</td>
  2307.   </tr>
  2308.   <tr>
  2309.     <td valign="top">filetype</td>
  2310.     <td valign="top">If non-null, the file is reopened as that
  2311.     filetype. If the filetype given is a partial filetype, that partial
  2312.     filetype is combined with the current filetype.</td>
  2313.     <td valign="top">No</td>
  2314.     <td valign="top">null</td>
  2315.     <td valign="top" align="center">p4 reopen -t filetype</td>
  2316.   </tr>
  2317. </table>
  2318.  
  2319. <h3>Examples</h3>
  2320. <p>Reopen all open files as text files with keyword expansion.</p>
  2321. <pre>
  2322. &lt;p4jreopen
  2323.     filetype=&quot;text+k&quot;
  2324.     files=&quot;//...&quot;
  2325. /&gt;
  2326. </pre>
  2327. <p>Move all open files under directory //depot/proj1 or that are
  2328. named README to pending changelist "410".</p>
  2329. <pre>
  2330. &lt;p4jreopen tochangelist=&quot;410&quot;&gt;
  2331.     &lt;file path=&quot;//depot/proj1/...&quot;/&gt;
  2332.     &lt;file path=&quot;//.../README&quot;/&gt;
  2333. &lt;/p4jreopen&gt;
  2334. </pre>
  2335. <p>Move all open ".exe" files to the default changelist, overwriting
  2336. older revisions of those files in the depot.</p>
  2337. <pre>
  2338. &lt;p4jreopen
  2339.     filetype=&quot;binary+S&quot;
  2340.     files=&quot;//....exe&quot;
  2341.     tochangelist=&quot;0&quot;
  2342. /&gt;
  2343. </pre>
  2344.  
  2345. <h2><a name="p4jresolve">P4JResolve</a></h2>
  2346. <h3>Description:</h3>
  2347. <p>Merge open files with other revisions or files. Automatically
  2348. resolve the results of a previous Perforce file integration. Note also
  2349. that having safeMerge, acceptTheirs, acceptYours, and forceResolve all
  2350. set to false in the associated ResolveFilesAutoOptions object results in
  2351. "-am" behavior.</p>
  2352. <h3>Parameters</h3>
  2353. <table border="1" cellpadding="2" cellspacing="0">
  2354.   <tr>
  2355.     <td valign="top"><b>Attribute</b></td>
  2356.     <td valign="top"><b>Description</b></td>
  2357.     <td valign="top"><b>Required</b></td>
  2358.     <td valign="top"><b>Default</b></td>
  2359.     <td align="center" valign="top"><b>P4 Command</b></td>
  2360.   </tr>
  2361.   <tr>
  2362.     <td valign="top">safemerge</td>
  2363.     <td valign="top">If true, only do "safe" resolves, as documented
  2364.     for the 'p4 resolve' "-as" option.</td>
  2365.     <td valign="top">No</td>
  2366.     <td valign="top">false</td>
  2367.     <td valign="top" align="center">p4 resolve -as</td>
  2368.   </tr>
  2369.   <tr>
  2370.     <td valign="top">accepttheirs</td>
  2371.     <td valign="top">If true, automatically accept "their" changes,
  2372.     as documented for the 'p4 resolve' "-at" option.</td>
  2373.     <td valign="top">No</td>
  2374.     <td valign="top">false</td>
  2375.     <td valign="top" align="center">p4 resolve -at</td>
  2376.   </tr>
  2377.   <tr>
  2378.     <td valign="top">acceptyours</td>
  2379.     <td valign="top">If true, automatically accept "your" changes, as
  2380.     documented for the 'p4 resolve' "-ay" option.</td>
  2381.     <td valign="top">No</td>
  2382.     <td valign="top">false</td>
  2383.     <td valign="top" align="center">p4 resolve -ay</td>
  2384.   </tr>
  2385.   <tr>
  2386.     <td valign="top">showactionsonly</td>
  2387.     <td valign="top">If true, don't do the actual resolve, just
  2388.     return the actions that would have been performed for the resolve.</td>
  2389.     <td valign="top">No</td>
  2390.     <td valign="top">false</td>
  2391.     <td valign="top" align="center">p4 resolve -n</td>
  2392.   </tr>
  2393.   <tr>
  2394.     <td valign="top">forceresolve</td>
  2395.     <td valign="top">Forces auto-mode resolve to accept the merged
  2396.     file even if there are conflicts. Corresponds to the "-af" option.</td>
  2397.     <td valign="top">No</td>
  2398.     <td valign="top">false</td>
  2399.     <td valign="top" align="center">p4 resolve -af</td>
  2400.   </tr>
  2401. </table>
  2402.  
  2403. <h3>Examples</h3>
  2404. <p>Automatically accept the Perforce-recommended file revision: if
  2405. theirs is identical to base, accept yours; if yours is identical to
  2406. base, accept theirs; if yours and theirs are different from base, and
  2407. there are no conflicts between yours and theirs; accept merge; other
  2408. wise, there are conflicts between yours and theirs, so skip this file.
  2409. This example corresponds to the "-am" option.</p>
  2410. <pre>
  2411. &lt;p4jresolve
  2412.     files=&quot;//depot/projA/test-branch/src/test/...&quot;
  2413. /&gt;
  2414. </pre>
  2415. <p>Accept yours, ignore theirs. This example corresponds to the
  2416. "-ay" option.</p>
  2417. <pre>
  2418. &lt;p4jresolve
  2419.     acceptyours=&quot;true&quot;
  2420.     files=&quot;//depot/projA/test-branch/src/test/...&quot;
  2421. /&gt;
  2422. </pre>
  2423.  
  2424. <h2><a name="p4jrevert">P4JRevert</a></h2>
  2425. <h3>Description:</h3>
  2426. <p>Discard changes from opened files. Revert an open file back to
  2427. the revision previously synced from the depot, discarding any pending
  2428. changelists or integrations that have been made. This command requires
  2429. naming files explicitly. After running revert the named files will no
  2430. longer be locked or open.</p>
  2431. <h3>Parameters</h3>
  2432. <table border="1" cellpadding="2" cellspacing="0">
  2433.   <tr>
  2434.     <td valign="top"><b>Attribute</b></td>
  2435.     <td valign="top"><b>Description</b></td>
  2436.     <td valign="top"><b>Required</b></td>
  2437.     <td valign="top"><b>Default</b></td>
  2438.     <td align="center" valign="top"><b>P4 Command</b></td>
  2439.   </tr>
  2440.   <tr>
  2441.     <td valign="top">noupdate</td>
  2442.     <td valign="top">If true, it lists what files would be affected
  2443.     but does not actually revert them.</td>
  2444.     <td valign="top">No</td>
  2445.     <td valign="top">false</td>
  2446.     <td valign="top" align="center">p4 revert -n</td>
  2447.   </tr>
  2448.   <tr>
  2449.     <td valign="top">changelist</td>
  2450.     <td valign="top">If given, it limits the revert to files opened
  2451.     under the given, pending changelist.</td>
  2452.     <td valign="top">No</td>
  2453.     <td valign="top">0 (default)</td>
  2454.     <td valign="top" align="center">p4 revert -c</td>
  2455.   </tr>
  2456.   <tr>
  2457.     <td valign="top">revertonlyunchanged</td>
  2458.     <td valign="top">If true, it reverts only those files which are
  2459.     opened for edit or integrate and are unchanged or missing. Files with
  2460.     pending integration records are left open.</td>
  2461.     <td valign="top">No</td>
  2462.     <td valign="top">false</td>
  2463.     <td valign="top" align="center">p4 revert -a</td>
  2464.   </tr>
  2465.   <tr>
  2466.     <td valign="top">noclientrefresh</td>
  2467.     <td valign="top">If true, bypasses the client file refresh. It
  2468.     can be used to make the server believe the file is no longer open, but
  2469.     keeps the file unchanged in the client workspace.</td>
  2470.     <td valign="top">No</td>
  2471.     <td valign="top">false</td>
  2472.     <td valign="top" align="center">p4 revert -k</td>
  2473.   </tr>
  2474. </table>
  2475.  
  2476. <h3>Examples</h3>
  2477. <p>Revert every file you have open, in every one of your pending
  2478. changelists, to its pre-opened state.</p>
  2479. <pre>
  2480. &lt;p4jrevert
  2481.     files=&quot;//...&quot;
  2482. /&gt;
  2483. </pre>
  2484. <p>Revert every file open in the default changelist to its
  2485. pre-opened state.</p>
  2486. <pre>
  2487. &lt;p4jrevert
  2488.     changelist=&quot;default&quot;
  2489.     files=&quot;//...&quot;
  2490. /&gt;
  2491. </pre>
  2492. <p>Preview a reversion of all open ".txt" files in the current
  2493. directory, but don't actually perform the revert.</p>
  2494. <pre>
  2495. &lt;p4jrevert
  2496.     noupdate=&quot;true&quot;
  2497.     files=&quot;*.txt&quot;
  2498. /&gt;
  2499. </pre>
  2500. <p>Revert all unchanged files. This command is often used before
  2501. submitting a changelist.</p>
  2502. <pre>
  2503. &lt;p4jrevert
  2504.     revertonlyunchanged=&quot;true&quot;
  2505. /&gt;
  2506. </pre>
  2507.  
  2508. <h2><a name="p4jshelve">P4JShelve</a></h2>
  2509. <h3>Description:</h3>
  2510. <p>Store files from a pending changelist in the depot, without
  2511. submitting them.</p>
  2512. <p>The 'shelve' command creates, modifies or deletes shelved files
  2513. in a pending changelist. Shelved files persist in the depot until they
  2514. are deleted (using the 'deletefiles' attribute) or replaced by
  2515. subsequent shelve commands. After shelving, the user can revert the
  2516. files and restore them later using 'unshelve'. Other users can
  2517. 'unshelve' the stored files into their own workspaces.</p>
  2518. <p>Files that have been shelved can be accessed by the 'diff',
  2519. 'diff2', 'files' and 'print' commands using the revision specification
  2520. '@=change', where 'change' is the pending changelist number.</p>
  2521. <p>Adds files from the user's specified changelist then shelves
  2522. those files into the depot.</p>
  2523. <p>If a file pattern is specified, 'shelve' limits the list of files
  2524. to those matching the pattern.</p>
  2525. <h3>Parameters</h3>
  2526. <table border="1" cellpadding="2" cellspacing="0">
  2527.   <tr>
  2528.     <td valign="top"><b>Attribute</b></td>
  2529.     <td valign="top"><b>Description</b></td>
  2530.     <td valign="top"><b>Required</b></td>
  2531.     <td valign="top"><b>Default</b></td>
  2532.     <td align="center" valign="top"><b>P4 Command</b></td>
  2533.   </tr>
  2534.   <tr>
  2535.     <td valign="top">changelist</td>
  2536.     <td valign="top">The pending changelist that contains shelved
  2537.     files to be created, deleted, or modified.</td>
  2538.     <td valign="top">Yes</td>
  2539.     <td valign="top"></td>
  2540.     <td valign="top" align="center">p4 shelve -c</td>
  2541.   </tr>
  2542.   <tr>
  2543.     <td valign="top">forceshelve</td>
  2544.     <td valign="top">If true, it forces overwriting any existing
  2545.     shelved files in a pending changelist.</td>
  2546.     <td valign="top">No</td>
  2547.     <td valign="top">false</td>
  2548.     <td valign="top" align="center">p4 shelve -f</td>
  2549.   </tr>
  2550.   <tr>
  2551.     <td valign="top">replacefiles</td>
  2552.     <td valign="top">If true, enables you to replace all shelved
  2553.     files in that changelist with the files opened in your own workspace
  2554.     at that changelist number. Only the user and client workspace of the
  2555.     pending changelist is allowed to replace its shelved files.</td>
  2556.     <td valign="top">No</td>
  2557.     <td valign="top">false</td>
  2558.     <td valign="top" align="center">p4 shelve -r</td>
  2559.   </tr>
  2560.   <tr>
  2561.     <td valign="top">deletefiles</td>
  2562.     <td valign="top">If true, it deletes the shelved files in the
  2563.     specified changelist so that they can no longer be unshelved. By
  2564.     default only the user and client of the pending changelist is allowed
  2565.     to delete its shelved files.</td>
  2566.     <td valign="top">No</td>
  2567.     <td valign="top">false</td>
  2568.     <td valign="top" align="center">p4 shelve -d</td>
  2569.   </tr>
  2570. </table>
  2571.  
  2572. <h3>Examples</h3>
  2573. <p>Stores the files under the "//depot/proj1/dev/..." path in the
  2574. changelist "410" to the Perforce server.</p>
  2575. <pre>
  2576. &lt;p4jshelve
  2577.     changelist=&quot;410&quot;
  2578.     files=&quot;//depot/proj1/dev/...&quot;
  2579. /&gt;
  2580. </pre>
  2581. <p>Deletes the shelved files in the specified changelist "410" so
  2582. that they can no longer be unshelved.</p>
  2583. <pre>
  2584. &lt;p4jshelve
  2585.     changelist=&quot;410&quot;
  2586.     deletefiles=&quot;true&quot;
  2587. /&gt;
  2588. </pre>
  2589.  
  2590. <h2><a name="p4jsubmit">P4JSubmit</a></h2>
  2591. <h3>Description:</h3>
  2592. <p>Commits a pending changelist and its files to the depot.</p>
  2593. <p>With no argument the 'submit' command attempts to submit all
  2594. files in the 'default' changelist. Submit provides the user with a
  2595. dialog similar to 'change' so the user can compose a changelist
  2596. description. In this dialog the user is presented with the list of files
  2597. open in changelist 'default'. Files may be deleted from this list but
  2598. they cannot be added. (Use an open command (edit, add, delete) to add
  2599. additional files to a changelist.).</p>
  2600. <p>If a (single) file pattern is given, only those files in the
  2601. 'default' changelist that match the pattern will be submitted.</p>
  2602. <h3>Parameters</h3>
  2603. <table border="1" cellpadding="2" cellspacing="0">
  2604.   <tr>
  2605.     <td valign="top"><b>Attribute</b></td>
  2606.     <td valign="top"><b>Description</b></td>
  2607.     <td valign="top"><b>Required</b></td>
  2608.     <td valign="top"><b>Default</b></td>
  2609.     <td align="center" valign="top"><b>P4 Command</b></td>
  2610.   </tr>
  2611.   <tr>
  2612.     <td valign="top">changelistdescription</td>
  2613.     <td valign="top">The description of the changelist.</td>
  2614.     <td valign="top">No</td>
  2615.     <td valign="top">null</td>
  2616.     <td valign="top" align="center">p4 submit -d</td>
  2617.   </tr>
  2618.   <tr>
  2619.     <td valign="top">changelist</td>
  2620.     <td valign="top">Submits the numbered pending changelist that has
  2621.     been previously created or a failed submit.</td>
  2622.     <td valign="top">No</td>
  2623.     <td valign="top">0 (default)</td>
  2624.     <td valign="top" align="center">p4 submit -c</td>
  2625.   </tr>
  2626.   <tr>
  2627.     <td valign="top">changelistproperty</td>
  2628.     <td valign="top">Name of property to set the new changelist
  2629.     number, if the Perforce server renumbers the change.</td>
  2630.     <td valign="top">No</td>
  2631.     <td valign="top">null</td>
  2632.     <td valign="top" align="center"></td>
  2633.   </tr>
  2634.   <tr>
  2635.     <td valign="top">needsresolveproperty</td>
  2636.     <td valign="top">Name of property to be set to true, if the
  2637.     submit requires a resolve.</td>
  2638.     <td valign="top">No</td>
  2639.     <td valign="top">null</td>
  2640.     <td valign="top" align="center"></td>
  2641.   </tr>
  2642.   <tr>
  2643.     <td valign="top">reopen</td>
  2644.     <td valign="top">If true, it allows submitted files to remain
  2645.     open (on the client's default changelist) after the submit has
  2646.     completed.</td>
  2647.     <td valign="top">No</td>
  2648.     <td valign="top">false</td>
  2649.     <td valign="top" align="center">p4 submit -r</td>
  2650.   </tr>
  2651.   <tr>
  2652.     <td valign="top">job</td>
  2653.     <td valign="top">List of job IDs, separated by whitespace, for
  2654.     jobs that will have their status changed to fixed or "jobStatus".</td>
  2655.     <td valign="top">No</td>
  2656.     <td valign="top">null</td>
  2657.     <td valign="top" align="center"></td>
  2658.   </tr>
  2659.   <tr>
  2660.     <td valign="top">jobstatus</td>
  2661.     <td valign="top">Status of jobs will be set on a successful
  2662.     submit; if null the jobs will be marked fixed.</td>
  2663.     <td valign="top">No</td>
  2664.     <td valign="top">null</td>
  2665.     <td valign="top" align="center">p4 submit -s</td>
  2666.   </tr>
  2667. </table>
  2668.  
  2669. <h3>Examples</h3>
  2670. <p>Commits a pending changelist and its files to the depot.</p>
  2671. <pre>
  2672. &lt;p4jsubmit
  2673.     changelistdescription=&quot;Updated Java classes.&quot;
  2674. /&gt;
  2675. </pre>
  2676. <p>Submits the numbered pending changelist "410" that has been
  2677. previously created or a failed submit.</p>
  2678. <pre>
  2679. &lt;p4jsubmit
  2680.     changelist=&quot;410&quot;
  2681. /&gt;
  2682. </pre>
  2683. <p>Submits files under the "//depot/proj1/newfiles/..." path in the
  2684. numbered pending changelist "410" to the depot.</p>
  2685. <pre>
  2686. &lt;p4jsubmit
  2687.     changelist=&quot;410&quot;
  2688.     files=&quot;//depot/proj1/newfiles/...&quot;
  2689. /&gt;
  2690. </pre>
  2691.  
  2692. <h2><a name="p4jsync">P4JSync</a></h2>
  2693. <h3>Description:</h3>
  2694. <p>Synchronize the client with its view of the depot.</p>
  2695. <p>Sync updates the client workspace to reflect its current view (if
  2696. it has changed) and the current contents of the depot (if it has
  2697. changed). The client view is used to map client file names to depot file
  2698. names and vice versa.</p>
  2699. <p>Sync adds files that are in the client view but which have not
  2700. been retrieved before. Sync deletes previously retrieved files which are
  2701. no longer in the client view or have been deleted from the depot. Sync
  2702. updates files which are still in the client view and which have been
  2703. updated in the depot.</p>
  2704. <p>Normally, sync affects all files in the client workspace. If file
  2705. arguments are given, sync limits its operation to those files. The file
  2706. arguments may contain wildcards.</p>
  2707. <p>If the file argument includes a revision specifier, then the
  2708. given revision is retrieved. Normally, the head revision is retrieved.
  2709. See 'p4 help revisions' for help specifying revisions.</p>
  2710. <p>If the file argument includes a revision range specification,
  2711. then only files selected by the revision range are updated, and the
  2712. highest revision in the range is used.</p>
  2713. <p>Normally, sync will not clobber files in the client workspace
  2714. that the user has made writable. Setting the 'clobber' option in the
  2715. client spec disables this safety check.</p>
  2716. <h3>Parameters</h3>
  2717. <table border="1" cellpadding="2" cellspacing="0">
  2718.   <tr>
  2719.     <td valign="top"><b>Attribute</b></td>
  2720.     <td valign="top"><b>Description</b></td>
  2721.     <td valign="top"><b>Required</b></td>
  2722.     <td valign="top"><b>Default</b></td>
  2723.     <td align="center" valign="top"><b>P4 Command</b></td>
  2724.   </tr>
  2725.   <tr>
  2726.     <td valign="top">forceupdate</td>
  2727.     <td valign="top">If true, it forces re-sync even if the client
  2728.     already has the file, and clobbers writable files. This flag doesn't
  2729.     affect open files.</td>
  2730.     <td valign="top">No</td>
  2731.     <td valign="top">false</td>
  2732.     <td valign="top" align="center">p4 sync -f</td>
  2733.   </tr>
  2734.   <tr>
  2735.     <td valign="top">noupdate</td>
  2736.     <td valign="top">If true, it causes sync not to update the client
  2737.     workspace, but to list what normally would be updated.</td>
  2738.     <td valign="top">No</td>
  2739.     <td valign="top">false</td>
  2740.     <td valign="top" align="center">p4 sync -n</td>
  2741.   </tr>
  2742.   <tr>
  2743.     <td valign="top">clientbypass</td>
  2744.     <td valign="top">If true, it bypasses the client file update. It
  2745.     can be used to make the server believe that a client workspace already
  2746.     has the file. Typically this flag is used to correct the Perforce
  2747.     server when it is wrong about what files are on the client. Use of
  2748.     this option can confuse the server if you are wrong about the client's
  2749.     contents.</td>
  2750.     <td valign="top">No</td>
  2751.     <td valign="top">false</td>
  2752.     <td valign="top" align="center">p4 sync -k</td>
  2753.   </tr>
  2754.   <tr>
  2755.     <td valign="top">serverbypass</td>
  2756.     <td valign="top">If true, it populates the client workspace, but
  2757.     does not update the server to reflect those updates. Any file that is
  2758.     already sync'ed or opened will be bypassed with a warning message.
  2759.     This option is very useful for build clients or when publishing
  2760.     content without the requirement of saving the client workspace state.</td>
  2761.     <td valign="top">No</td>
  2762.     <td valign="top">false</td>
  2763.     <td valign="top" align="center">p4 sync -p</td>
  2764.   </tr>
  2765. </table>
  2766.  
  2767. <h3>Examples</h3>
  2768. <p>Copy the latest revision of all files from the depot to the
  2769. client workspace, as mapped through the client view. If the file is
  2770. already open in the client workspace, or if the latest revision of the
  2771. file exists in the client workspace, it is not copied.</p>
  2772. <pre>
  2773. &lt;p4jsync/&gt;
  2774. </pre>
  2775. <p>Copy the fourth revision of "file.c" to the client workspace,
  2776. with the same exceptions as in the example above.</p>
  2777. <pre>
  2778. &lt;p4jsync
  2779.     files=&quot;file.c#4&quot;
  2780. /&gt;
  2781. </pre>
  2782. <p>Copy all the files under the "//depot/proj1" path from the depot
  2783. to the client workspace, as mapped through the client view. Don't copy
  2784. the latest revision; use the revision of the file in the depot after
  2785. changelist "21" was submitted.</p>
  2786. <pre>
  2787. &lt;p4jsync
  2788.     files=&quot;//depot/proj1/...@21&quot;
  2789. /&gt;
  2790. </pre>
  2791. <p>Force update of all the files under the "//depot/proj1" path from
  2792. the depot to the client workspace, even if the client already has the
  2793. file, and clobbers writable files. This option doesn't affect open
  2794. files.</p>
  2795. <pre>
  2796. &lt;p4jsync
  2797.     forceupdate=&quot;true&quot;
  2798.     files=&quot;//depot/proj1/...&quot;
  2799. /&gt;
  2800. </pre>
  2801. <p>Bring the workspace into sync with a label, but preserve
  2802. unlabeled files in the workspace.</p>
  2803. <pre>
  2804. &lt;p4jsync
  2805.     files=&quot;@mylabelname&quot;
  2806. /&gt;
  2807. </pre>
  2808.  
  2809. <h2><a name="p4jtag">P4JTag</a></h2>
  2810. <h3>Description:</h3>
  2811. <p>Tag files with a label.</p>
  2812. <p>Tag associates the named label with the file revisions indicated
  2813. by the file argument. Once file revisions are tagged with a label,
  2814. revision specifications of the form '@label' can be used to refer to
  2815. them.</p>
  2816. <p>If the file argument does not include a revision specification,
  2817. the head revisions will be tagged. See 'p4 help revisions' for revision
  2818. specification options.</p>
  2819. <p>If the file argument includes a revision range specification,
  2820. only the files with revisions in that range will be tagged. Files with
  2821. more than one revision in the range will be tagged at the highest
  2822. revision.</p>
  2823. <p>The "delete" (-d flag) option deletes the association between the
  2824. specified files and the label, regardless of revision.</p>
  2825. <h3>Parameters</h3>
  2826. <table border="1" cellpadding="2" cellspacing="0">
  2827.   <tr>
  2828.     <td valign="top"><b>Attribute</b></td>
  2829.     <td valign="top"><b>Description</b></td>
  2830.     <td valign="top"><b>Required</b></td>
  2831.     <td valign="top"><b>Default</b></td>
  2832.     <td align="center" valign="top"><b>P4 Command</b></td>
  2833.   </tr>
  2834.   <tr>
  2835.     <td valign="top">label</td>
  2836.     <td valign="top">Name of the label to be associated with the
  2837.     files.</td>
  2838.     <td valign="top">Yes</td>
  2839.     <td valign="top"></td>
  2840.     <td valign="top" align="center">p4 tag -l</td>
  2841.   </tr>
  2842.   <tr>
  2843.     <td valign="top">listonly</td>
  2844.     <td valign="top">If true, it lists the files that would be
  2845.     tagged, but doesn't actually do anything.</td>
  2846.     <td valign="top">No</td>
  2847.     <td valign="top">false</td>
  2848.     <td valign="top" align="center">p4 tag -n</td>
  2849.   </tr>
  2850.   <tr>
  2851.     <td valign="top">delete</td>
  2852.     <td valign="top">If true, it deletes the association between the
  2853.     specified files and the label, regardless of revision.</td>
  2854.     <td valign="top">No</td>
  2855.     <td valign="top">false</td>
  2856.     <td valign="top" align="center">p4 tag -d</td>
  2857.   </tr>
  2858. </table>
  2859.  
  2860. <h3>Examples</h3>
  2861. <p>Tag the head revisions of files under the "//depot/1.0/..." path
  2862. with label "rel1". If the label "rel1" does not exist, create it.</p>
  2863. <pre>
  2864. &lt;p4jtag
  2865.     label=&quot;rel1&quot;
  2866.     files=&quot;//depot/1.0/...&quot;
  2867. /&gt;
  2868. </pre>
  2869. <p>Tag the most recent revisions as of the submission of changelist
  2870. "1234" of files under the "//depot/1.0/..." path with label build. If
  2871. the label build does not exist, create it.</p>
  2872. <pre>
  2873. &lt;p4jtag
  2874.     files=&quot;//depot/1.0/...@1234&quot;
  2875.     label=&quot;build&quot;
  2876. /&gt;
  2877. </pre>
  2878.  
  2879. <h2><a name="p4junlock">P4JUnlock</a></h2>
  2880. <h3>Description:</h3>
  2881. <p>Release locked files but leave them open.</p>
  2882. <p>The unlock command releases a lock on an open file in a pending
  2883. changelist. If the file is open in a specific pending changelist other
  2884. than 'default', then the -c flag is required to specify the pending
  2885. changelist. If no file name is given then all files in the designated
  2886. changelist are unlocked.</p>
  2887. <h3>Parameters</h3>
  2888. <table border="1" cellpadding="2" cellspacing="0">
  2889.   <tr>
  2890.     <td valign="top"><b>Attribute</b></td>
  2891.     <td valign="top"><b>Description</b></td>
  2892.     <td valign="top"><b>Required</b></td>
  2893.     <td valign="top"><b>Default</b></td>
  2894.     <td align="center" valign="top"><b>P4 Command</b></td>
  2895.   </tr>
  2896.   <tr>
  2897.     <td valign="top">changelist</td>
  2898.     <td valign="top">If positive, use the changelist given instead of
  2899.     the default changelist.</td>
  2900.     <td valign="top">No</td>
  2901.     <td valign="top">0 (default)</td>
  2902.     <td valign="top" align="center">p4 unlock -c</td>
  2903.   </tr>
  2904.   <tr>
  2905.     <td valign="top">forceunlock</td>
  2906.     <td valign="top">Force unlock of any file; normally files can
  2907.     only be unlocked by their owner. The forceunlock (-f flag) option
  2908.     requires 'admin' access granted by 'p4 protect'.</td>
  2909.     <td valign="top">No</td>
  2910.     <td valign="top">false</td>
  2911.     <td valign="top" align="center">p4 unlock -f</td>
  2912.   </tr>
  2913. </table>
  2914.  
  2915. <h3>Examples</h3>
  2916. <p>Unlock the file "//depot/projA/fast1.c" in the depot.</p>
  2917. <pre>
  2918. &lt;p4junlock
  2919.     files=&quot;//depot/projA/fast1.c&quot;
  2920. /&gt;
  2921. </pre>
  2922. <p>Force unlock all files under "//depot/projA/..." in the depot.</p>
  2923. <pre>
  2924. &lt;p4junlock
  2925.     files=&quot;//depot/projA/...&quot;
  2926.     forceunlock=&quot;true&quot;
  2927. /&gt;
  2928. </pre>
  2929.  
  2930. <h2><a name="p4junshelve">P4JUnshelve</a></h2>
  2931. <h3>Description:</h3>
  2932. <p>Restore shelved files from a pending change into a workspace.</p>
  2933. <p>The unshelve command retrieves the shelved files from a pending
  2934. changelist and copies them into a pending changelist on the invoking
  2935. user's workspace. Unshelving files from a pending changelist is
  2936. restricted by the user's permissions on the files. A successful unshelve
  2937. operation places the shelved files on the user's workspace with the same
  2938. open action and pending integration history as if it had originated from
  2939. that user and client.</p>
  2940. <h3>Parameters</h3>
  2941. <table border="1" cellpadding="2" cellspacing="0">
  2942.   <tr>
  2943.     <td valign="top"><b>Attribute</b></td>
  2944.     <td valign="top"><b>Description</b></td>
  2945.     <td valign="top"><b>Required</b></td>
  2946.     <td valign="top"><b>Default</b></td>
  2947.     <td align="center" valign="top"><b>P4 Command</b></td>
  2948.   </tr>
  2949.   <tr>
  2950.     <td valign="top">fromchangelist</td>
  2951.     <td valign="top">The source pending changelist that contains the
  2952.     shelved files.</td>
  2953.     <td valign="top">Yes</td>
  2954.     <td valign="top">0 (default)</td>
  2955.     <td valign="top" align="center">p4 unshelve -s</td>
  2956.   </tr>
  2957.   <tr>
  2958.     <td valign="top">tochangelist</td>
  2959.     <td valign="top">The target changelist to receive the shelved
  2960.     files.</td>
  2961.     <td valign="top">No</td>
  2962.     <td valign="top">0 (default)</td>
  2963.     <td valign="top" align="center">p4 unshelve -c</td>
  2964.   </tr>
  2965.   <tr>
  2966.     <td valign="top">forceunshelve</td>
  2967.     <td valign="top">If true, it forces the clobbering of any
  2968.     writeable but unopened files that are being unshelved.</td>
  2969.     <td valign="top">No</td>
  2970.     <td valign="top">false</td>
  2971.     <td valign="top" align="center">p4 unshelve -f</td>
  2972.   </tr>
  2973.   <tr>
  2974.     <td valign="top">preview</td>
  2975.     <td valign="top">If true, previews what would be unshelved
  2976.     without actually changing any files or metadata.</td>
  2977.     <td valign="top">No</td>
  2978.     <td valign="top">false</td>
  2979.     <td valign="top" align="center">p4 unshelve -n</td>
  2980.   </tr>
  2981. </table>
  2982.  
  2983. <h3>Examples</h3>
  2984. <p>Restores the shelved files from changelist 410 to the default
  2985. changelist.</p>
  2986. <pre>
  2987. &lt;p4junshelve
  2988.     fromchangelist=&quot;410&quot;
  2989. /&gt;
  2990. </pre>
  2991. <p>Restores the shelved files from changelist 410 to the changelist
  2992. 810.</p>
  2993. <pre>
  2994. &lt;p4junshelve
  2995.     fromchangelist=&quot;410&quot;
  2996.     tochangelist=&quot;810&quot;
  2997. /&gt;
  2998. </pre>
  2999. <p>Force unshelve of the shelved files in the specified changelist
  3000. 410.</p>
  3001. <pre>
  3002. &lt;p4junshelve
  3003.     forceunshelve=&quot;true&quot;
  3004.     fromchangelist=&quot;410&quot;
  3005.     tochangelist=&quot;410&quot;
  3006. /&gt;
  3007. </pre>
  3008.  
  3009. <hr>
  3010. <h2><a name="changes">Change History</a></h2>
  3011. <table border="1" cellpadding="2" cellspacing="0">
  3012.   <tr>
  3013.     <td valign="top">Sept 2010</td>
  3014.     <td valign="top">V1.0</td>
  3015.     <td valign="top">Initial Release</td>
  3016.   </tr>
  3017. </table>
  3018. </body>
  3019. </html>
# Change User Description Committed
#1 8496 Matt Attaway Move P4Ant and P4Maven into their proper homes 11 years ago
//public/perforce/p4ant/main/com.perforce.ant/docs/manual/p4tasks.html
#1 8269 Matt Attaway Initial add of the p4ant source code 12 years ago