/*******************************/
/* SAMP-MySQL-lite v0.11       */
/*                             */
/* Installation Notes          */
/*******************************/

1. Archive contents:
--------------------

o samp-mysql-linux: Linux sourcecode.
o samp-mysql-win32: Windows sourcecode (devcpp project).
o sampmysql.so: Linux plugin.
o sampmysql.dll: Windows plugin.
o libmysql.dll: needed to execute plugin properly (see 3. Windows Installation).
o installation-en.txt: English installation notes.
o installation-fr.txt: French installation notes.
o a_sampmysql.inc: .inc file to use in your scripts.
o Untitled.pwn: example for how to use the plugin (be careful to change with your own settings).



2. Linux Installation:
----------------------

o Create a folder "plugins" into the server's one (samp server).
o Copy "sampmysql.so" in this folder.
o Configure "server.cfg", without forgetting to specify extension file (.so).
o Now if you launch server, plugin's working.
o if you have problems, verify that you've intalled MySQL and "libmysql" (mysqlclient or libmysqlclient).



3. Windows Installation:
------------------------

o Create a folder "plugins" into the server's one (samp server).
o Copy samp-mysql.dll into this folder.
o Copy libmysql.dll from this package to the same directory as samp-server.exe.
  NOT into the plugins directory
o Add the following line to your server.cfg:
  plugins samp-mysql
o When launching your server, you should get a message which indicates that plugin is loaded.



4. Linux Compilation:
---------------------

o First, install the libmysqlclient package (not included in this package).
o Open a console (command-line).
o Type this command: %gcc -Wall -fPIC -c sampmysql.cpp -DLINUX -ISDK/amx
o Type this second command: %gcc -shared -W1,-soname,sampmysql -o sampmysql.so *.o -lmysqlclient



5. Windows Compilation:
-----------------------

o If you have Dev-cpp installed, verify if the libmysql Devpak is intalled too (not included in the package).
o Open the devcpp project file (.dev), and click on "Execute", then on "Rebuild all".



6. How to use SAMP-MySQL in Pawno:
----------------------------------

o Copy "a_sampmysql.inc" in the folder "include" in "Pawno" folder which is included in the windows release of sa:mp server.
o Include this header at the beginning of your script: "#include <a_sampmysql>" (without ").
o Compile (F5 key) and there's no error.
o To help you, "Untitled.pwn" is an example and it's included in the release.



7. Known Bugs:
--------------

o 7.1 Under Windows: if mysql server is not running, samp server crashes if a function is called after samp_mysql_connect fails to connect.



8. Know Issues:
---------------

o => 7.1: make sure to verify the returned value by every function before continuing to process a query.



9. History:
-----------

o v0.11:
   - Error messages added when a function fails.
   - Some fixes added to make plugin working under windows.

o v.01:
   - First release of the plugin.
   - Minimal MySQL support: connecting, querying, fetching, closing.