Man Page sbtags.1

NAME

     sbtags - create database files for the Source Browsing  mode
     of WorkShop

SYNOPSIS

     sbtags [-V] file ...

AVAILABILITY

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

DESCRIPTION

     sbtags was derived from the etags utility, which was derived
     from the ctags utility.

     sbtags creates .bd data for  the  Source  Browsing  mode  of
     WorkShop.   It  collects the locations of the definitions of
     named objects (functions, variables,  macros,  types)  in  a
     group of source files.

     sbtags collects the same definition data as etags but stores
     it in a different format.  It also collects basic call graph
     data for C and C++.

     The following filename extensions are understood:

     .c  .h  .y  .C  .H  .cxx  .hxx  .ixx  .hc  .cc  .hpp  .cpp
               C or C++ source files.

     .tex  .aux  .bbl
               LaTex source files.

     .s  .a    Assembly language source files.

     .l  .el  .lisp  .cl  .clisp
               Emacs Lisp or Common Lisp source files.

     .scm  .sm  .scheme  .SM  .SCM  .scm.n  .SCM.n
               Scheme source files.

     Other files are examined to see if they contain  any  Pascal
     or  Fortran routine definitions; if not, they are reexamined
     for C or C++ definitions.

OPTIONS

     -v   display version information.

ENVIRONMENT VARIABLES

     TEXTAGS   additionalcontrolsequencesforLaTex

SEE ALSO

     ctags(1)  etags(1)  sbcleanup(1),  sbquery(1),  workshop(1),
     sbinit(4).

AUTHOR

     Ken Arnold wrote ctags.  Contributors include Jim  Kleckner,
     Bill  Joy,  Eduardo  Pelegri-Llopart,  and Richard Stallman.
     Sam Kendall (kendall@centerline.com) added C++  support  and
     maintains   this  version.   Eduardo  Pelegri-Llopart  added
     sbtags.

BUGS

     Tricky macros in C and C++, such as  macros  that  implement
     parameterized  types,  can  lead  to spurious or missing tag
     entries.

     C and C++ macros defined to nothing are not recorded.

     C++ nested classes, templates, and exception  specifications
     are not understood.

     Recognition of functions,  subroutines  and  procedures  for
     Fortran is performed in a very simple manner.

     The method of deciding whether to look  for  C  and  Fortran
     functions is heuristic.