Debugging instructions simplified

[jtulach]

• I am trying to improve Enso VSCode Extension (which depends on this extension) to support testing of Enso sources
• While working on Report test execution progress enso-org/enso#14720 I had huge problems setting debugging up
  • the current instructions seem complex and a bit obsolete
• At the end I decided to simplify it - the result is in this PR

vscode$ npm run nbcode

• shall be everything one needs to debug Java running in code
  • the code is started with fresh data and extension directories
  • as such it should be isolated enough from any personal setup
• I am able to install enso.vsix into the started code instance and then debug both
  • Apache NetBeans Language Server extension
  • as well as Enso VSCode Extension
• I am debugging from NetBeans IDE attaching to port 8000

[dbalek]

Is there any chance to change the debug port if necessary? I saw it is hard coded in the sources now.

[jtulach]

Is there any chance to change the debug port if necessary? I saw it is hard coded in the sources now.

• thanks for review, Dušane
• one change of this PR is that debugging is on by default when doing npm run nbcode
  • OK?
  • if so, we need default port - is 8000 OK?
• if you want to change the port, then we need a way to take action
  • right now the action is go to the src/nbcode.ts and change the code, btw.
  • should such an action be npm run nbcode port=7777?
  • or it should be port=7777 npm run nbcode?
  • or do you propose something else?

[dbalek]

* one change of this PR is that debugging is on by default when doing `npm run nbcode`
  * OK?
  * if so, we need default port - is 8000 OK?

To have debugging on by default when running npm run nbcode is OK for me together with using 8000 as the default port.

* if you want to change the port, then we need a way to take action
  
  * right now the action is go to the `src/nbcode.ts` and change the code, btw.
  * should such an action be `npm run nbcode port=7777`?
  * or it should be `port=7777 npm run nbcode`?
  * or do you propose something else?

Either of the proposed solutions should be IMHO better than the necessity to modify the extension's sources to start debugging on a non-default port.

[jtulach]

To have debugging on by default when running npm run nbcode is OK for me together with using 8000 as the default port.
Either ... solutions ... better than the necessity to modify the extension's sources to start debugging on a non-default port.

Done in e2b450b

[jtulach]

• thanks for the review.
• test-vscode-ext is failing and will also need a fix

[MartinBalin]

Will fix the JDK17 test to use 21 after the release. It is caused by the fact that I've changes netbeans submodule in master to commit in NB master where 21 is already required

[jtulach]

Will fix the JDK17 test to use 21 after the release. It is caused by the fact that I've changes netbeans submodule in master to commit in NB master where 21 is already required

OK, so it may not be problem of this PR at the end. Good. I locally tried:

netbeans-vscode$ export JAVA_HOME=~/bin/graalvm-jdk-25.0.1+8.1/
netbeans-vscode$ env "netbeans.extra.options=-J-Dnetbeans.logger.console=true" ant test-vscode-ext

and that succeeds OK. I guess I can them merge, right @MartinBalin?