Category : Miscellaneous Language Source Code
Archive   : DMLIST.ZIP
Filename : DMLIST.DOC

DMLIST

Source Program Listing And Cross Reference Utility


Version 1.5














Copyright (C) 1987 by D. M. Software And Systems. ALL RIGHTS RESERVED.
































Table Of Contents



Section 1 - Introduction
Table Of Contents................................................... 2
Copyright And User Support.......................................... 3
D. M. Software And Systems.......................................... 4
DMLIST Overview..................................................... 5
Using DMLIST........................................................ 6

Section 2 - Command Line Switches
-B (Tab Width Setting).............................................. 8
-D (Date/Time Exclusion)............................................ 9
-F (Form Feed Appending)............................................10
-L (Paper Length)...................................................11
-N (Suppress Line Numbering)........................................12
-O (Disk Output Selection)..........................................13
-S (Sort File Names)................................................14
-T (File Type Specification)........................................15
-W (Page Width).....................................................16
-X (Cross Reference)................................................17
File Name Specification.............................................18
@ (Response File Specification).....................................19

Section 3 - Text Command Strings
Overview............................................................20
Page Feed Command...................................................21
Subtitle Command....................................................22

Section 4 - Language Summary And Quick Reference
Overview............................................................23
Assembler Quick Reference...........................................24
BASIC Quick Reference...............................................25
C Quick Reference...................................................26
COBOL Quick Reference...............................................27
dBase Quick Reference...............................................28
Pascal Quick Reference..............................................29

Section 5 - Miscellaneous Information
Bug Report Form.....................................................30
Licensing Agreement.................................................31
Registration Form...................................................32
Future Update Information...........................................33
















January 1988 DMLIST PAGE 2





COPYRIGHT AND USER SUPPORT


DMLIST is the property of D. M. Software And Systems. You are granted a
license to distribute this program freely provided you do not modify the
program and no fee is charged for the redistribution or copying.

DMLIST is a user supported program. This means that you can make copies
and distribute it freely provided no fees are charged. If you find this
program useful, you are asked to make a donation to provide for future
updates and information. See the last section of this manual for details.

You may not use this program in a government or corporate environment
without a site license agreement, except for the sole purpose of
evaluation. See the last section of this manual for details on site
licensing.

Licensing will provide you with information about this program and others
that may be released by D. M. Software And Systems.

All suggestions are welcome. After all, user supported software means that
the user decides what goes into the next release. The only thing I do not
want to hear about are suggestions for some obscure or little used language
such as MPS or SNOBOL. There are dozens of these languages out there and I
cannot possibly support them all. Some languages, such as FORTH, have a
reasonable following, and are not currently supported, but will be
considered if I hear enough about it. Do not expect an immediate upgrade,
however. Someone has to use and understand the language before a
reasonable amount of support can be given.

This program, and others like it (sometimes referred to as Shareware or
Freeware) are for everyone's benefit. This is an attempt to provide
quality software at reasonable cost. The overhead involved in starting a
software company and distribution network are ungodly high. So please, if
you find this program useful make a donation for its upkeep. And support
other programs like it such as ARC, PC-TALK and QMODEM.

After all, did you ever get any chance to test a package from one of the
big name software companies before using it ?

By the way, just so we are legal......

Turbo Pascal and Turbo C are trademarks of Borland International.
dBase, dBase III and dBase III Plus are trademarks of Ashton-Tate.
IBM and TopView are the trademarks of International Business Machines.
MS-DOS, MS-ASM and Windows are all trademarks of Microsoft.













Section 1 Introduction
January 1988 DMLIST PAGE 3





D. M. Software And Systems


D. M. Software And Systems is a one man consulting and contracting firm. I
have fifteen years of experience in programming and analysis. I have
finally settled into the microcomputer and networking areas of DP and I am
very happy there. However, I am always upset over some of the simple tools
that are missing from our trade. This program is an attempt to rectify
that situation.

I have no intention of becoming another Microsoft. I have decided to
distribute this program though the Shareware channels because I find it
useful and others I have shown it to do too.

Since I am a one man shop, please understand that telephone support is out
of the question. At least right now. Things could always change in the
future. Just remember I am not in this to get rich. I am just trying to
help out my fellow programmers. Of course, if you want a contractor or
consultant........

