You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@netbeans.apache.org by GitBox <gi...@apache.org> on 2020/11/19 09:25:13 UTC
[GitHub] [netbeans] JaroslavTulach opened a new pull request #2546: End user oriented README.md and dedicated BUILD.md
JaroslavTulach opened a new pull request #2546:
URL: https://github.com/apache/netbeans/pull/2546
Backporting late time improvements into README and additional one-line fix.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
[GitHub] [netbeans] jisedlac commented on a change in pull request #2546: End user oriented README.md and dedicated BUILD.md
Posted by GitBox <gi...@apache.org>.
jisedlac commented on a change in pull request #2546:
URL: https://github.com/apache/netbeans/pull/2546#discussion_r526739863
##########
File path: java/java.lsp.server/vscode/README.md
##########
@@ -21,80 +21,39 @@
-->
+This is a technology preview of [Apache NetBeans](http://netbeans.org)
+based extension for VSCode. Use it to get all the _goodies of NetBeans_
+via the VSCode user interface! Run on __JDK8__[1], __JDK11__, __JDK15__, etc.
-Get all the goodies of NetBeans via the VSCode user interface!
+[1]: <http://github.com/oracle/nb-javac> "Running on JDK8 requires additional download of GPLv2 with ClassPath Exception code"
-## Building
+Invoke "Open Folder" action to open project directories with `pom.xml` or `build.gradle`
+build scripts. Edit, compile and debug (with the __Java 8+__ debugger configuration)
+the `.java` application and test files in such projects. Debug not only Java code,
+but JavaScript, Python, Ruby polyglot programs at once.
-To build the VS Code extension invoke:
+## Getting Started
-```bash
-netbeans$ ant build
-netbeans$ cd java/java.lsp.server
-java.lsp.server$ ant build-vscode-ext -D3rdparty.modules=.*nbjavac.*
-```
+Follow the
+[online instructions](https://cwiki.apache.org/confluence/display/NETBEANS/Apache+NetBeans+extension+for+Visual+Studio+Code)
+to set your environment up to support
+[typical development use-cases](https://cwiki.apache.org/confluence/display/NETBEANS/Apache+NetBeans+extension+for+Visual+Studio+Code).
-The `3rdparty.modules` property doesn't have to be set at all.
-The resulting extension is then in the `build` directory, with the `.vsix` extension.
+## Supported Actions
-### Building for Development
+* __Java: Compile Workspace__ - invoke Maven or Gradle build
+* __GraalVM: Pause in Script__ - place a breakpoint into first executed polyglot script
+* debugger __Java 8+__ - start test or main class on JDK8+ in polyglot mode
-If you want to develop the extension, use these steps for building instead:
+## Supported Options
-```bash
-netbeans$ cd java/java.lsp.server
-java.lsp.server$ ant build-lsp-server -D3rdparty.modules=.*nbjavac.*
-java.lsp.server$ cd vscode
-vscode$ npm install
-vscode$ npm run watch
-```
-
-The `3rdparty.modules` property doesn't have to be set at all.
-This target is faster than building the `.vsix` file. Find the instructions
-for running and debugging below.
-
-### Cleaning
-
-Often it is also important to properly clean everything. Use:
-
-```bash
-java.lsp.server$ ant clean-vscode-server
-java.lsp.server$ cd ../..
-netbeans$ ant clean
-```
-
-## Running and Debugging
-
-Have a sample Maven project, open it in NetBeans first and select the main file for both
-the Run and Debug actions.
-
-To use the extension created for developement you can run VSCode with
-following parameter:
-
-```bash
-vscode$ code --extensionDevelopmentPath=`pwd` path_to_the_maven_project
-```
-
-Or you can open the `vscode` folder in `code` directly and use **F5** to
-debug the extension's *typescript code*.
-
-To debug the *Java code*, launch the NetBeans part of the VSCode system first
-and specify suitable debug arguments:
-
-```bash
-vscode$ npm run nbcode -- --jdkhome /jdk-14/ -J-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=8000
-```
-
-Connect to the process with Java debugger, setup all breakpoints. Then launch
-and connect from the VSCode extension:
-
-```bash
-vscode$ code --extensionDevelopmentPath=`pwd` path_to_the_maven_project
-```
+* __netbeans.jdkhome__ - path to the JDK, see dedicated section below
+* __netbeans.verbose__ - enables verbose extension logging
+* __netbeans.conflict.check__ - avoid conflicts with other Java extensions, see below
## Selecting the JDK
-The NbCode Java part needs to run on a JDK. The JDK is being searched in
+The VSNetBeans Java part needs to run on a JDK. The JDK is being searched in
Review comment:
I believe the user is searching for the definition of JDK which runs/debugs the project. This is not immediately clear here. What about this wording?
"The project is built, run and debugged using the same JDK which runs the VSNetBeans Java part. The JDK is being searched in following locations:"
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
[GitHub] [netbeans] dbalek commented on a change in pull request #2546: End user oriented README.md and dedicated BUILD.md
Posted by GitBox <gi...@apache.org>.
dbalek commented on a change in pull request #2546:
URL: https://github.com/apache/netbeans/pull/2546#discussion_r526743637
##########
File path: java/java.lsp.server/vscode/README.md
##########
@@ -1,4 +1,4 @@
-# NBCode: A NetBeans based Extension for VSCode
+# VSNetBeans
Review comment:
IMHO title should correspond to the description in package.json: Apache NetBeans Language Server Extension for VS Code
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
[GitHub] [netbeans] lkishalmi commented on pull request #2546: End user oriented README.md and dedicated BUILD.md
Posted by GitBox <gi...@apache.org>.
lkishalmi commented on pull request #2546:
URL: https://github.com/apache/netbeans/pull/2546#issuecomment-730468185
I'm soryy for force pushing the removal of the properties change.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
[GitHub] [netbeans] lkishalmi merged pull request #2546: End user oriented README.md and dedicated BUILD.md
Posted by GitBox <gi...@apache.org>.
lkishalmi merged pull request #2546:
URL: https://github.com/apache/netbeans/pull/2546
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
[GitHub] [netbeans] JaroslavTulach commented on a change in pull request #2546: End user oriented README.md and dedicated BUILD.md
Posted by GitBox <gi...@apache.org>.
JaroslavTulach commented on a change in pull request #2546:
URL: https://github.com/apache/netbeans/pull/2546#discussion_r526790262
##########
File path: java/java.lsp.server/vscode/README.md
##########
@@ -21,80 +21,39 @@
-->
+This is a technology preview of [Apache NetBeans](http://netbeans.org)
+based extension for VSCode. Use it to get all the _goodies of NetBeans_
Review comment:
Done in a69fb9e
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
[GitHub] [netbeans] jisedlac commented on a change in pull request #2546: End user oriented README.md and dedicated BUILD.md
Posted by GitBox <gi...@apache.org>.
jisedlac commented on a change in pull request #2546:
URL: https://github.com/apache/netbeans/pull/2546#discussion_r526734514
##########
File path: java/java.lsp.server/vscode/README.md
##########
@@ -21,80 +21,39 @@
-->
+This is a technology preview of [Apache NetBeans](http://netbeans.org)
+based extension for VSCode. Use it to get all the _goodies of NetBeans_
Review comment:
Please use VS Code (include space), which is the official abbreviation used by Microsoft.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
[GitHub] [netbeans] JaroslavTulach commented on a change in pull request #2546: End user oriented README.md and dedicated BUILD.md
Posted by GitBox <gi...@apache.org>.
JaroslavTulach commented on a change in pull request #2546:
URL: https://github.com/apache/netbeans/pull/2546#discussion_r526794121
##########
File path: java/java.lsp.server/vscode/README.md
##########
@@ -1,4 +1,4 @@
-# NBCode: A NetBeans based Extension for VSCode
+# VSNetBeans
Review comment:
OK, updated as you suggest in 1e18194570
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
[GitHub] [netbeans] jisedlac commented on a change in pull request #2546: End user oriented README.md and dedicated BUILD.md
Posted by GitBox <gi...@apache.org>.
jisedlac commented on a change in pull request #2546:
URL: https://github.com/apache/netbeans/pull/2546#discussion_r526734844
##########
File path: java/java.lsp.server/vscode/README.md
##########
@@ -21,80 +21,39 @@
-->
+This is a technology preview of [Apache NetBeans](http://netbeans.org)
+based extension for VSCode. Use it to get all the _goodies of NetBeans_
+via the VSCode user interface! Run on __JDK8__[1], __JDK11__, __JDK15__, etc.
Review comment:
Please use VS Code (include space), which is the official abbreviation used by Microsoft.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
[GitHub] [netbeans] dbalek commented on a change in pull request #2546: End user oriented README.md and dedicated BUILD.md
Posted by GitBox <gi...@apache.org>.
dbalek commented on a change in pull request #2546:
URL: https://github.com/apache/netbeans/pull/2546#discussion_r526743160
##########
File path: java/java.lsp.server/vscode/BUILD.md
##########
@@ -0,0 +1,98 @@
+# VSNetBeans: A NetBeans based Extension for VSCode
Review comment:
IMHO title should correspond to the description in package.json: Apache NetBeans Language Server Extension for VS Code
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
[GitHub] [netbeans] JaroslavTulach commented on a change in pull request #2546: End user oriented README.md and dedicated BUILD.md
Posted by GitBox <gi...@apache.org>.
JaroslavTulach commented on a change in pull request #2546:
URL: https://github.com/apache/netbeans/pull/2546#discussion_r526795543
##########
File path: java/java.lsp.server/vscode/README.md
##########
@@ -21,80 +21,39 @@
-->
+This is a technology preview of [Apache NetBeans](http://netbeans.org)
+based extension for VSCode. Use it to get all the _goodies of NetBeans_
+via the VSCode user interface! Run on __JDK8__[1], __JDK11__, __JDK15__, etc.
Review comment:
Here is your wish: 9036a26
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
[GitHub] [netbeans] JaroslavTulach commented on a change in pull request #2546: End user oriented README.md and dedicated BUILD.md
Posted by GitBox <gi...@apache.org>.
JaroslavTulach commented on a change in pull request #2546:
URL: https://github.com/apache/netbeans/pull/2546#discussion_r526790442
##########
File path: java/java.lsp.server/vscode/README.md
##########
@@ -21,80 +21,39 @@
-->
+This is a technology preview of [Apache NetBeans](http://netbeans.org)
+based extension for VSCode. Use it to get all the _goodies of NetBeans_
+via the VSCode user interface! Run on __JDK8__[1], __JDK11__, __JDK15__, etc.
Review comment:
Done in a69fb9e
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
[GitHub] [netbeans] dbalek commented on a change in pull request #2546: End user oriented README.md and dedicated BUILD.md
Posted by GitBox <gi...@apache.org>.
dbalek commented on a change in pull request #2546:
URL: https://github.com/apache/netbeans/pull/2546#discussion_r526760755
##########
File path: java/java.lsp.server/vscode/README.md
##########
@@ -21,80 +21,39 @@
-->
+This is a technology preview of [Apache NetBeans](http://netbeans.org)
+based extension for VSCode. Use it to get all the _goodies of NetBeans_
+via the VSCode user interface! Run on __JDK8__[1], __JDK11__, __JDK15__, etc.
-Get all the goodies of NetBeans via the VSCode user interface!
+[1]: <http://github.com/oracle/nb-javac> "Running on JDK8 requires additional download of GPLv2 with ClassPath Exception code"
-## Building
+Invoke "Open Folder" action to open project directories with `pom.xml` or `build.gradle`
+build scripts. Edit, compile and debug (with the __Java 8+__ debugger configuration)
+the `.java` application and test files in such projects. Debug not only Java code,
+but JavaScript, Python, Ruby polyglot programs at once.
-To build the VS Code extension invoke:
+## Getting Started
-```bash
-netbeans$ ant build
-netbeans$ cd java/java.lsp.server
-java.lsp.server$ ant build-vscode-ext -D3rdparty.modules=.*nbjavac.*
-```
+Follow the
+[online instructions](https://cwiki.apache.org/confluence/display/NETBEANS/Apache+NetBeans+extension+for+Visual+Studio+Code)
+to set your environment up to support
+[typical development use-cases](https://cwiki.apache.org/confluence/display/NETBEANS/Apache+NetBeans+extension+for+Visual+Studio+Code).
-The `3rdparty.modules` property doesn't have to be set at all.
-The resulting extension is then in the `build` directory, with the `.vsix` extension.
+## Supported Actions
-### Building for Development
+* __Java: Compile Workspace__ - invoke Maven or Gradle build
+* __GraalVM: Pause in Script__ - place a breakpoint into first executed polyglot script
+* debugger __Java 8+__ - start test or main class on JDK8+ in polyglot mode
-If you want to develop the extension, use these steps for building instead:
+## Supported Options
-```bash
-netbeans$ cd java/java.lsp.server
-java.lsp.server$ ant build-lsp-server -D3rdparty.modules=.*nbjavac.*
-java.lsp.server$ cd vscode
-vscode$ npm install
-vscode$ npm run watch
-```
-
-The `3rdparty.modules` property doesn't have to be set at all.
-This target is faster than building the `.vsix` file. Find the instructions
-for running and debugging below.
-
-### Cleaning
-
-Often it is also important to properly clean everything. Use:
-
-```bash
-java.lsp.server$ ant clean-vscode-server
-java.lsp.server$ cd ../..
-netbeans$ ant clean
-```
-
-## Running and Debugging
-
-Have a sample Maven project, open it in NetBeans first and select the main file for both
-the Run and Debug actions.
-
-To use the extension created for developement you can run VSCode with
-following parameter:
-
-```bash
-vscode$ code --extensionDevelopmentPath=`pwd` path_to_the_maven_project
-```
-
-Or you can open the `vscode` folder in `code` directly and use **F5** to
-debug the extension's *typescript code*.
-
-To debug the *Java code*, launch the NetBeans part of the VSCode system first
-and specify suitable debug arguments:
-
-```bash
-vscode$ npm run nbcode -- --jdkhome /jdk-14/ -J-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=8000
-```
-
-Connect to the process with Java debugger, setup all breakpoints. Then launch
-and connect from the VSCode extension:
-
-```bash
-vscode$ code --extensionDevelopmentPath=`pwd` path_to_the_maven_project
-```
+* __netbeans.jdkhome__ - path to the JDK, see dedicated section below
+* __netbeans.verbose__ - enables verbose extension logging
+* __netbeans.conflict.check__ - avoid conflicts with other Java extensions, see below
## Selecting the JDK
-The NbCode Java part needs to run on a JDK. The JDK is being searched in
+The VSNetBeans Java part needs to run on a JDK. The JDK is being searched in
Review comment:
Instead of using "VSNetBeans Java part", I would suggest to use "Apache NetBeans Language Server" or simple "Language Server"
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
[GitHub] [netbeans] JaroslavTulach commented on pull request #2546: End user oriented README.md and dedicated BUILD.md
Posted by GitBox <gi...@apache.org>.
JaroslavTulach commented on pull request #2546:
URL: https://github.com/apache/netbeans/pull/2546#issuecomment-730373019
CCing @geertjanw: this pull request [links to wikipage](https://cwiki.apache.org/confluence/display/NETBEANS/Apache+NetBeans+extension+for+Visual+Studio+Code) that you are just improving.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
[GitHub] [netbeans] dbalek commented on a change in pull request #2546: End user oriented README.md and dedicated BUILD.md
Posted by GitBox <gi...@apache.org>.
dbalek commented on a change in pull request #2546:
URL: https://github.com/apache/netbeans/pull/2546#discussion_r526781061
##########
File path: java/java.lsp.server/vscode/README.md
##########
@@ -21,80 +21,39 @@
-->
+This is a technology preview of [Apache NetBeans](http://netbeans.org)
+based extension for VSCode. Use it to get all the _goodies of NetBeans_
+via the VSCode user interface! Run on __JDK8__[1], __JDK11__, __JDK15__, etc.
Review comment:
Better to use "__JDK8__[*]" instead of "__JDK8__[1]" - when rendered, the original text looks like "JDK81"
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
[GitHub] [netbeans] JaroslavTulach commented on a change in pull request #2546: End user oriented README.md and dedicated BUILD.md
Posted by GitBox <gi...@apache.org>.
JaroslavTulach commented on a change in pull request #2546:
URL: https://github.com/apache/netbeans/pull/2546#discussion_r526793208
##########
File path: java/java.lsp.server/vscode/README.md
##########
@@ -21,80 +21,39 @@
-->
+This is a technology preview of [Apache NetBeans](http://netbeans.org)
+based extension for VSCode. Use it to get all the _goodies of NetBeans_
+via the VSCode user interface! Run on __JDK8__[1], __JDK11__, __JDK15__, etc.
-Get all the goodies of NetBeans via the VSCode user interface!
+[1]: <http://github.com/oracle/nb-javac> "Running on JDK8 requires additional download of GPLv2 with ClassPath Exception code"
-## Building
+Invoke "Open Folder" action to open project directories with `pom.xml` or `build.gradle`
+build scripts. Edit, compile and debug (with the __Java 8+__ debugger configuration)
+the `.java` application and test files in such projects. Debug not only Java code,
+but JavaScript, Python, Ruby polyglot programs at once.
-To build the VS Code extension invoke:
+## Getting Started
-```bash
-netbeans$ ant build
-netbeans$ cd java/java.lsp.server
-java.lsp.server$ ant build-vscode-ext -D3rdparty.modules=.*nbjavac.*
-```
+Follow the
+[online instructions](https://cwiki.apache.org/confluence/display/NETBEANS/Apache+NetBeans+extension+for+Visual+Studio+Code)
+to set your environment up to support
+[typical development use-cases](https://cwiki.apache.org/confluence/display/NETBEANS/Apache+NetBeans+extension+for+Visual+Studio+Code).
-The `3rdparty.modules` property doesn't have to be set at all.
-The resulting extension is then in the `build` directory, with the `.vsix` extension.
+## Supported Actions
-### Building for Development
+* __Java: Compile Workspace__ - invoke Maven or Gradle build
+* __GraalVM: Pause in Script__ - place a breakpoint into first executed polyglot script
+* debugger __Java 8+__ - start test or main class on JDK8+ in polyglot mode
-If you want to develop the extension, use these steps for building instead:
+## Supported Options
-```bash
-netbeans$ cd java/java.lsp.server
-java.lsp.server$ ant build-lsp-server -D3rdparty.modules=.*nbjavac.*
-java.lsp.server$ cd vscode
-vscode$ npm install
-vscode$ npm run watch
-```
-
-The `3rdparty.modules` property doesn't have to be set at all.
-This target is faster than building the `.vsix` file. Find the instructions
-for running and debugging below.
-
-### Cleaning
-
-Often it is also important to properly clean everything. Use:
-
-```bash
-java.lsp.server$ ant clean-vscode-server
-java.lsp.server$ cd ../..
-netbeans$ ant clean
-```
-
-## Running and Debugging
-
-Have a sample Maven project, open it in NetBeans first and select the main file for both
-the Run and Debug actions.
-
-To use the extension created for developement you can run VSCode with
-following parameter:
-
-```bash
-vscode$ code --extensionDevelopmentPath=`pwd` path_to_the_maven_project
-```
-
-Or you can open the `vscode` folder in `code` directly and use **F5** to
-debug the extension's *typescript code*.
-
-To debug the *Java code*, launch the NetBeans part of the VSCode system first
-and specify suitable debug arguments:
-
-```bash
-vscode$ npm run nbcode -- --jdkhome /jdk-14/ -J-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=8000
-```
-
-Connect to the process with Java debugger, setup all breakpoints. Then launch
-and connect from the VSCode extension:
-
-```bash
-vscode$ code --extensionDevelopmentPath=`pwd` path_to_the_maven_project
-```
+* __netbeans.jdkhome__ - path to the JDK, see dedicated section below
+* __netbeans.verbose__ - enables verbose extension logging
+* __netbeans.conflict.check__ - avoid conflicts with other Java extensions, see below
## Selecting the JDK
-The NbCode Java part needs to run on a JDK. The JDK is being searched in
+The VSNetBeans Java part needs to run on a JDK. The JDK is being searched in
Review comment:
Done in d2def6e82
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists
[GitHub] [netbeans] JaroslavTulach commented on pull request #2546: End user oriented README.md and dedicated BUILD.md
Posted by GitBox <gi...@apache.org>.
JaroslavTulach commented on pull request #2546:
URL: https://github.com/apache/netbeans/pull/2546#issuecomment-730801537
Thanks Laszlo for polishing the history and separating the backport into #2548. I've meant this PR as a single "VS Code fixes for RC3", but you are right, having the intentions separated is cleaner.
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@netbeans.apache.org
For additional commands, e-mail: notifications-help@netbeans.apache.org
For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists