file: sortsym.doc
date: 29-jan-86

        This utility program is a software tool for assembly language
programmers using the MICROSOFT M80/L80 Z80/8085 CP/M assembler/linker.

        SORTSYM (SORT SYMbole file) is a companion program for
MICROSOFTS M80/L80 assembler and linker package. The L80 linker will generate
a .SYM symbol file of all the global labels used in a program if requested
via the /Y switch option. This .SYM file is used as input to the
symbolic debuggers ZSID ans SID.

        Since L80 does not generate anything resembling a useable link map,
this .SYM file is the closest clue as to where anything is located. The only
problem is that the .SYM file is UN-sorted in any form. SORTSYM uses the .SYM
file as input and generates as output a .SRT file of symbols sorted by
value AND alphabetized.

        USAGE:  > SORTSYM filename [optional comment field]

                filename.SYM  will be sorted to filename.SRT