If all else fails please write to:

D. M. Software And Systems
6572 Suson Woods Drive
St. Louis, MO 63128

As a last resort only (you need to be panicky!!! If your heart is about to
come out of your chest) you can call me at (314) 296-4719.

I tried to make this program simple to use, but there are many options
currently supported. So some times things get a little out of hand. I use
this program for assembler, C and dBase, so there is little chance of an
error. However, I do not use COBOL, Pascal or BASIC on an everyday basis,
so there is some chance for an error with these languages.

























Section 1 Introduction
January 1988 DMLIST PAGE 4





DMLIST Overview


This program is designed to help the serious programmer print formatted
program listings and provide them with a certain amount of help, such as a
cross reference listing.

To that end it contains certain features that I, as a programmer, always
want but can never find in a commercially available utility; such as the
ability to sort the input file names. Have you ever looked through a 500
page listing of 40 source modules printed in no particular order ? Come on
out there. What are those guys thinking about ?

Built in support is provided for the most popular languages on the PC.
These include the following:

ASM - 80x86 assembler
BASIC
C
COBOL
dBase
PASCAL

Other languages may well be supported in the future, as long as they are
not totally obscure. Certain modern day languages have been omitted from
here simply because I (the author) are almost completely unfamiliar with
them. These include Ada, LISP, Modula-2 and FORTH. You can except DMLIST
to support these in a future release. Please don't ask me when! I do have
every intention of supporting them.

Also, since DMLIST was written in C, and I have already ordered a C++
compiler (preprocessor actually) I will provide any additional support for
it that is deemed necessary, although it does seem to need any.

Anyway, enough of that. On to using DMLIST.
























Section 1 Introduction
January 1988 DMLIST PAGE 5





Using DMLIST


DMLIST is a normal executable DOS program. It has built in support for
several languages. Please refer to the appropriate Quick Reference for
specific language support.

DMLIST calling syntax is:
DMLIST filenames [FLAGS] [filenames] [flags]

Notice that more than one file name can be specified on a command line and
may include the normal DOS wildcard characters. All of the flags used in
DMLIST must be preceded with a - (hyphen) or a / (slash). Either character
can be used for a flag and they can be mixed on a command line. Personally
I always use a hyphen and that is what will be throughout this document.
These is no specific sequence for file names or flags. The entire command
line is parsed before printing starts so all formatting options are known
in advance.

Allowable flags and their meanings are:

-B Used to specify a tab length.
-D To specify a date and/or time for file printing.
-L Use this to change the length of the printed page.
-N To suppress line numbering.
-O To specify disk output.
-S You can use this to sort all file names before printing.
-T To specify a file's type if it has an unsupported
extension.
-V Enables Verbose execution. Default is OFF
-W Is used to change the width of the printed page.
-X Is used to print a cross reference listing.

Built in support is provided for the most popular languages on the PC.
These normally have certain extensions for their source files and that is
how their type can normally determined. A file's default type can be
overridden with the -T flag. See that section for more details. Here is a
list of normal file extensions and the types supported, along the value to
change a file's type:

Language Normal Extension(s) Override value
--------------------- ------------------- --------------
ASM - 80x86 assembler .ASM and .MAC A
BASIC .BAS B
C .C and .H C
COBOL .COB O
dBase .PRG D
PASCAL .PAS, .BOX and .INC P

A sample file in Assembler, two C files (a .c and .h), a Pascal, and a
dBase file have been provided. You may wish to print them before reading
this manual so you can see some examples. Use the command

DMLIST SAMPLE.* -S -B5 -X

if you are using 14 7/8" by 11" paper.



Section 1 Introduction
January 1988 DMLIST PAGE 6





Using DMLIST


Also, a PIF file is included in the archive for users wishing to run this
program under Windows DOS or TopView. Simply copy it to your PIF
directory. After selecting DMLIST you will be prompted for the normal
command line parameters. Note that TopView and Windows use identical PIF
files.

Please note here the difference between a zero (0) and the letter "oh" (O).

A more detailed explanation of the command line options and the text
commands follows.














































Section 2 Command Line Parameters
January 1988 DMLIST PAGE 7





-B flag (tab width setting)


This is a command line switch for changing the default tab width. DOS
normally supports 8 space tab lengths, and so does this program. It can be
changed to any value by specifying the length in the -B switch. For
example:

