# HG changeset patch # User Tom Rodriguez # Date 1438301528 25200 # Node ID 7a5b874b8d123de41dd20adf889a688b08b86ec4 # Parent 6dd4ab4d76d357fe7df9ea55e0d17d9056e8600d Fix checkstyle problems diff -r 6dd4ab4d76d3 -r 7a5b874b8d12 truffle/com.oracle.truffle.api/.checkstyle_checks.xml --- a/truffle/com.oracle.truffle.api/.checkstyle_checks.xml Thu Jul 30 18:13:42 2015 +0200 +++ b/truffle/com.oracle.truffle.api/.checkstyle_checks.xml Thu Jul 30 17:12:08 2015 -0700 @@ -209,7 +209,7 @@ - + diff -r 6dd4ab4d76d3 -r 7a5b874b8d12 truffle/com.oracle.truffle.api/src/com/oracle/truffle/api/debug/package-info.java --- a/truffle/com.oracle.truffle.api/src/com/oracle/truffle/api/debug/package-info.java Thu Jul 30 18:13:42 2015 +0200 +++ b/truffle/com.oracle.truffle.api/src/com/oracle/truffle/api/debug/package-info.java Thu Jul 30 17:12:08 2015 -0700 @@ -30,12 +30,14 @@ * needs to turn debugging on when constructing its Truffle virtual machine: *
  * vm = {@link com.oracle.truffle.api.vm.TruffleVM#newVM()}.
- *     {@link com.oracle.truffle.api.vm.TruffleVM.Builder#onEvent(com.oracle.truffle.api.vm.EventConsumer) onEvent}(new {@link com.oracle.truffle.api.vm.EventConsumer EventConsumer}{@code <}{@link com.oracle.truffle.api.debug.ExecutionEvent}{@code >}() {
+ *     {@link com.oracle.truffle.api.vm.TruffleVM.Builder#onEvent(com.oracle.truffle.api.vm.EventConsumer) onEvent}(new {@link com.oracle.truffle.api.vm.EventConsumer EventConsumer}
+ *     {@code <}{@link com.oracle.truffle.api.debug.ExecutionEvent}{@code >}() {
  *         public void handle({@link com.oracle.truffle.api.debug.ExecutionEvent} ev) {
  *             // configure the virtual machine as {@link com.oracle.truffle.api.vm.TruffleVM#eval(java.net.URI) new execution} is starting
  *         }
  *     }).
- *     {@link com.oracle.truffle.api.vm.TruffleVM.Builder#onEvent(com.oracle.truffle.api.vm.EventConsumer) onEvent}(new {@link com.oracle.truffle.api.vm.EventConsumer EventConsumer}{@code <}{@link com.oracle.truffle.api.debug.SuspendedEvent}{@code >}() {
+ *     {@link com.oracle.truffle.api.vm.TruffleVM.Builder#onEvent(com.oracle.truffle.api.vm.EventConsumer) onEvent}(new {@link com.oracle.truffle.api.vm.EventConsumer EventConsumer}{@code <}
+ *     {@link com.oracle.truffle.api.debug.SuspendedEvent}{@code >}() {
  *         public void handle({@link com.oracle.truffle.api.debug.SuspendedEvent} ev) {
  *             // execution is suspended on a breakpoint or on a step - decide what next
  *         }
@@ -43,30 +45,31 @@
  * 
* The debugging is controlled by events emitted by the Truffle virtual machine * at important moments. The {@link com.oracle.truffle.api.debug.ExecutionEvent} - * is sent when a call to {@link com.oracle.truffle.api.vm.TruffleVM#eval(java.net.URI) eval(...)} + * is sent when a call to {@link com.oracle.truffle.api.vm.TruffleVM#eval(java.net.URI) eval(...)} * is made and allows one to configure {@link com.oracle.truffle.api.debug.Breakpoint breakpoints} and/or decide whether the - * program should {@link com.oracle.truffle.api.debug.ExecutionEvent#prepareStepInto() step-into} or + * program should {@link com.oracle.truffle.api.debug.ExecutionEvent#prepareStepInto() step-into} or * {@link com.oracle.truffle.api.debug.ExecutionEvent#prepareContinue() just run}. Once the execution is suspended a * {@link com.oracle.truffle.api.debug.SuspendedEvent} is generated which * allows one to inspect the stack and choose the further execution mode - * ({@link com.oracle.truffle.api.debug.SuspendedEvent#prepareStepInto(int) step-into}, {@link com.oracle.truffle.api.debug.SuspendedEvent#prepareStepOver(int) step-over}, {@link com.oracle.truffle.api.debug.SuspendedEvent#prepareStepOut() step-out}, {@link com.oracle.truffle.api.debug.SuspendedEvent#prepareContinue() continue}). + * ({@link com.oracle.truffle.api.debug.SuspendedEvent#prepareStepInto(int) step-into}, {@link com.oracle.truffle.api.debug.SuspendedEvent#prepareStepOver(int) step-over}, + * {@link com.oracle.truffle.api.debug.SuspendedEvent#prepareStepOut() step-out}, {@link com.oracle.truffle.api.debug.SuspendedEvent#prepareContinue() continue}). *

* The events methods are only available when the event is being delivered and * shouldn't be used anytime later. Both events however provide access to * {@link com.oracle.truffle.api.debug.Debugger} which can be kept and used * during whole existence of the {@link com.oracle.truffle.api.vm.TruffleVM}. - * {@link com.oracle.truffle.api.debug.Debugger} is the central class that + * {@link com.oracle.truffle.api.debug.Debugger} is the central class that * keeps information about {@link com.oracle.truffle.api.debug.Debugger#getBreakpoints() registered breakpoints} * and allows one create new {@link com.oracle.truffle.api.debug.Breakpoint ones}. - * + * *

Turning on Stepping Mode

- * + * * In case you want your execution to pause on first statement, register for * {@link com.oracle.truffle.api.debug.ExecutionEvent} and once delivered * call {@link com.oracle.truffle.api.debug.ExecutionEvent#prepareStepInto()}. * *

Register a {@link com.oracle.truffle.api.debug.Breakpoint}

- * + * * Wait for execution to be started - which generates an * {@link com.oracle.truffle.api.debug.ExecutionEvent}. Use its * {@link com.oracle.truffle.api.debug.Debugger ev.getDebugger}() diff -r 6dd4ab4d76d3 -r 7a5b874b8d12 truffle/com.oracle.truffle.dsl.processor/.checkstyle_checks.xml --- a/truffle/com.oracle.truffle.dsl.processor/.checkstyle_checks.xml Thu Jul 30 18:13:42 2015 +0200 +++ b/truffle/com.oracle.truffle.dsl.processor/.checkstyle_checks.xml Thu Jul 30 17:12:08 2015 -0700 @@ -207,6 +207,6 @@ - +