
#F1
F1:HOW TO USE HELP 

       Press ESC to return to Help Menu.  Then press the key prior to
       the colon. Example...Scroll Lock: means to press the SCROLL LOCK
       key for it's help screen. TO EXIT PROGRAM: Press ESC and Y.

       GENERAL INFORMATION:
       Command line use:
           Command line use is limited to 128 characters including spaces.
               chtree \path\file1.c \path\file2.c ... \path\file20.c [/NORECUR]
       Command file use:
               chtree @file.cmd | A text file with one c file per line and
                                | optionally /NORECUR. Upto 20 c files can
               \path\file1.c    | be listed. RAM space limits number of source
               \path\file2.c    | lines to about 8000 for 600K. The /NORECUR
               .............    | option turns off recursive function call
               \path\file20.c   | checking. Logical tree building is faster
               [/NORECUR]       | but could go infinite (be careful) !!

#F2
F2:LOGICAL/PHYSICAL TREES/FILES ACCESSED BY REPEATED PRESSES

       Display 1: LOGICAL TREE
       Functions calling other functions are shown as the program would
       call them.

       Display 2: LOGICAL SOURCE FILE
       The C file belonging to the cursor marked function in the Logical
       Tree is displayed.

       Display 3: PHYSICAL TREE
       All function definitions and calls are displayed as they appear
       in the source files.

       Display 4: PHYSICAL SOURCE FILE
       The C file belonging to the cursor marked function in the Physical
       Tree is displayed.

#SHIFTF2
SHIFT F2:REVERSE LOGICAL/PHYSICAL TREES/FILES ACCESSED BY REPEATED PRESSES

       Displays previous tree or source file.  This key is F2 in reverse.
       This is useful to go between a source file and it's tree. As an 
       example: To review all function definitions independent of the
       file a particular definition is in: Press F2 to display the
       Physical Tree, select a function definition, and press F2 to
       display the Physical Source File. To view another function
       definition press SHIFT F2 to return to the Physical Tree and
       move the cursor to the desired function definition.  Then
       press F2 to display the Physical Source File.

#F3
F3:LIST OF FUNCTION DEFINITIONS/LABELS OR CALLS BY FILE, OR CALLS BY LEVEL

       Option 1: List of function definitions by file.
       Function names and labels are listed in the file where they are
       defined. Label names have the word :LABEL after them. This is
       useful as an index into the F2 displays using the F8 key.

       Option 2: List of function calls by file.
       Unique function calls are listed in the file where they are
       called. This is useful when function prototypes need to be
       coded. 

       Option 3: List of function calls by level.
       Unique function calls are listed by level. The number of times
       a particular function is called is displayed. If the function
       call does not have a function definition it is not displayed
       and a status message appears.

#F4
F4:NESTED CALLED FROM TREE

       A trace is displayed from the current call level back to main()
       at level 0.  The main() function name to the current marked cursor
       function name calls are shown.  All C files are included in the
       search.

#F5
F5:FUNCTION CALLED BY FUNCTIONS

       The program prompts for a function name.  All functions which
       call the entered function name are displayed.  This can be
       used to know what higher level functions are affected by changes
       in the entered function name.  All C files are included in the
       search.

#F6
F6:STRING FOUND IN FUNCTIONS

       The program prompts for a string.  All functions in the displayed
       source file are searched for the entered string. All function
       names found to contain the string are displayed. This key only
       works in the Logical and Physical Source File displays.

#F7
F7:SELECT CALL LEVEL(S)
       
            Option 1: View all occurrences of the entered level.
       The program prompts for the selection of a call level.  When
       the cursor is moved by F9 or F10, all levels not equal to the
       entered call level are skipped as the cursor moves..
            Option 2: View all levels less than or equal to the entered level.
       The program prompts for a new maximum current call level.  When
       the cursor is moved by F9 or F10, all levels more than the entered
       maximum call level are skipped as the cursor moves. The default
       maximum call level is the deepest nested call level.
            Option 3: View all levels greater than the entered level or equal
       to 0. The program prompts for a new minimum current call level.  When
       the cursor is moved by F9 or F10, all levels less than the entered
       minimum call level are skipped as the cursor moves. 

       The default Option is Option 2.

#F8
F8:FIND A FUNCTION NAME, LABEL OR STRING

       The program prompts for a function name, label or string. When
       in the Logical or Physical Tree displays, the program searches
       for a function name or label.  When in the Logical or Physical
       Source displays, the program searches for a string.  This key
       is used together with the KEYPAD+ and KEYPAD- keys. The line
       where the entered function name, label or string is found is
       marked by the cursor. This key is affected by the SCROLL LOCK
       key.

#F9
F9:MOVE CURSOR ONE LINE UP

       The cursor is moved one line up on the current display unless
       modified by F7.  If F7 sets a maximum current call level less
       than the maximum available call level, the F9 key will cause 
       the cursor to move up to the next allowable call level.  This
       key is affected by the SCROLL LOCK key.

