#This file was created by <alstrup> Sun Jan 25 14:49:01 1998
#LyX 0.12 (C) 1995-1998 Matthias Ettrich and the LyX Team
\lyxformat 2.15
\textclass article
\language default
\inputencoding default
\fontscheme default
\graphics none
\paperfontsize default
\spacing single 
\papersize Default
\paperpackage a4
\use_geometry 0
\use_amsmath 0
\paperorientation portrait
\secnumdepth 3
\tocdepth 3
\paragraph_separation indent
\defskip medskip
\quotes_language english
\quotes_times 2
\papercolumns 1
\papersides 1
\paperpagestyle default

\layout Title

Known BUGS in LyX
\layout Date

Last updated 1998-01-16
\layout Section

Introduction
\layout Standard

This file contains a compilation of bug reports that have been sent to the
 mailing list 
\family sans 
lyx@via.ecp.fr
\family default 
.
 We try to keep it up to date as far as possible, but of course it's better
 to spend time fixing bugs instead of archiving them.
 Since we cannot reproduce all of these bugs, please send us any details
 and updates and, of course, fixes.
\layout Subsection

How do I submit a bug report?
\layout Standard

All bug reports should always include information about which versions of
 LyX the bug appears in (you will be surprised to know how many forget that
 information).
 Try to get the latest version of LyX and see if the problem still exist
 before complaining
\begin_float footnote 
\layout Standard

This is especially important if Januar 1998 is more than a few weeks ago,
 in which case chances are that a newer development version of LyX has the
 bug fixed.
\end_float 
.
 New releases will typically contain bug fixes :-) 
\layout Standard

Remember: the less time the developers have to spend to understand and fix
 a problem, the faster the problem is likely to be fixed.
\layout Standard

Other than that, the good bug report is characterized by including 
\emph on 
all
\emph default 
 relevant information and only that.
 It's always relevant what the problem is, and how the problem is triggered.
 If it's a compilation problem, include 
\family typewriter 
\size small 
config.log
\family default 
\size default 
 and information about your system (
\family typewriter 
\size small 
uname -a
\family default 
\size default 
), which compiler you use, versions of libraries and so on.
\layout Standard

If you found a bug that causes LyX to crash, please take the time to produce
 a backtrace with a non-stripped lyx executable.
 The one built in the source directory is per default not stripped, while
 the installed binary is stripped.
 So, run LyX from gdb by typing 
\begin_inset Quotes eld
\end_inset 


\family typewriter 
\size small 
gdb /users/bozo/lyx-0.12.x/src/lyx
\family default 
\size default 

\begin_inset Quotes erd
\end_inset 

 and then 
\begin_inset Quotes eld
\end_inset 


\family typewriter 
\size small 
run
\family default 
\size default 

\begin_inset Quotes erd
\end_inset 

.
 Make LyX crash and you'll return to gdb.
 Use 
\begin_inset Quotes eld
\end_inset 


\family typewriter 
\size small 
bt
\family default 
\size default 

\begin_inset Quotes erd
\end_inset 

 to produce a backtrace and include the output in the bug report
\begin_float footnote 
\layout Standard

if you want to be thorough, use the 
\latex no_latex 

\begin_inset Quotes eld
\end_inset 

info locals
\begin_inset Quotes erd
\end_inset 

 and 
\begin_inset Quotes eld
\end_inset 

up
\begin_inset Quotes erd
\end_inset 

 commands to print out the values of local variables at a few stack levels.
\end_float 
.
 If possible, then a description of a way to reproduce the bug is more important
 than a backtrace, because then we have the possibility to roll our own
 backtrace.
 If the bug is not easily reproducible, a backtrace is essential, because
 then that might be all we've got.
\layout Standard

Bug reports should be mailed to the developer's mailing list at 
\family sans 
lyx@via.ecp.fr
\family default 
.
 However to avoid that we get cluttered with the same bug reports from many
 people, we recommend that you either check the archive of the developer's
 mailing list at 
\family typewriter 
\size small 
http://www.via.ecp.fr/~andre/lyx/archive
\family default 
\size default 
 or subscribe to the list first.
 If you want to be a real sport, you provide a patch along with the bug
 report.
\layout Section

Bugs
\layout Subsection

From: Rick Hawkins <rhawkins@iastate.edu>
\layout Standard

With my very small (
\begin_inset Formula \( 640\times 480 \)
\end_inset 

?) screen, I'm finding that math panel pops up the subpanels off screen.
 Is it practical to make it check it's position, and put the panels somewhere
 visible?
\layout Subsection

From: Ben Walding <e3322439@student.uq.edu.au>
\layout Standard

If a figure is larger than one page down press would have taken you, the
 page down fails and you are left where you started.
 I don't know if this is considered a bug, but it is unintuitive to me.
\layout Description

Comment: Behavior in this situation is improved but still imperfect.
 LyX now does the pageup or pagedown, but jumps from the top to the bottom
 of the figure, potentially skipping part of the middle.
 
\layout Subsection

From: 
\begin_inset Quotes eld
\end_inset 

A.
 Rae
\begin_inset Quotes erd
\end_inset 

 <rae@elec.uq.edu.au>
\layout Standard

If you have two environments of the same type, such as the Proof environment
 from the 
\family sans 
foils
\family default 
 class, one after the other they appear in LyX as separate environments.
 That is, each paragraph starts with: 
\family sans 
\series bold 
Proof:
\family default 
\series default 
.
 However, the final output shows these two paragraphs are treated as one.
 In fact the LaTeX that is generated shows just one 
\family typewriter 

\backslash 
begin{Proof}...
\backslash 
end{Proof}
\family default 
 instead of two.
\layout Standard

