********************************************************************
*                                                                  *
* THIS FILE IS PART OF THE cbedic SOURCE CODE.                     *
* USE, DISTRIBUTION AND REPRODUCTION OF THIS SOURCE IS GOVERNED BY *
* THE GNU PUBLIC LICENSE 2, WHICH IS INCLUDED WITH THIS SOURCE.    *
* PLEASE READ THESE TERMS DISTRIBUTING.                            *
*                                                                  *
********************************************************************


		CBE Dictionary README


CBE Dictionary ( Console Bulgarian-English Dictionary )
Copyright (c) 2001 by Antoby (antoby@mail.com)


This file describes the destination and useof cbedic, how to build and install,
how to use it.


CBEdic is a console version of the populat dictionary from Radostin Radnev
kbedic ( http://kbedic.sourceforge.net ). Its destination is to help people,
using extensively the text terminal (console).
It can be started from the command line by entering 'cbedic'.


Building and Installing CBEdic:
-------------------------------
    the easiest way is to use the following commands:
	./configure
	make
	make install (you must be root for the installation)

    for the people that know what they are doing:
	./configure --prefix=/usr/bin --datadir=/usr/share/dictionary
	make
	make install (you must be root for the installation)

    for those of you that think they wrote the code:
	just edit defaults.h in directory src/


How to use CBEdic:
------------------
    quick start - just type 'cbedic -h'
    then is a matter of tries and faults :) (some of them fatal)

    There are two modes of operation:
    The first one accepts the words and options from the command line. It is
    very useful for scripts or some kind of frontends.
    The second one is interactive mode 'cbedic -i'. there you have the possibility
    to change settings without invoking the configuration. All commands are
    preceded by a slash '/', for example /help.

    You can enter the configuration routines by typing 'cbedic -c'. All
    the settings you set there are written for later use in ~/.cbedic
    If you want to change the name where the settings are stored use your
    favorite hex editor (just kidding :) - edit src/defaults.h


Primeri:
--------
    latin input, cyrillic output
    ----------------------------
    input:
	cbedic testy
    output:
	TESTY
	a сприхав, раздразнителен, обидчив


    cyrillic input and output
    -------------------------
    input:
	cbedic човек	(bash shows - cbedic \367\356\342\345\352)
    output:
	ЧОВЕК
	man; person; разг. fellow, chap, guy, jack, bloke, sl joker, josser, bird


    cyrillic input
    --------------
    input:
	cbedic -u \`OWEK	( \` is the symbol ` escaped )
    output:
	ЧОВЕК
	man; person; разг. fellow, chap, guy, jack, bloke, sl joker, josser, bird


    latin input and output
    ----------------------
    input:
	cbedic -ul \`OWEK	( \` is the symbol ` escaped )
    output:
	CHOVEK
	man; person; razg. fellow, chap, guy, jack, bloke, sl joker, josser, bird
    
    

MISC:
-----
    You can check the file README.kbedic, this is a deeper description of the
    GUI version kbedic. There you can find information about the encoding
    of cyrillic to latin. Information about the dictionary itself and contacts.


Copyright (c) 2001 Antoby (antoby@mail.com)
