HP-UX Reference (11i v1 00/12) - 1 User Commands N-Z (vol 2)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1/neqn.1
________________________________________________________________
___ ___
v
vc(1) vc(1)
NAME
vc - substitutes assigned values in place of identification keywords
SYNOPSIS
vc [-a][-t][-c char ][-s][keyword=value ... keyword=value ]
DESCRIPTION
The vc,orversion control command copies lines from the standard input to the standard output under con-
trol of command line arguments and control statements encountered in the standard input. In the process
of performing the copy operation, user declared keywords can be replaced by their string value when they
appear in plain text and/or control statements. The copying of lines from the standard input to the stan-
dard output is conditional, based on tests of keyword values specified in control statements or on vc com-
mand arguments.
Replacement of keywords by values is done whenever a keyword surrounded by control characters is
encountered on a version control statement. The -a option forces replacement of keywords in all lines of
text. An uninterpreted control character can be included in a value by preceding it with \. If a literal \ is
desired, it too must be preceded by \.
The vc command is part of the SCCS (Source Code Control System) command suite.
Options
vc recognizes the following options and arguments:
-a Replace keywords surrounded by control characters with their assigned value in all text
lines and not just in
vc statements.
-t Ignore all characters from the beginning of a line up to and including the first tab character
for the purpose of detecting a control statement. If one is found, all characters up to and
including the tab are discarded.
-cchar Specify a control character to be used in place of :.
-s Silence warning messages (not errors) that are normally printed on the diagnostic output.
Control Statements
A control statement is a single line beginning with a control character, and the default control character is
colon (:) (Unless the -t and -c options are used [See above]). Input lines beginning with a backslash (
\)
followed by the control character are not control lines, and are copied to the standard output with the
backslash removed. Lines beginning with a backslash followed by a non-control character are copied in
their entirety.
A keyword is composed of 9 or fewer alphanumeric characters of which the first character is alphabetic. A
value is any
ASCII string that can be created using ed (see ed(1)); a numeric value is an unsigned string of
digits. Keyword values must not contain spaces or tabs.
Version control statements occur in the following forms:
:dcl keyword[, ..., keyword]
Used to declare keywords. All keywords must be declared.
:asg keyword=value
Used to assign values to keywords. An
asg statement overrides the assignment
for the corresponding keyword on the
vc command line and all previous asgs for
that keyword. Keywords declared, but not assigned values have null values.
:if condition
...
:
end Used to skip lines of the standard input. If the condition is true, all lines between
the if statement and the matching end statement are copied to the standard out-
put. If the condition is false, all intervening lines are discarded, including control
statements. Note that intervening if statements and matching end statements are
recognized solely for the purpose of maintaining the proper if-end matching.
HP-UX Release 11i: December 2000 − 1 − Section 1−−987
___
___