editpending.html #1

<TITLE>Editing a Pending Changelist</TITLE>

<p>
The Pending Changelist page
allows you to
create a new <a href="pendingchangelists?help">pending changelist</a>,
edit a pending changelist,
move files between pending changelists,
and <a href="submit?help">submit opened files</a> in a pending changelist.
<p>
Having multiple pending changelists is a way to organize
your opened files into logical groups.
When you submit a pending changelist,
all the files associated with that changelist
are submitted at the same time and a permanent
record is made of the event in the depot.
<P>
To view a pending changelist,

<UL>
<p>
<LI>Select the <B>Pending</B> tab and then select one of the changelists on that page, or
<table align=right><tr>
<td valign=top><img src="/runsubmit?icon" border=1></td>
<td valign=top><font size=-2>"Submit default<br>changelist"</font></td>
</tr></table>
<LI>Click the "Submit default changelist" shortcut button.
<p>

</UL>

<P> The following fields are displayed on the <b>Pending Changelist</b> page: 
<table width="66%" border="1" cellpadding="1">
  <tr> 
    <td><b>Field</b></td>
    <td><b>Description</b></td>
  </tr>
  <tr> 
    <td><b>Change</b></td>
    <td>The changelist number. This is a read-only field. Its value is "new" if 
      you are editing the default changelist. Numbered pending changelists are 
      assigned a changelist number when you create them. (Note that when you submit 
      a pending changelist, it may be renumbered. You have no control over the 
      numbering process.) </td>
  </tr>
  <tr> 
    <td><b>Date</b></td>
    <td>The current date and time. (Read-only.) </td>
  </tr>
  <tr> 
    <td><b>Client</b></td>
    <td>Your client name. (Read-only.) </td>
  </tr>
  <tr> 
    <td><b>User</b></td>
    <td>Your user name. (Read-only.) </td>
  </tr>
  <tr> 
    <td><b>Status</b></td>
    <td>Numbered pending changelists have a status of "pending". The default changelist 
      has a status of "new". (Read-only.) </td>
  </tr>
  <tr> 
    <td><b>Description</b></td>
    <td>A description of the change you are making to the files being submitted. 
      This description will be stored permanently in the Perforce depot when you 
      submit the changelist. You don't have to itemize the files in your description; 
      they are already listed in the "Files" field. 
      <p> When you first edit the changelist, this field will contain the text: 
      <pre>	&lt;enter description here&gt;</pre>
      You must change this text before you can submit the changelist. </td>
  </tr>
  <tr> 
    <td><b>JobStatus</b></td>
    <td>New status to assign to <a href="defs?help#job">jobs</a> listed in the 
      "Jobs" field of this changelist. The default is "closed". (Optional.) For 
      more information about job status, click <a href="editjob?help#jobdesc">here</a>. 
    </td>
  </tr>
  <tr> 
    <td><b>Jobs</b></td>
    <td> Perforce <a href="defs?help#job">jobs</a> to update when this changelist 
      is submitted. If you have a "Jobview" value set in your <a href="edituser?help">user 
      spec</a>, jobs matching that jobview will automatically appear in this field. 
      (Optional.) </td>
  </tr>
  <tr> 
    <td><b>Files</b></td>
    <td>The files that are opened by you, the current user, and that are associated 
      with this changelist. (Each open file in your workspace is associated with 
      only one user and one pending changelist.) The checkboxes indicate which 
      of the files will be used for the action button you choose, described below. 
    </td>
  </tr>
</table>



   
<P> The Pending Changelists page offers you several actions to take. The files 
  used in the action will be those <i>checked</i> in the file list shown on the 
  page. At the end of the page you'll see buttons that can execute those actions: 
<table width="66%" border="1" cellpadding="1">
  <tr> 
    <td><b>Action</b></td>
    <td><b>Description</b></td>
  </tr>
  <tr> 
    <td><b>Create Changelist</b></td>
    <td>Saves the information you've entered in a numbered pending changelist 
      which you can edit or submit later. This action is available when you are 
      editing the default changelist. </td>
  </tr>
  <tr> 
    <td><b>Update Changelist</b></td>
    <td>Saves the current pending changelist with the information you've entered. 
      This action is available when you are editing a numbered pending changelist. 
    </td>
  </tr>
  <tr> 
    <td><b>Submit</b></td>
    <td>Sends the selected files to the depot where they will be stored as new 
      revisions and makes a permanent record of this submitted changelist. This 
      action is available when you are editing a pending changelist that has files 
      associated with it. 
      <p> Next to the Submit button, there is a <b>leave files open</b> checkbox. 
        If you select this checkbox, your files will be checked back out after 
        you submit, and re-opened for edit. 
    </td>
  </tr>
  <tr> 
    <td><b>Move to Changelist</b></td>
    <td>Takes the files you've selected off the current changelist and puts them 
      in the changelist you picked in the "Move to Changelist" field. Note that 
      any changes you made to the Description or Jobs fields will be ignored when 
      you click this button. This action is available when you are editing a pending 
      changelist, and you have more than one pending changelist in your workspace. 
    </td>
  </tr>
  <tr> 
    <td><b>Delete Empty Changelist</b></td>
    <td>Deletes the pending changelist from your workspace. This action is available 
      when you are editing a numbered pending changelist that has no files associated 
      with it. </td>
  </tr>
  <tr> 
    <td><b>Revert Files</b></td>
    <td>Overwrites the workspace files you've selected with copies from the depot, 
      and removes the files from your pending changelist. If you had the files 
      <a href="lock?help">locked</a>, revert unlocks them. With "only if unchanged" 
      checked, only the unchanged files you have opened for <a href="edit?help">edit</a> 
      will be reverted. If you want to revert files you've changed, or files opened 
      for another reason, choose "ALL selected files". <font color=red> <i>Warning:</i> 
      file changes you've made in your workspace <b>will be lost</b> when you 
      revert files! </font> This action is available when you are editing a pending 
      changelist that has files associated with it. </td>
  </tr>
</table>
<h4>Sharing Workspaces</h4>

<p> P4Web assumes your workspace is used by only one user, the current user. (That's 
  the user name you see in the P4Web <a href="controlpanel?help">control panel</a> 
  at the top of each page.) In the rare case where more than one user is using 
  the same client workspace, you can end up with files opened by more than one 
  user. However: 
<ul>
  <li>only the files opened by the current user can be submitted 
  <li>only the files opened by the current user are visible in the Pending Changelist 
    form 
</ul>