Files
note/mysql
TLINDEN 9cf564ffe4 CHANGED: does no more use the external touch command to create a new
file, use perls open() instead.
CHANGED:        excluded some of the help texts from the usage message and the
                interactive help command to a manpage.
ADDED:          new commandline flag "--encrypt" which one can use to encrypt
                the mysql database password. This will be decrypted before
                connecting to the db. There is also a new config file option
                "encrypt_passwd" which indicates an encrypted db-password.
ADDED:          another new config option "ShortCd", which can be set to "yes"
                or 1 and if set, then a command like "cd 13" would jump
                directly to the topic of the note with the number 13.
ADDED:          now you can at any time cd back to the "root" of the
                topic-structure using the command "cd /".
CHANGED:        mysql.pm does now only do a table-lock on single write
                accesses, no more on the whole session. This allows one to
                access the same db twice or more.
FIXED:          Changed README and Changelog for readability on 80 by 25
                displays. And changed indentation of the note script itself.
ADDED:          NOTEDB.pm - a generic module, which holds some methods, which
                are used by binary.pm, mysql.pm and dbm.pm.
ADDED:          NOTEDB.pm generate_search(), which allows one to
                use AND, OR and various combinations of them using ( and ).
ADDED:          a search does now return the 2nd line of a note if a matching
                note's first line is a topic.
CHANGED:        use "unshift" instead of push to add $libpath to @INC.
ADDED:          a new feature, Caching of notes. supported by binary.pm and
                mysql.pm. To turn it on, one need to set "Cache" in the config
                to a true value.
2012-02-10 20:22:49 +01:00
..

README for the mysql database installation for note

Requirements
============

        You need the following things:
                o perl installed (5.004x)
                o mysql database installed and running
                o Mysql perlmodule (you can find it on 
                  http://www.mysql.org) PLEASE NOTE:
                  It needs the Module "Mysql". The install.sh
		  script will install it for you directly from
		  CPAN if you like. Newer versions
                  are DBI, which you can also use to access
                  mysql databases. If you want to use it, you
                  have to rewrite the program. Please let me
                  know, if you did it :-)
                o permissions to create a new database and
                  to write data to this database.



Installation
============

        First, make sure all these things above are ok.
        You can use the script "install.sh" to create a new
        database and the table structure. You might edit 
        the script before running it.

        If you are getting trouble, i.e. if you have not the 
        required permissions to do that, please make sure,
        you can. 
        As user root, you have to give your user the 
        neccessary permissions. Please refer to the mysql 
        documentation, how to do that.
        After that repeat the step above.

	You can find a sample config file within the subdirectory
	"config" named noterc. There are some special values
	which you can use to connect to a different database
	then the default.
	install.sh will create the following database:
		name: 		user_note
		Maintable: 	note
		Number:		number(int 10)
		Note:		note(text)
		Date:		date(text)

	You can use the file "permissions" as a template for
	modifying a users permissions to her database. Please
	note, that there are different version of mysql out 
	there with different access privilege systems, which
	are not compatible, refer to the documentation shipped
	with your mysql installation to learn, how many fields
	are available and what they are for.

	You may also take a look to:
	http://www.mysql.org/Manual_chapter/manual_Privilege_system.html	


        This should be all.