Managing workspace specifications

A workspace specification defines which portion of the depot can be accessed from that workspace and specifies the location where local copies of files in the depot are stored. This location is called the workspace. A computer can contain multiple workspaces. The mapping of depot files to local files is called the workspace view. P4V enables you to define the workspace view graphically; see Defining a workspace view for details.

To change the workspace you are using, choose Connection>Open Connection... and specify the desired workspace in the Workspace field.

To view all of the workspaces for the server to which you are connected, go to View> Workspaces. Details about each selected workspace appear at the bottom of the pane. Double-click the desired workspace to view the details in a separate Details tab.

To create a new workspace:
  1. Go to Connection> New Workspace... The New Workspace dialog is displayed.
  2. Enter the name of the new workspace and click OK. The Workspace form is displayed in the Details tab.
  3. Enter the required information as follows:
  4. Workspace: The name of the new workspace specification.
    Owner: The user that created the specification.
    Host: (optional) The computer where the workspace resides.
    Description: (optional) Your description of the workspace specification.
    Root: Specifies the top level of the workspace; the lowest-level folder that includes all the files and folders that you'll be working with. Use platform-specific syntax to specify this folder.
    AltRoots: For workspace specifications used from hosts on different platforms, a list of workspace roots in host-platform-specific syntax.
    Options
    • ALLWRITE: All files in the workspace are writable (can be modified).
    • CLOBBER:   Syncing files overwrites writable files on the workspace.
    • COMPRESS:   Compresses data sent between the workspace and the Perforce server.
    • LOCKED: Allows only the owner to use, change, or delete the workspace specification.
    • MODTIME: Modification time for files edited in the client workspace is set to the time when the file is submitted to the depot.
    • RMDIR: Deletes a workspace folder if all the files contained in the folder are removed.
    LineEnd The line-end convention used for storing text files on the workspace computer:
    • LOCAL: Uses the workspace platform default
    • UNIX: LF
    • MAC: CR
    • WIN: CRLF
    • SHARE: Line endings are LF. Any CR prior to a line ending is removed for storage or syncing (for disks shared between UNIX and Windows)
    View Describes which files and folders in the depot are available to the workspace, and where the files in the depot are located within the workspace. For details, see the next section, "Defining a workspace view."
  5. Click Save to save your entries and create the workspace specification.
Note: you cannot delete your current workspace specification in P4V.