There are still a couple large bugs (or features lacking) in reLyX, and new users (i.e., everyone) will need to know them in order to know how to avoid them. Those bugs are currently listed in the BUGS section of the reLyX man page. This file lists only the smaller bugs. This includes bugs which appear only rarely, and bugs which may be more common but do not affect the printed output.

- In optional arguments, reLyX doesn't recognize a braced bracket "]" as being different from a regular bracket. You'll notice this problem if you've got a description environment item like "[foo ] bar]". This is probably simplest to fix in the LyX file after you run reLyX. If you're very unlucky, it could mess up reLyX, in which case you'll have to remove it from the TeX file and put it in the LyX file after you translate it.

- The underscore character '_', when used as an argument to an unknown command, may be copied incorrectly. a_b will be copied in TeX mode as a_b. '_' in math mode works fine. It also works fine as the argument to known tokens, like [#!foo_bar!#], or even in translated arguments to untranslatable commands (see the Syntax Files section of the man page). Also, if you have an underscore in a file name, you have to use the LaTeX style of =. That is, write "\begin{center}\vbox{\input{a_b} }\end{center}" instead of the old TeX style " =a_b" (even though the latter is legal LaTeX). If can't be copied for various reasons (see the reLyX man page), underscore will break. Finally, in math mode will break.

- Complicated nesting could confuse matters. Simple nesting, including nesting lists within lists, or having multiple paragraphs in one , should work.

- ' ' is a legal LaTeX way to make five spaces. reLyX will translate it as ' ', which will show up in the LyX display, but not in the LaTeX document. Use '     ' instead. Or don't use it because it's usually bad style.

- and are not supported and may confuse the font stacks. You can change "foo " to "foo " or even to "foo" to get around this problem.

- font sizing commands *usually* work. reLyX may complain about "font confusion" when several font sizing commands are given in close proximity. Even if it complains, it may get the sizes right.

- foo is translated as foo. The LyX file will display and extra set of (red) braces, but those braces won't show up in the dvi file or printed output.

- CleanTeX adds around arguments if they're not there already. It breaks on a_b_c or a_bar. Unfortunately, examples like that are pretty hard to parse, so all we can do is ask you to write clearer LaTeX (or contribute your coding skills to the reLyX project!). Sorry.

- reLyX translates foo to foo. However, it also does that in math mode. Write foo explicitly in the LyX file instead.

- period in r #w#>ill word-wrap. E.g. [*] will yield a reference to "Dr." in the LyX file, with an extra "foo" printed as regular text

- n a , for example, will really confuse reLyX. Put the in the preamble to avoid this problem.

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Changes in translation caused by features not (yet) in LyX:

- Centering (or right or left justifying) works on full paragraphs. Therefore, if you have the following:

centered text
NON-centered text without a blank line before it

the reLyX'ed file will put your NON-centered text into a new paragraph. To closely approximate what you had, just select "No Indent" from the Layout->Paragraph popup for the new paragraph.

- LyX support for tables isn't perfect. Some complicated column descriptions (e.g., multiple lines between columns or @ column descriptions) will not be displayed WYSIWYG, but will be printed out correctly. These can be entered using the "Extra" popup in LyX's table popup. reLyX should translate these things correctly. In addition, '|' characters in the second argument to