Eclipse 3.1 final or later (e.g. the 3.1m5a based JBossIDE is not supported)
-
Java 5 VM or later
-
-
General
-
Multiple workbench windows are not supported and Mylar will not work
- properly if you have more than one window open (Bug
- 102663).
-
Java editing
-
The Package Explorer can get into a mode where it refresh too often (Bug
- 103585). The work-around is to Toggle the "Apply Mylar" glasses in
- the toolbar.
-
Folding must be toggled off in order to view all the matches for "mark
- occurrences". This is not a Mylar-specific limitation but is more
- noticeable when Automatic Folding is enabled.
-
Task List
-
Bugzilla refresh fails if task active on startup (Bug
- 104118)
-
To select a task, the column with the icon or the space before the Mylar
- glasses has to be selected, since all
- other fields are editable.
-
Bugzilla
-
You can only set one bug repository per workspace. Proxy servers
- are not yet supported.
- The top of the content assist menu will put the items that are in
- your task context on top of the list, to enable quick selection via
- arrow keys. Once you start typing the menu will work as usual. Note
- that the Mylar Java Editor needs to be set as default for ".java"
- files (this is the only new functionality that comes from the Mylar
- Java editor).
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Toggle auto folding
-
-
- Pressing the editor toolbar button with the Mylar glasses on it will
- enable/disable Mylar's automatic folding. This can be useful
- when needing to browse through the code, or copy/paste code around
- (since Eclipse's folding support can cause odd expansions when
- copying folded regions,
- bug
- 104648).
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Show all filtered children
-
-
- When you are using filtering in a Mylar view you have the option of
- temporarily showing all children of a filtered node by <alt>clicking
- a node that is not currently selected. For example, you can
- <alt>click a source folder, keep the <alt> key down, and continue
- drilling down until you find a method of interest.
-
-
-
-
-
-
-
-
-
-
-
Filter declarations in Package Explorer
-
-
- 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.
-
-
-
-
-
-
-
-
-
-
-
Highlight a task context
-
-
You can associate a task with a
- highlighter. This can be useful if you are using Mylar without the
- filtering support. It also allows you to distinguish between
- task contexts if you have multiple tasks active.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Search within task context
-
-
The automatically updated Mylar Task
- Context working set can be searched as any other working set, either
- via the popup menus or using the search dialog. For example,
- to find all System.out/err calls before checking in, search for
- "System." within the task context. To quickly search all references
- click Alt+Shift+G.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Directly manipulate interest
-
-
Directly manually manipulate the
- interest level of elements by right clicking them and using the two
- Mylar actions in the popup menu. Keyboard shortcuts for these
- are Ctrl+Alt+Shift+Up Arrow for Make Landmark, and
- Ctrl+Alt+Shift+Down Arrow for Make Less Interesting.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Interest filtering for the Java Browsing
- perspective
-
-
Interest filtering can be toggled for
- the Packages, Types, and Members views simultaneously by clicking
- the leftmost toolbar button visible below.
-
-
-
-
-
-
-
Task List
-
-
-
-
-
-
-
-
-
Open reports in web browser
-
-
- Bug reports can be opened with either the Bug Editor or the Internal
- Web Browser. This can be set as a Task List preferences.
- When the Bug Editor is open you can click the hyperlink to show the
- report in the browser (e.g. to use a feature not yet available in
- the editor, such as voting).
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Focus on a single task category
-
-
- To see only the tasks for a single category click the toolbar drop
- down (upper-right of toolbar) and select "Go Into". To see all
- categories select "Go Home".
As you work on programming tasks, Mylar watches your activity and creates
- a task context. This context is associated with the task that you have
- activated. Mylar extends Eclipse structure views and editors to show
- you only what you're working on by focusing on the task context, and to
- highlight the degree of interest of the program structure that you are
- working on. The following list and figure summarize the core Mylar
- features.
-
-
Use the task list to create tasks and categories. You can also
- add a bugzilla report as a task, or create a bugzilla query as a
- category. A task context is activated by clicking the gray
- glasses, which causes the task and its category to become bold.
- Note that tasks can show up in multiple categories (e.g. as a result of
- a query, as in the figure below). To disable the context click the
- glasses again. If you are using bugzilla reports you must
- configure the Bugzilla server first (Preferences -> Bugzilla). If
- you double-click a Bugzilla report it will open with the internal
- browser, or with a Bugzilla Editor if you set Preferences -> Mylar ->
- Task List accordingly.
-
Click the Mylar glasses to filter out all uninteresting elements
- (i.e. those not a part of the task context), shown here on the Outline
- view. You will notice that views with Mylar filtering update
- automatically as you work. Toggle this button to switch between
- the standard view mode and the Mylar interest filtering. If you
- have no task context active and all of the Mylar glasses are toggled off
- all of the Mylar functionality is disabled.
-
The Problems list can be filtered just like the outline.
-
The editor provides an automatic folding feature that can be toggled
- using the toolbar button next to "Mark Occurrences". When enabled
- all uninteresting elements will be folded, an interesting elements
- unfolded. Note that if you use the Mylar Java editor for ".java"
- files the highest interest elements will be moved to the top of the
- content assist list.
-
Mylar filtering works in the Package Explorer as well.
- Elements that are not a part of the task context show up in gray
- consistently throughout the views. The highest interest elements,
- called Landmarks, show up in bold.
- The Mylar Task List provides methods for creating and maintaining tasks
- and bug reports. In the order that they appear on the toolbar, the
- Task List provides the following features work managing task and bug
- reports:
-
Create task - add new task to Task List
-
Create category - organize tasks and bug reports into groups
-
Add or create new bugzilla report - add a bug report into Task List
-
Add bugzilla query - creates a category that contains all bugzilla
-
- reports that match the query
-
Refresh - refresh all bug reports and bugzilla queries
-
Filter tasks - set filters for Task List
-
-
-
-
-
-
-
Tasks
-
A task can be created with a description and a priority level. The
- priority level can be varied from P1 through P5 which is used for sorting
- and filtering the Task List. A task can be set to complete by right clicking
- and selecting "Mark Complete". The completed tasks appear in the
- Task List
- with light gray font to distinguish it from incomplete tasks. More detailed
- information such as notes and related links can be added to the task by
- double clicking on the task, which will open an editor. A task can be
- activated by selecting the glasses icon in the first column, which will
- initiate the monitoring feature of mylar to store the task context. The
- active task and its category will appear in bold on the task list. The
- context stored for each task can be cleared by right clicking the task and
- selecting "Clear Task Context".
-
Categories
-
A category can be created to organize the Task List. If a category is
- selected during task creation, the task will be added to that category. The
- drag and drop feature of the Task List allows tasks and bug reports to be
- moved from one category to another.
-
Bugzilla Reports
-
Bugzilla reports can be added to the Task List via two methods. An
- existing bug report can be downloaded from a bugzilla server or a new bug
- report can be created on a bugzilla server. The Task List shows the same
- details for the bug report as it does with tasks, but the icons are
- different. When the bug report is double clicked, the bug report will be
- opened by a bugzilla editor or an internal browser, which can be toggled in
- the preferences. A bugzilla report can be activated in the same manner as
- tasks.
-
Bugzilla Query
-
A bugzilla query is a category that is made up of all bug reports that
- match a specified query. When it is created, the user is presented with a
- dialog that presents query options similar to the search page on the
- bugzilla server. All hits form the query are added to the query and can be
- used like standard bug reports.
-
Filters
-
Filters are available to manage the Task List. There are two filters, one
- for filtering completed tasks, and one for filtering based on priorities.
