Next: , Previous: Top, Up: Top


1 User guide

1.1 About

Memo is a recursive acronym standing for Memo Enables Memory Optimisation.

Memo's purpose is enhancing its user's ability to remember foreign words and phrases by regular repetition of a properly chosen material. Memo can be used to regularly send emails containing packs of words or phrases to be translated by the receiver. User replies to the e-mail filling in the answers. Memo parses the reply and updates its internal database with user's results. Sets of questions for every test are chosen basing on user's performance in previous tests – the words that are most difficult for the user are sent more frequently.

1.2 Requirements

The following software is required to run Memo.

Besides, you are going to need a shell account.

1.3 Installation

Just do

     ./configure && make && sudo make install

Details are available in the INSTALL file which can be found in Memo releases.

1.4 Running Memo

Memo's command line options may be displayed executing:

     memo --help

1.4.1 Adding new phrases to the database

In order to add a new word to the database run the following command:

     memo --add-pair "a phrase" "its translation"

If the database does not exist it will be automatically created.

1.4.2 Sending and replying to tests

Having a database filled with pairs of phrases you are ready to send tests. Now it's time to configure receiving. Be sure that your incoming mail is filtered by procmail. If it is not, find out how to enable it in the procmail's documentation.

Add to your ~/.procmailrc the following rule.

     :0:
     * ^Subject: Re: memo \[[0-9]*\]
     | memo --receive

Now procmail should forward your replies to Memo's tests to the Memo reply parser.

In order to send a test set MEMO_EMAIL environment variable to you e-mail address and run the command shown below.

     memo --send

In order to get your tests sent automatically consider adding to your crontab the following line after adjusting it to your needs.

     19  12  *   *   *   memo --send

Don't forget to inform the authors in case of spotting a bug or any other unwanted behavior which doesn't seem to be a feature.