Initial revision

WPrefs.app/README

@@ -0,0 +1,111 @@
+
+			          WPrefs.app
+				  ==========
+
+ 		  The WindowMaker Prerefences Application
+		
+
+    WPrefs.app is the preferences "editor" for the WindowMaker window 
+manager. It can be used to set most of the preference options of WindowMaker
+and define it's applications menu. It also can change some settings 
+that do not belong to WindowMaker. 
+
+    Although WPrefs.app is designed to be easy to use, you should read the
+user guide to be fully aware of all available options and other features
+of WindowMaker that are not related to configuration.
+
+    To run WPrefs, do not put it in your search path. Instead, run it
+with the full path, like /usr/local/GNUstep/Apps/WPrefs.app/WPrefs
+Then, dock it's application icon. The dock will automatically detect it's
+icon and use it.
+
+    If you change configuration often, you might want to leave WPrefs
+always running, leaving it hidden while not in use. You can also make it
+be automatically started with WindowMaker and toggle the Start Hidden
+option in the attributes panel for the WPrefs window. Of course, it will
+use some memory, but by leaving it hidden it'll probably be swapped out and
+stay there until you unhide it.
+
+    WPrefs is still under development. Some of the configuration options are 
+not yet configurable from WPrefs, notably the appearance related options.
+It might contain bugs that can corrupt your configuration files, so backup
+the contents of the ~/GNUstep/Defaults directory before using it.
+
+
+
+
+Notes
+-----
+
+The mouse speed configuration is saved as a call for xset in 
+~/G/D/L/W/autostart. WindowMaker calls this file when it is started.
+
+If you don't want or can't use the menu definition section, do not
+open it's section (or if you do open it, do not Save), or WPrefs will
+overwrite your ~/G/D/WMRootMenu file.
+
+Only options that have different values than what is found in the 
+system-wide configuration file is saved.
+
+WPrefs only supports property list menus. If you have a plain text file
+menu, it will not be read by WPrefs. You can either recreate the menu from
+scratch or not use WPrefs for menu definition. The old menu will not be
+overwritten if you recreate it.
+
+
+Build
+-----
+
+WPrefs will be built automatically and installed with the rest of WindowMaker.
+
+
+
+Customized Installation
+-----------------------
+
+By default, WPrefs.app will be installed in the GNUstep applications 
+directory, which is /usr/local/GNUstep/Apps. If you want to install it
+somewhere else, like in /some_weird_path/Apps, set the GNUSTEP_LOCAL_ROOT
+environment variable to some_weird_path before running configure for
+WindowMaker. Leave this variable always set (make it be set from your
+.profile or .tcshrc or whatever), or WPrefs.app will not find it's resource
+files (like icons).
+If you change your mind after installing, you can move the .app directory 
+to one of the following GNUstep/Apps directories:
+
+/usr/GNUstep/Apps
+
+OR
+
+/usr/local/GNUstep/Apps
+
+OR
+
+~/GNUstep/Apps
+
+
+
+Credits
+-------
+
+User interface design, programming and a few icons:
+    Alfredo K. Kojima <kojima@windowmaker.org>		
+
+Icon and image artwork:
+    Marco van Hylckama Vlieg <fatal@global.uibk.ac.at>
+
+
+WindowMaker
+-----------
+
+    If for some weird reason you end up with this preferences program and 
+don't have WindowMaker yet, you can get more information about it at
+http://windowmaker.org and download it at ftp://ftp.windowmaker.org
+
+
+Contact
+-------
+
+Send comments and bug reports to kojima@windowmaker.org 
+Use the WindowMaker BUGFORM to report bugs.
+