dev-eclipse.txt: Amend the section on hosted mode debugging The existing section on hosted mode debugging left out a couple of steps, and the requirement to use DEVELOPMENT_BECOME_ANY_ACCOUNT instead of OpenID is not mentioned anywhere. Change-Id: Iebf7f79f9111c5d2201ecabbc49aed5f0129b690
diff --git a/Documentation/dev-eclipse.txt b/Documentation/dev-eclipse.txt index ca56da3..a19d85e 100644 --- a/Documentation/dev-eclipse.txt +++ b/Documentation/dev-eclipse.txt
@@ -73,9 +73,15 @@ Running Hosted Mode ~~~~~~~~~~~~~~~~~~~ -Import the gerrit-gwtdebug project: +To debug the GWT code executing in the web browser, three additional Git +repositories need to be cloned. -* Import gerrit-gwtdebug/pom.xml using General -> Maven Projects +* https://gerrit.googlesource.com/gwtexpui +* https://gerrit.googlesource.com/gwtjsonrpc +* https://gerrit.googlesource.com/gwtorm + +In Eclipse, import the pom.xml file in the root directory of each of +these cloned gits via General -> Maven Projects. Duplicate the existing `gwtui_dbg` launch configuration: @@ -97,12 +103,17 @@ Known problems -------------- -When running Gerrit under the Eclipse debugger, code that attempts +* 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. + GERRIT ------