Specify mappings

Views consist of multiple mappings. Each mapping has two parts, with a blank space to separate them.

  • The left-hand side specifies one or more files in the depot and has the form: //depotname/file_specification
  • The right-hand side specifies one or more files in the client workspace and has the form: //clientname/file_specification

The left-hand side of a workspace view mapping is called the depot side, and the right-hand side is the client side.

To determine the location of any workspace file on your computer, substitute the client workspace root for the workspace name on the client side of the mapping. For example, if the workspace root is C:\bruno_ws, the file //JamCode/dev/jam/Jamfile resides in C:\bruno_ws\dev\jam\Jamfile.

Later mappings override earlier ones. In the example below, the second line overrides the first line, mapping the files in //Acme/dev/docs/manuals/ up two levels. When files in //Acme/dev/docs/manuals/ are synced, they reside in c:\bruno_ws\docs\.

View:
    //Acme/dev/...            //bruno_ws/dev/...
    //Acme/dev/docs/...       //bruno_ws/docs/...