Installing MyCC
===============

* Building MyCC
   -Notes on QT
   -Compiling under Linux/Unix
   -Compiling under Windows

* Linux Binary Installation

* Windows Binary Installation

* Contributors to MyCC


Building MyCC
=============

You need the following tools to create a MyCC binary from the source
distribution:

   * MyCC source distributions for Windows are provided as compressed
     `tar' archives and have names like `mycc-VERSION-src.tar.gz', where
     `VERSION' is a number (for example, `0.8.2').

   * GNU `gunzip' to uncompress the distribution.

   * A reasonable `tar' to unpack the distribution.  GNU `tar' is known
     to work.  Sun `tar' is known to have problems.

   * A working ANSI C++ compiler.  gcc >= 2.95.3 < 3.0.0 are some of
     the compilers that are known to work.

     For Microsoft Windows Operating Systems, Microsoft Visual C++ 6.0
     with the latest service pack is highly recommended.

   * A good `make' program.  GNU `make' is always recommended and is
     sometimes required.  If you have problems, we recommend trying GNU
     `make' 3.75 or newer.

   * MySQL Client libraries and headers need to be installed.  For more
     information, check http://www.mysql.com

   * Trolltech's Qt 3.0.2 library is required to build this application from
     source.  For more information regarding Qt visit http://www.trolltech.com


Notes on QT
-----------

It is highly recommended that you compile QT with the following options
enabled:

     -thread
     -shared

The source distribution of MyCC assumes you have compiled QT with the
above settings.  If QT was compiled differently, you will have to
modify MyCC.pro.in and the generated Makefile in order to compile
MyCC correctly.

You probably also want to add the following options to fully enable
graphics support in MyCC:

     -qt-gif
     -qt-imgfmt-png
     -qt-imgfmt-jpeg
     -qt-imgfmt-mng

Our statically built binary links against QT compiled in the with the
following configure arguments:

     -static
     -qt-gif
     -thread
     -no-stl
     -qt-imgfmt-png
     -qt-imgfmt-jpeg
     -qt-imgfmt-mng

For more information on building the QT library, read the "Installation"
section of the QT manual.


Compiling MyCC under Linux/Unix
-------------------------------

The basic commands you must execute to install a *MyCC* source
distribution are:

     shell> gunzip < mycc-VERSION.tar.gz | tar -xvf -
     shell> cd mycc-VERSION
     shell> ./configure
     shell> make

For a list of possible configure options type:
     shell> ./configure --help


Compiling MyCC under Microsoft Windows
--------------------------------------

The basic steps for compiling *MyCC* under a Windows environment
are:

     * Unzip the source distribution.

     * copy the file win32/MyCC.pro to the root directory of
       the unziped source distribution

     * Edit MyCC.pro and make sure the `LIBS` and `INCLUDEPATH`
       directives point to the correct places.

     * from the command prompt, type:
       C:\path_to_mycc_src\>qmake -t vcapp -o MyCC.dsp MyCC.pro

       The above command will create a file called MyCC.dsp

     * Open the newly created file `MyCC.dsp` in Microsoft Visual C++
       and select the `Build` option from the `Project` menu.


Linux Binary Installation
=========================

To install a binary distribution, follow the steps below:

  1. Obtain a distribution file from one of the sites listed in *Note
     Getting MySQL: Getting MySQL.

     MyCC binary distributions are provided as compressed `tar'
     archives and have names like `mycc-VERSION-OS.tar.gz', where
     `VERSION' is a number (for example, `0.8.2'), and `OS' indicates
     the type of operating system for which the distribution is intended
     (for example, `linux').

  2. Pick the directory under which you want to unpack the
     distribution, and move into it.  In the example below, we unpack
     the distribution under `/usr/local' and create a directory
     `/usr/local/mycc' into which MyCC is installed.  (The following
     instructions therefore assume you have permission to create files
     in `/usr/local'.  If that directory is protected, you will need to
     perform the installation as `root'.)

  3. Change into the intended installation directory:

          shell> cd /usr/local

  4. Unpack the distribution and create the installation directory:

          shell> gunzip < /path/to/mycc-VERSION-OS.tar.gz | tar xvf -
          shell> ln -s mycc-VERSION-OS mycc

     The first command creates a directory named `mycc-VERSION-OS'.
     The second command makes a symbolic link to that directory.  This
     lets you refer more easily to the installation directory as
     `/usr/local/mycc'.

  5. Change into the installation directory:

          shell> cd mycc

After everything has been unpacked and installed, you should now be
able to execute MyCC and test your distribution.

You can start MyCC with the following command:

     shell> /usr/local/mycc/MyCC


Note:  MyCC is a Graphical GUI Client.  This means you will need to be
       running in an X environment before starting MyCC with the above
       command.


Windows Binary Installation
===========================

To install a binary distribution under Windows, follow the steps below:

  1. Obtain a Windows distribution file from one of the sites listed in
     *Note Getting MySQL: Getting MySQL.

     MyCC binary distributions for Windows are provided as compressed
     `zip' archives and have names like `mycc-VERSION-OS.zip', where
     `VERSION' is a number (for example, `0.8.2'), and `OS' indicates
     the type of operating system for which the distribution is intended
     (for example, `win32').

  2. Unzip the Windows binary distribution to a directory  of it'ss own.

  3. Click on `Setup.exe` and follow the installation wizard.


Contributors to MyCC
====================

Below are the contributors who have taken an active role in the development
of MyCC:

Jorge del Conde <jorge@mysql.com>
Main concept, programming, design, GUI

Sasha Pachev <sasha@mysql.com>
Unix configuration scripts, optimizing, bug fixing

Michael (Monty) Widenius <monty@mysql.com>
Main concept, design

Reginald Stadlbauer <reggie@trolltech.com>
Several parts of the Syntax Highlighing Editor

Adam Hooper <adamh@densi.com>
Several bug-reports & MyCC's mailing list

MySQL AB
MySQL Server, Client libraries, etc, etc, etc... :)

Trolltech AS <info@trolltech.com>
QT Toolkit, support


