-- Moodle Commander v0.002a --

This is totally experimental software. 

The author accepts no responsibility for the use of this software and provides
it on an ``as is'' basis without express or implied warranty. In short: if it
breaks, you get to keep all the pieces.

If you are using this stuff, please email gavin.mccullagh_AT_gcd_DOT_ie.

--Utilities--

mdlpasswd   
    allows an admin user to change a user's password
mdlcheckpasswd
    checks an existing user's password
mdlfinduser
    search the user database


--Install--

As with other Moodle extensions unzip the zip archive into your Moodle source
code folder.  You should now have a new directory called "bin" alongside the
other folders.


--Config For Users--

Users must add this bin directory to their PATH environment variable. For
example, if they use the bash shell:

  export PATH=$PATH:/usr/share/moodle/bin

The user must then create a file in their home directory called .mdlcommander
with the following three lines in it:

username=[moodle_username]
password=[moodle_password]
debug=0

Replace [moodle_username] and [moodle_password] with the user's own username
and password on the Moodle system.  If something is not working you can get
extra debug information by setting debug to 1.

The user must have read access to the main Moodle config.php.  On Debian,
that file is:

	/usr/share/moodle/config.php

On debian systems you can grant this by adding the user to the www-data group
(the group of that file).  At some point it is intended to come up with a
better solution to this but for now read access is required.

NB: Moodle Commander will only work if provided with the username and password
    of an ADMIN user.