There is a temporary workaround though.
 Insert a 
\family sans 
LaTeX
\family default 
 paragraph between the two and put a 
\begin_inset Quotes eld
\end_inset 

%
\begin_inset Quotes erd
\end_inset 

 there.
 This LaTeX comment is sufficient to trick LyX into outputting the right
 LaTeX code.
\layout Standard

Probably the only way to fix this is to add another paragraph type such
 as LATEX_SINGLE_ENVIRONMENT, that treats each paragraph of this type as
 a separate unit.
 Thereby generating the two Proof environments required above.
\layout Subsection

From <lyx@via.ecp.fr>
\layout Enumerate

If you delete marked text, the text is not deleted, but 
\begin_inset Quotes eld
\end_inset 

cut
\begin_inset Quotes erd
\end_inset 

, which deletes the current text in the clipboard.
\layout Enumerate

You can not export a selection from LyX to another X11 program.
 Not even between two instances of LyX.
 You can only paste into LyX using the middle mouse button.
\layout Enumerate


\family sans 
Options->Keyboard
\family default 
 has no Apply and Cancel buttons.
 [
\emph on 
Note from Asger: Well, I think the entire form should be redesigned, such
 that it isn't dynamic.
 Also, it should not be possible to select a non-existing keyboard mapping.
 In other words, the drop-down list should show exactly those that are available.
 Similarly, the charset definition should be a droplist too.
 
\emph default 
] 
\layout Enumerate

If you have a margin note in itemize text and the first paragraph of the
 margin note is also itemize text it is possible to 
\begin_inset Quotes eld
\end_inset 

depth-increment
\begin_inset Quotes erd
\end_inset 

 and make the first itemize paragraph in the margin note deeper on-screen
 even though LaTeX doesn't permit this (and ignores this).
 
\layout Enumerate

If you have edited and then undo all changes, then the 
\begin_inset Quotes eld
\end_inset 

Changed
\begin_inset Quotes erd
\end_inset 

 status is not reset.
\layout Enumerate

The 
\family sans 
Citation Reference
\family default 
 command doesn't escape 
\begin_inset Quotes eld
\end_inset 


\family typewriter 
_
\family default 

\begin_inset Quotes erd
\end_inset 

 characters in the remarks field when generating TeX documents.
 You have to type 
\begin_inset Quotes eld
\end_inset 


\family typewriter 

\backslash 
_
\family default 

\begin_inset Quotes erd
\end_inset 

 by hand in these remarks if you want to use an underscore.
 Similar for other special characters.
\layout Enumerate

If a LaTeX command is partially bold, it doesn't generate correct LaTeX
 commands.
 LaTeX commands written using the LaTeX layout or the LaTeX font state should
 always use the standard font (this means no font changing commands should
 be allowed).
 Don't use font changing commands when you are in LaTeX mode.
\layout Enumerate

A table which is larger than the screen manages to go outside the red lines
 drawn by a table float.
 Same goes for figures.
 A similar thing can happen with large mathematical equations.
 Resize your LyX window.
\layout Enumerate

It is possible to use the subfigure style to get two small figures (side-by-side
), each with a caption and label, and then a common caption and label for
 the entire figure.
 LyX currently seems to support this in the pop-up menu for an eps figure.
 However, I am unable to successfully add labels to each of the subfigures.
 If I insert a label next to each subfigure, the labels appear fine and
 can be cross-referenced in the usual manner.
 However, the actual output (dvi or ps) does not distinguish between the
 two labels and any cross-reference gets the same number.
 You have to use plain old raw LaTeX mode and do this by hand.
\layout Enumerate

The LyX keyboard mappings, including dead-keys, do not work in pop-up dialogs.
 You can try cut & paste from a text editor.
\layout Enumerate

If you close a document while some included images are still in the rendering
 phase, all images in newly opened documents will stay in the rendering
 phase, making it impossible to preview or print the document.
 You can't fix this by killing gs-processes, because there aren't any.
 You'll have to restart LyX to work with figures again.
\layout Enumerate

The vertical scroll bar of the preamble window is broken.
 If you resize the window, strange things can happen, including a fatal
 crash! This is a bug in XForms.
\layout Enumerate

If you preview an empty document, no dvi-file will be created, and xdvi
 will not start.
 We should present a kind warning to the user rather than be silent.
\layout Enumerate

Sometimes, when you delete large sections of text, the screen will appear
 empty, and you have to use the scrollbar to make the cursor visible again.
\layout Enumerate

In a LyXCode environment, you can't have an empty line.
 You'll have to type a single space to make it work.
\layout Enumerate

The 
\family sans 
Layout->Character
\family default 
 pop-up toggles rather than sets attributes.
 Use 
\family sans 
Reset
\family default 
 first, and then set the attributes to get a real set.
\layout Enumerate

When the spellchecker replaces a word, the replacement word looses the font
 state of the original word.
\layout Enumerate

Upon checking in or registering a file into RCS that has been changed but
 not saved to disk yet, results in Lyx checking in the file, and they trying
 to save the current buffer to disk, resulting in a permission denied error
 on write.
\layout Enumerate

The spellchecker considers optional hyphenation points as word-separators.
\layout Enumerate

Document that includes others: if LaTeX reports an error during the execution
 of LaTeX on a sub-document as a chain reaction of executing LaTeX on a
 higher level document, LyX places the error window on the correct position
 of the higher level doc, not of the lower one.
 There might be some spurious document corruption effects related to this.
 Be careful with raw LaTeX in sub-documents.
\layout Subsection

From: Joao Cardoso <jcard@merlin.inescn.pt>
\layout Standard

It is not possible to include footnotes in tables.
\the_end