DMLIST SAMPLE.C -B5

will change the tab width to 5 spaces. This does not mean that 5 spaces
will be inserted, just enough to pad to the next space who's position is
divisible by 5.

There is a range limit of between one and twenty spaces for a tab width.
But some printers allow the setting of its tabs. If your printer is one
and you have them set to your liken DMLIST can suppress tab expansion by
using the flag -b0.


EXCEPTION - COBOL normally defines tab spacing as every four spaces. Since
most PC COBOL compilers have also done away with the line numbering scheme,
tabs are set for four spaces for a COBOL file unless the eight character
spacing has already been overridden.



































Section 2 Command Line Parameters
January 1988 DMLIST PAGE 8





-D flag (Date/Time Exclusion flag)


This is the one option that prompted me to write this program. After
several years of trying to write systems that have 20, 40 or more source
modules, I got tired of having to reprint entire listings just to get
updates to three or four modules. The flag work like this:

DMLIST *.PAS -D10/11/85@12:00

Looks pretty bad doesn't it ? Actually it is a handy feature. What the
-D10/11/85@12:00 says is print all .PAS files last modified after noon on
October 11th, 1985.

The date and the time are both optional. If no date is specified then the
current system date is used. If a date is specified and no time then all
files with a date LATER than this one are printed. For example:

DMLIST *.PAS -D10/11/85

will print all .PAS files modified on or after October 11th, 1985 and

DMLIST *.PAS -D@13:00

will print all .PAS files modified after 1:00pm today.

The time specified is military time. (Just add 12 to the hours if it is
after 12:00 noon). The minutes may be omitted so that both of the
following will produce the same results:

DMLIST *.C -@13:00
DMLIST *.C -@13

The date must be in the format MM/DD/YY except that a - may be used to
separate the values so 10/11/85 and 10-11-85 are equivalent.
























Section 2 Command Line Parameters
January 1988 DMLIST PAGE 9





-F flag (Append form feeds)


Some printers have the annoying habit of not printing the last line sent to
it, even if a carriage return and line feed. The original intention of
this flag was to append a form feed to the end of the last file printed.
However, this flag can also be used to simply eject two pages (or more) so
the paper can be removed.

If this flag is not included, then NO form feeds are appended. If -f alone
is included then one form feed is included. You can specify the number of
form feeds by placing a decimal number behind the -f. For example:

DMLIST SAMPLE.C -b5 -F5

will add five form feeds to the end of the run.











































Section 2 Command Line Parameters
January 1988 DMLIST PAGE 10





-L flag (Change page length)


You can use this to change the default page length by specifying a decimal
number after the -L. For example:

DMLIST *.C -L50

will change the page length to 50 lines. The built in default is 55 lines.
This is normal for 6 line per inch on paper that is 11 inches long. It
will leave a bottom margin of 2 lines.

Remember that this is only text lines. It does NOT include the two line
(or more) header at the top of the page. So if you wanted to print only 25
lines per page so there was a blank space after it can be done.

The length of the page must be between 25 and 100 lines. Any other value
is assumed to be an erroneous entry.









































Section 2 Command Line Parameters
January 1988 DMLIST PAGE 11





-N flag (Suppress line numbers)


You can use this option to suppress the printing of line numbers. If you
invoke this option it does change formatting slightly. Normally there is a
7 character lead in with line numbers (a five digit line number, a colon
and a space). It will now be changed to two characters. This is so line
continuation markers can be printed. Normally when a line is split during
formatting the second, and all subsequent lines, have the line number
omitted and a hyphen directly beneath the colon in the first part of the
line. Suppressing numbering causes a two space indentation for the first
past of a line and a hyphen and a space for all parts there after. For
example:

1) 100: This is a sample...........more text
- line for showing formatting options...

2) This is a sample............more text
- line for showing formatting options...

are both the same text with line numbering on in example 1 and suppressed
in example 2.





































Section 2 Command Line Parameters
January 1988 DMLIST PAGE 12





-O Flag (Disk output selection)


This tells DMLIST to place the printed output in a disk file instead of
directing it to the printer. The output file will have the same name as
the source file with an extension of .PRN. For example:

DMLIST SAMPLE.C -O

will produce the disk file SAMPLE.PRN

