Merge branch 'main' into develop

.gitignore

@@ -60,3 +60,4 @@ jason-interpreter/settings.gradle
 doc/install.html
 doc/index.html
 doc/doc.html
+doc.html

doc/install.adoc

@@ -23,5 +23,3 @@ To test the installation, run the command `jason --version` in a terminal. The o
 ----
 Jason CLI 3.2
 ----
-
-(You may need to close and open VSCode again to have Jason in its `PATH` terminal)

doc/jason-cli/readme.adoc

@@ -23,6 +23,12 @@ The first command creates a Jason application identified by `app1` with two agen
 [alice] hello world.
 ```
 
+This approach uses Gradle to execute the application. Gradle is useful if you are using other packages. However, it you do not have dependencies, the application can be started faster without Gradle:
+
+```
+jason mas start --mas2j=app1.mas2j
+```
+
 You can add more agents in the project with:
 
 ```
@@ -34,6 +40,7 @@ To run agent karlos, there are two options: stop the MAS and run it again; or ad
 jason agent start --source="src/agt/karlos.asl" --mas-name="app1" karlos
 ```
 
+
 You can add a Gradle script for the application with:
 
 ```
@@ -43,8 +50,7 @@ jason app add-gradle
 and then run it with `./gradlew run`.
 
 
-More details and commands with (or xref:./commands.adoc[here])
-:
+More details and commands with (or xref:./commands.adoc[here]):
 
 ```
 jason app

doc/publishDocInGHPages.sh

@@ -2,17 +2,18 @@ cd ..
 
 ./gradlew doc
 
-rm -rf ../jason-pages/api
-rm -rf ../jason-pages/doc
+SITE_PATH=../jason-lang.github.io
+
+rm -rf $SITE_PATH/api
+rm -rf $SITE_PATH/doc
 
-#asciidoctor -a stylesheet=adoc-empty.css readme.adoc -o doc.html
 IMAGE=jomifred/adoc
-docker run --rm -i --user="$(id -u):$(id -g)" --net=none -v "$PWD":/app "$IMAGE" asciidoctor -r /pygments_init.rb -a stylesheet=adoc-empty.css readme.adoc -o doc.html
+docker run --rm -i --user="$(id -u):$(id -g)" --net=none -v "$PWD":/app "$IMAGE" asciidoctor -r /pygments_init.rb -a stylesheet=adoc-empty.css doc/readme.adoc -o doc/doc.html
 
-cp -R jason-interpreter/build/docs/javadoc ../jason-pages/api
-cp -R doc ../jason-pages
+cp -R jason-interpreter/build/docs/javadoc $SITE_PATH/api
+cp -R doc $SITE_PATH
 
-cd ../jason-pages
+cd $SITE_PATH
 git add api
 git commit -a -m "add javadoc api"
 
@@ -21,6 +22,3 @@ git add doc
 git commit -a -m "add jason github doc folder"
 
 git push
-
-
-

doc/readme.adoc

@@ -2,7 +2,7 @@
 
 Jason is an interpreter for an extended version of AgentSpeak. It implements the operational semantics of that language, and provides a platform for the development of multi-agent systems, with many user-customisable features. Jason is available as Open Source, and is distributed under GNU LGPL.
 
-Jason is developed by http://https://jomifred.github.io[Jomi F. Hübner] and http://www.inf.pucrs.br/r.bordini[Rafael H. Bordini], based on previous work done with many colleagues, in particular Michael Fisher, Joyce Martins, Álvaro Moreira, Renata Vieira, Willem Visser, Mike Wooldridge, but also many others, as acknowledged in the manual (see the http://jason-lang.github.io/[Jason web site]).
+Jason is developed by https://jomifred.github.io[Jomi F. Hübner] and http://www.inf.pucrs.br/r.bordini[Rafael H. Bordini], based on previous work done with many colleagues, in particular Michael Fisher, Joyce Martins, Álvaro Moreira, Renata Vieira, Willem Visser, Mike Wooldridge, but also many others, as acknowledged in the manual (see the http://jason-lang.github.io/[Jason web site]).
 
 ifdef::env-github[]
 NOTE: The documentation of is also available (and better rendered) at http://jason-lang.github.io/jason/.

doc/tutorials/vscode/readme.adoc

@@ -9,10 +9,13 @@
 
 == What You Will Build
 
-In this document, you will build an environment to develop agent-based system with link:https://github.com/jason-lang/jason[Jason] language.
+In this document, you will build an environment to develop agent-based systems with link:https://github.com/jason-lang/jason[Jason] language.
 
 include::../../install.adoc[]
 
+(You may need to close and open VSCode again to have Jason in its `PATH` terminal)
+
+
 //image:./figs/inst.png[vscode and java installation]
 
 
@@ -63,6 +66,7 @@ To add more agents in your project:
 jason app add-agent karlos
 ----
 
+
 More commands for the application are shown with
 
 ----

readme.adoc

@@ -5,7 +5,7 @@
 
 Jason is an interpreter for an extended version of AgentSpeak. It implements the operational semantics of that language, and provides a platform for the development of multi-agent systems, with many user-customisable features. Jason is available as Open Source, and is distributed under GNU LGPL.
 
-Jason is developed by http://https://jomifred.github.io[Jomi F. Hübner] and http://www.inf.pucrs.br/r.bordini[Rafael H. Bordini], based on previous work done with many colleagues, in particular Michael Fisher, Joyce Martins, Álvaro Moreira, Renata Vieira, Willem Visser, Mike Wooldridge, but also many others, as acknowledged in the manual (see the http://jason-lang.github.io/[documents] page).
+Jason is developed by https://jomifred.github.io[Jomi F. Hübner] and http://www.inf.pucrs.br/r.bordini[Rafael H. Bordini], based on previous work done with many colleagues, in particular Michael Fisher, Joyce Martins, Álvaro Moreira, Renata Vieira, Willem Visser, Mike Wooldridge, but also many others, as acknowledged in the manual (see the http://jason-lang.github.io/[documents] page).
 
 == Documentation