Skip to content

Commit 22b88fb

Browse files
authored
Merge pull request #71 from usethesource/chore/release-notes/0.41.2
Release notes [0.41.2]
2 parents 91221cb + 74a3f31 commit 22b88fb

File tree

19 files changed

+132
-46
lines changed

19 files changed

+132
-46
lines changed

courses/Bibliography/Bibliography.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,7 @@ This literature is about the meta systems themselves, their design and their eva
7878
* Mauricio Verano Merino, Tom Beckmann, Tijs van der Storm, Robert Hirschfeld, and Jurgen J. Vinju. Getting Grammars into Shape for Block-based. (2021) International Conference on Software Language Engineering.
7979
> We can generate block-based syntax editors from context-free grammars. The paper bridges between the grammarware and blockware technological spaces. A collaboration with TU Eindhoven en Canon Production Printing.
8080
* Jurgen J. Vinju and Tijs van der Storm. Bacatá: Notebooks for DSLs, Almost for Free. (2020) <Programming> Journal and DSLDI 2020
81-
> We can generate Jupyter Notebook interfaces for language descriptions in Rascal, similar to the way we can generate Eclipse plugins and VScode extensions,
81+
> We can generate Jupyter Notebook interfaces for language descriptions in Rascal, similar to the way we can generate Eclipse plugins and VS Code extensions,
8282
> but with a very different user experience.
8383
8484
### 2010's

courses/GettingHelp/GettingHelp.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ details:
3131
* Directly in the Rascal IDE there is help available:
3232
1. On the commandline, type `:help`
3333
2. In Eclipse there is the `Tutor View` which opens all the documentation pages inside Eclipse.
34-
3. In VScode use the command palette and search for `Rascal` for more commands.
34+
3. In VS Code use the command palette and search for `Rascal` for more commands.
3535
* For specific application topics, "Howto" kind of information, etc. please go to ((FurtherReading)).
3636
* There is a lot of documentation on Rascal and its libraries. Read the ((Browsing)) page on how to navigate it.
3737

