opendev/gerrit
Code Issues Proposed changes

Update the Eclipse developer documentation

Browse Source 
- Commit 90d0a58 fixed the problems with Prolog in Eclipse, so remove
the section about this from the list of known problems.

- Explicitly mention that after changing the debug configuration during
the set up for hosted debugging, the dialog must be closed and the changes
saved.

- Add a section in the known problems about the "Cannot create ReviewDB"
error that will occur if trying to run hosted debugging while the test
site is already running.

Change-Id: I9be63039fee94d2b75c0f3e8a899677c9b2d6b34
This commit is contained in:
David Pursehouse 2013-05-08 09:24:29 +01:00
parent c7ba392dac
commit 3800abd46c
1 changed files with 6 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
Documentation/dev-eclipse.txt
View File

@ -73,6 +73,7 @@ Duplicate the existing `pgm_daemon` launch configuration:
* Switch to Common tab.
* Change Save as to be Local file.
* Close the Debug Configurations dialog and save the changes when prompted.
[[hosted-mode]]
@ -103,23 +104,22 @@ Duplicate the existing `gwtui_dbg` launch configuration:
* Switch to Common tab.
* Change Save as to be Local file.
* Close the Debug Configurations dialog and save the changes when prompted.
[[known-problems]]
Known problems
--------------
* When running Gerrit under the Eclipse debugger, code that attempts
to load Prolog code may erroneously raise ClassNotFoundException,
claiming that classes in the `Gerrit` package can't be found. The
error can often be resolved by rebuilding Gerrit with `mvn package`
and restarting the debug session.
* OpenID authentication won't work in hosted mode, so you need to change
the link:config-gerrit.html#auth.type[auth.type] configuration parameter
to `DEVELOPMENT_BECOME_ANY_ACCOUNT` to disable OpenID and allow you to
impersonate whatever account you otherwise would've used.
* Error "Cannot create ReviewDb" occurs if the test site is already running.
Stop the test site with `gerrit.sh stop` before attempting to run hosted mode
debugging.
* Gerrit site doesn't appear, only directory listing is shown. Web toolkit
developer browser plugin is missing. If there is no warning, that browser
plugin is missing with the suggestion to install it, you can install the