You must be a little careful when using this option and the * or ?
characters in a file's extension. If you type the line:

DMLIST SAMPLE.* -O

there will be a SAMPLE.PRN file created, but it will only contain the
formatted output from the last file. See the file name specification
section for a more detailed explanation.








































Section 2 Command Line Parameters
January 1988 DMLIST PAGE 13





-S Flag (Sort file names before printing)


This is another convenient feature. Normally all files on the command line
are printed in order FROM RIGHT TO LEFT. This option will let you specify
the names in any order and include wild card characters in any order and
have the source modules print in alphabetical order. For example, assume
you have a directory containing the files x1.c, x2.c, x3.c x4.c and xx.h.
You can look at a directory listing to find out what order this would be
found in, but you can get them printed in the order shown above with the
following command:

DMLIST X?.* -S














































Section 2 Command Line Parameters
January 1988 DMLIST PAGE 14





-T flag (specify input file type)


This flag is used to specify the file type for files with an extension that
is not included in the table below. Note that when this flag is included
that ALL files on this run will be assumed to be the specified type. So if
your directory contains the files SAMPLE.PAS and SAMPLE.BAS then the line

DMLIST SAMPLE.PAS SAMPLE.BAS -TB

will cause both files to be checked as if they are BASIC files. Normally a
file's type is determined by checking the extension. No page feed or
subtitle command is supported for undetermined file types.

Use the table below to determine if your files conform to this standard. If
you have a popular compiler that uses extensions that are not shown below,
please write and it will be taken care of. See the bug report section for
more details.



Language Normal Extension(s) Override value
--------------------- ------------------- --------------
ASM - 80x86 assembler .ASM and .MAC A
BASIC .BAS B
C .C and .H C
COBOL .COB O
dBase .PRG D
PASCAL .PAS, .BOX and .INC P






























Section 2 Command Line Parameters
January 1988 DMLIST PAGE 15





-W flag (Set line width)


You can use this flag to change the default line width. The default is 132
characters. This width includes the characters at the beginning of a line.
If there are line numbers included then this is 7 characters and if line
numbers are suppressed it is 2. Most programmers using paper that 14 7/8
inches wide. For 8 1/2 inch wide paper you can normally get 85 characters
on a line. This varies as some printers print characters at a different
rate per inch.

A verification message will be printed on start up.

Only values between 75 and 256 are allowed. Any other value is assumed to
be an erroneous entry.












































Section 2 Command Line Parameters
January 1988 DMLIST PAGE 16





-X flag (Cross Reference Listing)


This flag will cause DMLIST to print a function/procedure and variable
cross reference listing at the end of the program listing. Currently BASIC
has not standard way to specify a procedure or function name that I am
aware of. There is no function/procedure cross reference available for
BASIC programs.

Currently the name column in the listing will only contain the first 14
characters of a name, followed by the line numbers that reference it.

String (or character) literals are supported. Numeric literals are not.
All string literals will contain the beginning ' or " and the ending one if
it does not increase the length of the string past 14 characters. Leading
and trailing spaces are included.

Entries will be listed in the following order;

1) All literals starting with a '
2) All literals starting with a "
3) All variables and function/procedures.

They are NOT sorted in strict ASCII order, but alphabetical . All items
are compared without case sensitivity. For an example see the output from
SAMPLE.PAS.


EXCEPTION - dBase allows both ' and " to be used as a string delimiter.
Other languages allow both of these, but they have two different meanings.
So for dBase files, ' and " are treated as equals for sorting purposes.
However, the actual source text for the first occurrence of a string will be
printed in the cross reference.


























Section 2 Command Line Parameters
January 1988 DMLIST PAGE 17





File Name Specification


Source file names can contain the normal DOS wildcard characters * and ?.
However, a certain amount of warning is required here. If the -O (disk
output) flag is specified, and there is a wildcard in the extension,
separate .PRN files are not created. They are simply overwritten each time
a file with the same name is encountered. For example, if you specified

DMLIST X?.*

and your directory contained the files x1.c, x2.c, x3.c and xx.h and they
were printed in that order, there would be separate .PRN's for each. But
if your directory contained x1.c, x2.c, x1.h and x2.h there would only be a
x1.PRN and x2.PRN and they would contain ONLY THE LAST ONE PRINTED.

