		          WBCtrl
		 1999/2000 by Stephan Rupprecht
		    All rights reserved.
 

COPYRIGHT AND DISCLAIMER
 WBCtrl is copyrighted 1999/2000 by Stephan Rupprecht. 
 All rights reserved. This program is freeware, so no financial
 donations required. Redistribution allowed if the package is 
 left unchanged. The author is not responsible for any damage 
 caused by the use or misuse of this documentation and/or the 
 program(s) it describes.


REQUIREMENTS
 Any Amiga (compatible) computer with at least OS3.5 and
 68020+ cpu.


DESCRIPTION
 WBCtrl allows you to control some undocumented features of
 the AmigaOS3.5 Workbench.


USAGE
 The program can only be started from shell, the following
 options are provided:
 
 MCM=MAXCOPYMEM/N/K,IMT=IMAGEMEMTYPE/K,DN=DRAWERNOTIFICATION/S,
 G=GAUGE/S,R=REFRESH/S,MNL=MAXNAMELENGTH/N/K,TB=TITLEBAR/S,
 LP=LOCKPENS/S,Q=QUERY/S
 
 MCM=MAXCOPYMEM/N/K: will set the maximum number of bytes the
  file copy code will use. Some SCSI controllers (don't ask which:)
  are not able to transfer more 32k at once because of this the
  default setting is 65536 bytes (two buffers, each 32k).

 IMT=IMAGEMEMTYPE/K: when set to FAST or ANY, wb and icon.lib will
  use fastram for imagedata, if available (p96/cgx or fblit required!). 
  Use CHIP for chipram. It's safe to use this option without p96/cgx
  as WBCtrl will check for an RTG system / fblit before actually
  performing the change. If you use fblit by Stephen Brookes,
  you should use ICONFAST instead of FAST to avoid problems
  with workbench.library. Last but not least WBFAST tells wb
  to use fastram for imagedata and resets icon.library to use
  chipram.

 DN=DRAWERNOTIFICATION/S: enable/disable drawer notification:
  "if enabled, Workbench will be notified of changes in every
   'Show all files' mode drawer. Every time a notification arrives,
   Workbench will reread the drawer." 

 G=GAUGE/S: disable/enable the Workbench volume fill gauges.
  Any open volume/root drawer window will *not* be updated. You
  must close them first.

 R=REFRESH/S: use this option in conjunction with G=GAUGE/S
  and WBCtrl will update the drawer windows for you. 
 
 MNL=MAXNAMELENGTH/N/K: "icon.library has a built-in file name length
  limit that affects whether icon files are read and written.
  Currently, the default for this value is 25 characters. This 
  is sufficient for an icon file name acceptable with the ROM
  filing system. This limit has two effects: if an icon file is
  to be written whose name would be longer than the limit,
  icon.library will silently abort the write attempt and pretend
  that the icon file has been written; this is done in order to
  avoid overwriting the original data file with the icon file.
  If an icon file was read that turns out to contain invalid icon
  data, another test is done in order to find out whether the file
  name was longer than the limit. If this is the case, it is
  assumed that the data was read from the original file rather
  than from the icon file. The library then pretends that the 
  icon file was not found." (this was taken from the Autodocs,
   1985-2000 Amiga Int., Inc.)
  
 TB=TITLEBAR/S: disables/enables the titlebar of the workbench
  (requires workbench.library 44.1514 or later, BB#2). As of
  time writing this text, BB#2 isn't available! I only released
  this version because I already uploaded it to amiga.com by
  mistake.
  
 LP=LOCKPENS/S: (un)locks the screen pens 4-7 (MagicWB colors).
  You should only use this option when needed and not every time
  your computer boots. This will prevent some unnecessary disk
  accesses.
 
 Q=QUERY/S: show current settings.


INSTALLATION
 Copy the program to your C: directory. The best it to start
 somewhere in your s:user-startup.


HISTORY
 1.0	first public release for os35 beta testers.
 1.1	added REFRESH/S option.
 1.2	internal release.
 1.3	IMAGEMEMTYPE can be changed even without an RTG system
 	now, when FBlit by Stephen Brookes is running. Extented
 	IMT=IMAGEMEMTYPE/K option.
 1.4	added MNL=MAXNAMELENGTH/N/K option.
 1.5	REFRESH/S didn't free allocated DrawerList <Gunther Nikl>. 
 1.6	added TB=TITLEBAR/S option (Requires BB#2).
 1.7	added LP=LOCKPENS/S option.

AUTHOR

 Please send bug reports and ideas to:

	Stephan Rupprecht
	Apfeldweg 1
	D44359 Dortmund
	Germany

 Send emails to

	stephan.rupprecht@gmx.de or
	stephan.rupprecht@web.de
	
 WWW
 	
 	http://stephan-rupprecht.de
