Installation of libremail


Installation of the applications

If you recovered the sources compressed file, start by decompressing it:

Place the file libremail.tar in the directory of your choice and unarchive it:
If you recovered an update (file majlibremail.tar),see note at the end of the paragraph.


The various archival files will be recopied in under directory libremail .

Go in this directory and launch: to compile the sources.


If you recovered the file with the executable programs, the installation is done in a similar way, but without the need to run make


The executable files of libremail are ready. However necessary move them or add the access to subdirectory libremail/bin in the variable of environment PATH .
In the last case, better is worth to modify a file directly where variable PATH is declared (/etc/profile, .bashrc or .bash_profile), then reconnect (login).


It any more but does not remain you to create your file of configuration (by basing you the file exemple.cfg) and the root directory of your mails to be able to reach your letter-box.


Note : If you recovered an update (file majlibremail.tar), you must position just in top of the directory libremail which contains the files of a former version.
The unarchivage of the file majlibremail.tar and the compilation of the modified sources, are carried out then as described above.


Selection of a default language

Since version 2.0, the user interface of Libremail and the contents of the mails generated by several filtering tools, are available in all the languages of this Web site.
The various tools of Libremail analyze the environment variable $LANG to choose the language of the user interface.

Consequently, if the environment variable $LANG has not been initialized, or if it refers to a nonavailable language, Libremail cannot work.
To be able to use Libremail in these 2 cases, it is necessary to create data files for a chosen default language.

The names of these files are obtained by removing the linguistic suffix (a . followed of 2 letters) of the files from which they are created.
For a correct operation of the default language, It's better to avoid using files whose name ends in -utf .
It is advised to establish links symbolic systems rather than copies to create the files of the chosen default language.

For example to choose the English language as default language, the commands:
        ln -s mess-libremail.en  mess-libremail
        ln -s mail-supbcc.en     mail-supbcc
        ln -s mail-supgros.en    mail-supgros
        ln -s mail-suphtm.en     mail-suphtm
 will be launched.

If one wishes that the files of the language by defect are used systematically (thus, without holding account of the variable of environment $LANG), it is necessary to add a file of name deflang-libremail (it can be empty) in the directory containing the commands of Libremail.


Installation of documentation

If the file containing documentation is compressed, start with a decompression:

Unarchive the file containing documentation:

under directory libremail will contain one or more files presentation (a file by language installed), as well as pages of man in under directories of libremail/man .

More precisely, the pages of man will be installed in the directories : with ?? who is a language among: fr de es it nl pt eo .


For the languages other than English, the documentation filename contains -utf or -iso to indicate the accented charset used (UTF-8 and ISO8859-1).
If your man pages do not display or displayed with an incorrect charset, you can use the other documentation file.


The man files are provided not compressed, which makes it possible to see their real physical contents. On the other hand, the pages of man of Libremail occupy approximately 200 Kbytes by language.
In order to reduce this space, one will be able to compress the files while launching since the directory containing all the malls of a language:
If the command bzip2 (the best compressor) is not available, one will use gzip in the place.


Normally, if the PATH variable has been initialized to find the executable files of Libremail in .../libremail/bin , man pages located in .../libremail/man are accessible.

Si ce n'est pas le cas, il y a deux solutions pour corriger le problème :

For that, the cleanest method will be to add an access path to the variable of environment MANPATH .

If this variable of environment was not declared, (frequent case), it will be enough to add in /etc/profile (it is necessary to be root for that), or on its account in the file .bashrc or .bash_profile, 2 lines of the form: (by supposing that one was in /home/xxx when one unarchived the file documentation).

The pages of man will be accessible to next the login.


Another method less clean move the new pages of man in the directories containing all the other pages: