Intel XENIX 286 Programmers Guide (86) - Tenox.tc

Intel XENIX 286 Programmers Guide (86) - Tenox.tc Intel XENIX 286 Programmers Guide (86) - Tenox.tc

09.06.2013 Views

XENIX Programming SCCS: Source Code Control System Setting s-file Flags You can set the flags in a given s-file by using the -f option of the admin command. The command has the form admin -fflag s. filename where -f(lag gives the flag to be set, and s.filename gives the name of the s-file in which the flag is to be set. For example, the command admin -fi s.demo.c sets the i flag in the s-file s.demo.c. Note that some s-file flags take values when they are set. For example, the m flag requires that a module name be given. When a value is required, it must immediately follow the flag name as in the command admin -fmdmod s.demo.c which sets the m flag to the module name "dmod". Using the i Flag The i flag causes the admin and delta commands to print a fatal error message and stop if no keywords are found in the given text file. The flag is used to prevent a file version that contains expanded keywords from being saved as a new version. (Saving an expanded version destroys the keywords for all subsequent versions.) When the i flag is set, each new version of a file must contain at least one keyword. Otherwise, the version cannot be saved. Using the d Flag The d flag gives the default SID for versions retrieved by the get command. The flag takes an SID as its value. For example, the command ad min -fd 1.1 s.demo.c sets the default SID to 1.1. A subsequent get command that does not use the -r option will retrieve version 1.1. 5-15

SCCS: Source Code Control System XENIX Programming Using the v Flag The v flag allows you to include modification requests in an s-file. Modification requests are names or nu mbers that may be used as a shorthand method to indicate the reason for each new version. When the v flag is set, the delta command asks for the modification requests just before asking for comments. The v flag also allows the -m option to be used in the delta and admin commands. Removing an s-file Flag You can remove an s-file flag from an s-file by using the -d option of the admin command. The command has the form admin -df/ag s. filename where -dflag gives the name of the flag to be removed and s.filename is the name of the s-file from which the flag is to be removed. For example, the command admin -di s.demo.c removes the i flag from the s-file s.demo.c. When removing a flag that takes a value, only the flag name is required. For example, the command admin -dm s.demo.c removes the m flag from the s-file. The -d option and the -i ("initialize") option must not be used at the same time. Modifying s-file Information Every s-file contains information about the deltas it contains. Normally, this information is maintained by the SCCS commands and is not directly accessible by the user. Some information, however, is specific to the user who creates the s-file and may be changed as desired to meet the user's requirements. This information is kept in two special parts of the s-file called the delta table and the description field. The delta table contains information about each delta, such as the SID and the date and time of creation. It also contains user-supplied information, such as comments and modification requests. The description field contains a user-supplied description of the s-file and its contents. Both parts can be changed or deleted at any time to reflect changes to the s-file contents. 5-16

<strong>XENIX</strong> Programming SCCS: Source Code Control System<br />

Setting s-file Flags<br />

You can set the flags in a given s-file by using the -f option of the admin command. The<br />

command has the form<br />

admin -fflag s. filename<br />

where -f(lag gives the flag to be set, and s.filename gives the name of the s-file in<br />

which the flag is to be set. For example, the command<br />

admin -fi s.demo.c<br />

sets the i flag in the s-file s.demo.c.<br />

Note that some s-file flags take values when they are set. For example, the m flag<br />

requires that a module name be given. When a value is required, it must immediately<br />

follow the flag name as in the command<br />

admin -fmdmod s.demo.c<br />

which sets the m flag to the module name "dmod".<br />

Using the i Flag<br />

The i flag causes the admin and delta commands to print a fatal error message and stop<br />

if no keywords are found in the given text file. The flag is used to prevent a file version<br />

that contains expanded keywords from being saved as a new version. (Saving an<br />

expanded version destroys the keywords for all subsequent versions.)<br />

When the i flag is set, each new version of a file must contain at least one keyword.<br />

Otherwise, the version cannot be saved.<br />

Using the d Flag<br />

The d flag gives the default SID for versions retrieved by the get command. The flag<br />

takes an SID as its value. For example, the command<br />

ad min -fd 1.1 s.demo.c<br />

sets the default SID to 1.1. A subsequent get command that does not use the -r option<br />

will retrieve version 1.1.<br />

5-15

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

Saved successfully!

Ooh no, something went wrong!