NAME

sbbuild — generate SourceBrowser database with limited information

SYNOPSIS

sbbuild [ −help ] [ −verbose ] [ −version ]  filename | filename=x | filename=scanner

AVAILABILITY

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

DESCRIPTION

Use sbbuild to generate a SourceBrowser database for either a text file or a file that produces a warning or error message when you compile it with the SourceBrowser option.  sbbuild scans filename and generates the database with the names of the symbols only.  sbbuild does not include semantic information about the symbols.  sbbuild generates the database in the current working directory. 

Once you run sbbuild, you can use SourceBrowser to browse filename.  You will be able run a simple query for a symbol.  You will also be able to run limited filtered and focused queries. 

sbbuild generates the database using either a language scanner or a text scanner.  You can either explicitly specify the scanner to use or let sbbuild select the scanner based on the filename extension. 

OPTIONS

−help Display synopsis of the sbbuild command. 

−verbose Print the name of the scanner used to scan the file. 

−version Display the current version of sbbuild. 

filename

filename=x

filename=scanner filename is the name of the file for which you want to generate the
SourceBrowser database. sbbuild determines which scanner to use to scan the file based on the filename extension.  For example, if the filename is hello.c, sbbuild uses the ANSI C scanner.  If the filename has no extension, sbbuild uses the text scanner. 

You can also explicitly tell sbbuild the scanner to use by including an equal sign and either the file extension or scanner name after the filename.  For example, sbbuild hello.p=.c tells sbbuild to use the ANSI C scanner on the Pascal file hello.p. 
sbbuild hello.p=sbscan_ansi_c also tells sbbuild to use the ANSI C scanner on a Pascal file. 

Following is a list of valid filename extensions and their corresponding scanners. 

.c, .h, .l, .y sbscan_ansi_c

.C, .cc sbscan_sun_c_plus_plus

.ext sbscan_extend

.f, .F sbscan_sun_f77

.p sbscan_sun_pascal

t, T sbscan_text

no extension sbscan_text

You can use wildcards in place of the filename.  sbbuild ∗ or sbbuild .  scans all files in the directory.  In this case, you cannot specify which scanner to use. 

EXAMPLE

The command

sbbuild hello

generates a limited SourceBrowser database for the file hello using the text scanner. 

The command

sbbuild hello.c

generates a SourceBrowser database for hello.c using the ANSI C scanner.  The scanners checks for the names of symbols only. 

The commands

sbbuild hello.p=.c
sbbuild hello.p=sbscan_ansi_c

generate a database for the Pascal file hello.p using the ANSI C scanner. 

The command

sbbuild ∗

generates the database for all files in the directory.  sbbuild selects the scanner based on the filename extension.  For example, sbbuild selects sbscan_sun_f77 for files ending in .f or .F and sbscan_sun_pascal for files ending in .p. 

FILES

sbscan_ansi_c ANSI C file scanner

sbscan_extend Extend file scanner

sbscan_sun_c_plus_plus
C++ file scanner

sbscan_sun_f77 FORTRAN file scanner

sbscan_sun_pascal Pascal file scanner

sbscan_text text file scanner
 

SEE ALSO

sbrowser(1), sbquery(1), .sbinit(5)

Browsing Source Code
 

Sun Release 4.1  —  Last change: 23 March 1992