User Commands                                               vc(1)


NAME

     vc - version control


SYNOPSIS

     vc [-a] [-t] [-c char] [-s] [keyword=value... keyword=value]


DESCRIPTION

     The vc command copies lines from the standard input  to  the
     standard output under control of its arguments and of ``con-
     trol statements'' encountered in the standard input.  In the
     process of performing the copy operation, user-declared key-
     word may 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 standard
     output  is  conditional,  based  on tests (in control state-
     ments) of keyword values specified in control statements  or
     as vc command arguments.

     A control statement is a single line beginning with  a  con-
     trol  character, except as modified by the -t keyletter (see
     below).  The default control character is colon (:),  except
     as  modified  by  the -c keyletter (see below).  Input lines
     beginning with a backslash (\) followed by a control charac-
     ter  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 alphanumerics; the  first  must  be
     alphabetic.  A value is any ASCII string that can be created
     with ed; a numeric value is an unsigned  string  of  digits.
     Keyword values may not contain blanks or tabs.

     Replacement of keywords by values is done whenever a keyword
     surrounded by control characters is encountered on a version
     control statement.  The  -a  keyletter  (see  below)  forces
     replacement  of  keywords in all lines of text.  An uninter-
     preted control character may  be  included  in  a  value  by
     preceding it with \.  If a literal \ is desired, then it too
     must be preceded by \.


OPTIONS

     The following options are supported:

     -a        Forces replacement of keywords surrounded by  con-
               trol  characters  with their assigned value in all

SunOS 5.11           Last change: 2015/04/29                    1


User Commands                                               vc(1)

               text lines and not just in vc statements.

     -t        All characters from the beginning of a line up  to
               and  including the first tab character are ignored
               for the purpose of detecting a control  statement.
               If a control statement is found, all characters up
               to and including the tab are discarded.

     -cchar    Specifies a control character to be used in  place
               of the ``:''  default.

     -s        Silences warning messages  (not  error)  that  are
               normally printed on the diagnostic output.

     vc recognizes the following version control statements:

     :dcl keyword[, ..., keyword]
         Declare keywords.  All keywords must be declared.

     :asg keyword=value
         Assign values to keywords.  An asg  statement  overrides
         the  assignment  for the corresponding keyword on the vc
         command line and all previous asg  statements  for  that
         keyword.    Keywords  that  are  declared  but  are  not
         assigned values have null values.

     :if condition
     ...
     :end
         Skip lines of the standard input.  If the  condition  is
         true,  all lines between the if statement and the match-
         ing end statement are copied to the standard output.  If
         the  condition  is false, all intervening lines are dis-
         carded, including control statements.  Note: Intervening
         if statements and matching end statements are recognized
         solely for the purpose of maintaining the proper  if-end
         matching.

         The syntax of a condition is:

         <cond>     ::=  [ ``not'' ] <or>

         <or>       ::=  <and> | <and> ``|'' <or>

SunOS 5.11           Last change: 2015/04/29                    2


User Commands                                               vc(1)

         <and>      ::=  <exp> | <exp> ``&'' <and>

         <exp>      ::=  ``('' <or> ``)'' | <value> <op> <value>

         <op>       ::=  ``='' | ``!='' | ``<'' | ``>''

         <value>    ::=   <arbitrary  ASCII  string>  |  <numeric
                    string>

         The available operators and their meanings are:

         =      equal

         !=     not equal

         &      and

         |      or

         >      greater than

         <      less than

         ()     used for logical groupings

         not    may only occur immediately after the if, and when
                present,  inverts  the value of the entire condi-
                tion

         The > and < operate only on unsigned integer values (for
         example, : 012 > 12 is false).  All other operators take
         strings as arguments (for example, : 012 != 12 is true).

         The precedence of the operators (from highest to lowest)
         is:

         = != > <    all of equal precedence

         &

SunOS 5.11           Last change: 2015/04/29                    3


User Commands                                               vc(1)

         |

         Parentheses may be used  to  alter  the  order  of  pre-
         cedence.

         Values must be separated from operators  or  parentheses
         by at least one blank or tab.

     ::text
         Replace keywords on lines that are copied to  the  stan-
         dard  output.   The  two  leading control characters are
         removed, and keywords surrounded by  control  characters
         in  text  are replaced by their value before the line is
         copied to the output file.  This action  is  independent
         of the -a keyletter.

     :on
     :off
         Turn on or off keyword replacement on all lines.

     :ctl char
         Change the control character to char.

     :msg message
         Print message on the diagnostic output.

     :err message
         Print message followed by:

               ERROR: err statement on line ... (915)

         on the  diagnostic  output.   vc  halts  execution,  and
         returns an exit code of 1.


ENVIRONMENT VARIABLES

     See environ(5) for descriptions of the following environment
     variables that affect the execution of vc(1):  LANG, LC_ALL,
     LC_CTYPE, LC_MESSAGES, and NLSPATH.

     SCCS_NO_HELP
          If set, vc(1) will not automatically call help(1)  with
          the  SCCS  error  code in order to print a more helpful
          error message. Scripts that depend on the  exact  error
          messages  of  SCCS  commands should set the environment
          variable SCCS_NO_HELP and set LC_ALL=C.

SunOS 5.11           Last change: 2015/04/29                    4


User Commands                                               vc(1)


EXIT STATUS

     The following exit values are returned:

     0    Successful completion.

     1    An error occurred.


FILES

     dump.core
          If the file dump.core exists in the  current  directory
          and a fatal signal is received, a coredump is initiated
          via abort(3).


ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWsprot                   |
    |_____________________________|_____________________________|


SEE ALSO

     ed(1), attributes(5).

SunOS 5.11           Last change: 2015/04/29                    5


Man(1) output converted with man2html


FhG Schily's Home VED powered