Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
vc(1)				 User Commands				 vc(1)

       vc - version control

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

       The  vc	command	 copies	 lines from the	standard input to the standard
       output under control of its arguments and of ``control statements'' en-
       countered in the	standard input.	 In the	process	of performing the copy
       operation, user-declared	keyword	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 statements) of  keyword	values
       specified in control statements or as vc	command	arguments.

       A  control  statement is	a single line beginning	with a control charac-
       ter, 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	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 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 uninterpreted	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 control charac-
		 ters 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 includ-
		 ing 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  dis-

       -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 assign-
	   ment	for the	corresponding keyword on the vc	command	line  and  all
	   previous  asg  statements  for that keyword.	 Keywords that are de-
	   clared but are not assigned values have null	values.

       :if condition
	   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 output.  If the condition is false, all  in-
	   tervening lines are discarded, including control statements.	 Note:
	   Intervening if statements and matching end  statements  are	recog-
	   nized  solely  for  the  purpose  of	 maintaining the proper	if-end

	   The syntax of a condition is:

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

	   <or>	      ::=  _and_ | _and_ ``|'' _or_

	   <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 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	true).

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

	   = !=	> <    all of equal precedence



	   Parentheses may be used to alter the	order of precedence.

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

	   Replace keywords on lines that are copied to	the  standard  output.
	   The	two  leading control characters	are removed, and keywords sur-
	   rounded by control characters in text are replaced by  their	 value
	   before the line is copied to	the output file.  This action is inde-
	   pendent of the -a keyletter.

	   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.

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

	      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

       The following exit values are returned:

       0    Successful completion.

       1    An error occurred.

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

       See attributes(5) for descriptions of the following attributes:

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

       ed(1), attributes(5).

       A frequently updated source code	for the	SCCS suite is included in  the
       schilytools  project  and may be	retrieved from the schilytools project
       at Sourceforge at:

       The download directory is:

       Check for the schily-*.tar.bz2 archives.

       Less frequently updated source code for the SCCS	suite is at:

       Separate	project	informations for the SCCS  project  may	 be  retrieved

SunOS 5.11			  2018/12/18				 vc(1)


Want to link to this manual page? Use this URL:

home | help