                       MySQL Administrator for Windows

                          Version 1.01 - 22/04/1998

                      David B. Mansel <david@zhadum.org>

  1 Introduction

    MySQL Administrator for Windows is a simple front-end graphical administration
    program for Microsoft Windows users. 

    MySQL Administrator for Windows works on both Windows 95 and Windows NT 4.0.

    The program allows a number of server connections to be set up and displayed
    in a tree view. Each server connection can be configured with a required host,
    login username and password and port address, as well as being given a friendly
    free format display name. These server connections can be added, removed and
    edited, and are automatically saved to the system registry upon program exit.
    All stored passwords are encrypted (not a strong algorithm though!), although
    the user can chose not to save the password, in which case it will be prompted
    for when a connection to a server connection is made.

    (The password encryption should not be relied upon if you are running in a
    multiuser environment, such a machine with a network connection, or a shared
    PC. Under NT, careful maintenance of registry security will ensure a
    higher degree of protection. However, by choosing not to save the password,
    such issues can safely be ignored.)

    Once one or more server connections have been configured, a connection can be
    made to the MySQL service on the local or remote machine. Note that all client
    to server communications are done using a resident Winsock. Apart from
    disconnecting again from the server, the following actions can be performed:

    - Descend the tree view to reveal databases and tables on the server. A full
    list of database tables is only available if you have the correct permissions

    - Request the server to stop

    - View server statistics

    - Display a real time list of server processes/threads

    - View server variables

    - Display table structures

    - Display table keys/indexes

    - Reload privilege tables, refresh open database tables and reopen the log
    file

    - Create a new database

    - Drop an existing database (two confirmations required)

    - Run an SQL command against a database


  2 Installation

    To install MySQL Administrator for Windows, simply create a new directory
    anywhere on your system. Extract the following files from the distribution
    zip file into this directory:

    MySQLWinAdmn.exe
    libmySQL.dll

    You could of course add MySQLWinAdmn.exe as a shortcut, either to a menu
    or on to your desktop.

    If you wish to remove the program, just delete your directory and any
    shortcuts that you might have created. You may also wish to delete the
    associated registry key...

    HKEY_CURRENT_USER/Software/David Mansel/MySQLWinAdmn

    Currently, I don't think that this very simple program warrants a full
    installation package. Further to this, newer versions of this program
    should just be installed straight over any current installation.


  3 Copyright

    None! Do as you wish with this program. The MySQL client part (libmysql.dll)
    has also kindly been placed in the public domain by Monty.

    I would ask a few things:

    - I know my button bar icons are pretty poor. If you have an artistic side,
    I'd love to include better icons on the button bar, so feel free to submit your
    art work to me. I need any submitted icons to be of the following format:

    Windows BMP file format
    16 x 16 pixels
    16 colours
    A uniquely coloured background, not used anywhere else in the icon
    Completely original and freely usable art work - no copyright issues please!
    A comment for which icon your art work should replace

    - If anyone could to put together a Windows help file, that would be great!

    - If you actually use this program properly, especially anyone State Side,
    I have a real passion for JellyBelly jelly beans - hideously expensive in the
    UK. If a pack of these were to land on my door mat one morning, it would be a
    pleasant suprise! :)


  4 Version History

    Version 1.01 - 22/04/1998
    -------------------------

    Changed to work with client version 3.21.29a-gamma
    Internally, all DLL calls are now stdcall rather than cdecl
    Added better results box cell sizing logic, although it's a bit slow
    Added row count truncation to the results box, set at 1000 rows
    Various spelling/grammar corrections in dialogues and hints
    Readme.txt added to distribution archive

    Version 1.00 - 01/03/1998
    -------------------------

    First release, using client version 3.21.25a-gamma
