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

With help from:   Dagmar d'Surreal <nospam dagmar at d'surreal noapostrophe dot org>
                  Ethan Fischer <allanon@crystaltokyo.com>
		  PinkX for the pixmaps  (except the crappy freshmeat one)
		  Arjuna Shunn 
		  #afterstep 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

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

netscape or nss 
	nss is recommended: http://users.telekabel.nl/eon/netscape.html
	www.netscape.com

perl 5.004
	www.perl.com


NOTES:
-----

There are many routies to this this script.  Each takes the latest news
(or whatever) from nerd/linux oriented sites, and puts it in your AfterStep
startmenu.

User Friendly comic strip.
Linux Today news.
Segfault news.
Freshmeat headlines.
Slashdot news.
LinuxApps headlines.
linux.com Tuneup tips.
Yahoo! Weather.

If you think a news site should be added to asDrinks, read the CONTRIB file

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/

Make the following directories in your startmenu directory FIRST:

start
start/asDrinks
start/asDrinks/Freshmeat
start/asDrinks/LinuxToday
start/asDrinks/Segfault
start/asDrinks/Slashdot
start/asDrinks/Tuneup
start/asDrinks/LinuxApps
start/asDrinks/Weather

These directories can, of course, by changed by editing the config file.

Copy the 'sample.asDrinksrc' file to ~/.asDrinksrc  and edit as needed. 

Just put the script somewhere in your path (like /usr/local/bin). 


*If you have AfterStep  version < 1.7.55:  

	 Run the script, and then MANUALLY UPDATE the startmenu.  There is
	 NO way to auto-matically update the startmenu in a version less
	 than 1.7.55.

*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 30 minutes (or whatever).

This tarball should have also come with a few pixmaps.  These 16x16 xpms 
are meant for startmenu items.  If you use startmenu items in your look,
copy these xpms to a directory in your AfterStep PixmapPath

~/GNUstep/Library/AfterStep/desktop/icons/common/   is a good place

Thanks to PinkX for the pixmaps (except that crappy freshmeat one, if any
one could make me one *THATS RECOGNIZEABLE*, it would be much appreciated).


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

The 'sample.asDrinksrc' file should have a working configuration.  Make 
sure it is copied to ~/.asDrinksrc.

**THEN EDIT IT.**  Make sure it is good for YOUR system and connection.


EXECUTION:
---------


--slash		 	Get Slashdot headlines.
--fm			Get Freshmeat news.
--seg			Get Segfault headlines.
--lt			Get Linux Today headlines.
--uf			Get User Friendly comic.		
--tuneup		Get linux.com Tuneup tips.
--apps			Get LinuxApps headlines.
--weather		Get the local weather.

--news			Only get the news (no comics).
--noupdate		Don't auto update the startmenu.
--none  	        Don't get any news, just update the startmenu.
--help			Display help.

These can be combined.  So

asDrinks.pl --slash --fm --uf

  would only get the Slashdot, Freshmeat headlines, and the User Friendly comic.  
asDrinks.pl --seg --lt --noupdate

  will get the Segfault and Linux Today headlines, and won't update the 
  startmenu.

asDrinks.pl --none
  
  will just update the startmenu, it wont get any news.

asDrinks.pl --slash --help

  will tell you available commands, as to not confuse things.


						-ishamael
						-ishamael@themes.org
