            Contents of this directory Docs

There is a lot of documentation here. You may not need any of it to begin
with if you just want to look at the stored polyhedra and/or you already
understand the mathematics.  The file !Help and Acorn interactive help are
supported, so they may be enough to get you started.

If you want more help with using the program, look at the files in the
sub-directory Tutorials with its collection of example Draw files. These
should enable you to explore all the stored polyhedra and make new ones of
your own. 

The sub-directory Reference contains files to help you understand more of
the mathematics, but it does not attempt to teach a lot of details, for that
you need a textbook (See BookKits)

The directory, TryThese has suggestions for interesting things to do with 
the program after you have learnt how to use it.

The rest of this file is a contents: skip to the part you want to use now,
you don't need to wade through it all.

Draw files have been squashed to save space. Use the !Squash application
to restore them.


Contents of Docs directory

    Text files:

  BookKits   - WWW URLS, suggested reading, and suppliers of model kits
  CopyRight  - a statement of Fortran Friends copyright
  FaultRep   - a form for you to return if you find any problems
  ReadMe     - this file
  Versions   - record of the differences between versions of !Stellate
  WishList   - current planned enhancements for !Stellate


    Sub-directory Reference:

  Component  - Draw file showing the characteristics of the 10 possible
               components used to make polyhedra in !Stellate
  CrossRef   - (squashed) listings of the polyhedra stored in
  DualFig    - Draw file pictorial explanation of dual models
  Duals      - explanation of dual models and how Stellate makes them 
  Faces      - Draw file showing the characteristics of the 9 possible
               face types used to make polyhedra in !Stellate
  FormChoice - defines the format of Resources.Choices file
  FormCols   - defines the format of Resources.Colours file
  FormComps  - defines the format of Resources.Components file and
               explains how to enter formulae instead of numbers
  FormData   - (squashed) defines the format of the output PolyData file
  FormList   - defines the format of Resources.StellaList file
  Glossary   - defines terms associated with polyhedra
  Intro      - explains what uniform polyhedra are and gives an introduction
               on how to make them using !Stellate
  ReadStel   - skeleton BASIC program for reading Resources.StellaList
  Snubs      - description of how the snub polyhedra are created
  SplitFigs  - figures for Splits (Draw file)
  Splits     - how to make split faces for difficult 3D plots
  WennError  - some problems in the stellation diagrams in the book:
               Polyhedron Models by M.J. Wenninger
  WennIndex  - Type and alphabetical list of the polyhedra in 
               Polyhedron Models by M.J. Wenninger
               Numerical list of names, aliases and dual names

    Sub-directory TryThese:

  Activities - suggestions for things to try out with !Stellate. It is
               organised as a series of questions.
  Answer-n   - compressed Draw files and text files giving possible answers
               to the questions posed in Activities
  NewLine9   - StellaList format file answer to question 9.


    Sub-directory Tutorials contains three tutorials to help show you what
is possible with !Stellate. Each assumes that you have worked through the
previous ones.

  Tutorial1 - Instructions for beginners - shows how to make the 3D view
              plot from the stored command data

  Tutorial2 - Instructions for making your own selections from the
              stellation diagram to make your own version of a polyhedron
              from the stored instructions; also how to make dual polyhedra.
              The second section shows how to select star faces and
              selecting faces from more than one component
 
  Tutorial3 - Instructions for making a new polyhedron by selecting your
              face types to make stellation diagram(s) and a new polyhedron 

  pictures  - sub-directory of squashed Draw files of figures used in the
              tutorials