#F10
F10:MOVE CURSOR ONE LINE DOWN

       The cursor is moved one line down on the current display unless
       modified by F7.  If F7 sets a maximum current call level less
       than the maximum available call level, the F10 key will cause 
       the cursor to move down to the next allowable call level.  This
       key is affected by the SCROLL LOCK key.

#PADMINUS
KEYPAD-:PREVIOUS FUNCTION NAME, LABEL OR STRING

       When in the Logical Tree or Physical Tree displays, this key
       finds the previous function name or label as entered by F8. 
       When in the Logical Source File or Physical Source File
       displays, this key finds the previous string as entered by
       F8.  This key is affected by the SCROLL LOCK key.

#PADPLUS
KEYPAD+:NEXT FUNCTION NAME, LABEL OR STRING

       When in the Logical Tree or Physical Tree displays, this key
       finds the next function name or label as entered by F8.  When
       in the Logical Source File or Physical Source File displays,
       this key finds the next string as entered by F8.  This key is
       affected by the SCROLL LOCK key.

#SSWITCH
SCROLL LOCK:TOGGLE PAGE(S-)/SCROLL(S+)

       Scrolling is either by page or by individual line.  The S- or
       S+ indicator on the right end of the information line indicates
       the current scroll state.  S+ indicates scrolling is done one
       line at a time.  S- indicates scrolling is done by page.  If
       in S+ and you are searching, scrolling can be temporarily 
       suspended by pressing the SPACE BAR.

#ALTPL
ALT+:DISPLAY FIRST PAGE

       Pressing the ALT key along with the + key (+= key) will display
       the first page of the tree or source file.

#ALTMI
ALT-:DISPLAY LAST PAGE

       Pressing the ALT key along with the - key (_- key) will display
       the last page of the tree or source file.

#SCROLLUP
SCROLLUP:SCROLL DISPLAY ONE LINE UP

       The UP ARROW will cause the display to move one line up towards
       the first page.

#SCROLLDN
SCROLLDN:SCROLL DISPLAY ONE LINE DOWN

       The DOWN ARROW will cause the display to move one line down towards
       the last page.

#PGUP
PAGE UP:SCROLL UP ONE PAGE

       The PAGE UP key will cause the display to move one page up towards
       the first page.  This key is affected by the SCROLL LOCK key.

#PGDN
PAGE DOWN:SCROLL DOWN ONE PAGE

       The PAGE DOWN key will cause the display to move one page down towards
       the last page.  This key is affected by the SCROLL LOCK key.

#HOME
HOME:DISPLAY PAGE WITH CURSOR

       Pressing the HOME key will return the display to the page containing
       the cursor.  The cursor will be on the top most line of the display.

#END
END:MOVE CURSOR TO DISPLAYED PAGE

       Pressing the END key will place the cursor on the top most line
       of the displayed page (moving the cursor from some other page).

#CNTRLHOME
SET BOOKMARKS

       1. CONTROL HOME:mark current page number 1

       Pressing CONTROL HOME bookmarks the current display page so that
       it can be returned to by pressing the CONTROL END key.  This key 
       can be used to move around the current display tree or file and
       then return to the marked page.  There is a separate bookmark
       for each of the four displays.                        

       2. LETTER H:mark current page number 2

       Pressing LETTER H bookmarks the current display page so that
       it can be returned to by pressing the LETTER H key.  This key 
       can be used to move around the current display tree or file and
       then return to the marked page.  There is a separate bookmark
       for each of the four displays.                        

#CNTRLEND
RETURN TO BOOKMARKS

       1. CONTROL END:display marked page 1

       Pressing CONTROL END returns the current display page to the 
       bookmarked page.  This key can be used to move around the
       current display tree or file and then return to the marked
       page.  There is a separate bookmark for each of the four displays.

       2. LETTER E:display marked page 2

       Pressing LETTER E returns the current display page to the 
       bookmarked page.  This key can be used to move around the
       current display tree or file and then return to the marked
       page.  There is a separate bookmark for each of the four displays.

#PRTSC
PRTSC*:PRINTER OUTPUT MENU

       Use an IBM compatible printer in text mode.  Any one C source file
       can be printed or all C source files with one command. A starting
       and ending source file line number can be entered. The printer output
       includes line numbers.  The physical tree can be printed and/or the
       logical tree.  The tree output includes a sequential line number, the
       file the function is found in, the line number where the function is
       defined or called, the call level, the function's type, and the
       function name on each line.
      
       Before printing logical tree, a call level is requested (See Help F7).
       Option 1: Print all occurrences of the entered level.
       Option 2: Print all levels less than or equal to the entered level.
       Option 3: Print all levels greater than or equal to the entered level.

       Pressing the ESC key will stop the printing (you may need to wait
       until the print buffer is empty).

#

