
Installation
------------
First and foremost you must have X-Windows to run eview on your workstation.
Check with your lab manager if you are not sure.

If you have downloaded the file eview.tar.Z by ftp (set in binary transfer mode)
Enter the 2 command lines as follows :

    uncompress eview04.tar.Z
    tar -xvf eview04.tar

You will find a new subdirectory with the name "eview" that contains the Eth-
View source files.  If you have obtained your copy of eview through encoded
email, you will need to save the email message as a new file name and enter at
the window command line :

    uudecode filename

you will then discover a new file has been created with the name "eview.tar.Z" .
At this point follow the 2 commands given for the ftp instructions above.


BEFORE COMPILING
----------------
 
You will be required to make a directory in your account for holding font
files.  You may make this directory anywhere in your account, lets call it
"FONTDIR" for now.  

        % cd eview
        % mkdir FONTDIR
        % cp ethiom12.bdf FONTDIR

        % [ edit line 9 of eview.h and replace /usr/u1/yacob/fonts with
            FONTDIR -do NOT delete the " " marks! ]

        % cd FONTDIR
        % bdftopcf ethiom12.bdf > ethiom12.pcf
        % mkfontdir
        % xset fp+ `pwd`


If "mkfontdir" or "xset fp+ `pwd`" failed, it is ok (you may need to try
"xset -default" if a problem occurs now with Latin fonts), at this point you
may compile and run Eth-View without installing the X Windows font and Eth-View
will know where to find and read the default Ethiopic font (ethiom12.bdf). 
If only the "mkfontdir" failed, you may write the "font.dir" file by hand
and try the "xset fp+ `pwd` again. In many cases you must have root
privaledges to perform installation on the X-server.


To compile:   %make  - makes everything.

To run    :  %eview -options filename
             (see "MANUAL" for a full list of options)


To View Ethiopic Documentation:

When installation is successful, the files; "ethums", "fidel", "system",
"recipe" and "review"  can be viewed at once as follows:

	eview -l system
	eview -e -c fidel
	eview -e -c -x 64 fidel2
	eview -e ethnums
	eview -l names
	eview -e review


TROUBLE SHOOTING :


Colored Fonts Are Not Appearing
-------------------------------

If your fonts do not appear in color when a color switch has been applied (see
the MANUAL document) it may be due to another X utility that uses a dominating
color palette.  For instance, a workstation background image may be preventing
your color fonts from appearing.  Turning off the background image should have
the effect of allowing your font colors to appear.

Adjusting Your Latin And Ethiopic Fonts
---------------------------------------

Choosing Your Latin Font.

Eth-View now uses 3 default Latin fonts.  The name of the first font is given
in an example below and begins with the "-adobe-courier-..." string.  This
choice has been made to compliment the "look" of the default Ethiopic font
"ethio12".   The 2nd default font is named "9x15bold" and will be used when the
"adobe-courier-" font is not available from the X Server of your workstation.
If you are using Eth-View with the "gez.asc" graphic Ethiopic font, we suggest
the choice of "9x15bold" for your Latin font as it is more compatible in 
appearance.  You may specify this choice at the command line as follows :

	eview -fnl 9x15bold ...etc...

You may wish to experiment with other Latin fonts to find the one most
appealing to you.  To see a complete list of fonts available on your computer
type "xlsfonts" at your window command line.  The Latin font is required in
all cases where Latin (or English) letters, punctuation, and Arabic numbers
are used.  If again the "9x15bold" font is not available Eview will finally
try using the "fixed" Latin font.  If trouble persists when the "fixed" font is
applied you will have to consult your lab manager about the problem.  Eview
will omit the latin characters when it can not obtain any of the Latin fonts
in the default chain.

You may "hardwire" alternative default fonts into Eth-View by editing one of
lines 10-14 of the eview.h source file as follows:
     
 #define ETHFONT "-Admas-Ethiom12-Medium-R-Normal--12-120-100-100-m-104-a dmas-fontspecific"

to

 #define ETHFONT "another_font_name"


Improving Your Graphic Ethiopic Font

The program "fideledit" formerly provided with Eth-View allows you to adjust
the Ethiopic fonts to your own liking.  You may compile fideledit at your
Unix command line by :

    cc fideledit.c -lX11 -o fedit

Editting a character is done by painting the pixels of a selected letter with
your screen pointing device (commonly a mouse).  Fideledit has its own menu of
commands for selecting a letter to edit, saving, and quitting.  You may wish to
keep a back up file of "gez.asc" which is the font file used by Eth-View that
fideledit will save your changes in.


Improving Your X-Windows Ethiopic Font

The font file "ethiom12.bdf" is in the standard "Bitmap Distribution Format".
A number of editors have been made for the editting of these fonts.  See the
file ETHIOP-X for a discussion of the editting process.  A modified version
of fideledit for the bdf format should be available by the fall of 1994.
