[GR-24925] Replace relative links with absolute to avoid broken links on other domains.

PullRequest: graalpython/1223

Author: olyagpl

docs/user/FAQ.md

@@ -47,7 +47,7 @@ can expect to see between 0.1x and 0.5x performance.
 
 ### I heard languages with JIT compilers have slow startup. Is that true for GraalVM's Python?
 
-It depends. When you use the [GraalVM Native Image](https://www.graalvm.org/docs/reference-manual/graalvm-native-image/) feature with Python or
+It depends. When you use the [GraalVM Native Image](https://www.graalvm.org/reference-manual/native-image/) feature with Python or
 use the `graalpython` launcher of GraalVM, its startup is competitive with
 CPython. In any case, both with Native Image or when running on JVM you first
 need to warm up to reach peak performance. This is a complicated story in

docs/user/Interoperability.md

@@ -73,7 +73,7 @@ print("Here is what we found: '%s'" % md[1])
 
 To run it, pass the `--jvm --polyglot` options to `graalpython` binary:
 ```shell
-$ graalpython --jvm --polyglot polyglot_example.py
+graalpython --jvm --polyglot polyglot_example.py
 ```
 
 This example matches Python strings using the JavaScript regular expression object
@@ -85,7 +85,7 @@ Python, and use R again to display the resulting data image, using both R and
 Python libraries in conjunction. To run it, first install the
 required R library:
 ```shell
-$ R -e 'install.packages("https://www.rforge.net/src/contrib/jpeg_0.1-8.tar.gz", repos=NULL)'
+R -e 'install.packages("https://www.rforge.net/src/contrib/jpeg_0.1-8.tar.gz", repos=NULL)'
 ```
 
 This example also uses [image_magix.py](http://graalvm.org/docs/examples/image_magix.py) and works
@@ -179,5 +179,5 @@ print(java.is_function(my_list.add))# prints True, the add method of ArrayList
 print(java.instanceof(my_list, ArrayList)) # prints True
 ```
 
-See the [Polyglot Programming](https://www.graalvm.org/docs/reference-manual/polyglot-programming/) and the [Embed Languages](https://www.graalvm.org/docs/reference-manual/embed-languages/#Function_Python) reference
+See the [Polyglot Programming](https://www.graalvm.org/docs/reference-manual/polyglot-programming/) and the [Embed Languages](https://www.graalvm.org/reference-manual/embed-languages/) reference
 for more information about interoperability with other programming languages.

docs/user/Jython.md

@@ -175,4 +175,4 @@ For Graal Python, no dependency other than on the [GraalVM SDK](https://mvnrepos
 required. There are no APIs particular to Python that are exposed, and
 everything is done through the GraalVM API. Important to know is that as long as
 your application is executed on a GraalVM with the Python language installed,
-you can embed Python in your programs. For more detail, refer to the [Embed Languages](https://www.graalvm.org/docs/reference-manual/embed-languages/#Function_Python) reference.
+you can embed Python in your programs. For more detail, refer to the [Embed Languages](https://www.graalvm.org/reference-manual/embed-languages/) reference.

docs/user/Packages.md

@@ -6,13 +6,13 @@ environment. This generates wrapper scripts and makes the implementation usable
 from shell as standard Python interpreter. To do so execute the following from a
 GraalVM installation:
 
-```
+```shell
 graalpython -m venv <venv-dir>
 ```
 
 To activate the environment in your shell session call:
 
-```
+```shell
 source <venv-dir>/bin/activate
 ```
 
@@ -23,13 +23,13 @@ simple module to install packages is provided (including
 potential patches required for those packages). Try the following to find out
 more:
 
-```
+```shell
 graalpython -m ginstall --help
 ```
 
 As a slightly more exciting example, try:
 
-```
+```shell
 graalpython -m ginstall install numpy
 ```
 

docs/user/README.md

@@ -10,8 +10,8 @@ questions about this implementation.
 ## Installing Python
 
 Python can be added to the GraalVM installation with the [GraalVM Updater](https://www.graalvm.org/docs/reference-manual/gu/), `gu`, tool:
-```
-$ gu install python
+```shell
+gu install python
 ```
 The above command will install a community version of a component from GitHub catalog.
 For GraalVM Enterprise users, the [manual component installation](https://www.graalvm.org/docs/reference-manual/gu/#manual-installation) is required. See `bin/gu --help` for more information.
@@ -21,8 +21,8 @@ For GraalVM Enterprise users, the [manual component installation](https://www.gr
 GraalVM implementation of Python targets Python 3.7 compatibility. While support
 for the Python language is still limited, you can run simple Python scripts or
 commands with the `graalpython` binary.
-```
-$ graalpython [options] [-c cmd | filename]
+```shell
+graalpython [options] [-c cmd | filename]
 ```
 
 If no program file or command is given, you are dropped into a simple REPL.
@@ -31,8 +31,8 @@ GraalVM supports some of the same options as Python 3.7 and some additional
 options to control the underlying Python implementation, the GraalVM tools
 and the execution engine. These can be viewed using the following command:
 
-```
-$ graalpython --help --help:tools --help:languages
+```shell
+graalpython --help --help:tools --help:languages
 ```
 
 ## Installing Supported Packages
@@ -45,21 +45,21 @@ incompatible interaction with the local user's packages that may have been
 installed using a system installation of CPython:
 
 ```shell
-$ graalpython -m venv my_new_venv
-$ source my_new_venv/bin/activate
+graalpython -m venv my_new_venv
+source my_new_venv/bin/activate
 ```
 
 To see the list of installable packages, run:
 
 ```shell
-$ graalpython -m ginstall install --help
+graalpython -m ginstall install --help
 ```
 
 This will print a short help including a comma-separated list of packages you
 can install. The installation works as described in that help:
 
 ```shell
-$ graalpython -m ginstall install pandas
+graalpython -m ginstall install pandas
 ```
 
 Note that when using the GraalVM implementation of Python from Java, the

docs/user/Tooling.md

@@ -8,8 +8,8 @@ about tools currently supported on Python.
 ### Debugger
 To enable debugging, pass the `--inspect` option to the `graalpython`
 launcher. For example:
-```
-$ graalpython --inspect -c "breakpoint(); import os; os.exit()"
+```shell
+graalpython --inspect -c "breakpoint(); import os; os.exit()"
 Debugger listening on port 9229.
 To start debugging, open the following URL in Chrome:
     chrome-devtools://devtools/bundled/js_app.html?ws=127.0.1.1:9229/76fcb6dd-35267eb09c3
@@ -26,8 +26,8 @@ the `graalpython --help:tools` command line help for more details on how to use
 it. In order to work better with existing Python code, we also partially support
 the standard library `trace` module with this low-overhead GraalVM coverage
 instrument. So you can do this:
-```
-$ graalpython -m trace -m -c -s my_script.py
+```shell
+graalpython -m trace -m -c -s my_script.py
 ```
 This will work similarly to how it will run on CPython. The programmatic API
 also works, with some limitations. For example, it does not currently track calls,
@@ -37,13 +37,13 @@ only line counts and called functions.
 The `_lsprof` built-in module has been implemented using the GraalVM `cpusampler`
 tool. Not all profiling features are currently supported, but basic profiling
 works:
-```
-$ graalpython -m cProfile -s sort -m ginstall --help
+```shell
+graalpython -m cProfile -s sort -m ginstall --help
 ```
 The interactive exploration of a stats output file also works:
-```
-$ graalpython -m cProfile -o ginstall.profile -m ginstall --help
-$ graalpython -m pstats ginstall.profile
+```shell
+graalpython -m cProfile -o ginstall.profile -m ginstall --help
+graalpython -m pstats ginstall.profile
 ginstall.profile%
 callers
 [...]