Unix‎ > ‎Solaris‎ > ‎Solaris man pages‎ > ‎1‎ > ‎


     vc - version control

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

     This command is obsolete and will be  removed  in  the  next

     The vc command copies lines from the standard input  to  the
     standard  output  under  control  of  its   arguments and of
     ``control statements'' encountered in the standard input. In
     the  process of performing the copy operation, user-declared
     keywords 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 9 or less 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 \.

     The following options are supported:

     -a       Forces replacement of keywords surrounded  by  con-
              trol  characters  with  their assigned value in all
              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 nor-
              mally printed on the diagnostic output.

     vc recognizes the following version control statements:

     :dcl keyword[, ..., keyword]    Declare keywords.  All  key-
                                     words 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 pre-
                                     vious   asg  statements  for
                                     that keyword. Keywords  that
                                     are  declared  but  are  not
                                     assigned  values  have  null

     :if condition                   Skip lines of  the  standard
     ...                             input.   If the condition is
     :end                            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:  Interven-
                                     ing if statements and match-
                                     ing   end   statements   are
                                     recognized  solely  for  the
                                     purpose  of  maintaining the
                                     proper if-end matching.

                                     The syntax  of  a  condition

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

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

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

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

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

                                     <value>         ::=   <arbi-
                                                     trary  ASCII
                                                     string>    |

                                     The available operators  and
                                     their meanings are:

                                     =        equal

                                     !=       not equal

                                     &        and

                                     |        or

                                     >        greater than

                                     <        less than

                                     ()       used  for   logical

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

                                     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

                                     The precedence of the opera-
                                     tors    (from   highest   to
                                     lowest) is:

                                     = != > <        all of equal



                                     Parentheses may be  used  to
                                     alter   the  order  of  pre-

                                     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  sur-
                                     rounded  by  control charac-
                                     ters in text are replaced by
                                     their  value before the line
                                     is  copied  to  the   output
                                     file.    This    action   is
                                     independent   of   the    -a

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

     :ctl char                       Change the control character
                                     to char.

     :msg message                    Print message on  the  diag-
                                     nostic 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.

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

    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    | Availability                | SUNWsprot                   |

     ed(1), attributes(5)

Man pages from Solaris 10 Update 8. See docs.sun.com and www.oracle.com for further documentation and Solaris information.