IvriTeX
"""""""
Hebrew support for LaTeX

This package includes files for hebrew support in LaTeX. This includes
mainly:

* hebrew support for babel, including support for bidirectional hebrew
* Hebrew fonts

Under this directory you will find the following subdirectories

latex/heblatex: The Hebrew support for babel
latex/hebclass: Some hopefully useful classes and styles
fonts: Some fonts packages
example: Some example documents
bibtex: BibTeX styles for support of hebrew
utils: Various scripts and such

INSTALLATION:
""""""""""""

On a unix system:
""""""""""""""""

run 'make TEX_ROOT=<YOUR_TEXMF_DIR> install'

or 'make' as a user and later 'make TEX_ROOT=<YOUR_TEXMF_DIR> install' as
root. By default <TEXMFDIR> is /usr/local/share/texmf , but your system may
have a different value, e.g: /usr/share/texmf , /usr/local/lib/texmf

'make' will create the heblatex files and hebclass files. It will also typeset 
the sample documents using those files.

'make install' will install all of the generated files (except the examples).


From the dist Package:
""""""""""""""""""""""
The dist package includes an installed texmf tree. Locate the root of 
texmf on your system and run:

  cp -R texmf/ /path/to/texmfdir/


On other systems:
""""""""""""""""
TODO: fill in instructions



Note: currently the hebrew babel files install (in the tex tree) under 

  tex/generic/0ivritex

This is to allow them to override files with the same name from:

  tex/generic/babel

In case the local version of babel is >= 3.7

This is not guaranteed to work by libkpathsea's specs, although it works with
its implementation. Anyway this hack is only temporary, until those files are 
merged into babel.

The Culmus Fonts:
""""""""""""""""
The package will build by default with the culmus fonts.
The following options can be passed to the toplevel make at build-time
to customize this:

To avoid using the culmus fonts, and use the original hebfonts:

  make use_oldfonts=1
  
Note that this is not recommended and currently not tested. It also 
requires that you change the default encoding from HE8 to LHE.
(TODO: explain how)

  make culmusdir=/path/to/culmus/fonts
  
    By defualt the culmus fonts are taken from 
    /usr/share/fonts/he/Type1 , which is where they are installed by the
    current culmus-fonts package from culmus.sf.net . If you use
    a different path (e.g: the redha/mandrake path, or you installed it
    manually elsewhere) you can use this parameter.
  
  
  make is_debian=1

    use the culmus fonts from the debian package of culmus (a 
    workaround as they are not alone in a directory)


  make use_symlinks=1

    By default the culmus fonts are copied, and thus a different copy of
    them is created. With this option the files are merely symlinks.


Building from the CVS:
"""""""""""""""""""""
The latest version [*] of ivritex can be grabbed from the CVS 
repository on SF.net . The instructions below are for the unix 
command-line cvs.

See also:

  https://sourceforge.net/cvs/?group_id=33341

1. Login: (you'll only need this once). The password is empty: just
   press enter when prompted:

   cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/ivritex login

2. Get the tree from the server:

   cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/ivritex get ivritex

3. This will create the source tree in the subdirectory "ivritex".
   Note that before creating a tar or an rpm, you'll need to create
   files_list . In the ivritex subdirectory run:

   make update_list

[*] Note that currently the public CVS of sourceforge may be up 
    to 1 day behind the maintainers' CVS, as it is a copy of it.

Known issues:
""""""""""""
* Due to a bug in the culmus fonts (version <= 0.90) it has an extra 
  unnecessary ligature of lamed-alef. (TODO: perl one-liner to remove 
  it from original fonts)

* In certain systems the generated postscript has no DSC comments and 
  thus it is impossible to page page etc. This is due to a bug in 
  certain versions of dvips. The versions in RedHat 7.3 and in SuSE 7.1
  are known to be bad, whereas the versions in SuSE 8.2, and debian 
  unstable are known to be good.

* There is currently no known way to use oldcode (7bit (yuck!)) input
  mode with the Culmus fonts. This means that the compatibility mode 
  can't work out-of-the-box, and will require the old fonts.

* Tables are not reversed.

* A reference in math mode:   

    \label{A} $\ref{A}$   

 Fails on the second latex run.

