AMUS PROGRAM LABEL GENERATOR

	The PROLAB program is designed to create a standarized label which
will be appended to all source code donations to the AMUS Network.  Since 
there are quite a few programs to label, the AMUS Staff would appreciate
your help by using the program to label any donations you may make in the
future.  
  The only file you need is PROLAB.LIT. This is an AlphaArchive archive,
which will automatically dearchive into the following files: PROLAB.RUN,
EDIT.SBR, DIRHSH.SBR, and PROLAB.INI. To dearchive this file, simply type
PROLAB in the account where you have downloaded the PROLAB.LIT file. You
can run the PROLAB program by simply typing RUN PROLAB.
  Creating a program label is simply a matter of specifying the type of
program being labeled and then filling in a number of fields. The program,
as it stands, creates a LABEL.RPT file which can then be appended to the
source code program. The append command for this is as follows:
           APPEND filename.ext = LABEL.RPT,filename.ext

The information included in the label is as follows:
FILENAME - name of source code file including extension
DATE - enter date program was uploaded to AMUS Network (mm/dd/yy)
CATEGORY - GAME, UTILity, SBR, TDV, MATH, TEXT processing, GRAPhics,
           COMMunications, CALendar, SECurity, SCIentific or DOCumentation
           files   Please feel free to suggest other category types.
HASH CODE - hash code of assembled or compiled program (dir/h filename.ext)
VERSION - version of assembled or compiled program (dir/v filename.ext)
INITIALS - AMUS Network logon initials i.e. AMUS/AM
NAME - program donor name (optional)
COMPANY - name of company (optional)
TELEPHONE # - (optional)
RELATED FILES - includes necessary XCALL subroutines, documentation files, etc.
MIN. OP. SYS. - Minimum version of operating system which program will run
                under. i.e. AMOSL 1.3B, AMOS32 1.0D, etc.
EXPERTISE LEVEL - (BEG)inner, (INT)ermediate, (ADV)anced
  Beginner - program is easy to get up and running and is fairly easy to
             use or comprehend.
  Intermediate - program requires some computer and/or AMOS knowledge to
	         run the program or make use of it.
  Advanced - program which requires a comprehensive knowledge of AMOS or 
             other "Use Caution" programs.
SPECIAL - Any special notes which apply to the program i.e. program must
          be assembled under the 2.0 assembler.
DESCRIPTION - description of program function - please try to convey the
purpose of the program. If you have room to include the usage, feel free
to use the space. However, do not try to cram instructions into this space.
Instructions may be located elsewhere within the program. 

 The program makes use of the EDIT.SBR XCALL.  This SBR allows you to use
VUE-like control chars to edit input data. Use RETURN or the UP and DOWN
arrow keys to move from field to field. When finished, hit ESC to exit.
The LABEL.RPT file will then be created.

 The program makes use of DIRHSH.SBR XCALL. This SBR will return the hash
total, and version number of the compiled or assembled file. If the 
program cannot find the assembled or compiled program then the user will
be prompted for the file to hash. Full filespec is accepted.

 If a PROLAB.INI file is located in the users' account or BAS: then
PROLAB will use the defaults in the PROLAB.INI so user input is reduced.

 If the source code that PROLAB.BAS is generating an AMUS Program Label
for, already has an AMUS Program Label, PROLAB.BAS will preload the 
previous information in the new label for the user to edit. 

  If you feel the inclination to make changes to the source code or write
your own label program, feel free to do so. HOWEVER, do not change the
content or layout of the fields. This will keep the label standarized and
allow future utilities to take advantage of this fact. AMUS feels this
program label will allow everyone to make better use of our Network, and
we thank you for your cooperation.

Please address any problems, questions, comments to ARCH/US or MATT/US. 

.