NAME

       iclass - class browser

SYNOPSIS

       iclass [-r] [-v] [-c] path [path...]

DESCRIPTION

       Iclass  is a simple class browser that lets you navigate through C++ class hierarchies and
       view the definition of a particular class.  You can select classes  from  three  browsers:
       the  first shows a list of all known classes; the second shows the parents of the selected
       class, if any; and the third shows the children of the selected class, if  any.   You  can
       choose  a  name  from  any  of  these lists and tell iclass to show the definition of that
       class, or you can type the  name  of  a  class  explicitly  in  the  StringEditor  labeled
       ``selected  class.''   The  view  of  the  class definition shows the source code from the
       header file that defines the selected class.

ARGUMENTS

       Iclass interprets arguments that specify the header files to search for class definitions.
       Each non-option argument on the command line should specify a pathname to a header file or
       a directory containing header files.  If the pathname is a filename ending in  the  suffix
       ``.h'',  then  iclass will scan that header file.  If the pathname is a directory, then it
       will scan every header file in that directory.  Iclass will ignore filenames that  do  not
       end  in  the  suffix  ``.h'', unless the ``-c'' option is given.  In this case iclass will
       search both ``.h'' and ``.C'' files for class definitions.

       You may use any of the standard options accepted by InterViews programs in addition to the
       following options:

       -r     Recursively  scan  subdirectories  for  additional  header  files  when  scanning a
              directory.

       -v     Verbosely print the name of every header file scanned.

       -c     Allow iclass to search ``.C'' files as well as ``.h'' for class definitions.   This
              option  should  be  used  carefully.   Because  of the way that iclass searches for
              definitions, it is possible for it to get confused by code in  a  ``.C''  file  and
              think  it  is  a definition.  Nonetheless, this is a useful option if there are C++
              input files that contain definitions.

COMMANDS

       Iclass provides pull-down menus for issuing commands.   The  ``File''  menu  includes  the
       following commands:

       Scan Files/Directories...
           Prompt for additional pathnames to scan.

       Clear Classes
           Purge iclass of all classes it has scanned.

       Quit
           Close the window and exit.

       Commands in the ``Search'' menu include:

       Forward Search...
              Search forward in the class definition for a match with a given regular expression,
              wrapping from the end to the beginning of the buffer if necessary.

       Backward Search...
              Search backward for a match with a given regexp.

       Go to Line...
              Move the cursor to the beginning of  the  given  line,  scrolling  the  display  if
              necessary.

MOUSE BINDINGS

       The  left  mouse  button  selects  text.  Left-clicking inside a browser, StringEditor, or
       class definition also focuses keyboard input to it, which  lets  it  interpret  subsequent
       keyboard  commands  as  scrolling  or selection operations.  Double left-clicking inside a
       browser is equivalent to selecting a class and then pressing the ``Show'' button.

       The middle and right mouse buttons scroll text in different  ways.   Middle-clicking  lets
       you  ``grab-scroll''  the text.  During grab-scrolling, the text is scrolled to follow the
       mouse position, making it appear as though you  are  dragging  the  text  itself.   Right-
       clicking  engages  ``rate-scrolling,''  a  joy-stick-like scrolling interface in which the
       scrolling rate increases as you drag the mouse away from the  initial  click  point.   For
       example,  dragging the mouse downwards after the initial click scrolls a browser downwards
       at an increasing rate; dragging upwards thereafter reduces the rate until scrolling  stops
       entirely  at  the  initial  click  point.  Dragging up beyond this point makes the browser
       scroll in the reverse direction.

KEYBOARD BINDINGS

       For convenience, all menu commands have keyboard equivalents:

       (^V)   Scan a file or directory.

       (^Q)   Quit.

       (^S)   Search forward.

       (^R)   Search backward.

       (^N)   Go to a line.

       Iclass also provides keyboard commands for changing focus:

       ESC or TAB
              Set focus to the StringEditor showing the selected class.

       CR     Show the selected class (equivalent to pressing the Show button) and set  focus  to
              the class definition.

SEE ALSO

       Regexp(3I), StringBrowser(3I), StringEditor(3I), TextEditor(3I)

                                                                                        iclass(1)