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 - CleanTeX adds {} around arguments if they're not there already. It breaks
  46 on a_b_c or a_\foo{bar}. Unfortunately, examples like that are pretty hard
  47 to parse, so all we can do is ask you to write clearer LaTeX (or contribute
  48 your coding skills to the reLyX project!). Sorry.
  49
  50 - reLyX translates {\bf foo} to \textbf{foo}. However, it also does that in
  51 math mode. Write \mathbf{foo} explicitly in the LyX file instead.
  52
  53 - period in \label or \ref will word-wrap. E.g. \ref{Dr. foo} will yield
  54 a reference to "Dr." in the LyX file, with an extra "foo}" printed as
  55 regular text
  56
  57 - \end in a \newcommand, for example, will really confuse reLyX. Put the
  58 \newcommand in the preamble to avoid this problem.
  59
  60 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  61 Changes in translation caused by features not (yet) in LyX:
  62
  63
  64 - Centering (or right or left justifying) works on full paragraphs. Therefore,
  65 if you have the following:
  66     \begin{center}
  67     centered text
  68     \end{center}
  69     NON-centered text without a blank line before it
  70
  71 the reLyX'ed file will put your NON-centered text into a new paragraph. To
  72 closely approximate what you had, just select "No Indent" from the
  73 Layout->Paragraph popup for the new paragraph.
  74
  75 - LyX support for tables isn't perfect. Some complicated column descriptions
  76 (e.g., multiple lines between columns or @{} column descriptions) will not
  77 be displayed WYSIWYG, but will be printed out correctly. These can be
  78 entered using the "Extra" popup in LyX's table popup. reLyX should
  79 translate these things correctly. In addition, '|' characters in the second
  80 argument to \multicolumn will be ignored. (For example, if you have:
  81     \begin{tabular}{|cc|}
  82     a & b \\
  83     \multicolumn{2}{c}
  84     \end{tabular}
  85
  86 there will be lines to the right and left in all rows of the table.)
  87 Tables must be their own paragraphs, while LaTeX allows a table to appear
  88 in the middle of a paragraph. \clines will only work on multicolumns. However,
  89 most tables that aren't too complicated will be translated just fine. For very
  90 complicated tables, use a "skip" block, so that they will be copied in TeX
  91 mode.
  92
  93 - Nested \input files will only work if you set \use_tempdir false in your
  94 lyxrc file.