HOW TO USE LISTAT:
------------------

Listat is written is Perl so it should be usable right out of the box.

NEW: If you find any difficulty running it from command line, you can use
     the online version at http://wordsmith.org/anu/listat/generate.html

You can simply run it as:
	listat -list list.txt -text report.txt -html report.html
where:
	list.txt is the list file with email addresses (one per line)
	report.txt is the file where stats are written in text format 
	report.html is the file where stats are written in html format 

To sort the stats by domainname, you can specify -sort option:
	listat -list list.txt -text report.txt -html report.html -sort name

Default sort option is COUNT i.e. the domain having the most subscribers
come on top. e.g.
        listat -list list.txt -text stats.txt -html report.html -sort name

The files for flags images are in flags subdirectory.  You can change the
variable $flag_dir in listat script if you wish to keep the flag images
in a different directory.


SUMMARY OF USAGE OPTIONS:
------------------

Usage: listat switches arguments
  -list filename       List file with email addresses, one per line 
  -text filename       Output file for stats in text format 
  -html filename       Output file for stats in HTML format 
  -sort name|count     Sort order: domain name or domain count (default: count)
  -help                Help message 
  -version             Version information 

All of these options (and some more) can be set in the configuration file
listat.conf.

PROBLEMS:
--------

If you have any problems, please make sure:

o the path to perl in the first line of the listat is correct for your system
o the file is executable

You may want to check the Listat homepage at:
http://wordsmith.org/anu/listat for any updated information.

FEEDBACK
--------

Your feedback on Listat is very important to me. I welcome any questions
or comments you may have for improving Listat. Please contact me if you
have feature suggestions, bug reports or if you notice any problems with
the documentation.

Anu Garg
garg at wordsmith.org
http://wordsmith.org/anu
