02.05.2013 Views

Description - Mks.com

Description - Mks.com

Description - Mks.com

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

si createsandbox<br />

creates a new sandbox on your local machine<br />

SYNOPSIS<br />

si createsandbox [(-R|--[no|confirm]recurse)] [--lineTerminator=[lf|crlf|native]]<br />

[--[no]populate] [--[no]sparse] [--[no]openView] [--[no]shared]<br />

[(-Pproject|--project=project)] [--devpath=path] [--projectRevision=rev]<br />

[--hostname=server] [--port=number] [--password=password] [--user=name]<br />

[(-?|--usage)] [(-F file|--selectionFile=file)] [(-N|--no)] [(-Y|--yes)] [--[no]batch]<br />

[--cwd=directory] [--forceConfirm=[yes|no]] [(-g|--gui)] [--quiet]<br />

[--settingsUI=[gui|default]] [--status=[none|gui|default]] [--xmlapi] directory<br />

DESCRIPTION<br />

si createsandbox creates a new sandbox on the client machine in a specified directory. When<br />

creating a sandbox you are able to determine the type of sandbox you want it to be:<br />

● The default regular type creates a sandbox based upon the current state of the project.<br />

● Choosing to create a variant creates a sandbox based upon a specific revision of the<br />

master project and is used for branching off the main development path. You first have to<br />

specify a development path other than the default one; to create a development path, see<br />

the si createdevpath <strong>com</strong>mand.<br />

● You may also choose to create a build sandbox. A build sandbox creates a static sandbox<br />

based upon a specific revision of the master project that is used for building or testing the<br />

project, but not for further development.<br />

Variant Sandboxes and Development Paths<br />

By default, si createsandbox creates regular sandboxes that are based upon the current state<br />

of the project. You can also create a variant sandbox, a sandbox that is based upon a previously<br />

checkpointed revision of the project. When you create a variant sandbox, you choose a checkpoint<br />

(snapshot) of your project and use it as a starting point for new development. MKS Source Integrity<br />

allows you to do this by defining a new development path and then specifying that path with the<br />

--devpath option. For example:<br />

si createsandbox --devpath=MyVariant<br />

A development path is an identifier given to a new direction of software development. Changes<br />

made through the development path are kept separate from the main development trunk unless<br />

you choose to merge them (see si merge) into it later. Source Integrity allows multiple<br />

developers to point to the same development path, each using their own variant sandbox. In the<br />

86 of 457

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!