F90BROWSE(1)

NAME

f90browse − Program source code browser

SYNOPSIS

f90browse [Xoptions] [-f90] [-r routine name] [-c options] [-tt] [-V] [[-f] file]

IMPLEMENTATION

All Sun Microsystems’ SPARC systems

DESCRIPTION

The Program Browser, f90browse, provides application programmers with an interactive environment in which to view and edit Fortran 90 codes. Cross-reference information is provided about aspects of the code being browsed and is updated when edits are applied. The browser may act upon a routine, a file, or an entire program, where the entire program is composed of one or more distinct files but treated by the browser as a single unit.

f90browse also will act as a base for other Sun tools that reference source code. To display a list of available tools, use the left mouse button to click on the Tools menu button.

The f90browse command accepts the following options:

Xoptions Specifies the standard X Window System options that you want f90browse to use. These values establish your f90browse X Window System environment and override values set in your .Xdefaults file. See the online Help text for a list of possible options.

-f90 Specifies use of Fortran 90 (-f90) for .f files. Fortran 90 is default on SPARC systems.

-r routine name Specifies a routine name, which if it exists within the file being opened, is displayed automatically. Shell wildcards are allowed in routine names. For example, -r "ab∗" would display all routines beginning with the letters ab.

-c options Specifies compile-time options to be used for code examined by f90browse. For example, if you specify -c "-I../includes", f90browse passes this option to the compiler thereby allowing the compiler to locate include files in the named directory.

-tt Specifies that f90browse create a binary-format version of the CIF file with an extension of .tt. The binary-format version is created by default in the same directory as the source code. Specifying this option will make subsequent browsing of the same file operate more quickly as f90browse will not have to recreate the .tt file.

-V Displays the version of f90browse running on your system.

-f file(s) Specifies file(s) to be opened. The -f is optional; you may specify only the file name or, if you do not specify any file name(s) on the command line, you can open files by using File menu options. If you enter multiple file names, enter a space between each file name. Shell wildcards are allowed in file names.

None of the f90browse options are required. You can start the browser simply by entering f90browse on the command line. You may want to run f90browse as a background process, thereby freeing your command line for other uses. To run the browser as a background process, add an ampersand (&) to the end of the command as follows: f90browse &.

WINDOW LAYOUT

The Program Browser window consists of four sections: the menu bar, the upper display, the source code display, and the information panel. The menu bar displays buttons that control most of the browser’s actions. The upper display is composed of three separate information lists that show the output from menu options. The source code display shows the source code you are currently browsing. The information panel provides information about the status of f90browse, displays information generated by menu functions, and allows you to enter commands.

f90browse contains a peel-off feature that allows you to convert portions of the f90browse display into separate X Window System windows. Peel-off windows retain all information contained in the original display. To create a peel-off window, position the cursor on the peel-off icon (a small square with an arrow pointing towards the upper-right corner) and press the right mouse button. Once you have created a peel-off window, you can move, resize, iconify, or otherwise manipulate the window in the same manner as any X Window System window.

ONLINE HELP

f90browse features extensive online help. To access the help facility, click on the Help button at the top of the main f90browse window. Help menu options are as follows:

Help Contains complete information about all f90browse menu options, lists X Window System Toolkit options and environment variables available for use with f90browse, and gives command equivalents for menu options. This help text is displayed within a separate Xhelp window.

Context Sensitive Provides context-sensitive help relevant to the task you are performing or to the area of the f90browse window in which the cursor is positioned. To access context-sensitive help, press either the <F1> key or the key designated as the <HELP> key on your workstation.

Man page Opens an input panel on which you can specify the name of the man page you want to be displayed within the f90browse window.

Version Displays current f90browse version and copyright information.

ENVIRONMENT VARIABLES

The following environment variables are used by f90browse:

CIFDIR Name of the directory where CIF files are created. Default is the directory where the original source files are located. If permissions forbid this location, TMPDIR points to /tmp/xxx. If you cannot write to this directory, files are created in /tmp/xb/xxx. (CIF files have a .t extension.)

F90LIST Location of f90list tool. Default is /opt/SUNWspro/bin/f90list.

EDITOR Name of the editor you want to use with f90browse. Default is vi.

F90 Compiler used to create Fortran 90 CIFs. Default is /opt/SUNWspro/bin/f90.

INCLUDE_PATH
List of directories in which include files are located. For example, if source code includes files from a directory other than the directory in which the source files are located, you can set this variable to point at that location.

MAXLIST Maximum number of layers held in each of the three lists displayed in the upper display panel of the main f90browse window. Default is 10.

XTERM Location of xterm terminal emulator. Default is /usr/bin/X11/xterm.

Museum

Related Articles