
First aid for problems with WarpOS
----------------------------------

- Problem:
  Every demo which opens the powerpc.library, crashes.

- Solution:
  - On systems without PPC board, the env variable 'noPPC' must
    absolutely be set to a value unequal zero. After that, all
    demos which are able to run without PPC (but which try to
    open the powerpc.library) should run.
  - If the 68060.library of the PowerUp distribution of Phase5
    was not installed of if this library causes problems, the
    problem can be solved with the env variable 'boardtype'.
    Owner of a CyberStormPPC board should set the variable to 2,
    owner of a developer board to 1.



- Problem:
  If a demo is started several times in the shell, crashes occur.

- Solution:
  The problem can occur in conjunction with the WShell, which frees
  signals that were not allocated by itself. The problem can be
  solved with the env variable 'earlyterm'. If this variable is set
  to 1, the problems should be solved. Restrictions: no global settings
  can be made in the shell, which could affect the PPC, so the tools
  'stackppc' and 'changemmu' don't work anymore. To set the PPC stack
  size, you have to use the command 'stack' (the PPC stack is about
  double the stack size of the 68K stack).


- Problem:
  Since version 1.6 the voxelspace demo doesn't work with Picasso96
  anymore.

- Solution:
  The voxelspace supports the OS3.0 multibuffering for Picasso96
  since V1.6 to achieve a better display quality. Therefore it is
  required that an appropriate new version of Picasso96 is installed.

