PrLabel
                                 =======
                                 
                          Version 1.1  17.01.92
                          Version 1.2  14.09.92


                            SciTech  Software
                              23, Stag Leys
                                 Ashtead
                                 Surrey
                                KT21 2TD

                         Tel.: +44 (0372) 275775



        PrLabel is shareware with a suggested donation of £5.00.

        The interface is created using STSLib, a library of 3D
        gadget and menu building routines available from SciTech
        Software for £20.00.




PrLabel is a utility to print labels on laser printer label sheets. 
Three patterns of labels are supported: 3x8, 2x8 and 2x7, defaulting to the
3x8 format.

V1.2 now allows address lists to be read from, or written to, files. The
record delimiter may be specified and defaults to a comma. The program
can thus be used to read files written by a database, etc.

Running the Program
===================
From the CLI, the program is invoked with:

   PrLabel [-38][-28][-27][-s<c>]

where -38 is the same as the default label format, -28 and -27 select the 
2x8 and 2x7 formats respectively and -s is followed by a character which
specifies the delimiter (default: ,).


From the Workbench, the Icon tooltype may be set to one of:

   FORMAT=38
   FORMAT=28
   FORMAT=27
   SEPARATOR=,

where FORMAT=38 is the same as the default and FORMAT=28 and FORMAT=27 
select the 2x8 and 2x7 formats respectively. The default separator is
a comma, any other sensible character (e.g. |, \, +, etc.) may be used.
To alter the icon's tooltype, select the icon with a single click, then 
choose the Info item from the Workbench's menu.


The PrLabel Window
==================
If, when you run PrLabel, you obtain a message saying BuildBoolGadget() 
needs a larger window, then you should select a smaller Screen Text font 
(this applies only to AmigaDOS V2.0).

When PrLabel starts, a window is opened on the Workbench screen. The window 
contains:

o  A group of gadgets on the left in the format specified.
o  Seven text gadgets
o  Three gadgets labelled NEXT, PREV and KILL
o  One gadget labelled PRINT!

The first of the text gadgets will be activated and will allow you to enter 
text. When you press RETURN, the next text gadget will be activated 
allowing you to enter an address without having to touch the mouse.

If you have entered a single address, you can select the label position at 
which it will be printed by clicking the relevent label on the format group.
Clicking the gadget again will deactivate it. If you select more than one 
label position, the label will be printed at all the selected positions.

By clicking the NEXT gadget, the text gadgets will be cleared allowing you 
to enter a second address. You can repeat this process as many times as you 
desire. The addresses will be printed in the order you entered them, but 
they will only be printed at the currently selected label positions. Thus 
some of the addresses may not be printed. The addresses will be printed in 
order running down (rather than across) the label positions.

When multiple addresses have been entered, each will be printed only once
even if the number of label positions selected exceeds the number of 
addresses entered.

The PREV gadget will allow to to step back through the adresses and correct 
mistakes while the KILL gadget will delete the currently displayed address. 
If KILL has no effect, it is because there is only one address left.

Finally PRINT! will cause the labels to be printed.


Menus
=====
PrLabel has only a Project menu with the items:

o  Open
o  Save
o  About
o  Quit

The Open item displays a file requester in which a pre-existing file of 
addresses is specified. The file must contain 1 label to each line with the
records (i.e. name and lines of the address) separated by the delimiter 
character specified with the tooltype or on the command line character.

The Save item displays a file requester in which a file of addresses to
be written is specified. The file will contain 1 label to each line with the
records (i.e. name and lines of the address) separated by the delimiter
character specified with the tooltype or on the command line character.

The About item displays information about the program.

The Quit item (or the window's close gadget) exits the program.


Re-compiling
============
To recompile and link the program, you will require the demo. or commercial
version of STSLib. The demo. version is on Fish Disk 599. To link
completely, the Heath file requester from Fish Disk 41 is required. However,
this requester is only used if you do not have the ASL requester. 
Consequently, if you have AmigaDOS V2.04, or above, the Heath requester 
will not be used and you may safely ignore the error message produced by 
Blink.

To include the Heath requester you should alter the makefile. Search for
#HEATH and comment out the OFILES line which is currently used and 
un-comment the one which is currently commented. You must also uncomment 
the compile lines used to compile the Heath requester code. Copy 
safeclose.c and getfile.c from AmigaLibDisk41:GetFile and run make to 
compile these and re-link.