DrWimp - desktop programing system.
 Andrew Ayre 1995-98
Major additions and updates by Guy Bartle
 Ray Favre - additions/changes from 1st May 1999 to May 2010

Version 5.00 (29-Nov-08)

The complete package consists of:

!MyApp           - blank template application.
                   (take a look at !Fabricate in the Utils folder as well)

Elixirs folder   - contains Dr Wimp's 'elixirs' (optional additional functions
    	    	   to carry out certain specific tasks - see Section 2.36
    	    	   of Manual).


Documents folder - contains the history and manuals, etc:
    
                             Conditions - Conditions of Use (HTML version)

                             !Manual    - DTP'ed manual inc. tutorials.
                                          (Impression format)
                                          >>Start with this if a new user<<
                             TextManual - Manual in text format.
                             Figure1    - Drawfile for text manual.
                             History    - Development history of DrWimp,
                                          including any changes since
                                          previous versions.
                             Security   - A short note on code security.
                             
                             Addr+Cred  - How to contact the author & credits.
                             Upgrading  - How to upgrade applications using
                                          a previous version of DrWimp to
                                          this one.
                             !Fnc'n'Prc - Details all the functions in
                                          DrWimp, the names, arguments and
                                          short descriptions.
                             (FuncProc  - as above but in StrongHelp format)
                             

Tutorials folder - contains files for the tutorials in the manual.

                             Messages   - Text file.
                             Sprites    - Sprite file.
                             Print      - Template file.
                             Template1  - Template file.
                             ...
                             Template7  - Template file.


Utils folder     - contains various utilities:

                             !WinEd     - 3rd party. Template editor.
                             !TemplEd   - 3rd party. Template editor.
                             !MakeApp3  - 3rd Party. BASIC to Absolute.
                             !Linker    - Links Libraries with RunImages.
                             !Fabricate - Produces blank template
                                          applications but with options of
                                          adding very common features
                                          automatically.
                             !CodeTemps - Converts templates of windows into
                                          code that can be used with DrWimp
                                          to recreate the windows without
                                          the need for templates files.
                             !StrongBS  - 3rd party, Basic file compressor.            

  All these utilities have !Help files inside them which give details on how
  they are used and the distribution conditions.


Examples folder  - contains DrWimp example applications:

                             !Animate   - icon animation.                                                    !Bar       - bars.
                             !BuildSpr  - constructing a custom sprite.
                             !Clocker   - pollidles, private 'user' sprite
                                          areas.
                             !ColPick   - colour picker.             
                             !Create    - example of creating windows in
                                          BASIC, instead of loading them
                                          from templates files.
                             !DragCopy  - dragging and copying an icon.
                             !DrawDisp  - handling drawfiles.
                             !Drawing   - example of drawing text, sprites
                                          and drawfiles in windows.
                             !ESG       - example of using ESG in radio icons.  
                             !FastSlow  - example of switching between fast
                                          and slow polling (using 'singlepoll').
                             !FontMen   = font menus and sub-menus.             
                             !Grid      - example of drawing grids.
                             !IconPlot  - plotting icons directly to a window.
                                          menus and writeable menu items.
                             !Messages  - example of using messages files.                                   !MultiPane - multiple panes.
                             !Orientate - example of printing portrait and
                             !PrintTest - example of printing and print
                                          control with all the options.                                      !Quit      - example of asking to confim quits
                                          and desktop shutdowns.
                             !Saver     - save windows.
                             !ScaleDraw - rendering scaled drawfiles & sprites
                             !Scroll    - fast redraw of scrolling text list
    	    	    	     !Slider    - sliders.
                             !SprAreas  - private 'user' sprite areas.
                             !Toolbar   - how to implement toolbars.
                             !ViewPage  - printer paper size example.
                             
                             !DrWimpLib - not an example application, just a
                                          place to store DrWimp for the
                                          examples. Just ignore it.
                             !!ReadMe   - a bit more information on
                                          !DrWimpLib.


  All these examples have fully commented !RunImage files. If you feel that
  there is an example on some aspect of DrWimp missing, and the manual does
  not explain the usage clearly, I would be grateful for any suggestions...


DISTRIBUTION NOTES:
    
  The Conditions of Use for the Dr Wimp package are contained in the
'Conditions' file (in the Documents folder) and also in the Manual and
at the start of the DrWimp library. 

  The 3rd Party applications have their own distribution conditions,
but as far as I can make out they may only be distributed without
making any profit.

  !Linker may be distributed separately and is Freeware. It may not be
disributed with any of the files missing or altered, nor may it be
distributed for profit.

  !Fnc'n'Prc, the example applications and the manuals may only be
distributed with this package.

  This package may only be distributed with all the files and
applications listed here (that includes !Linker). No files may be
altered.  !TemplEd is rather large and may be left out if the recipient
has the same or an equivalent application but a note must be included
to indicate you removed it.

You can always download the latest version from:
    
    http://www.rayfavre.me.uk/
    
    
EOF500