courses/GettingStarted/CreateNewProject/CreateNewProject.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ remove(|home:///my-project-name|, recursive=true);
99
```
1010

1111
Rascal projects, generally, work the same in all contexts:
12-
* VScode
12+
* VS Code
1313
* Commandline
1414

1515
To create an empty project to get started, follow these instructions:
@@ -23,7 +23,7 @@ newRascalProject(|home:///my-project-name|)
2323

2424
The Eclipse plugin has a "New Project Wizard" you can use as well.
2525

26-
The next step is to import the new project into VScode or Eclipse, or
26+
The next step is to import the new project into VS Code or Eclipse, or
2727
to `cd` to the project's root directory. From there on ((RunningRascal))
2828
with the new project's source and library settings is trivial.
2929

@@ -51,7 +51,7 @@ The `pom.xml` file is the basic setup that names the project and defines its dep
5151
```
5252

5353
Next to that `RASCAL.MF` is required to configure the development environment for the project. Some
54-
information from the `pom.xml` is repeated here, because this file is common between Eclipse, VScode and empty commandline projects,
54+
information from the `pom.xml` is repeated here, because this file is common between Eclipse, VS Code and empty commandline projects,
5555
and such projects could work with a `pom.xml`:
5656

5757
```MF

courses/GettingStarted/DownloadAndInstallation/DownloadAndInstallation.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ sidebar_position: 1
66
Rascal is deployed as one of four easy-to-use packages:
77

88
1. **A standalone "jar" file**, which can be downloaded [here](https://update.rascal-mpl.org/console/rascal-shell-stable.jar)
9-
2. A **Visual Studio Code extension**, which can be found [here](https://marketplace.visualstudio.com/items?itemName=usethesource.rascalmpl) or search for "Rascal" in the "Extension" view in VScode itself.
9+
2. A **Visual Studio Code extension**, which can be found [here](https://marketplace.visualstudio.com/items?itemName=usethesource.rascalmpl) or search for "Rascal" in the "Extension" view in VS Code itself.
1010
3. An **Eclipse plugin**, for which the update site is <https://update.rascal-mpl.org/stable/>.
1111
4. A set of **Maven MOJOs**, for which the plugin repository is <https://releases.usethesource.io/maven/>
1212

courses/GettingStarted/RascalShell/Commands/Edit/Edit.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,4 +17,4 @@ mean different things:
1717

1818
* On the Unix commandline the `${EDITOR}` environment variable will be used to open a file. If that file is present in the local file system, it is opened by running `${EDITOR} /absolute/path/to/module.rsc`, but if the file is hidden behind an opaque ((Values-Location)) scheme, then it is first copied to a temporary file on the local file system, and then opened.
1919
* In Eclipse, the eclipse editor framework is used to open an editor for the file. If it is a so called "resource" in the eclipse file system, and editable file is opened with all the Rascal language support. If the file is from an embedded library (inside a jar) then the contents of the file are shown in a similar editor, but read-only.
20-
* In VScode a similar experience is provided as in Eclipse, but the editor for library files does not know it is read-only.
20+
* In VS Code a similar experience is provided as in Eclipse, but the editor for library files does not know it is read-only.

courses/GettingStarted/RunningRascal/RunningRascal.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ sidebar_position: 2
66
#### Running Rascal: starting a terminal with a read-eval-print-loop
77

88
1. On the Unix or Windows [Commandline]((RunningRascal-Commandline)), start a ((RascalShell)) by: `java -jar rascal-<version>.jar`
9-
2. In [VScode]((RunningRascal-VScode)), in the command palette type `Rascal` and select `Create Rascal Terminal`
9+
2. In [VS Code]((RunningRascal-VScode)), in the command palette type `Rascal` and select `Create Rascal Terminal`
1010
4. With Maven, ((CreateNewProject)) first and then type: `mvn rascal:console`
1111

1212
You will be prompted for input right after the version is printed and a lot of information about the current searchpath configuration.

courses/GettingStarted/RunningRascal/VScode/VScode.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
2-
title: Running Rascal in VScode
2+
title: Running Rascal in VS Code
33
---
44

55
After the [installation procedure]((DownloadAndInstallation)) running Rascal
6-
in VScode is a matter of starting the ((RascalShell)):
6+
in VS Code is a matter of starting the ((RascalShell)):
77
1. Using an editor action
8-
2. Using the VScode command palette
8+
2. Using the VS Code command palette
99

1010
## Starting ((RascalShell)) from an editor
1111

@@ -24,9 +24,9 @@ This assumes there is a functional [Rascal project]((CreateNewProject)) in your
2424
* A ((RascalShell)) started from the palette has no source or library or classpath configuration and so it only knows about the standard library.
2525
* See above for well-configured instances of ((RascalShell)).
2626

27-
## Programmatic access to VScode features
27+
## Programmatic access to VS Code features
2828

29-
* Use ((util::IDEServices)) to communicate with VScode, to register problems, to open files and browsers, etc.
30-
* Use ((util::LanguageServer)) to register languages designed and implemented in Rascal with the Language Server Protocol in VScode immediately.
31-
* The `project://<projectName>` location scheme provides access to the root of each registered folder in the VScode workspace.
29+
* Use ((util::IDEServices)) to communicate with VS Code, to register problems, to open files and browsers, etc.
30+
* Use ((util::LanguageServer)) to register languages designed and implemented in Rascal with the Language Server Protocol in VS Code immediately.
31+
* The `project://<projectName>` location scheme provides access to the root of each registered folder in the VS Code workspace.
3232
* Use ((util::Reflective::getProjectPathConfig)) for Java and Rascal project configuration extracted from Maven configuration (classpaths, sourcepaths, library dependencies).

courses/GettingStarted/Troubleshooting/StackOverflow/StackOverflow.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,5 +13,5 @@ To be able to generate parsers Rascal uses stack space from the Java Virtual Mac
1313
If you get exceptions better configure your JVM with this `-Xss32m`
1414

1515
* On the commandline, you can use `java -Xss32m ...`
16-
* In VScode the Rascal language server already configures this automatically.
16+
* In VS Code the Rascal language server already configures this automatically.
1717
* The same for the Rascal Maven plugins; they are configured with big stack sizes.

courses/Rascal/Tests/Tests.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ public class RunRascalTestModules { }
5353

5454
* <1> selects the test runner (parallel or not)
5555
* <2> selects the root package to search for modules and tests
56-
* Then use JUnit configuration in Eclipse, VScode or Maven to activate the tests at the right time.
56+
* Then use JUnit configuration in Eclipse, VS Code or Maven to activate the tests at the right time.
5757
* Reporting goes through standard JUnit reporting, so this integrates well with IDEs and continuous integration systems like Jenkins and GitHub Actions.
5858

5959

courses/Recipes/BasicProgramming/IDEConstruction/IDEConstruction.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ keywords:
55
- IDE
66
- Language Server Protocol
77
- Eclipse
8-
- VScode
8+
- VS Code
99
---
1010

1111
#### Synopsis
@@ -22,18 +22,18 @@ Extend an IDE with interactive, language-specific, features (VSCode)
2222

2323
Meta-programs become most useful, when they are integrated with an Interactive Development Environment (IDE).
2424

25-
A Rascal program running inside a [language server protocol](https://microsoft.github.io/language-server-protocol/) server that is part of the VScode IDE can service most of the typical IDE features such as syntax highlighting,
26-
outlining, documentation hovering and much more. Similarly Rascal programs running inside VScode have access to all features
25+
A Rascal program running inside a [language server protocol](https://microsoft.github.io/language-server-protocol/) server that is part of the VS Code IDE can service most of the typical IDE features such as syntax highlighting,
26+
outlining, documentation hovering and much more. Similarly Rascal programs running inside VS Code have access to all features
2727
of the , and more.
2828

2929
Rascal builds on top of the [language server protocol](https://microsoft.github.io/language-server-protocol/) for its own services, and for services that
30-
Rascal programmers create for their own languages. By default Rascal can instantiate an LSP server for VScode, but there is nothing in the way of using other editors that have LSP clients.
30+
Rascal programmers create for their own languages. By default Rascal can instantiate an LSP server for VS Code, but there is nothing in the way of using other editors that have LSP clients.
3131

3232
To instantiate an IDE for a language implemented using Rascal, use the following steps:
3333

3434
* Define the grammar for the language.
3535
* Define a parse function for the language.
36-
* Register the language with the LSP/VScode, using ((util::LanguageServer))
36+
* Register the language with the LSP/VS Code, using ((util::LanguageServer))
3737

3838
You find more information on these topics [here]((util::LanguageServer))
3939

0 commit comments

Comments
 (0)