When there is a wildcard in a file's extension, it is possible for DMLIST
to encounter a .OBJ or .EXE file. Since I suspect no one wants to try and
print these, I automatically ignore all files with the extensions .OBJ,
.PRN, .EXE, .COM, .BAK and .BIN. Note that .BAT files would be printed
since they are normal ASCII text files. .PRN files are excluded since
there were generated by this program anyway. .BAK files are excluded since
some editors automatically create them are they are seldom needed.

It is suggested that whenever a wildcard is specified that the -S (sort)
option is also used.

































Section 2 Command Line Parameters
January 1988 DMLIST PAGE 18





@ flag (Response file specification)


After all of the above discussion it should be obvious that this is a very
useful documentation tool. However, not everyone has a standard way of
doing things, and that includes odd paper sizes. Fortunately, there is a
way to specify these type of things once and reusing them.

Typing @ followed by a file name will cause DMLIST to read this file for
run time parameters. For example if you want to print 60 lines per page
and 80 characters on a line you can create the file DMLIST.RSP with the
following lines:
-L60
-W80
and use these parameters always by typing:

DMLIST @DMLIST.RSP filenames

All command lines flags except another @ can be contained in this file and
can be in any order. Also it is not required to specify parameters on
separate lines. So the line

-L60 -W80

is the same as the above example.

There is no specific extension required for this file.

If you have several of these files they do not have to be located in the
default directory. You can keep them in the same directory with DMLIST.EXE
and the program will find them.

The response file's name can appear anywhere on the command line after the
program name. However, only one response file can be specified. You are
also not allowed to nest response file names.

Any parameters that are specified in the file override any found on the
command line.





















Section 3 Text Command Strings
January 1988 DMLIST PAGE 19





Text Command Strings


There are currently only two commands that fall into this category; PAGE
and (for subtitles). They should be relatively self-explanatory.

EXCEPTION - Since the assembler used by most of use already has the page
feed and subtitle directives available, they were duplicated in this
program. You must PAGE and SUBTTL directives where you wish.

The correct procedure for including one of these commands is to make the
directive a comment, according to the rules of that language. Some
languages use more than one comment delimiter, and for those I have
selected a format.

Any amount of white space may be between the beginning and end of the
directive and the beginning and end of a line. For example -

/* PAGE */ and
/* PAGE */

are both acceptable in C. Also the name of the directive is not case
sensitive, so the word PAGE may be typed as Page, PAGE or page if you wish.




































Section 3 Text Command Strings
January 1988 DMLIST PAGE 20





Page Feed Command - Text Command String


This command is used to perform a forced page feed. Simply make the word
PAGE a command and DMLIST will start a new page with the next line. The
table below shows the correct format for each of the supported languages.

Language Format
-------- ------
Assembler PAGE
BASIC 'PAGE (DO NOT USE REM PAGE)
C /*PAGE*/
COBOL (not supported)
dBase *PAGE
Pascal {PAGE} (DO NOT USE (*PAGE*) )

See the sample files provided for examples.










































Section 3 Text Command Strings
January 1988 DMLIST PAGE 21





Subtitle Command - Text Command String


You can use this command to print a subtitle. Only one subtitle is active
at a time. Every subtitle command encountered replaces the previous one.
Normally a subtitle command would immediately precede a page command. See
the sample files for an example. For purposes of discussion, assume there
are 132 characters on a line.

Normally there are two header lines on a page. The first contains the time
and date of the listing, the source file's name and the page number. The
only item on the second line is the time and date the file was last
changed.

Adding a subtitle will center the text string specified on the second line.
For a clear example print the test file named sample1.c

This command is a little different than the page feed command. The correct
format is for a (with the <>) and the subtitle string to be placed in a
comment. For example -

/*Subtitle Sample Line*/

for C. See the table below for the correct format for your particular
language.

Language Subtitle Format
-------- ---------------
Assembler SUBTTL (See the assembler manual)
BASIC 'text
C /*text*/
COBOL (not supported)
dBase *text
PASCAL {text}

See the sample files provided for examples.























Section 4 Language Summary
January 1988 DMLIST PAGE 22





Language Quick Reference


The tables below are provided as a quick reference only. There is extra
space at the bottom of each page for your notes. Please use this space as
you see fit.

