         ____  ___ ____   ____    ___  ____    _____ _       _      _   
        |  _ \|_ _/ ___| / ___|  / _ \/ ___|  |  ___(_) __ _| | ___| |_ 
        | |_) || |\___ \| |     | | | \___ \  | |_  | |/ _` | |/ _ \ __|
        |  _ < | | ___) | |___  | |_| |___) | |  _| | | (_| | |  __/ |_ 
        |_| \_\___|____/ \____|  \___/|____/  |_|   |_|\__, |_|\___|\__|
                                                       |___/            

What Figlet is
--------------

  Figlet is a program which produces large ASCII art letters such as those at
the top of this document.  You can choose from a variety of typestyles.  The
results are displayed in a window,  and can be saved as a text file using
drag-and-drop.

  The original version by Glenn Chappell and Ian Chai ran under unix.  This
version has been altered slightly,  and a frontend has been bolted on.  The
original README is supplied in the DOCS directory as README_unx,  but as it
describes the use of the original command-line version most of it is
irrelevant - it does give you the original authors contact details.

How to use Figlet
-----------------

  You will need to have installed the toolbox modules on your system.  These
are included in RISC OS 3.60,  but earlier versions of the operating system
need to have them added as an extra.  Double-click on !UpdateSys and,  if
necessary,  drag your main !System folder to the window.  Click on 'Continue'
and then 'Quit'.

  Load the !Figlet application by double-clicking on it.  It will install
itself on the iconbar.  Click select over the iconbar icon to bring up the
main window.  Type the text that you want processed into the writable field
and click on 'Process'.  The results will appear in the top part of the
window.

The main menu
-------------

  The main menu is accessed by clicking Menu over the results part of the
window.

  'Info'    Move right to see a standard info box.
  
  'Save'    Move right to produce a standard save box.  You can drag the
            output text to a directory display or to another application
            such as your text editor or wordprocessor.
  
  'Font'    This leads to a submenu containing a list of all the fonts
            which are currently available.
  
  'Align'  This produces a setup window.  You can set the width of the
            output text so that when text wraps it does not produce
            output lines that are too wide - it is also useful when using
            the centred and right-justified output modes.
            
            The justification buttons should be self explanatory;  the
            right to left option is less so.  I think it is supposed to be
            used with fonts which go from right to left (it only reverses
            the order of the characters and not the actual characters
            themselves).
            
  
  'Smush'  This is really for people that are familiar with unix figlet.
            It allows control over how the characters are moved or smushed
            together.  It is reccommended that you leave it on 'Default',
            but feel free to experiment with it.

   When you have changed font,  justification,  direction or smushmode then
you will need to click on the 'Process' button again to reflect the changes.
   
Adding new fonts
----------------

  The main drawback with the original release of RISC OS figlet was that you
couldn't easily add different fonts.  The standard 15 fonts which are
supplied with the unix distribution are present,  but many more are available
by anonymous ftp from various sites around the internet.  To add new fonts, 
simply drag them into the '!Figlet.flf' directory.  If you run out of space
(the maximum number of fonts in an ADFS directory is 77), then you can create
subdirectories and put more fonts in there.

Licence conditions
------------------

The frontend is  Paul Corke, 1995.

  This software is supplied as-is.  I can not be held responsible for any
data loss caused by it.  The software may be distributed freely,  as long as
it is not altered and no profit is made.

Contacting me
-------------

  Bugs,  suggestions,  small amounts of cash,  comments,  large amounts of
cash, etc. can be sent to me:

Paul Corke, c/o 6 Shotford Rd., Harleston, Norfolk, IP20 9JN.

As I'm in the process of graduating and getting a job,  I'm not sure what my
email address is going to be when you read this.  Currently,  you could try
'corkep@unix.lancs.ac.uk' but I'm not promising that it will get through.
I will update this file when I have a more permanent address.
