~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
README.ETH                                                        V. 1.0
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

* The EthTeX Package

 The system comes with ten 5.25" floppy diskettes and it is also available
 in a number of archive sites through FTP (File Transfer Protocol.)
 To get it via ftp, you must have an access to a network with an ftp
 service.  If you don't have one, you may get the package from me,
 but you must cover the expense--material and shipping & handling.


* Hardware Requirement

 IBM pc or compatible with 8086, 80286, 80386, or 80486
 640MB RAM
 EGA, or VGA display adapter
 About 8MB hard disk space

* The System features

 emTeX : TeX, LaTeX, METAFONT, and others stuff.
 MicroEMACS that includes EthioME for Ethiopic editing.
 TeXshell
 eLaTeX--a modified version of LaTeX featuring Amharic commands
 Ethiopian fonts including source code
 Installer

* Documents

 All the following documents are included in distribution and can be
 processed and printed. They are located in "C:\EMTEX\DOC\AMHARIC"
 directory.

  README.ETH   :  This file
  READ1ST.TEX  :  Introduction and installation guide (Amharic--TeX file)
  VIEWER.TEX   :  Users guide for dvi file viewing (Amharic--TeX file)
  PRTDVR.TEX   :  Users guide for printing dvi files (Amharic--TeX file)
  TEXSHELL.TEX :  Introductory TeXshell users guide (Amharic--TeX file)
  ETHIOME.TEX  :  An Amharic reference manual for ETHIOME (a TeX file)

*  Optional

  An Amharic eLaTeX document preparation Guide $xx.xx



 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
* Installing the EthTeX Package

 There are two ways of installing the EthTeX package---automatic
 installation with an installer program or else manual using
 PKUNZIP program.

 *  With Installer

    The installer will allow you to install a minimum pre-configured system.
    To do so follow the instruction below:

    1. It is always a good practice to make a back copy of all original
       diskettes; therefore, before you install the system, backup the
       diskettes.

    2. Insert the diskette labeled "emTeX #1/8" into the floppy disk
       drive.

    3. While you are on floppy disk drive type "install" and press
       <enter>.  For example,

                A:\>install <enter>

       then follow the program instruction until it tells you that the
       installation is complete.  Incase, if you want to quit installing
       just press <Esc>, but the installation part that was done until the
       time of the "quit" command is given will not be undo.


    NOTE: The installer program will not install every component of the
          package; therefore, it will skip a number diskettes during
          installation.


  *  Using PKUNZIP:

     Here, you should be familiar with TeX, LaTeX, and METAFONT in general.
     You must know what part of the system you want to install.

     README.ENG (Disk #1): Read this file for more information on emTeX.

     README.INS (Disk #7): Read this file for more information on eLaTeX,
                           TeXshell, EthioME, and fonts.

     PKUNZIP.EXE (Disk #1) can be used to decompress the necessary files.


 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
*  Modifying AUTOEXEC.BAT and CONFIG.SYS

  The installer program knows how to update these files.  However, if you
  have preferred to install the system with PKUNZIP,  you should check
  and make an update to AUTOEXEC.BAT and CONFIG.SYS yourself.

  * Defining the environment:

    TeX and METAFONT must know  where some part  of files are located.  There
    is a file called "set-tex.bat" which will take care of this for you.
    However, in order to use the system, either you have to run it every time
    you turn on the machine, or you should make a call from your AUTOEXEC
    file so that whenever the machine is turned on, it automatically set the
    environment.  To call from AUTOEXEC:

    1. Edit the AUTOEXEC.BAT file with your favorite editor

    2. And, insert "call set-tex" at the end of the file, at least
       below the "PATH" definition.

  * Setting the PATH:

    If you want to run TeX from  other directories other than "c:\emtex"
    directory, you need to specify the directory in the PATH section of
    AUTOEXEC.BAT file.  You should also includes other related directories
    to the PATH.  Here is what exactly should be added to the path

          c:\emtex;c:\mytex;c:\emacs;c:\emacs\ethiome;

   * Modifying CONFIG.SYS

     This system file among other things specify how many files DOS can open
     at the same time.  At least, number of "files" and "buffers" has to be or
     above as shown below

            FILES=20
            BUFFERS=20

     To insure that enough environment space is available, you need also to
     include at the first line of this file:

                       SHELL=command.com /E:1000/P

 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
*  Getting Started

  There are a number of ways of invoking TeX.  The easy one might be to
  use TeXshell.  TeXshell is a menu driven environment to edit, compose,
  view, and print TeX's documents.  TeXshell is set to suit eLaTeX, but
  you can change this configuration yourself whenever you want.

  It is good to invoke TeXshell in "c:\mytex" directory since this
  directory serve you to organize your documents.  Here is what you
  should:

       1. Type "cd c:\mytex"

       2. Type "texshell sample.tex"

       3. Now you are in TeXshell environment.  Press F4

       4. You should be now in EthioME mode with "sample.tex".  Examine the
          file, but don't make a change.  For more information on EthioME,
          please retrieve "ETHIOME.TEX", compose it, and print it.  It is
          an Amharic reference manual for EthioME (EthioMicroEmacs.)

       5. When you finish looking at the "sample.tex", press F10 to exit from
          EthioME.  By this time you are back to TeXshell environment.

       6. To process "sample.tex", press F6.  TeX now reads "sample.tex" and
          produce a final version of "sample.tex", which is "sample.dvi".
          This is the file used to view or print.  While TeX is working
          on the document, it displays information on screen telling you what
          it is really doing. If it encounters an error, it will stop and
          tell where the error has occurred.

       7. To view the document that TeX has produced, press F8.  This will
          take you to a previewer.  The previewer displays the first page of
          the document zoomed at higher level.  You can reduce the zoom
          by pressing "-" or increase by pressing "+".  For more information,
          compose and print VIEWER.TEX.

       8. When you finish viewing the document, press "q", then you are back
          to TeXshell environment.

       9. The final act of this process is to print the document on your
          printer.

          a. Press F9

          b. Press <enter>.

          The driver now sends the document to the printer one
          page at a time until the entire document is printed.


~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Abass B. Alamnehe
P.O. Box 36921
Houston, TX 77236
e-mail: [email protected]
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~