Please note that BASIC, dBase and Pascal all have more than one way to
delimit comments. This means that there would also be more than one way to
delimit a page feed or subtitle command. However, only one way is
currently supported for both languages. Please refer to the tables that
follow.

Remember, imbedded text commands are NOT case sensitive.













































Section 4 Language Summary
January 1988 DMLIST PAGE 23





Assembly Language Quick Reference



Default Tab Spacing 8 Spaces

File Extensions Supported .ASM and .MAC

Page Feed Command Format PAGE (See assembler manual)

Subtitle Command Format SUBTTL (See assembler manual)

Type Override On Command Line -TA


NOTES

1) All of the 80186, 80286, 8087 and 80287 op codes and the normal
Microsoft MASM directives are considered reserved words and will not be
listed in a cross reference, EVEN IF THERE ARE OP CODES FOR THE EXTRA
PROCESSORS AND NOT A DIRECTIVE IN THE SOURCE FILE !.






































Section 4 Language Summary
January 1988 DMLIST PAGE 24





BASIC Language Quick Reference



Default Tab Spacing 8 spaces

File Extension Supported .BAS

Page Feed Command Format 'PAGE

Subtitle Command Format 'subtitle text

Type Override On Command Line -TB


NOTES

1) Do not use the REM do start the page feed and subtitle commands.
This is not currently supported.

2) There is no support for PROCEDURE/FUNCTION cross reference for the BASIC
dialects that do not support named procedures.

3) Files must be saved with the ,A option. Consult your BASIC manual.



































Section 4 Language Summary
January 1988 DMLIST PAGE 25





'C' Language Quick Reference



Default Tab Spacing 8 spaces

File Extensions Supported .C and .H

Page Feed Command /* PAGE */

Subtitle Command Format /* subtitle text */

Type Override On Command Line -TC














































Section 4 Language Summary
January 1988 DMLIST PAGE 26





COBOL Language Quick Reference



Default Tab Spacing 4 spaces

File Extension Supported .COB

Page Feed Command Format not supported

Subtitle Command Format not supported

Type Override On Command Line -TO














































Section 4 Language Summary
January 1988 DMLIST PAGE 27





dBase Language Quick Reference



Default Tab Spacing 8 spaces

File Extension Supported .PRG

Page Feed Command Format * PAGE

Subtitle Command Format * subtitle text

Type Override On Command Line -TD


NOTES -

1) There are two string delimiters in dBase, ' and ". They are equivalent
in dBase. For this reason, DMLIST will sort both of these as equals when
printing a cross reference. The listing will contain the delimiter used in
the source text.

2) There are two comment delimiters in dBase, * and &&. Only * can be used
with the imbedded text commands.



































Section 4 Language Summary
January 1988 DMLIST PAGE 28





Pascal Language Quick Reference



Default Tab Spacing 8 spaces

File Extension Supported .PAS, .BOX and .INC

Page Feed Command Format {PAGE}

Subtitle Command Format { subtitle text}

Type Override On Command Line -TP



NOTES

1) Do not use (* *) to delimit the page feed and subtitle commands.
This is not currently supported.

2) The Turbo Pascal reserved words are also included in DMLIST's internal
table and do not appear in a cross reference listing. I seriously doubt
this will cause anyone a problem, with the possible exception of the word
STRING. These additional reserved words are:

Absolute
External
Inline
Overlay
Shl
Shr
String
Xor

























Section 5 Bug Report & Licensing Agreement
January 1988 DMLIST PAGE 29





Licensing Agreement, Bug Report And Updates


D. M. Software And Systems Bug Report

Name Of Program _____________________________________________

Version Number ______________________________________________

Serial Number _______________________________________________

User's Name _________________________________________________

Company _____________________________________________________

Address _____________________________________________________

_____________________________________________________

City _____________________________________________________

State ______________ Zip Code ____________________

Day Time Telephone (include area code) ______________________

Problem Description _________________________________________________

_____________________________________________________________________

_____________________________________________________________________

Instructions:

1) Please provide a brief description of the problem BUT IT IS MORE
IMPORTANT TO BE SPECIFIC. Use the back of the page if required.

2) Please provide your name, address and day time telephone number
in case I have trouble duplicating the error.

