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.