X-Git-Url: http://git.iain.cx/?a=blobdiff_plain;f=README.md;h=df5651b146b0afbb94cd703c68b018d4eb43529a;hb=da7982a6dc5c0387d4aadc996cfe5dc53dafbd45;hp=b89592892bc930c3e32351f6580ba536aeeafc6c;hpb=10b04d24c2139d54d20a9ef80a9de9ed79177147;p=pstop.git

diff --git a/README.md b/README.md
index b895928..df5651b 100644
--- a/README.md
+++ b/README.md
@@ -2,3 +2,29 @@ pstop
 =====
 
 pstop - a top-like program for MySQL
+
+pstop is a program which collects information from MySQL 5.6+'s
+performance_schema database and uses this information to display server
+load in real-time. This should also work for MariaDB 10.0 though I
+have not tested this at all. Data is shown by table or filename and the
+metrics also show how this is split between select, insert, update or
+delete activity.
+
+This program was started as a simple project to allow me to learn go,
+which I'd been following for a while, but hadn't used in earnest.  This
+probably shows in the code so suggestions on improvement are most welcome.
+
+Access to MySQL is currently via a defaults-file which is assumed to be
+~/.my.cnf. I should probably make this more configurable.
+
+Do not forget to ensure that the MySQL user you configure has access
+to the performance_schema tables.
+
+See also BUGS and NEW_FEATURES which describe things that probably need
+looking at, keys.txt which describes the keys used inside pstop, and
+screen_samples.txt which provides some sample output from my own system.
+
+Feedback and patches welcome.
+
+Simon J Mudd
+<sjmudd@pobox.com>