This file contains a list of known problems, and workarounds (if known)

ENGLISH CAPTIONS
""""""""""""""""
On many places there is a piece of english text that should be wrapped in \L
For instance, when using the "seminar" class, the slide numbering appears
garbled. Since the default fonts are 7bit fonts, small caps englsih letters
appear as hebrew letters. Two simple workarounds:

\def\slidelabel{\R{\bf  \theslide}}

\def\slidelabel{\L{\bf Slide \theslide}}


I saw something that looks similar in the sample thesis document from the
hebxampl package: the word "figure" (?) in pages 6,7 and the word  "Table" in
pages 10,11 appears messed. In page 12 the hebrew word appears there.


MULTIPLE AUTHORS / AUTHOR LINES
""""""""""""""i""""""""""""""""
When the author field contains either a line break or an \and , the second
line (and/or author) onwards appears reversed, and has to be explicitly be
surrounnded with \R{} to be fixed.

See http://ivrix.org.il/mailing-lists/ivrix-discuss/2000/11/0022.html
(the "additional problem").

INCOMPATIBLE PACKAGES
"""""""""""""""""""""
- The hyperref package is incompatible with heblatex
 
  * For once, it defines a macro \L .
  If you load hyperref after you oad babel, be sure to override it with:

    \HeblatexRedefineL
 
  * But there are mre substential problems: hyperlinks are made with, e.g. 
  postscript directives (or PDF directives, the effect would be the same):

  to create a link it needs to add a "start link" directive, and an "end link"
  directive. So you would get:

    <start>some text<end>
 
  But with all the rearanging that is done by rlbabel (recall that postscript
  is interpereted long time after the TeX interpeter has passed over the text)
  you may get something like:

    <end>txet emos<start>


  One possible workaround is to try to wrap the whole the whole link with
  \L{}. e.g:

    \newcommand{\hyperlinkL}[2]{\L{\hyperlink{#1}{\L{#2}}}}
    \newcommand{\hyperlinkR}[2]{\L{\hyperlink{#1}{\R{#2}}}}
    \newcommand{\citeL}[1]{\L{\cite{#1}}}
  
  * \ref and similar macros are redefined by hyperref to a verson that is
  doesn't work well with heblatex. I used the following workaround:

    \let\TCref=\ref
    \def\ref#1{\TCref{#1}}
    \let\TCvref=\vref
    \def\vref#1{\TCvref{#1}}
    [...]

- graphics, pstricks

  those packages use postscript-based graphics (other packages use it as well,
  so this comment may apply to the as well).

  Things may get very strange when you try to do that in right-to-left mode.
  I generally try to put all sorts of figures inside a LTR block:

    \begin{otherlanguage}{hebrew}
      % include EPS, d ps-tricks, or whatever
    \end{otherlanguage}
