Man Page sbenter.1

NAME

     sbenter - generate SourceBrowser database with more  general
     information

SYNOPSIS

     sbenter [ -help ] [ -verbose ] [ -version ]  filename

AVAILABILITY

     Available with ANSI C and Sun FORTRAN, C++, and Assembler.

DESCRIPTION

     Sbenter is a generic program that provides an  ASCII  inter-
     face  for  the  creation of .bd files (for the SourceBrowser
     database).  Sbenter is currently used  by  sbtags;  See  the
     manual page for this program.

     The format is a collection  of  lines  in  which  each  line
     starts  with  a character describing the action and may con-
     tain some additional  arguments.   Whitespace  delimits  the
     arguments;  backslash  `\'  can be used to quote whitespace,
     including newlines.

     The implemented operators are described below.  The L opera-
     tor  must  be  the  first  line in the input and must not be
     repeated.

     S <symbol> <line#> <semtag#>
     S <symbol> <line#> <semtag-id>
     The S operator is used to insert a symbol with  a  line  and
     semantic tag value.

     L <language-name>
     The L operator is used to describe the language to  be  used
     in creating the BD file

     P <filename>
     The P operator is used to denote the beginning  of  a  file.
     It must be matched with a Z operator.

     Z
     The Z operator closes a file started with the P operator.

     H <Nelems> <nchars-1> <hash-1> ... <nchars-N> <hash-N>
     The H operator  is  used  to  provide  the  hash  value  for
     <Nelems> lines.

     A <from-descr-name> <from-name> <arc-descr-name>  <to-descr-
     name> <to-name> <line#>
     The I operator is used to describe an arc.

     F <descr-name> <name> <start-line#> <end-line#>
     The F operator is used to describe a focus unit.
     # <text>
     The # operator is used to describe a comment.

OPTIONS

     None

EXAMPLE

     Below are listed the contents of a sample file, (ex.c) and a
     corresponding input file to sbenter that would describe some
     useful data for this file.

     ex.c:
     main() {
          int i;
     }

     ex.c.data:
     L ansi_c
     P ex.c
     F Function main 1 4
     S main 1 cb_c_def_global_func_w_body
     H 4 8 657 7 536 1 125 0 0
     F Source_File ex.c 1 4
     Z

FILES

SEE ALSO

     sbcleanup(1), sbquery(1), sbtags(1), sbinit(4).