diff --git a/lib/doc/BUGS.lyx b/lib/doc/BUGS.lyx deleted file mode 100644 index b761962f39..0000000000 --- a/lib/doc/BUGS.lyx +++ /dev/null @@ -1,520 +0,0 @@ -#This file was created by Thu Jul 1 15:12:26 1999 -#LyX 1.0 (C) 1995-1999 Matthias Ettrich and the LyX Team -\lyxformat 2.15 -\textclass article -\language default -\inputencoding default -\fontscheme default -\graphics default -\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 1999-07-01 -\layout Standard - -This file contains a compilation of bug reports that have been sent to the - mailing list -\family sans -lyx-devel@lists.lyx.org -\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 Section - -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. - 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-1.0.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 list at -\family sans - lyx-devel@lists.lyx.org -\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 -http://www.mail-archive.com/lyx-devel@lists.lyx.org/ -\family 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 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 - -It is not possible to enter -\family typewriter - -\backslash -dj{} -\family default - or -\family typewriter - -\backslash -DJ{} -\family default - as LaTeX accent insets; this means that these characters are not available - to people who want to use latin1 as encoding. -\layout Enumerate - -On a very small ( -\begin_inset Formula \( 640\times 480 \) -\end_inset - -?) screen, math panel pops up the subpanels off screen. - It should check it's position, and put the panels somewhere visible. -\layout Enumerate - - -\family sans -Options\SpecialChar \menuseparator -Keyboard -\family default - has no -\family sans -Apply -\family default - and -\family sans -Cancel -\family default - 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 - -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. - [ -\emph on -Note from Jean-Marc: things are a bit better now, but not perfect. - -\emph default - ] -\layout Enumerate - -Navigation by table of contents (ToC) is limited by Section Number Depth, - rather than ToC Depth. - If you have Section Number Depth of 1, but ToC of 2, clicking on any of - the numbered sections takes you to the right point in the document. - But clicking on a (unnumbered) Subsection takes you to the beginning of - the Section, rather than to the subsection. -\layout Enumerate - -If you have a footnote (or margin note) in a section heading, the text after - this not will not appear in the ToC popup. -\layout Enumerate - -When several insets are placed consecutively (this can happen with error - insets), clicking on an inset can result in opening the wrong one. - A workaround is to use -\family sans -C-o -\family default -, with the cursor placed just before the desired inset. -\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 figure is larger than one page down press would have taken you, the - page down fails and you are left where you started. - [ -\emph on -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 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 - -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 - -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 - -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 - -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 - -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 not possible to include footnotes in tables. - -\layout Enumerate - -The numbering policy of LyX does not exactly match what LaTeX does for sections: - for example, LyX resets subsection -\emph on -and -\emph default - subsubsection counters at a new section, while LaTeX does not reset the - subsubsection counter. - As a workaround, you can add -\family typewriter - -\backslash -setcounter{subsubsection}{0} -\family default -, marked as TeX, just after the section heading. -\layout Enumerate - -LyX is not able to render correctly -\family sans -Paragraph -\family default - and -\family sans -SubParagraph -\family default - headings which, in standard LaTeX classes, are just placed at the start - of the following paragraph. - This can be confusing. -\layout Enumerate - -LyX sometimes gets caught by TeX fonts ligatures: for example, in the sentence - -\begin_inset Quotes eld -\end_inset - -He said 'Hello!' -\begin_inset Quotes erd -\end_inset - -, the single and double closing quotes come out inverted (just try to preview - this paragraph). - The only sollution is to write it as -\begin_inset Quotes eld -\end_inset - -He said 'Hello!' -\latex latex - -\backslash -textcompwordmark -\latex default - -\begin_inset Quotes erd -\end_inset - -, which is admittedly not very nice. -\layout Enumerate - -When going into math text mode (which results in -\family typewriter - -\backslash -mathrm{} -\family default - in the LaTeX output) it is impossible to enter punctuation, as this is - always put back into math mode. -\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 - -If you change font in a special word (like in -\begin_inset Quotes eld -\end_inset - - -\bar under -L -\bar default -aTeX -\begin_inset Quotes erd -\end_inset - -), the whole word will have the font of the first character in dvi output. - This can be solved by using for example -\begin_inset Quotes eld -\end_inset - - -\bar under -L -\bar default -\latex latex -{} -\latex default -aTeX -\begin_inset Quotes erd -\end_inset - -, thus disabling the automatic translation to the macro -\family typewriter - -\backslash -LaTeX -\family default -. -\layout Enumerate - -In a LyX-Code environment, you can't have an empty line. - You'll have to type a single space to make it work. -\layout Enumerate - -In LyX-Code and in paragraphs written completely using the typewriter font, - all spaces are protected so that LaTeX isn't able to perform correct formatting - of the text. - You'll have to insert linebreaks manually. -\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 - -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 - -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 - -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. -\the_end