3) If at all possible, enclose a diskette with a copy of the data
file(s) in question. Any data or code received by D. M. Software
And Systems will be considered proprietary and returned as soon as
the problem is fixed, along with your diskette.

4) Unregistered user will immediately have their data and diskette(s)
returned. NO SUPPORTED WILL BE PROVIDED FOR UNREGISTERED USERS AND
THERE ARE ABSOLUTELY NO EXCEPTIONS TO THIS RULE!!!!!!!!!

5) The first user to report a bug will receive a free fix. So will
any user who has a problem that could well render his program
unusable.

6) Complete this form and mail it, along with a sample to:

D. M. Software And Systems
6572 Suson Woods Drive.
St. Louis, MO 63128


Section 5 Bug Report & Licensing Agreement
January 1988 DMLIST PAGE 30





Licensing Agreement, Bug Report And Updates


Since I have to put food on my table too, I ask that if you find this
program useful, you make a donation for its upkeep. After all, I went to a
lot of trouble to make sure this program is useful! This will also entitle
you to information and notice about upgrades to this program and any others
that D. M. Software And Systems may release in the future.

Do not use this program in a governmental or commercial environment without
registering your copy, except for the sole purpose of evaluation. As of
December 1987 the following fee schedule is being used:

Number Of Copies Charge Per Copy
---------------- ---------------
1 - 4 $40.00
5 - 9 $37.50
10 - 19 $35.00
20 - 49 $30.00
50 or more $25.00

For questions or current pricing, call D. M. Software And Systems at (314)
296-4719, or write to:

D. M. Software And Systems
6572 Suson Woods Dr.
St. Louis, MO 63128

For orders outside the United States please add $5 dollars and enclose an
international money order. No other form of payment will be accepted. All
amounts are in United States dollars. Please write for foreign currency
amounts.

You will be provided with one update to the most current version upon
receipt of your registration when you do NOT already have the most current
version. The prices above are guaranteed through March 1, 1988. So it may
be necessary to charge an additional fee. Both of these items are subject
to change after March 1, 1988.

Fees for network installation are based on the number of user that have
access to it at any one time. i.e. - The number of terminals attached to
the network.

D. M. Software And Systems make no guarantees for DMLIST. This program is
not warranted or guaranteed, and will not provide any support other than
that outlined in the above documentation.

The user is provided a license for copying and redistribution of DMLIST as
long as no charge is made for the copying and redistribution. You may make
as many copies as you deem necessary for archival purposes and may install
it on more than one machine, IF IT WILL ONLY BE USED ON ONE MACHINE AT A
TIME. (Treat it like a book).







dml1.000188
January 1988 DMLIST PAGE 31





DMLIST REGISTRATION FORM


Please fill out the form below for registration and mail to:

D. M. Software And Systems
6572 Suson Woods Drive
St. Louis, MO 63128

For commercial or governmental orders please list only one name for contact.
See the previous page for pricing information.

Your phone number will only be used when you have reported a bug and I
cannot duplicate the problem.

Writing your name below says you have read the attached Licensing Agreement
and agree to abide by those terms.


Name (Print) ______________________________________________________

Signature _________________________________________________________

Company ___________________________________________________________

Address ___________________________________________________________

___________________________________________________________

___________________________________________________________

City ____________________________________________________________

State ________________ Zip Code ____________________


Day Time Telephone (include area code) ________________________


I received my copy of DMLIST from:

_______________________________________________________________


Was any fee charged for the copying of this program ?

____________________

Type of computer

_____________________________________________


DOS version number

____________________



dml1.000188
January 1988 DMLIST PAGE 32





Future Updates


There are several additional features planned for future releases of
DMLIST. You will see these listed below. Version 2.0 is now targeted for
March 1, 1988. This is not a promise of all of the features below. In
fact I do not plan to have all of these in version 2.0. Remember I am not
really a software vendor but I do want to help!

Updates are currently $15.00 PER COPY. This price is guaranteed through
March 1, 1988. But remember there is no guarantee that an update will be
made on this date. It is my target. I am telling you all of this in an
attempt to honest with you. I would also like to know when an update is
planned and what features to expect. I assume you would too.

If you feel you have a valid suggestion, please drop me a line. After all
this program is for all users, not just me. Unless you want to pay an
hourly fee, this program will NOT be modified for an obscure language.
Also, if you feel that any of the features below are mandatory for a
complete program let me know.

