Home | Products | Support | How to Order | Contact Us | Search  

ENHANCED LISTER & XREF

Enhanced Lister Datasheet

General

This program is designed to help programmers document and debug BASIC programs. It provides features and information which can neither be obtained from the built-in LIST and XREF commands nor from RUNning the program. In addition to listing the user’s program, it provides three groups of useful features. The ‘cosmetic’ features include such things as page titles, page numbers, dates, indentation, and comment alignment all of which make the program easier to read and understand.

The ‘program flow’ group includes such features as flags for lines that are the targets of GOTO’s and GOSUB’s, flags for unused lines, blank lines to indicate a break in sequential (line-by-line) program flow, and context separators. These features are invaluable in unraveling ‘spaghetti code’, understanding someone else’s code, or even reviewing your own code which was written years ago.

The ‘Information’ group of features include a table of labels and the page numbers on which they occur, a table of duplicate IMAGE statements, a table of duplicate code sequences, and a table of subroutines and subprograms and where they are called from.

Platform

This program will run on TransEra’s HTBasic and HP’s HPBASIC for Windows and Workstations.

Detailed Feature Descriptions

‘Cosmetic’ Features

• Pages are numbered, dated and contain the program name.
• Line numbers are right justified.
• Lines are automatically indented regardless of original indentation.
• Comments are aligned in the center of the page
• Lines longer than the page width are wrapped to the next line and right justified.

‘Program Flow’ Features

• Lines which are the targets of GOTO’s and GOSUB’s are indicated. Different indicators are used to differentiate between lines which are the targets of GOTO’s, GOSUB’s or both.
• Blank lines are inserted after lines which terminate sequential (by line number) program flow such as RETURN, STOP, END, END LOOP, etc.
• Program contexts are separated by a line of dashes.
• Unused lines are marked.
• Lines referenced by ERRL functions are marked.
• Lines referenced by RESTORE statements are marked.
• Sequential lines which contain duplicate variable assignments are marked.

‘Information’ Features. This is a group of tables which appear at the end of the listing.

• A table of labels and the page on which they are defined.
• A table of subroutines and subprograms, where they are called from, and the number of times they are called. Recursive routines are identified.
• A table of duplicate IMAGE statements.
• A table of calls to subprograms not contained in this listing as well as line numbers and label references which cross context boundaries. (These problems will be found at RUN time but only if the offending code is executed.)
• A table of ERRL and RESTORE line number references not found in the listing.
• A table of duplicate code sequences longer than three lines.
• The number of program lines
• The program checksum.

XREF PROGRAM

This companion program provides a cross-reference listing of all program variables similar to that obtained from the XREF command in BASIC. The main benefit of this program is that the variables are listed alphabetically as opposed to the order in which they occur in the program. The program name, date and page numbers are also printed on each page.

ORDERING INFORMATION

Price for both programs is $95.00 which includes shipping and handling.

The programs are supplied on a 3.5" floppy disk unless 5 1/4" disk is requested.

The programs can be ordered from Test & Measurement Systems Inc.