1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2005. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<link rel="stylesheet" href="http://eclipse.org/mylar/style.css" charset="ISO-8859-1" type="text/css">
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<meta http-equiv="Content-Style-Type" content="text/css">
<title>
Mylar FAQ
</title>
</head>
<body>
<h1>
Mylar
Frequent Asked Questions</h1>
<p>For supported platforms and known limitations please see
<a href="http://eclipse.org/mylar/dl.php">http://eclipse.org/mylar/dl.php</a> </p>
<p><b>Contents</b></p>
<ul>
<li><a href="#install-failure">Why does Mylar fail to install?</a></li>
<li><a href="#tasklist-blank">Why did my tasks disappear?</a></li>
<li><a href="#performance-summary">What are the effects of Mylar on Eclipse performance?</a></li>
<li><a href="#filtering-declarations">How do I stop declarations from showing up in the Package Explorer?</a></li>
<li><a href="#active-search-empty">Why does nothing show up in the Active Search or Active Hierarchy?</a></li>
</ul>
<h3> </h3>
<h3><a name="install-failure">Why does Mylar fail to install or update?</a></h3>
<p>The most likely reason is that you are using an <b>incompatible VM </b>(e.g. JDK
1.4), in which case you'll errors like the following in your log file. To
check JDK version that Eclipse was launched with to to Help -> About Eclipse SDK
-> Configuration Details and verify that the java.vm.version is 1.5. Mac
users should refer to the last
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=116347#c4">bug 1163477</a>
for instructions on how to change the 1.4 default.</p>
<p>
<pre> Root exception:
java.lang.UnsupportedClassVersionError: org/eclipse/mylar/tasklist/MylarTasklistPlugin
(Unsupported major.minor version 49.0)</pre>
</p>
<p>
This can also be the result of using an <b>incompatible version of Eclipse</b>.
Separate versions and update sites exist
<a href="http://eclipse.org/mylar/dl.php">for Eclipse 3.1 and for the latest 3.2
milestone</a>), in which case you'll see errors like the following in your
<workspace>/.metadata/.log file or in a Mylar view:</p>
<p>
<pre> java.lang.NoSuchMethodError:
org.eclipse.ui.internal.dialogs.FilteredTree.getFilterControl()Lorg/eclipse/swt/widgets/Text;
org.osgi.framework.BundleException: The activator org.eclipse.mylar.java.MylarJavaPlugin for bundle org.eclipse.mylar.java is invalid
</pre>
</p>
<p>In this case the easiest thing to do is reinstall Mylar. <b>Your tasks won't be
lost</b>, by default they are stored in the <workspace>/.mylar/tasklist.xml file
which will be read next time Mylar starts. First, uninstall the old version of Mylar using Help ->
Software Updates -> Manage Configuration. You need to first Disable on all
Mylar features by right-clicking them, allow Eclipse to restart after the last
is disabled, and after restart. Then ensure that the 3rd toolbar button is
pressed (figure below) so that you see the disabled features to uninstall, and
Uninstall them using the popup menu. If you don't uninstall the the Update
Manager will think that you have the latest and tell you that there are no
updates. Note that manually removing the plug-ins
and features can lead to Eclipse configuration errors. After uninstalling update Eclipse
by adding the correct update site specified at:
<a href="http://eclipse.org/mylar/dl.php">http://eclipse.org/mylar/dl.php</a>,
and after that automatically or manually updating will install the correct
version.</p>
<p>
<img border="0" src="images/faq/eclipse-manage-configuration.gif" width="679" height="335"></p>
<p>
</p>
<h3><a name="tasklist-blank">Why did my tasks disappear?</a> </h3>
<p>Either because Mylar failed to <a href="#install-failure">install or update</a>,
or because there was a problem reading the task list. By default Mylar
keeps your task list in <workspace>/.mylar/tasklist.xml. If you move
workspaces, and have not changed the Mylar data directory via the Task List
preference page, the new location will be used when Eclipse restarts (hit
Restore Defaults on that page to copy tasks back to the default location).
If your tasks ever disappear please
<a href="https://bugs.eclipse.org/bugs/enter_bug.cgi?product=Mylar">report this
as a critical bug</a>, and check the .mylar folder for a tasklist-backup.xml
file, which will contain the previous state task list. Make sure to copy
it somewhere it before adding any tasks or queries or restarting Eclipse because
it will get overwritten on any modification.</p>
<p>If your workspace folder is not backed up it is a good idea to either
backup the tasklist.xml file manually or periodically use File ->
Import/Export -> Other -> Mylar Task Data. Note that when restoring
an previous tasklist.xml file you should first close Eclipse.</p>
<p>
<img border="0" src="images/faq/tasklist-backup.gif" width="525" height="310"></p>
<h3> </h3>
<h3><a name="performance-summary">What are the effects of Mylar on Eclipse
performance?</a></h3>
<p>The goal is for Mylar to have no noticeable effect on Eclipse's speed or
memory usage, and any performance issue should be
<a href="https://bugs.eclipse.org/bugs/enter_bug.cgi?product=Mylar">reported as
a bug</a>. The current performance profile is:</p>
<ol>
<li>Mylar only runs if a task is active, and has no impact on Eclipse if no
task is active.</li>
<li>Task context models have negligible memory overhead. </li>
<li>The time to activate a task context is dominated by the time it takes
Eclipse to open the editors in the context. You can set the preference
for how many editors to open in the Mylar preference page (e.g. setting to 1
will dramatically reduce activation time). You can also turn off
editor management entirely in the Mylar Tasks view pull-down.</li>
<li>Eclipse startup is slowed down by (3) if a task is active when Eclipse
is shut down.</li>
</ol>
<h3> </h3>
<h3><a name="filtering-declarations">How do I stop declarations from showing up in the Package Explorer?</a></h3>
<p>If you don't like Mylar's constant showing of Java members in the
Package Explorer, select the drop-down menu, then "Filters..." and
enable the "Mylar Java Declarations Filter". It will then
stick in the menu in case you want to toggle between modes.
Note that this will hide interest information about members that aren't in your
current file (e.g. showing you which methods are landmarks) so this mode is not
recommended, but can be useful for 1024x768 screen resolutions.</p>
<p>
<img border="0" src="images/filtering-declarations.gif" width="441" height="211"></p>
<p>
</p>
<h3><a name="active-search-empty">Why does nothing show up in the Active Search or Active Hierarchy?</a></h3>
<p>
As you work and elements become landmarks (bold decoration), and
these elements populate the Active Search and Active Hierarchy
views. To force an element to populate the views manually make
it a landmark by right-clicking or hitting Ctrl+Alt+Shift+Up Arrow. </p></body></html>
|