Additional Features Planned

1) A default parameter file to ALWAYS be loaded on startup. Personally I
do not use eight character tabs. I find it a nuisance to always type -B5
or load a response file every time I start the program. In addition to
command line parameters it will allow for additional options such as a
printer startup strings.

2) A menu driven program. This will actually be included for the
inexperienced user and invoked with a different name so this user has a
choice.

3) C++ support. I am not sure that this will really be required, but I
intend to check it out. But I am not even sure I like the language from
some of the reviews I have read.

4) Keyword capitalization and/or emphasis. This will be a handy
documentation feature. What this means, for example, in a C program every
time char is encountered it will be changed to CHAR and emphasized in the
listing.

5) Reformatting for C, Pascal and dBase programs. You will then be allowed
to save the reformatted file for recompilation.

6) Support for alternate comment delimiters in BASIC and Pascal. BASIC
allows ' and REM, and Pascal uses {} and (**). Currently only ' is
supported for BASIC and {} for Pascal.

7) Selective printing of cross reference items. i.e. - Only numeric
literals or only numeric literals.








dml1.000188
January 1988 DMLIST PAGE 33





User Survey


This is an attempt to provide the users of this program with more support
in the future and is strictly optional. Please feel free to attach another
page if there is not enough room for your explanations. You do not have to
register your program to send in this survey. Please complete it and mail
to:
D. M. Software And Systems
6572 Suson Woods Drive
St. Louis, MO 63128

Program this form is from _____________________________________________

Version _______________________________________________________________

What could be done to improve this program? ___________________________

_______________________________________________________________________

What could be done to improve the documentation ? _____________________

_______________________________________________________________________

What features does this program contain that you like? ________________

_______________________________________________________________________

What do you dislike about it? _________________________________________

_______________________________________________________________________


What make and model of equipment are you going to run this program on ?

_______________________________________________________________________

What CPU is in this machine? (check one)
8086/8088 ___ 80186 ___ 80286 ___ 80386 V20 ___ V30 ___ V40 ___

Which math co-processor do you have?
None ___ 8087 ___ 80287 ___ 80387 ___

If you have a modem, what is its make, model and maximum baud rate?

_______________________________________________________________________

What operating system and version are you using?

_______________________________________________________________________

If you operate in a networked environment, which one and what version ?

_______________________________________________________________________





dml1.000188
January 1988 DMLIST PAGE 34





User Survey


If you did not register this program, why not? ________________________

_______________________________________________________________________



What other program(s) would you like to see released as user supported
software in the future? Please be specific. Don't give me just a name, I
would like a complete description.

_______________________________________________________________________

_______________________________________________________________________

_______________________________________________________________________

What is your job title? _______________________________________________

Is this copy going to be used by a company ? __________________________

If so,
How many people are in the Data Processing and IC? ________________

How many PC's are there in your company ? _________________________

How many of these have modems? ____________________________________

How many programmers are employed? ________________________________

Do you use contractors? ___________

If so, how many and what type of functions do they perform? _______

___________________________________________________________________

___________________________________________________________________


Which four languages are most frequently used by you or in your IC? Please
list the vendor and version.

Language Vendor Version

__________ _______________________________________ ________________

__________ _______________________________________ ________________

__________ _______________________________________ ________________

__________ _______________________________________ ________________






dml1.000188
January 1988 DMLIST PAGE 35





User Survey


Please check any of the following operating environments you may use, or
plan to use in the near future.

OS/2 ___ Windows Dos ___ TopView ___ Unix ___ Xenix ___

What program editor do you currently use and what features does it have
that you consider mandatory?

_______________________________________________________________________

_______________________________________________________________________

_______________________________________________________________________

Should D. M. Software And Systems start its own bulletin board? Why? If so,
which one do you find the most useful? What type is it? (RBBS, FIDONet,
etc.) What features should it incorporate?

_______________________________________________________________________

_______________________________________________________________________

_______________________________________________________________________

Can I contact you about this survey ? If so please give me your name,
phone number and the hours you can be reached.

Name _______________________________ Phone ___________________________

Hours you can be reached at this phone ________________________________

Time zone? Eastern ____ Central ___ Mountain ___ Pacific ___
























dml1.000188
January 1988 DMLIST PAGE 36