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

3. How to use Freemacs with MULE.

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

MULE provides your Freemacs editor with five new functions, which get installed into the USER library (they have have prefix U:).

If you have chosen a key binding for the functions during the installation, you can invoke them by hitting the corresponding keychords. If not, you can invoke them with M-x, followed by the funcion's name.

The functions are:

1. kbd-fnt-ld ("keyboard and font loading").

This function loads a font into the video memory, in the upper ASCII table (characters 128 to 255), and a keyboard driver, which will have your keyboard display those characters.

When you invoke this function, you will be prompted for an encoding name (see files ENCODING.TXT and LANGS.TXT for more info).

If you type "cyr1", your Freemacs should start displaying Cyrillic characters.

To find out how to get the various Russian letters with your keyboard, see the keyboard mappings in the files "cyr1_map.ps" (if you use the .txt version, make sure you first loaded Cyrillic fonts!).

2. kbd-fnt-uld ("unload keyboard and font").

Restores font and keyboard driver. If you have typed something in Russian and then invoke kbd-fnt-uld, you will now see strange signs in place of the Russian characters you typed. However, don't worry. The data you typed are still all in. If you invoke again kbd-fnt-ld and respond "russian" at the prompt, you will see your Russian letters again.

And if you make a PS while still seeing the strange signs, you'll get the correct characters in the PS.

3. kbd-load ("Load keyboard") and

4. kbd-unload ("Unload keyboard").

This functions load/unload only the keyboard driver; the font remains loaded in memory. So, if you are typing Russian, and need to enter something in English, you need only to temporarily unload the keyboard driver. Invoke kbd-unload, and you'll see Russian characters still in place.

However, if you type something now, you'll get Latin letters. When you are done with English, and want to switch back to Russian, you can invoke kbd-load.

If you have to invoke some Freemacs command, remember to invoke kbd-unload first, in order to switch off the keyboard driver.

Otherwise, if you are prompted for a "y/n" answer and type a "n", you'll be actually typing a Cyrillic n (with a differen ASCII code), and your answer will not be recognized! (If you get into such a situation by mistake, simply exit the command by typing C-G, then invoke kbd-unload to switch off the keyboard driver, then try again).

Using kbd-load and kbd-unload, you can toggle between keyboard drivers if you have to write a mixed-language text.

5. print-to-ps.

This function "prints" the current buffer to a PS file. If your buffer has a filename associated with it, the PS file will have the same name, only with a .ps extension. If you are using a buffer without associated file name, the output file will be named "print.ps", and will be located in the current directory.