asDrinks 2.0
Author: Charlie Schmidt <ishamael@themes.org>

With help from:   Dagmar d'Surreal
                  Ethan Fischer
		  PinkX
		  Arjuna Shunn
		  #afterstep, efnet for putting up with my shit
		  Many others for testing it

----------------------------------------------------------------------
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
---------------------------------------------------------------------


REQUIREMENTS:
------------

-AfterStep 1.6.0 (>= 1.7.55 for automatic menu updating)
	www.afterstep.org/Download.shtml

-an image viewer (like xv or ee) to view the UserFriendly comic.

-lynx (a version that can do -source)
	lynx.browser.org

-netscape [and i suggest nss]
	nss is recommended: http://users.telekabel.nl/eon/netscape.html
	www.netscape.com

-perl 5.004 [maybe an earlier version works....]
	www.perl.com


INSTALL:
-------

You should use the ~/GNUstep/Library/AfterStep/  directory to house your
startmenu.  If you don't, this can easily be fixed by:

cp -r /usr/local/share/afterstep/start ~/GNUstep/Library/AfterStep/


1. Make an asDrinks directory in your startmenu.
2. Copy the 'sample.asDrinksrc' file to ~/.asDrinksrc  and edit as needed. 
3. Copy the 'sample.asDrinkslist' file to ~/.asDrinkslist and edit it.
4. Put the script somewhere in your path (like /usr/local/bin). 

[to find your AfterStep version, run 'afterstep --version']
*If you have AfterStep version < 1.7.55:  

	 Run the script, and then MANUALLY UPDATE the startmenu.  There is
	 NO way to automatically update the startmenu in a version less
	 than 1.7.55.
	 You should edit your ~/.asDrinksrc and turn off auto-updating.

*If you have AfterStep version >= 1.7.55

	Make sure  'ascommand.pl'  is in the same directory as 'afterstep'
	Run the asDrinks.pl script.		

You could, optionally, put a crontab entry like

1,31 * * * * /path/to/asDrinks.pl

or something like that to have the script run every so often.


If you edit your list of NAMES and URLS, and remove any item, after running
asDrinks with that item in the file, you will need to remove that
directory in your startmenu.  This _could_ be fixed by a rm -rf * in the
start directory at the beginning of the script, but im hesitent to put
such an item in a perl script.......

CONFIGURATION:
-------------

The 'sample.asDrinksrc' file should have a working configuration.  Make 
sure it is copied to ~/.asDrinksrc.
The 'sample.asDrinkslist' file should have a working list of NAMES and URLS
Make sure it is copied to ~/.asDrinkslist.

**THEN EDIT THEM**


EXECUTION:
---------

        --headlines             Get headlines.
        --uf                    Get User Friendly Comic.
        --noupdate              Don't update the startmenu when done.
        --help                  Display this help.
        --version               Version information.

						-charlie schmidt
						-ishamael@themes.org

