unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



sccsfile(4)							  sccsfile(4)



NAME
  sccsfile - Contains Source Code Control System (SCCS)	information

SYNOPSIS

  sccsfile

DESCRIPTION

  The sccsfile file is a text file consisting of six logical parts: checksum,
  delta	table, user names, flags, comments, and	body.

  Note that there are lines throughout an SCCS file that begin with the	ASCII
  SOH (start of	heading) character (octal 001).	 This character	is called the
  control character and	is represented graphically as an @ (at sign) in	the
  following text.

  Checksum


  The checksum is the first line of an SCCS file.  The value of	the checksum
  is the sum of	all characters,	except those of	the first line.

  The format of	the line is @hDDDDD.

  DDDDD	is the serial number corresponding to the delta	for the	control	line
  (a 5-digit string from 00000 to 99999).  @h designates a magic number	of
  064001 octal (or 0x6801).

  Delta	Table


  The delta table provides information about each delta	including type,	SCCS
  identification (SID),	date and time of creation, and comments.

  The delta table consists of a	variable number	of entries such	as the fol-
  lowing:

  @s DDDDD/DDDDD/DDDDD
      Contains the number of lines inserted or deleted or unchanged, respec-
      tively.

  @d<type> <SID> yy/mm/dd hh:mm:ss <user> DDDDD	DDDDD
      where:

	+  type	is the type of delta, with D designating a normal delta	and R
	   designating a removed delta.

	+  SID is the SCCS identification of the delta.

	+  yy/mm/dd hh:mm:ss is	the date and time the delta was	created.  If
	   yy is 69 to 99, the year is interpreted as being in the twentieth
	   century, i.e. 19yy.	Otherwise, the year is interpreted as being
	   in the twenty-first century,	i.e. 20yy.

	+  user	is the username	that corresponds to the	real user ID at	the
	   time	the delta was created.

	+  DDDDD is the	serial number of the delta and its predecessor,
	   respectively.

  @i DDDDD
      Contains the serial numbers of the deltas	included.  This	line is
      optional.

  @x DDDDD
      Contains the serial numbers of deltas excluded.  This line is optional.

  @g DDDDD
      Contains the serial numbers of the deltas	ignored.  This line is
      optional.

  @m<&lt;MR_number>&gt;
      Contains a modification request (MR) number associated with the delta,
      one MR number per	line.  These lines are optional.

  @c<&lt;comment>&gt;
      Contains comment lines associated	with the delta.

  @e  Ends the delta table entry.

  User Names


  The user names section contains user names and numerical group IDs of	users
  who are allowed to add or remove deltas from the SCCS	file, separated	by
  newline characters.  The bracketing lines @u and @U surround the lines con-
  taining the list.  An	empty list allows any user to make a delta.

  Flags


  The flags section contains definitions of internal keywords.

  Comments


  The comments section contains	descriptive information	about the file.	 Typ-
  ically, this section contains	a description of the purpose of	the file.
  Bracketing lines @t and @T surrounding text designate	the Comments section.

  Body


  The body contains the	actual text lines, intermixed with control lines.
  Control lines	begin with a control character,	text lines do not.  There are
  three	kinds of control lines:	 insert, delete, and end, represented by:

       @I DDDDD

       @D DDDDD

       @E DDDDD

  The digit string is the serial number	corresponding to the delta for the
  control line.



  Keywords


  Keywords are used internally in the system.  For more	information about
  their	use, see the admin(1) reference	page.  The format of each line is as
  follows:

       @f <&lt;character>&gt; <&lt;optional	text>&gt;

  The following	keywords are defined:

  @f t
      <type of program>

  @f v
      <program name>

  @f i

  @f b

  @f m
      <module name>

  @f f
      <floor>

  @f c
      <ceiling>

  @f d
      <default SID>

  @f n

  @f j

  @f l
      <lock releases>

  @f q
      <user defined>

  The characters are used as follows:

  b   Allows the use of	the -b flag on the get command to cause	a branch in
      the delta	tree.

  c   Defines the highest release number, less than or equal to	9999, that
      can be retrieved by a get	command	for editing.  This release number is
      called the ceiling release number.

  d   Defines the default SID to be used when one is not specified with	a get
      command.

  f   Defines the lowest release number	between	0 and 9999, that can be
      retrieved	by a get command for editing.  This release number is called
      the floor	release	number.

  i   Controls the error warning message No ID keywords.  When this character
      is not present, this message is only a warning.  When this character is
      present, the file	is not used and	the delta is not made.

  j   Causes the get command to	allow concurrent edits of the same base	SID.

  l   Defines a	list of	releases that cannot be	edited with get	using the -e
      flag.

  m   Defines the first	choice for the replacement text	of the %@M% identifi-
      cation keyword.

  n   Causes the delta command to insert a delta that applies no changes for
      those skipped releases when a delta for a	new release is made.  For
      example, delta 5.1 is made after delta 2.1, skipping releases 3 and 4.
      When this	character is omitted, it causes	skipped	releases to be com-
      pletely empty.

  q   Defines the replacement for the %Q% identification keyword.

  t   Defines the replacement for the %Y% identification keyword.

  v   Controls prompting for MR	numbers	in addition to comments.  If optional
      text is present, it defines an MR	number validity	checking program.

RELATED	INFORMATION

  Commands:  admin(1), cdc(1), comb(1),	delta(1), get(1), prs(1), rmdel(1),
       sact(1),	sccsdiff(1), sccshelp(1), unget(1), val(1), what(1).