Stable Build - Wednesday May 8, 2002 - for Eclipse M5 (Stable R2 driver) This document is intended to point out issues or problems with the current release of the product.(You may also want to see the accompanying "todo.txt") This list is not complete, please refer to the CDT Bugzilla database at http://bugs.eclipse.org for a comprehensive and up-to-date list of known defects. Debugger issues --------------- 1. When creating a new launch configuration make sure that an executable is selected, or the launch configuration can not be created. If the CDT does not recognize that a file is an executable, try closing and reopening the project to force a refresh. 2. In some cases, there are problems the first time the Disassembly or Mixed Views are shown. Switching to another view and then back to these views should fix the problem. 3. While stepping/running in Disassembly or Mixed View, the debug session may switch back to Source View unexpectedly. Switch back to the desired view to continue. 4. Running or jumping to a location in the Mixed View may not stop at the correct location. 5. There are some problems with the "New Configuration" shortcuts: 1) The working directory is not initialized and 2) the Browse button doesn't work. 6. A problem has been reported (15566) when trying to debug an newly created executable in a remote project. If a "Launch Configuration Error" Dialog Box appears, try restarting Eclipse. Project Issues (Local and Remote) --------------------------------- 1. C/C++ files contained in non-C/C++ projects will not get parsed in the current driver. 2. Some memory leaks have been reported when working with large projects. Appearance on Linux ------------------- 1. Eclipse on Linux currently uses Motif widgets. CDT will support other widget sets as Eclipse adds them. Parsing Issues -------------- The parser has been written to handle both C and C++ and is really a work in progress. There are constructs or features of both languages that the parser does not currently handle gracefully or at all. When the parser encounters some code that it can't handle, it tries to skip over the problem and continue parsing. When it does this, it creates Parse Exception objects that will appear intermingled in with the other C/C++ objects when looking at the Details view of a Parsed File... Here are some of the most common known problems: 1. There are several known issues with UI responsiveness during a large parse job. For now, once a large parse has been started, it is best to wait until the status bar has disappeared before trying to access the parse information in the UI. The status bar actually disappears when a "first-level" parse of all files has been completed. There is still more work being done by the parser at this point. For some very large parse jobs, UI responsiveness may not return to normal until the parser is completely finished. Currently the only way to know when the parser is completely finished is to check the CPU usage for the java vm used to start eclipse, and verify that it is near 0. The performance of the parser is is one of the key areas that will be addressed in future releases of the CDT. 2. When parsing a large project, there is a potential to use a large amount of memory. If you encounter memory problems create a batch\script file that starts eclipse (so that we can have control over the command-line parameters sent to the JVM. A typical script would look like this: java -Xms100m -Xmx200m -verify -cp startup.jar org.eclipse.core.launcher.Main The -Xms and -Xmx set the minimum and maximum memory size that the JVM is invoked with. (We will be looking into memory issues in upcoming releases) 3. Known language limitations: - Some names of enums and structs are being shown incorrectly - Operator Overloading - Some macro replacements will not behave correctly - Expression Evaluation is broken in the preprocessor, so #if, #ifdef etc, will not behave correctly: Essentially every conditional directive is ignored, so all code will be included. This can cause duplicate objects or affect the accuracy of parse information. This will be fixed soon. - If a function is forward declared, both the definition and declaration will appear as separate objects - Functions that take as parameters or return, arrays - Some casts are not parsing properly - The type information displayed for most objects contains duplicates - C++ has not well been tested so there are likely problems with templates, namespaces, etc. Command Launcher View -------------------- 1. The Command Launcher View requires an object in the C/C++ Projects view to be selected. If you find that the Run Button in the Command View doesn't appear to work, goto the C/C++ Projects view and select a Project or File and try again. Command Specifications View --------------------------- 1. Users may need to click on the project to set the focus in the navigator before adding/removing command specifications within that project scope 2. When creating a command specification using the wizard, the selected project will be highlighted and selected automatically. Changing it to another project from within the wizard will not cause the command specification to belong to the selected project. This will be fixed in the next release Searching --------- 1. Search results only appear for objects contained in the files of local projects. Objects contained in included files or remote projects do not show up in the search results view. For remote projects use the Output view to see the results. 2. When searching for "Type" objects, the search will not terminate. General View Issues ------------------- 1. Several views such as the Command Specifications and Command Launcher view may require a project to be selected before the view can operate properly. If you find a view not working as expected, goto the C/C++ Projects view and select your project and try again. 2. For large projects, parse view refreshing is quite slow. 3. The C/C++ Projects view and the Navigator are not always in sync. The solution is to do a refresh in the view that appears not up to date. 4. If you display a large amounts of information in the Output view, then painting problems have been known to occur. 5. Markers are not be displayed in the Editor for remote projects.e.g adding a breakpoint will succedd even though the marker is not visible in the Editor left margin. Platform issues --------------- 1. The C/C++ Plugin is intended for Linux, although some of its features will work with Windows(with cygwin and some even without it.) - With remote Linux projects, Windows Eclipse should support most features.