  The CCmconvCA package deals with CCmbbsCA files in two forms - normal files and menu
  files.

  Normal files describe text to be displayed. They contain only text,
  attribute codes, datestamps and other special lines. Menu files, on the
  other hand, describe a menu which can contain text, menu options, submenus,
  and so on. They may therefore contain text, attributes, and menu code.

  These different kinds of "special" data are described below.

Message:

Subject: 2.1 Attribute codes

  Any text in any file may be highlighted in bold or reverse, underlined, or
  given a different colour. To do this, character sequences called Battributeb
  Bcodesb are used.

  An attribute code is an escape character (typically [B^[b] or [B^]b]) followed
  by another character signifying the attribute to be used. In general, an
  uppercase second character turns an attribute Bonb, and a lowercase character
  turns it Boffb. The exception to this rule is the colour attribute code, which
  is always uppercase [BCb].

  Attributes are automatically turned off at the end of each line, but it is
  good practice to turn them off explicitly anyway.

  For example, the following can be used to highlight some text:

   This is some ^]Bbold text^]b.

  This would be displayed as follows:

   This is some bold text.

  Full details of attribute codes are given later in this manual. See section
  Attribute List.

Message:

Subject: 2.2 Special lines

  Within text files, lines beginning in certain ways have special meanings.
  They are used to define datestamps (marking when entries were written, or
  simply dividing files into pieces), entry authors, subject headings, or
  message recipients.

2.2.1 CCMessageCA line

  Any line in a file which begins with the word "Message", followed by a colon
  (":"), will be expanded into a separator. If an 8-digit hexadecimal number
  follows, this separator will be a datestamp.

  For instance:

   aMessage: 36A3B6B4             (Mon Jan 18 22:33:24 1999)
foo
aMessage:

  ...is turned, by CCmconvCA and CCmviewCA, into:

   ----------------------------[Mon Jan 18 22:33:24 1999]--
foo
--------------------------------------------------------

  Note how any text after the 8-digit number is simply ignored. This number,
  incidentally, is simply the number of seconds since 1 January 1970, or the
  "Epoch"; it can be obtained by the C function CCtime()CA or by the GNU CCdateCA
  program with `date +%s'. You will then have to convert this number to
  hexadecimal.

  These separators are useful for marking divisions between entries in files;
  for instance, in a discussion file, they record where a new addition begins,
  and can also record the time it was added.

  A handy Unix command line utility for generating CCaMessage:CA lines for any
  given date is CCmtimeCA. See section 7. MTIME.

  Given a date as a parameter, CCmtimeCA will produce a datestamp line for that
  date; given no parameter, it produces a datestamp line for the current date.
  Invalid dates produce blank separators.

  Adding entries to files with the [BAb] key, in CCmviewCA (see section 4. MVIEW),
  automatically prefixes your text with a datestamp.

2.2.2 CCFromCA line

  Lines beginning with CCaFrom:CA mark the author of an entry in a file, and
  should go just after a datestamp line (see section 2.2.1 CCMessageCA line).

  The text CCaFrom:CA (including the colon and a trailing space) should be
  followed by descriptive text known as the Bnamelineb - usually the author's
  real name - and ends with their username in brackets.

  This information is used to determine who wrote an entry, and the username
  is also used when indexing files with the [BIb] key in CCmviewCA.

  If a file is marked as "anonymous", then when it is viewed the username is
  automatically stripped so that the viewer cannot see who wrote the entry.
  Note that the nameline is still visible, so it should be left blank in
  anonymous files if you wish to remain anonymous.

  When being viewed, all text after the word CCaFrom:CA is shown in bold green to
  distinguish it from the body of the message.

  CCaFrom:CA lines are automatically added just after the datestamp when adding
  an entry with the [BAb] key in CCmviewCA.

2.2.3 CCSubjectCA line

  Any text following a line beginning with CCaSubject:CA will be highlighted in
  underlined cyan automatically, to distinguish it from the body of the
  message. Thus there is no need to add attributes (see section 2.1 Attribute
  codes) to outline your headings.

2.2.4 CCToCA line

  Lines beginning with CCaTo:CA mark a list of recipients for a message, and
  should normally go on the line after a CCaFrom:CA line (see section 2.2.2 CCFromCA
  line). The word CCaTo:CA should be followed by one or more bracketed usernames,
  which will be shown in green.

Message:

Subject: 2.3 Menus

  Menus are generated from text files which contain menu commands and entry
  specifiers.

  The entry specifiers say what a menu entry's name is, its keypress, and what
  action to take when it is selected; the menu commands determine which parts
  of the menu are visible to which users, and what permissions those users
  will have in terms of modifying files.

  A menu command is indicated by prefixing it with a dot (CC.CA). More specific
  information about menu code is given later in this manual. See section 10.
  Menu Code.

Message:

Subject: 2.4 Last Access

  When using the file viewer CCmviewCA and the BBS system CCmbbsCA, it is possible to
  record the position you were last at when reading files, so that at any time
  you may quit and come back later exactly where you left off.

  This "bookmarking" of your position is done automatically, provided your
  last access database has been set up properly (see section 4.3 Last Access
  Database). Your last access database, or LDB, also stores information about
  subscription to menus and files (see section 4.5 Scanning).

  If you are a user of the CCmbbsCA BBS system, then you shouldn't have to worry
  about setting up your LDB; you just need to know it exists, and the BBS
  administrator should have sorted everything else out.

