Please also read the documentation in the folder "docs" (in tarball or
CVS version) or the folder "html" (in installed version).
Maybe you can find more help at http://www.gesindel.de
Or you can contact fontlinge@gesindel.de, after you have read
the docs and don't get further with a problem or if you
have ideas for features.



Contents
========

A) system installation
B) user installation
C) database setup
D) fill the database
E) upgrading from older Fontlinge versions
F) non-root installation



Fontlinge have a two-step installation, like i. e. OpenOffice.
This means that every user who wants to use Fontlinge has to execute
the two steps described in B) as well as the database setup as
described in C) and D)



To quickinstall, follow the steps below.



A) system installation

If your Linux distribution can install RPM packages, download and
install the Fontlinge RPM file. You can then continue with B)

Manual installation using the tar.gz or tar.bz2 file:

1. Type './configure'        as user.
   You can change several installation paths - type './configure --help'
   for details
2. Type 'make'               as user.
3. Type 'make test'          as user.
4. Type 'make install'       as ROOT.
   If you are creating i. e. a RPM package, you may want to use
   'make DESTDIR=/tmp/rpm_build_root install'
   Never use DESTDIR for a normal system installation!

****************************************************
*  Now you have finished the system installation,  *
*  but you still have to install for a specified   *
*  user. See B).                                   *
****************************************************



B) user installation

1. Type 'fontlinge_userinstall' as USER!
   This will install the WebGUI files to ~/public_html/fontlinge
   If you want to install into another directory, type i. e.
   'fontlinge_userinstall --htmldir /home/me/htdocs/'.
   fontlinge_userinstall will create a subdir 'fontlinge' in the directory
   you specify.

2. Type 'fontlinge_config' as USER   - OR -    edit ~/.fontlinge
   This will create your ~/.fontlinge config file.



C) database setup

Now let's setup the database. This requires a valid ~/.fontlinge, so do this
as user.

The easy way to setup the database is:
fontlinge_database_assistant --phoenix
If this works, you can skip the rest of this section and section D)

Prepare the database as user:
fontlinge_database_assistant --check

If user is not found, create it (with username/password from your ~/.fontlinge):
fontlinge_database_assistant --create-user [--dbadmin-user="MySqlAdminUser"]
    [--dbadmin-password="MySqlRootPassword"] [--mysqlclient="clienthost"]
The database administrator's username can be specified with
--dbadmin-user="MySqlAdmin" - defaults to "root" if not given.
If the root/dbadmin password is not given in commandline, you will be prompted
for it twice.
If your MySql server isn't running on localhost, you have to use
--mysqlclient="clienthost" to tell MySql the client host from where you want to
login into the database. "clienthost" stands for the IP adress or the hostname.
It depends on your nameserver (or /etc/hosts) if short or full host name is
needed, so using the IP adress is the easier way ;-) Another way is to use "%"
for clienthost. This allows database connections from _all_ hosts, but may be a
security risk.

Then --check again

If database is not found, create it:
fontlinge_database_assistant --create-database
Then --check again



D) fill the database

Finally you have to put data into the database.
At first generate the tables. Type:
fontlinge_database_assistant --import-database empty.SQL
WARNING: If the table existed before, data may be deleted!


Optional you can start with lots of catalogued fontinfos. (SUGGESTED)
Download my database from where you have downloaded this program, maybe 
on http://sourceforge.net/projects/fontlinge/

To fill the database, type:
fontlinge_database_assistant --import-text DOWNLOADED_FILE.txt


Now you've installed Fontlinge, look inside the docs/ directory for a
step-by-step introduction how to use the programs.



E) Upgrading from older Fontlinge versions

Do system installation as described in A).

Do user installation as described in B) - don't forget to call
fontlinge_config to update your ~/.fontlinge.

Run 
    fontlinge_database_assistant --phoenix 
to check and update your database.
If --phoenix doesn't work for you, use --update-database instead.

If you updated from Fontlinge <= 2.0.0, the MySQL user has to be
re-created because of missing ALTER rights in MySQL. This can be done
manually with fontlinge_database_assistant --create-user or with a
--phoenix run.



F) non-root installation

You can completely install Fontlinge as user if you don't have root
access to your system. Just set the corresponding ./configure options.
I recommend using at least
    ./configure --prefix ~ --perllibdir ~/perllib

~/bin should be in your $PATH.

Add  export PERL5LIB=/home/yourname/perllib  to your ~/.profile or
~/.bashrc so that the perl modules can be found. Please note that you
need to re-login after changing these files.

If the WebGUI detail preview can't find the fontlinge::* perl modules,
add   perl5lib=/home/yourname/perllib   to your ~/.fontlinge.
Replace /home/yourname/perllib with the directory where the Fontlinge
perl modules are installed. It's the directory you specified at
./configure --perllibdir.
Then run fontlinge_getconfig --webgui and reload the detail preview page
in your browser.

If you don't have CREATE rights in MySQL, ask your admin to setup the
database as described in C). After that, you only need normal user
rights (SELECT, UPDATE, INSERT, DELETE).
If you updated from an old Fontlinge version and have no ALTER rights,
avoid using fontlinge_database_assistant --update-database or ask your
admin to do it. If you have DROP and CREATE rights, you also can
re-create the database. Don't forget to backup your sortlist!

