X-Sys README
============
What is X-Sys?

X-Sys is a plugin for X-Chat that allows you to display your current system statistics in
a channel, private conversation or just in an echo to yourself for testing purposes.
It is supported on Linux, running on various architectures. Right now x86, ppc, ppc64, sparc,
sparc64 and alpha are supported, with parisc and ia64 implemented but awaiting testing.

---------------
Who wrote this?

X-Sys is a Mike Shoup creation, from the very first alpha releases to the open-source
version 1 releases. But then, things stalled. For a few months (more like a year almost)
Mike didn't work on X-Sys. The last version that had been written was 1.0.5.
The website was gone, and I (Tony) couldn't find Mike. So, I took over and improved it to my liking. 
It turned out that Mike was still around, though, he contacted me and started development again,
now called version 2, a complete rewrite. Various 1.9 beta's came out that I contributed patches to,
and starting with version 2.0.0 I'm maintaining xchat-xsys again while Mike Shoup has started work
on a new system information plugin, this time written from scratch in Python.
It is called Py-Xsys and appears to be limited to the x86 architecture for now.
Feel free to have a look: http://mshoup.us/index.php/category/works/

===========
COMMANDS

X-Sys 2 has the following implemented commands:
/XSYS & /EXSYS - Output current version, either to channel or echoed on screen.
/CPUINFO & /ECPUINFO - Echoes or says current cpu statistics
/SYSUPTIME & /ESYSUPTIME - Echoes or says current uptime
/OSINFO & /EOSINFO - Echoes or says various OS statistics
/SOUND & /ESOUND - Echoes or says the current sound card, as determined by ALSA
/UNAME & /EUNAME - Echoes or says 'uname -a'
/NETDATA & /ENETDATA - Echoes or says total amount transferred through a network
	interface. Use like: `/netdata eth0' (where eth0 is a network interface)
/NETSTREAM & /ENETSTREAM - Echoes or says amount of bandwidth being used.
	Use like: `/netstream eth0' (where eth0 is a network interface)
/DISKINFO & /EDISKINFO - Echoes or says free space on partitions. The DISK command has a
	few arguments as follows:
	ALL - Displays every partitions
	/mount - Displays free space for that specific mount point
	No arguments just displays total free space
/MEMINFO & /EMEMINFO - Echoes or says memory information.
/VIDEO & /EVIDEO - Echoes or says the current video card on the PCI bus
/ETHER & /EETHER - Echoes or says the current network card on the PCI bus
/DISTRO & /EDISTRO - Echoes or says which distro you're running
	If this doesn't work for your distro, look for a *-release file or similar in /etc
	E-mail this to chainsaw@gentoo.org

and the big one:
/SYSINFO & /ESYSINFO - Complete system information!

Two output control commands:
/XSYS2FORMAT , No arguments, it will print just the current formatting string.
   It will take any arguments to it as the formatting string.
   The formatting string can consist of any letter/numbers, and is used to format
   the output. The following special symbols can be used:
   
   %B      : Bold
   %Cnn    : Foreground Color, where nn is a number corresponding to a mIRC color
   %Cnn,nn : Foreground,Background Color
   %R      : Reverse Foreground/Background Colors
   %O      : Reset Color and Format (thats an 'oh' not a 'zero (0)')
   %C      : Reset Color
   %U      : Underline 

/PLAYING will either print or allow you to set the text for /np.
The default is now_playing, but you can set this to whatever text you prefer. In older
releases, it said xmms_playing for /xmms, and bmp_playing for /bmp.
Due to a bug in the BMP output, version 2.0.1 could spot the difference between XMMS and
BMP automatically. However, that bug has now been resolved, so allowing a custom now_playing
string and having one command seems clearer to me.

/PERCENTAGES will allow you to set whether to use percentages in plugin output or not.
Percentages are enabled  by default. Use a zero value to disable, and a non-zero value
to enable. If unsure, use 1.

XMMS / BMP support:
/NP & /ENP - Reports what's currently playing.
===========
BUGS
(none known)

E-mail me your bug reports at chainsaw@gentoo.org
Please include the following information:
- what architecture you are using (amd64, ia64, parisc, ppc, ppc64, sparc, sparc64 or x86)
- what linux distribution you are using (Gentoo 2005.1, Fedora Core 4, etc)
- what compiler you have used to compile X-Sys, i.e. gcc (GCC) 3.4.4 (Gentoo 3.4.4-r1, ssp-3.4.4-1.0, pie-8.7.8)
- what version of X-Sys you are using

===========
Thanks!
Remember, everything here is:
(C) 2003, 2004, 2005 by Michael Shoup
(C) 2005 by Tony Vroon
All Rights Reserved.
Visit http://dev.gentoo.org/~chainsaw/xsys/ for release information.

Feel free to e-mail me for feature requests, or see if I'm online on irc.freenode.net
