<HTML><HEAD><TITLE>P4Web User Guide - Editing a Pending Changelist</TITLE></HEAD><BODY><FONT SIZE=-1><B>P4Web Release 2012.1 User Guide</B></FONT><BR>
<FONT SIZE=-1><B><A HREF="quickstart.html">[Getting Started]</A> <A HREF="howto.html">[How To...]</A> <A HREF="tips.html">[Browser Tips]</A> <A HREF="defs.html">[Glossary]</A> <A HREF="roadmap.html">[Road Map]</A> </B></FONT><BR>
<H3>Editing a Pending Changelist</H3>
<p>
The Pending Changelist page
allows you to
create a new <a href="pendingchangelists.html">pending changelist</a>,
edit a pending changelist,
move files between pending changelists,
and <a href="submit.html">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="../icons/runsubmit.gif" 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> <enter description here></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.html#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.html#jobdesc">here</a>.
</td>
</tr>
<tr>
<td><b>Jobs</b></td>
<td> Perforce <a href="defs.html#job">jobs</a> to update when this changelist
is submitted. If you have a "Jobview" value set in your <a href="edituser.html">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.html">locked</a>, revert unlocks them. With "only if unchanged"
checked, only the unchanged files you have opened for <a href="edit.html">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.html">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>
<P>
<HR>
<FONT SIZE=-1><I>
Copyright 2012 <A HREF="http://www.perforce.com">Perforce Software</A>.
All rights reserved.
</I></FONT>
</BODY></HTML>