lib/reLyX/BUGS

   1 There are still a couple large bugs (or features lacking) in reLyX, and new
   2 users (i.e., everyone) will need to know them in order to know how to avoid
   3 them. Those bugs are currently listed in the BUGS section of the reLyX man
   4 page. This file lists only the smaller bugs. This includes bugs which appear
   5 only rarely, and bugs which may be more common but do not affect the printed
   6 output.
   7
   8 - In optional arguments, reLyX doesn't recognize a braced bracket "{]}"
   9 as being different from a regular bracket. You'll notice this problem if
  10 you've got a description environment item like "\item [foo {]} bar]". This
  11 is probably simplest to fix in the LyX file after you run reLyX. If
  12 you're very unlucky, it could mess up reLyX, in which case you'll have to
  13 remove it from the TeX file and put it in the LyX file after you translate it.
  14
  15 - The underscore character '_', when used as an argument to an unknown command,
  16 may be copied incorrectly. \foo{a_b} will be copied in TeX mode as \foo{a_{b}}.
  17 '_' in math mode works fine.  It also works fine as the argument to known
  18 tokens, like \cite{foo_bar}, or even in translated arguments to untranslatable
  19 commands (see the Syntax Files section of the man page).  Also, if you have
  20 an underscore in a file name, you have to use the LaTeX style of \input. That
  21 is, write "\input{a_b}" instead of the old TeX style "\input a_b" (even though
  22 the latter is legal LaTeX). If \includegraphics can't be copied for various
  23 reasons (see the reLyX man page), underscore will break. Finally,
  24 \label{foo_bar} in math mode will break.
  25
  26 - Complicated nesting could confuse matters. Simple nesting, including nesting
  27 lists within lists, or having multiple paragraphs in one \item, should work.
  28
  29 - ' { } { } ' is a legal LaTeX way to make five spaces. reLyX will translate
  30 it as '     ', which will show up in the LyX display, but not in the LaTeX
  31 document. Use '~~~~~' instead. Or don't use it because it's usually bad style.
  32
  33 - \normalfont and \textnormal are not supported and may confuse the font stacks.
  34 You can change "\sffamily foo \normalfont" to "\sffamily foo \rmfamily" or
  35 even to "\textsf{foo}" to get around this problem.
  36
  37 - font sizing commands *usually* work. reLyX may complain about "font
  38 confusion" when several font sizing commands are given in close proximity.
  39 Even if it complains, it may get the sizes right.
  40
  41 - {\cal foo} is translated as {\mathcal{foo}}. The LyX file will display
  42 and extra set of (red) braces, but those braces won't show up in the dvi file
  43 or printed output.
  44
  45 - reLyX translates {\bf foo} to \textbf{foo}. However, it also does that in
  46 math mode. Write \mathbf{foo} explicitly in the LyX file instead.
  47
  48 - period in \label or \ref will word-wrap. E.g. \ref{Dr. foo} will yield
  49 a reference to "Dr." in the LyX file, with an extra "foo}" printed as
  50 regular text
  51
  52 - \end or \begin in a \newcommand, for example, will really confuse reLyX,
  53 because they're not being used for their regular purpose of starting or
  54 ending an environment. Put the \newcommand in the preamble to avoid this
  55 problem.
  56
  57 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  58 Changes in translation caused by features not (yet) in LyX:
  59
  60
  61 - Centering (or right or left justifying) works on full paragraphs. Therefore,
  62 if you have the following:
  63     \begin{center}
  64     centered text
  65     \end{center}
  66     NON-centered text without a blank line before it
  67
  68 the reLyX'ed file will put your NON-centered text into a new paragraph. To
  69 closely approximate what you had, just select "No Indent" from the
  70 Layout->Paragraph popup for the new paragraph.
  71
  72 - LyX support for tables isn't perfect. Some complicated column descriptions
  73 (e.g., multiple lines between columns or @{} column descriptions) will not
  74 be displayed WYSIWYG, but will be printed out correctly. These can be
  75 entered using the "Extra" popup in LyX's table popup. reLyX should
  76 translate these things correctly. In addition, '|' characters in the second
  77 argument to \multicolumn will be ignored. (For example, if you have:
  78     \begin{tabular}{|cc|}
  79     a & b \\
  80     \multicolumn{2}{c}
  81     \end{tabular}
  82
  83 there will be lines to the right and left in all rows of the table.)
  84 Tables must be their own paragraphs, while LaTeX allows a table to appear
  85 in the middle of a paragraph. \clines will only work on multicolumns. However,
  86 most tables that aren't too complicated will be translated just fine. For very
  87 complicated tables, use a "skip" block, so that they will be copied in TeX
  88 mode.
  89
  90 - Nested \input files will only work if you set \use_tempdir false in your
  91 lyxrc file.