<HTML><HEAD><TITLE>P4Web User Guide - Syncing Files</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>Syncing Files</H3>
<p> The Perforce <b>sync</b> command synchronizes your workspace files with the
files in the depot. Syncing uses your client spec to determine which depot files
to get and where to put them in your workspace. To look at or edit your client
spec, click your client name at the top of any screen in P4Web .
<p> If there are files in the depot that haven't been copied to your workspace,
<b>sync</b> copies them in. If any the depot files have been updated, <b>sync</b>
copies the newer files to your workspace. If you have files in your workspace
that have been deleted in the depot, or if you have changed your client mapping
so that files you previously synced are no longer in your client view, <b>sync</b>
removes those files from your workspace. If your workspace files are already
up to date with the depot, syncing does nothing.
<p>
The
"<img src="../icons/synced.gif">" and
"<img src="../icons/syncednone.gif">" icons mark workspace
files that are in sync with existing and deleted depot files,
respectively.
The "<img src="../icons/sync.gif">" icon marks files that are
not in sync with head revisions in the depot.
If you have "Show entire depot" set,
files previously synced but no longer mapped in your client
view are marked with "<img src="../icons/unmapped.gif">".
<p> If you have files open for edit or integrate, syncing does not remove or copy
over them. However, you won't be able to submit your open files until you've
<a href="resolve.html">resolved</a> changes from the newer files in the depot.
After you sync open files, they are marked with the "<img src="../icons/resolve.gif">"
icon to remind you they need to be resolved.
<p> Normally files synced to your workspace are read-only. Use <a href="edit.html">open
for edit</a> to make them writable.
<p> To sync files:
<p>
<ul>
<li>Select <b>Sync...</b> from the <b>Action</b> menu at the top of the <B>Files</B>
tab. P4Web displays the <a href="sync.html#options">Sync Options</a> page
where you can pick options and preview or run the the <b>sync</b> command.
</li>
<li>Click the <b>Sync to head revision</b> shortcut button. This shortcut syncs
the current path or file and syncs to head revisions without offering you
any options. </li>
</ul>
<p> <img src="../icons/runsync.gif" alt="Sync to Head Revisions"> <b>Sync to head revision</b>
shortcut button </p>
<a name=options></a> <b>The Sync Options Page</b>
<p> The Sync Options page lets you pick from these options before previewing or
running the <b>sync</b> command:
<table width="66%" border="1" cellpadding="1">
<tr>
<td><b>Head revision</b></td>
<td><b>Sync</b> to the head revisions (latest versions). </td>
</tr>
<tr>
<td><b>Revision number</b></td>
<td><b>Sync</b> to a specified revision.</td>
</tr>
<tr>
<td><b>Changelist Number</b></td>
<td><b>Sync</b> to a specified changelist number. Enter the changelist number
in the space provided. Syncing to a changelist number gets files that were
the head revisions in the depot at the time the changelist was submitted.
</td>
</tr>
<tr>
<td><b>Label or Date</b></td>
<td><b>Sync</b> to a specific symbolic revision revision (either a label or
date). Enter the label or date in the space provided. </td>
</tr>
<tr>
<td>
<p>
<dl>
<dt><b>Same Revision</b></dt>
</dl>
</td>
<td> <b>Sync</b> to the same revisions you already have in your workspace.
</td>
</tr>
<tr>
<td><b>Force</b></td>
<td>Gets fresh copies of files from the depot, even if the Perforce server
thinks you already have those files. Use this option to replace files that
were manually removed from your workspace. </td>
</tr>
</table>
<p> If you came to the <b>Sync Options page</b> with a directory selected, you
can <a href="restrictfiles.html">restrict</a> the files to be opened. Regardless
of which files you select, a file is only synced to your workspace if:
<p>
<ul>
<li>The file is not already opened in your workspace
<li>The file is in your client view
<li>You have permission to read the file
</ul>
<h3>Syncing and submitting from remote machines</h3>
<p>P4Web mediates between a Web browser and a Perforce server. You can run P4Web
on a machine that is separate from both the browser and server machines. When
using P4Web remotely, the important thing to understand is that <b>your workspace
resides on the machine where P4Web is running</b>, and <i>not</i> the machine
where the browser is running.
<p>P4Web enables you to edit text files directly in your browser, even when P4Web
is running on a remote machine. However, to edit binary files on a remote machine,
you must sync them, open them for edit, and then download them to your browser
machine. To submit edited files from a remote machine, you must upload them
to the workspace on the P4Web machine before submitting them.
<p><b>Downloading and uploading binary files: </b>
<ul>
<li> To download a file from the P4Web machine, right-click its link on the
<b>Revision History</b> page and choose your browser's <b>Save</b> option
(for example, <b>Save Target As...</b>) </li>
<li>To upload a file to the P4Web machine, choose the <b>Upload File to Workspace</b>
option from the drop-down list on the <b>Revision History</b> page, browse
to the file you want to upload, then click <b>Upload</b>. </li>
</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>