|
|
| (9 intermediate revisions by the same user not shown) |
| Line 1: |
Line 1: |
| − | [[Mylar User Guide]],
| |
| − | [http://eclipse.org/mylar Mylar Home],
| |
| − | [http://wiki.eclipse.org/index.php?title=Special:Userlogin&returnto=Special:Userlogout Log in to edit]
| |
| | | | |
| − |
| |
| − |
| |
| − |
| |
| − |
| |
| − |
| |
| − |
| |
| − |
| |
| − |
| |
| − |
| |
| − |
| |
| − |
| |
| − |
| |
| − | = Tasks and Repositories =
| |
| − |
| |
| − | == Unsupported repositories ==
| |
| − |
| |
| − | '''How do I encourage someone to make a connector for my repository?'''
| |
| − |
| |
| − | First, do a search of the open repository connector requests and [https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&short_desc_type=anywordssubstr&short_desc=%5Bconnector%5D&product=Mylar&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailtype1=substring&email1=&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0= vote for the corresponding bug] if your tracker is there, or [http://www.eclipse.org/mylar/bugs.php create a new bug].
| |
| − |
| |
| − | '''There isn't a connector for the repository I use: is there a workaround?'''
| |
| − |
| |
| − | Yes. See [[Mylar_User_Guide#Unsupported_repositories]]
| |
| − |
| |
| − | == Bugzilla Connector ==
| |
| − |
| |
| − | '''What versions of Bugzilla are supported?'''
| |
| − |
| |
| − | For supported versions see the [http://www.eclipse.org/mylar/dl.php download page]. We recommend using the latest [http://www.bugzilla.org/download/ release] of Bugzilla.
| |
| − |
| |
| − | If you are just looking for a place to start be sure to check out the [[Mylar User Guide]].
| |
| − |
| |
| − | '''Why don't the times in Bugzilla correspond to the times that I actually create the tasks?'''
| |
| − |
| |
| − | The times that appear in the Bugzilla bug editor (ie. created, modified) are local to the server hosting the Bugzilla repository, not your local machine's time zone.
| |
| − |
| |
| − | '''Why do I get the message "attributes are missing options" (i.e. it's missing a recently added milestone) in the bug editor?'''
| |
| − |
| |
| − | That's [https://bugs.eclipse.org/bugs/show_bug.cgi?id=155431 bug# 155431]). To work around it:
| |
| − | ** Update attributes by choosing "Update Attributes" from the context menu in the Task Repositories view
| |
| − | ** Synchronize the task in the tasklist
| |
| − | ** Reopen the task - new options should be available.
| |
| − |
| |
| − | '''Why do I get the message "queries are not working"?"
| |
| − |
| |
| − | The most likely answer is that you don't have the right Bugzilla server version selected for the corresponding repository. To set it, select ''Task Repositories (view) -> right+click repository -> Properties''.
| |
| − |
| |
| − | If the repository is still not functioning it may be due to authentication or connectivity problems. If that does not resolve the problem please post a message to the newsgroup or [http://www.eclipse.org/mylar/bugs.php submit a bug].
| |
| − |
| |
| − | '''Why do I get the message "reports are failing to submit" or "missing products or components"?'''
| |
| − |
| |
| − | Currently our support for retrieving the products/components etc. available on the server relies on the information from <your-repository-url>/config.cgi?ctype=rdf. If you are unable to access this url with your web browser then this is likely the source of problems related to missing products/configuration.
| |
| − |
| |
| − | Try updating the attributes for the repository via ''New -> New Repository Task -> '' select Bugzilla repository ''-> Update Products from Repository''.
| |
| − |
| |
| − | '''Why do I get the message "reports fail to load" or "reports fail to synchronize" (and the task description remains ''italic'')?'''
| |
| − |
| |
| − | These messages usually happen when the '''urlbase''' parameter is not set on the bugzilla server. Check the error log for a "'''File not found'''" error pointing to '''bugzilla.dtd''' or a "'''Failed to retrieve products from server'''" error message. (@@@ and how to fix it? @@@)
| |
| − |
| |
| − | '''Why do I get the warning "Could not download task data, possibly due to timeout or connectivity problem. Please check connection and try again" on the Bugzilla tab when opening a bug?
| |
| − |
| |
| − | It is likely that the repository is too old (Mylar currently supports Bugzilla 2.18 and up). The Bugzilla connector requires that bugs be accessible in XML form, and older versions of Bugzilla do not support XML. You can see if your repository is returning XML data by pointing your browser to <your-repository-url>/show_bug.cgi?id=1&ctype=xml and verifying that the page returned shows bug number 1 in XML form.
| |
| − |
| |
| − | '''Why do I get the message "attachments are failing to submit" and a size of "bytes" with no numbers for the attachment size? Why do I see errors like <nowiki>DBD::mysql::st execute failed: Got a packet bigger than 'max_allowed_packet' bytes [for Statement "INSERT INTO attach_data (id, thedata) VALUES (38, ?)"] at /path/to/bugzilla/attachment.cgi line 993</nowiki>'''
| |
| − |
| |
| − | Your database may be dropping the packet sending the file. On MySQL, check the [http://dev.mysql.com/doc/refman/5.0/en/packet-too-large.html max_allowed_packet directive]. Also, check the maximum attachment size in ''Bugzilla Parameters -> Attachments''. @@@ where is this ? @@@
| |
| − |
| |
| − | '''Why do I get a message about "mid-air collisions"?'''
| |
| − |
| |
| − | It is likely that you are using Bugzilla 2.18 with an incorrectly formatted timestamp field in the underlying bugs database table ([https://bugs.eclipse.org/bugs/show_bug.cgi?id=149513 bug 149513]). You can resolve this by upgrading to Bugzilla 2.20 or later.
| |
| − |
| |
| − | == JIRA Connector ==
| |
| − |
| |
| − | '''JIRA isn't working for me.'''
| |
| − |
| |
| − | To use JIRA, you need to install both the core and the connector. Make sure that you did that during the installation process.
| |
| − |
| |
| − | Note that the JIRA SOAP/RPC services have to be running on the server. For additional details see the Requirements on the [http://jira-dashboard.tigris.org JIRA Dashboard] page. For supported versions see the [http://www.eclipse.org/mylar/dl.php download page].
| |
| − |
| |
| − | '''Why do I get a 503 error code?'''
| |
| − |
| |
| − | Your SOAP/RPC interface probably isn't enabled. Verify that the SOAP/RPC interface is enabled. @@@how?@@@
| |
| − |
| |
| − | '''Why do I get a 403 error code?'''
| |
| − | This might mean that your SOAP/RPC interface isn't enabled. Check that your SOAP/RPC interface is enabled and also check your authentication mechanism. (@@@how?@@@) If the JIRA server is using NTLM authentication, see [https://bugs.eclipse.org/bugs/show_bug.cgi?id=156397 bug 156937] for diagnosis steps.
| |
| − |
| |
| − | = Content assist =
| |
| − |
| |
| − | '''Why don't I see any content completion proposals?'''
| |
| − |
| |
| − | Check to make sure that either the Mylar or the plain proposals are enabled. Select ''Window -> Preferences -> Java -> Editor -> Content Assist -> Advanced'' and make sure that there is at least one of the boxes is checked in the list labelled "Select the proposal kinds contained in the 'default' content assis list". . (See the images at the end of this section.)
| |
| − |
| |
| − | Proposals will also not show up if a workspace into which Mylar was once installed is later run without Mylar installed (e.g. as a result of uninstalling or multiple Eclipses using same workspace. See [https://bugs.eclipse.org/bugs/show_bug.cgi?id=140416 Platform bug 140416]).
| |
| − |
| |
| − | '''Why do I get an error message dialog that says "The extension tool too long to return from the 'computeCompletionProposals()' operation" after invoking content assist?'''
| |
| − |
| |
| − | This is most likely due to something interrupting the proposal operation (e.g. garbage collection). If it doesn't happen again, you can ignore it. If it keeps happening, increase Eclipse's memory (e.g via -Xmx384M command line argument). See [https://bugs.eclipse.org/bugs/show_bug.cgi?id=141457 bug 141457] for more details.
| |
| − |
| |
| − | '''How can I see proposed content completions ranked according to interest?'''
| |
| − |
| |
| − | To see proposals ranked according to interest you must be running Eclipse 3.2 (or higher) and have only the ''(Mylar)'' proposals kinds enabled in ''Window -> Preferences -> Java -> Editor -> Content Assist -> Advanced'', otherwise you will see duplicates.
| |
| − |
| |
| − | (Note: the following image has been cropped for space reasons. The actual Preferences panel is much bigger, and has two selection boxes.)
| |
| − |
| |
| − | [[Image:mylar-content-assist-prefs.gif]]
| |
| − |
| |
| − |
| |
| − |
| |
| − | = Integration with other tools =
| |
| − |
| |
| − | Mylar relies on [[Mylar Architecture|Bridges]] to integrate the context model with the structure and UI features of domain-specific tools. The core set of Bridges supports the Eclipse SDK (i.e. has bridges for Java, JUnit, PDE, Ant and Resources). The Resources Bridge enables a basic level of interoperability with other tools that use files (e.g. .php, .cpp), and enables Mylar filtering to work for generic views that shows those files (i.e. the ''Project Explorer'', ''Navigator'') and any corresponding markers (i.e. the ''Problems'' and ''Tasks'' views). This is only the most basic context model integration, and does not offer the benefits of a specialized structure bridge, such as making declarations part of the context and providing Active Search facilities. Without a bridge Mylar also can not be applied to tool-specific views.
| |
| − |
| |
| − | If you would like to see support for a particular tool, first do a search of the open bridge requests and [https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced&short_desc_type=anywordssubstr&short_desc=%5Bbridge%5D&product=Mylar&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailtype1=substring&email1=&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0= vote for the corresponding bug] if your tool is there, or [http://www.eclipse.org/mylar/bugs.php create a new bug]. Also consider adding your experiences to the FAQ sections below.
| |
| − |
| |
| − | = Contributing =
| |
| − |
| |
| − | '''I tried to download the source following the directions given on the [[Mylar Contributor Reference]], and Eclipse says that there are errors. What do I do?'''
| |
| − |
| |
| − | There are several possible things wrong:
| |
| − | # You don't have the latest milestone of Eclipse; download the latest stable version from [http://download.eclipse.org/eclipse/downloads/ the "all downloads" page]. Note that the downloads page that is easiest to find will show you the ''latest releases'', not the ''latest milestones''.
| |
| − | # You don't have JRE 1.5 associated with this workspace. Go to ''Window -> Preferences -> Java -> Installed JREs -> Execution Environments'' and make sure that the 1.5 checkbox is checked.
| |
| − | # You don't have Jira installed, but do have the org.eclipse.mylar.tests installed. That is a separate download. See [[Mylar_Contributor_Reference#Workspace_setup]].
| |
| − | # You have Jira installed but don't have Subclipse installed. See [[Mylar_Contributor_Reference#Workspace_setup]].
| |
| − |
| |
| − | = Key Limitations =
| |
| − | '''What limitations does Mylar have?'''
| |
| − |
| |
| − | * [https://bugs.eclipse.org/bugs/show_bug.cgi?id=106678 Bug 106678]: The Package Explorer hierarchical layout is not supported on Eclipse 3.2.0 and will show uninteresting elements when enabled. Resolved on Eclipse 3.2.1 and Eclipse 3.3.
| |
| − | * Mylar does not work with the WTP XML editor. See [https://bugs.eclipse.org/bugs/show_bug.cgi?id=144882 bug 144882: interest filter fails on WTP Dynamic Web Project].
| |
| − |
| |
| − | = Older versions of Eclipse =
| |
| − | '''Why doesn't the Package Explorer show hierarchy?'''
| |
| − |
| |
| − | This should only be a problem with Eclipse 3.1. The Hierarchical layout is not supported in the Package Explorer. In the Package Explorer menu, select ''Layout -> Flat''.
| |
| − |
| |
| − | '''When I click on a .java file, the right editor doesn't open! What do I do?'''
| |
| − |
| |
| − | This sometimes happens when using Eclipse 3.1. Reset the Java editor to be default for ".java" again via: ''Preferences -> General -> Editors -> File Associations''. Upgrading to 3.2 will also eliminate the problem.
| |
