--------------------------------------------------------
Moodle RPM package		2005-11-26
KITA Toshihiro  http://t-kita.net/
--------------------------------------------------------

-- simple instructions -----------------------------------------------------

* install
rpm -ihv http://t-kita.net/rpm/moodle/moodle-1.5.3-0fc1.noarch.rpm

* upgrade     # it should work
rpm -Uhv http://t-kita.net/rpm/moodle/moodle-1.5.3-0fc1.noarch.rpm

* uninstall
rpm -e moodle
/tmp/moodle-unsetdb.sh    # delete anything remained (DB data, too)

----------------------------------------------------------------------------

This is a RPM package of Moodle (http://moodle.org).
The packaging has been done on Vine Linux 3.1/3.2, 
and is intended to make the smooth installation into Japanese environment 
possible.
Installation in environments other than Japanese also should work.
This package requires php >= 4.3 and php-mysql though they are not in
the dependency information.
Any reports and comments will be appreciated.

During rpm installation, moodle-db-setup.sh is executed, but 
if it fails, run moodle-db-setup.sh afterwards manually.

Edit /var/www/html/moodle/config.php if necessary, and 
access http://SERVERNAME/moodle/ with a Web browser.
Installation will be completed after the required steps on the Web.

Moodle scripts will go into
/var/www/html/moodle/ 
and other files will be placed at 
/var/lib/moodle/, /var/lib/moodle-rpm/ .

Uninstallation does not include the DB clearance for inheriting 
the previous data when you upgrade by 'rpm -U'.
If you want to completely uninstall it, 
run moodle-unsetdb.sh after the rpm uninstallation.

Upgrading by rpm -U should works, but do make your backup of your contents
in case.
After rpm -U upgrading, login Moodle as admin, and
you will have DB upgrading automatically.

cron.php is invoked every 5 minutes by /etc/cron.hourly/moodle-chk.sh .

mk-another-copy.sh is an example script for making a copy of Moodle files
installed by rpm to run with other URI.
If you want to run several Moodles on a machine, 
it is useful to make copying scripts by modifying the parameter settings in 
mk-another-copy.sh .
-----------------------
* install by copying :
cp /var/lib/moodle-rpm/mk-another-copy.sh ./
vi mk-another-copy.sh      # you may want to change installation directory
./mk-another-copy.sh
* upgrade by copying :
rpm -Uhv rpmfile
./mk-another-copy.sh       # does upgrading if already installed
* uninstall the copied one
./mk-another-copy.sh --uninstall
-----------------------

Parameter settings like $CFG->lang are inserted in config.php. 
They can not be overwritten in Moodle admin pages if you do not
delete them from config.php.

Additional scripts to deal with problems in Japanese files, langlib.php
ver. 1.3.4 by Takahito Kashiwagi, are included.
lang/ja/fonts/ and lang/ja/lib/ are added, 
lib/setup.php and lib/moodlelib.php are patched to use the library.
They are patched to work only if lib/ exists under the directory of 
current langpack, so it is safe for other languages than Japanese.

htmlentities(x) often causes corrupted characters in Japanese (and also maybe 
in other langs). To avoid it, in all the .php files, modification like
htmlentities(x,ENT_COMPAT,$SESSION->encoding) 
has been done to specify CHARSET explicitly.
A script replace-htmlentities.pl is used for the replacement.

And also glitches of
Bug #4325 - order of firstname and lastname in filling forms
Bug #4326 - dropdown order of date in print_date_selector()
have been fixed in this package.

# moodle-quizans1.patch is a patch to display usernames, all the answers
# when "Show mark details" is checked on Overview of Quiz Reports.
# The patch has not been applied to this package.


This package supports only MySQL. 
# Support for PostgreSQL will be added if I have any help for testing the
# experimental package.

--------------------------------------------------------------------
