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.

<strong>com</strong>mand's format. For example, here is the synopsis of the si add <strong>com</strong>mand.<br />

si add [--archive=filename] [--author=name] [(--binaryFormat|--textFormat)]<br />

[(--cpid ID|--changePackageId=ID)] [--[no]defer] [--[no|confirm]closeCP]<br />

[--issueId=ID] [--description=desc] [--descriptionFile=file] [--issueId=ID]<br />

[(-l|--lock)] [--onExistingArchive=[confirm|sharearchive|newarchive|cancel]]<br />

[--[no]createSubprojects] [--[no]retainWorkingFile] [--[no]saveTimestamp]<br />

[--[no]unexpand] [(-r rev|--revision=rev)] [(-R |--[no|confirm]recurse)]<br />

[(-S sandbox|--sandbox=sandbox)] [--hostname=server] [--port=number]<br />

[--password=password] [--user=name] [--cwd=directory] [(-F file|--selectionFile=file)]<br />

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

[--settingsUI=[gui|default]] [--status=[none|gui|default]] [(-?|--usage)] [(-Y|--yes)]<br />

nonmember...<br />

The synopsis takes the form of a <strong>com</strong>mand line as you might type it into the system; it shows what<br />

you can type in and the order in which you should do it. The parts that are enclosed in square<br />

brackets are optional; you may omit them if you choose. Parts that are not enclosed in square<br />

brackets must be present for the <strong>com</strong>mand to be correct.<br />

The synopsis begins with the name of the <strong>com</strong>mand itself. The Source Integrity <strong>com</strong>mands all<br />

include the si prefix. In Source Integrity documentation, <strong>com</strong>mand names are always written in<br />

bold Courier font.<br />

After the <strong>com</strong>mand name <strong>com</strong>es a list of options. A typical Source Integrity <strong>com</strong>mand option<br />

consists of either a single dash (-) followed by a single character, usually an uppercase or<br />

lowercase letter, or it may consist of a double dash (--) followed by a multi-character option name.<br />

Often there are single-character and multi-character options that do the same thing. The multicharacter<br />

strings are not case sensitive, but are shown in mixed case to facilitate readability. For<br />

example, you might have -L or --label.<br />

The synopsis line shows options in bold Courier font. Note that the case of single-character<br />

options is important; for example, in the synopsis of si add, -r and -R are different options, with<br />

different effects.<br />

Furthermore, in the synopsis all options are shown in one long string. Other <strong>com</strong>mon option forms<br />

are:<br />

-r rev<br />

--revision=rev<br />

where rev or, in some cases, value provides extra information for using that option. For example,<br />

the si lock <strong>com</strong>mand locks sandbox members; here's the <strong>com</strong>mand's synopsis:<br />

7 of 457

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

Saved successfully!

Ooh no, something went wrong!