@database Blot.guide
@$VER: Blot.guide_english V2.0
@author "Markus Illenseer"
@font topaz.font 11
@wordwrap
@width 77
@master "Blot.guide"

## This  is  a  doc  file in the amigaguide.library format.
## The needed programm is avail since May 1993.  AmigaGuide
## can  be  found  on  either  the  Aminet  or  on  a later
## Fish-Disc  >880.   Also, for the blessed A4000 and A1200
## user, multiview of WB 3.0 does support this guide.

@Node Main "Blot V0.1 - Manual"

    @{fg fill}@{b}Blot V0.1 - Manual@{ub}@{fg text}

   I.      @{" Synopsis             " Link SYNOPSIS}
   II.     @{" Description          " Link DESCRIPTION}
   III.    @{" Source               " Link SOURCE}
   IV.     @{" Copyright            " Link COPYRIGHT}
   V.      @{" Author & Support     " Link AUTHOR}
   VI.     @{" Changes to original  " Link CHANGES}
   VII.    @{" Purpose & Theory     " Link PURPOSE}
   VIII.   @{" Version              " Link VERSION}
   IX.     @{" Starting             " Link STARTING}
   X.      @{" Arguments            " Link ARGUMENTS}
   XI.     @{" Tool Types           " Link TOOLTYPES}
   XII.    @{" Known Problems       " Link PROBLEMS}
   XIII.   @{" Credits              " Link CREDITS}

@EndNode

@Node SYNOPSIS "Blot/Synopsis"

@{b}NAME@{ub}
   SYS:WBStartup/Blot

@{b}Synopsis@{ub}
   Blot
      @{"COUNT/N/K     " Link TOOLTYPES 5 }  =<Number of Blots pe cycle>
      @{"BACKDROP      " Link TOOLTYPES 13}  =<Yes|No>
@EndNode

@Node DESCRIPTION "Blot/Description"
@{b}Description@{ub}

Some simple X-Port
Have fun!

@EndNode

@Node SOURCE "Blot/Source"
@{b}Source@{ub}

The  source  code  is not included, it can be compiled with SAS-C 5.10a (or
newer) or with the registered version of Dice V2.06.54 (or newer).

The  source code is based upon Jamie Zawinski xblot.c, not included in this
archive.

@EndNode

@Node COPYRIGHT "Blot/Copyright"
@{b}Copyright@{ub}

Copyright 1994,1994 by the Author.

Blot V0.1 is freely distributable.

Blot  V0.1  is  free  to  be  spread  on  public-domain and shareware disks
especially  on  Fred  Fish's  AmigaLibDisks, as long as they are sold for a
reasonable charge that is less than US $6 or DM 8.- .

Blot  V0.1  may  be  distributed  on  freely available CD-ROM.  This CD-ROM
should  not  be used for commercial obstinacles like professional copyiing.
The  price  of the CD-ROM is to be sold at a reasonable price, ie.  DM20 or
$US 15.

For use in commercial products the permission of the authors is required.

Blot V0.1 may be copied and distributed via electronic networks such as the
Internet,   also  it  may  be  held  available  on  anonymous  ftp-servers,
mail-boxes or BBS's.

Blot V0.1 may not, or is not allowed to be used by any military institution
or any civil institution which makes any research or products which is used
by military institutions.

@{i}The Copyright is still by the Author.@{ui}

The  author  is not responsible for anything which may happen to you, while
using Blot.  Especially for any hypnosis trauma...

@EndNode

@Node AUTHOR "Blot/Author & Support"
@{b}Author & Support@{ub}

   Markus Illenseer            # Graphic routines
   Kurt-Schumacherstr. 16       # Documentation
   33615 Bielefeld               # Dice Support
   Germany
   INTERNET: markus@techfak.uni-bielefeld.de, markus@tiger.owl.de (preferred)
   ZERBERUS: markus%techfak.uni-bielefeld.de@uucp.zer
   IRC: ill


   Original Code:
   Jamie Zawinski jwz@lucid.com


   SUPPORT FTP ADDRESS:
   ftp.uni-paderborn.de [131.234.2.32] anonymous access.
   (Thus any AmiNet site around the world)

   Please  first refer to @{"KNOWN PROBLEMS" Link PROBLEMS}
   below,  before  you  contact  us  for  a Bug-report, any
   comment  is  welcomed  of  course.   Feel free to send a
   donation, some flowers or a postcard.

@EndNode

@Node CHANGES "Blot/Changes"
@{b}Changes@{ub}

I  changed  all  the  X11 routines into their correspondent Amiga-Intuition
functions where this was possible.

@EndNode

@Node PURPOSE "Blot/Purpose & Theory"
@{b}Purpose & Theory@{ub}

Blot has no purpose at all, no other than fun :)

@EndNode

@Node VERSION "Blot/Version"
@{b}Version@{ub}

This is Blot V 0.1, initial release.

    3984 Bytes for the SAS/C version.

@EndNode

@Node STARTING "Blot/Starting"
@{b}Starting@{ub}

To  get Blot started now, double-click the icon.  If the Tool Types weren't
changed yet, a window shows up.

You  can  start  Blot  from  the CLI or another Shell.  For example you can
start Blot in the S:User-Startup:

    Run >NIL:  <NIL:  Blot

Blot supports @{"ReadArgs()" Link "Docs:AutoDocs/dos.hyper/ReadArgs()"}.
For  a  small  help on the command line arguments, start Blot with a '?' as
Parameter.

@EndNode

@Node ARGUMENTS "Blot/Arguments"
@{b}Arguments@{ub}

As every good program, Blot supports ReadArg entries when started from CLI.

    @{"CPUNT     " Link TOOLTYPES   }=200  # Number of Blots per Cylce
    @{"BACKDROP  " Link TOOLTYPES 5 }=NO   # Use full size of screen and backdrop window

@EndNode

@Node TOOLTYPES "Blot/Tool Types"
@{b}Tool Types@{ub}

    COUNT= 1..200
      Use this amount of Blots per Cycle.

    BACKDROP=YES | NO
      Use a small, resizable window (NO) or a full screen sized
      backdrop window (YES).

 Icon-based Tool Type entries aren't supported.

@EndNode

@Node PROBLEMS "Blot/Known Problems"
@{b}Known Problems@{ub}

I  do  know  of  some  problems and strange behaviours, some of them aren't
strange anymore, when you read this:

-  Backdrop  window  hides  the  icons  on my workbench.  
Well, that is the nature of backdrop windows and windows in common.  I cant
do  anything  against  this, sorry.  Everything else would be a kludge, not
worth  the  effort and trouble.  Remeber, RTG would not work with that hack
anyway...

-  Backdrop  window  is not removable, i cannot stop the program.  
Activate  the  window  and  press  'ESC'  to  exit, or send a CTRL-C to the
programm, using CLI Command Break.

- What nasty colors, yucc.
Uh,  sorry, but i wanted the programm to be run on Workbench, its up to you
to change the colors. I didnt wanted to mess around with ObtainPen() ...

- Tool Type Entries do not work?
Yes, they are not supported, i thought it's not worth the effort.

@EndNode

@Node CREDITS "Blot/Credits"
@{b}Credits@{ub}

Jamie  Zawinski  for  the  initial hack on X11 (Un*x) systems.  If you ever
happen to run X11 on Unix, try out xlockmore with the blot-mode.

Various  Net-Freaks  for  their  suggestions  and  (strange)
Bug-Reports.

                      Markus Illenseer
                       January 1995

@EndNode