02.05.2013 Views

User Guide - Mks.com

User Guide - Mks.com

User Guide - 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.

Using Keywords<br />

graphical user interface can override the default settings. For information<br />

on setting <strong>com</strong>mand keyword options, see “Command Preferences” on<br />

page 48.<br />

For information on setting the keyword options for individual <strong>com</strong>mands,<br />

see Source Integrity Enterprise Edition CLI Reference <strong>Guide</strong> or man pages.<br />

Keyword expansion applies to text files only. It is disabled for binary files.<br />

Text before and after the keyword is preserved, making it suitable for use<br />

within expressions, as above, and within <strong>com</strong>ments.<br />

If keyword expansion is enabled and you are checking out a text file that<br />

contains the string<br />

$Revision$<br />

Source Integrity, when it encounters this string, automatically adds the<br />

value of the keyword $Revision$ in the format<br />

where<br />

$Revision: value $<br />

value is the appropriate value of the keyword (in this case, the revision<br />

number).<br />

For example, including the statement<br />

char revnum[] = "$Revision$";<br />

in a C source file creates a character string named revnum containing the<br />

file’s revision number. The program can then be configured to display this<br />

string when it starts up, automatically presenting the current revision of<br />

the program’s source file.<br />

Using the $Revision$ keyword to obtain the revision number of a file is<br />

one of the <strong>com</strong>mon applications of keywords. Other <strong>com</strong>mon applications<br />

include:<br />

The $Header$ keyword provides a one-line summary of useful<br />

information associated with a revision. Including this information in a<br />

<strong>com</strong>ment makes the information available to anyone looking at the<br />

member.<br />

The $Log$ keyword supplies the same sort of information as<br />

$Header$ plus the revision description. The $Log$ keyword provides<br />

a <strong>com</strong>plete list of changes that are made to the member over time.<br />

209

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

Saved successfully!

Ooh no, something went wrong!