Make bash code samples consistent

Author: chrisseaton

doc/contributor/benchmarking.md

@@ -2,7 +2,7 @@
 
 ## Benchmarking with the GraalVM Compiler
 
-```
+```bash
 $ jt benchmark bench/classic/mandelbrot.rb --simple
 ```
 
@@ -13,13 +13,13 @@ for the first few iterations).
 
 You can turn off the GraalVM Compiler if you want using `--no-graal`.
 
-```
+```bash
 $ jt benchmark --no-graal bench/classic/mandelbrot.rb --simple
 ```
 
 You can benchmark an entirely different implementation using the
 `JT_BENCHMARK_RUBY` environment variable.
 
-```
+```bash
 $ JT_BENCHMARK_RUBY=ruby jt benchmark bench/classic/mandelbrot.rb --simple
 ```

doc/contributor/building-graal.md

@@ -11,13 +11,13 @@ install Graal locally.
 Our workflow tool can install Graal automatically under the directory
 `../graal/compiler` with:
 
-```
+```bash
 $ jt install graal
 ```
 
 You can then use `jt` to run TruffleRuby with Graal.
 
-```
+```bash
 $ jt ruby --graal ...
 ```
 
@@ -32,6 +32,6 @@ You can then set the `GRAAL_HOME` environment variable to the location of the
 `compiler` directory inside the `graal` repository and use `jt` to run
 TruffleRuby.
 
-```
+```bash
 $ GRAAL_HOME=.../graal/compiler jt ruby --graal ...
 ```

doc/contributor/cexts.md

@@ -5,28 +5,28 @@
 Get the gem test pack.
 
 ```bash
-jt gem-test-pack
+$ jt gem-test-pack
 ```
 
 You can then test C extension support.
 
 ```bash
-jt test cexts
+$ jt test cexts
 ```
 
 You can also runs specs:
 
 ```bash
-jt test :capi
+$ jt test :capi
 ```
 
 ### OpenSSL
 
 The `openssl` specs and tests are currently segregated and are run separately.
 
 ```bash
-jt test :openssl
-jt test mri --openssl
+$ jt test :openssl
+$ jt test mri --openssl
 ```
 
 ## Benchmarking
@@ -40,7 +40,7 @@ jt cextc bench/chunky_png/oily_png
 Then follow the instructions for benchmarking above, and then try:
 
 ```bash
-USE_CEXTS=true TRUFFLERUBYOPT=--cexts-log-load jt benchmark bench/chunky_png/chunky-color-r.rb --simple
+$ USE_CEXTS=true TRUFFLERUBYOPT=--cexts-log-load jt benchmark bench/chunky_png/chunky-color-r.rb --simple
 ```
 
 These benchmarks have Ruby fallbacks, so we should carefully check that the

doc/contributor/docker.md

@@ -12,7 +12,7 @@ For example, to build a Docker image called `truffleruby-test` to test
 installing the public GraalVM CE binary and the public Ruby installable,
 using rbenv, and running a basic test:
 
-```
+```bash
 $ jt docker build truffleruby-test --ubuntu1804 --public 1.0.0 --rbenv --basic-test
 ```
 
@@ -23,13 +23,13 @@ built to use TruffleRuby.
 Or, to print a Dockerfile to show how to install TruffleRuby from source on
 Fedora 28 using RVM:
 
-```
+```bash
 $ jt docker print --fedora28 --source --rvm
 ```
 
 Or, to run a full set of tests on a set of new release candidate tarballs:
 
-```
+```bash
 $ jt docker test --graalvm graalvm-ce.tar.gz ruby-installable.jar --test release_branch
 $ jt docker test --graalvm graalvm-ee.tar.gz ruby-installable.jar --test release_branch
 $ jt docker test --graalvm graalvm-ee.tar.gz ruby-installable.jar --rebuild-images --test release_branch
@@ -87,7 +87,7 @@ You may find that the Docker cache interacts badly with these Dockerfiles (such
 as repository URLs being cached that become unavailable). Therefore we recommend
 regularly clearing your Docker cache.
 
-```
+```bash
 $ docker system prune -a -f
 ```
 

doc/contributor/native-image.md

@@ -33,12 +33,14 @@ warm-up time for shorter running commands and benchmarks.
 $ cd graalvm
 $ otool -L jre/bin/ruby
 jre/bin/ruby:
-	/System/Library/Frameworks/CoreFoundation.framework/Versions/A/CoreFoundation (compatibility version 150.0.0, current version 1348.28.0)
-	/usr/lib/libSystem.B.dylib (compatibility version 1.0.0, current version 1238.0.0)
-	/usr/lib/libz.1.dylib (compatibility version 1.0.0, current version 1.2.8)
+  /System/Library/Frameworks/CoreFoundation.framework/Versions/A/CoreFoundation (compatibility version 150.0.0, current version 1348.28.0)
+  /usr/lib/libSystem.B.dylib (compatibility version 1.0.0, current version 1238.0.0)
+  /usr/lib/libz.1.dylib (compatibility version 1.0.0, current version 1.2.8)
+```
 
+```bash
 $ du -h jre/bin/ruby
-200M	jre/bin/ruby
+200M jre/bin/ruby
 ```
 
 The Native Image version of TruffleRuby has better startup performance and lower memory
@@ -81,7 +83,7 @@ There is no need to do so, but you can actually also compile your own copy of
 the Native Image version of TruffleRuby using a tool distributed as part of GraalVM and
 the Java version of TruffleRuby from GraalVM.
 
-```
+```bash
 $ native-image -H:Name=native-ruby --language:ruby
 ```
 
@@ -90,7 +92,7 @@ $ native-image -H:Name=native-ruby --language:ruby
 You can build a native build of TruffleRuby using the Native Image Tool from a
 source distribution using:
 
-```
+```bash
 $ jt build native
 ```
 

doc/contributor/static-analysis.md

@@ -11,7 +11,7 @@ The [Clang Static Analyzer](https://clang-analyzer.llvm.org) finds bugs in C
 code. We occasionally run this tool locally but only take its output as a
 suggestion. We use a default configuration.
 
-```
+```bash
 $ scan-build --use-analyzer `which clang` -analyze-headers clang -c --std=c99 -Ilib/cext/include src/main/c/cext/ruby.c src/main/c/truffleposix/truffleposix.c
 $ scan-view ...as instructed by scan-build...
 ```
@@ -23,7 +23,7 @@ $ scan-view ...as instructed by scan-build...
 We have a tool to check that some use of our internal annotations and the
 Truffle DSL are correct. Passing this is enforced in our CI gate.
 
-```
+```bash
 $ jt check_dsl_usage
 ```
 
@@ -32,7 +32,7 @@ $ jt check_dsl_usage
 [CheckStyle](http://checkstyle.sourceforge.net) enforces a Java style guide.
 Passing CheckStyle is enforced in our CI gate.
 
-```
+```bash
 $ mx checkstyle
 ```
 
@@ -42,7 +42,7 @@ $ mx checkstyle
 errors. We run it with the default Graal project configuration. Passing
 SpotBugs is enforced in our CI gate.
 
-```
+```bash
 $ mx spotbugs
 ```
 
@@ -54,7 +54,7 @@ $ mx spotbugs
 It's configured in `.rubocop.yml`, and can be run locally as `jt rubocop`.
 Passing Rubocop is enforced in our CI gate.
 
-```
+```bash
 $ jt rubocop
 ```
 
@@ -64,7 +64,7 @@ $ jt rubocop
 performance improvements. We occasionally run this tool locally but only take
 its output as a suggestion. We use a default configuration.
 
-```
+```bash
 $ gem install fasterer
 $ fasterer lib/truffle lib/cext src/main
 ```
@@ -78,7 +78,7 @@ suggestion. We disable a lot of the defaults in `.reek.yml`, either because
 we're implementing a set API, because we're doing something low-level or
 outside normal Ruby semantics, or for performance reasons.
 
-```
+```bash
 $ gem install reek
 $ reek lib/truffle lib/cext src/main
 ```
@@ -89,7 +89,7 @@ $ reek lib/truffle lib/cext src/main
 check that your methods do not appear near the top of this list. We
 occasionally run this tool locally but only take its output as a suggestion.
 
-```
+```bash
 $ gem install flog
 $ flog -m -t 10 lib/truffle lib/cext src/main
 ```
@@ -100,7 +100,7 @@ $ flog -m -t 10 lib/truffle lib/cext src/main
 could potentially be factored out. We occasionally run this tool locally but
 only take its output as a suggestion.
 
-```
+```bash
 $ gem install flay
 $ flay lib/truffle lib/cext src/main
 ```
@@ -112,7 +112,7 @@ vulnerabilities. It's really designed for Rails, and many of the rules are
 specific to Rails, but we do run it ocassionally anyway and take its output as
 a suggestion.
 
-```
+```bash
 $ gem install brakeman
 $ brakeman --force-scan --run-all-checks --interprocedural --no-pager --add-libs-path src --only-files lib/truffle/,lib/cext/,src/main/ruby/core/
 ```

doc/contributor/updating-ruby-installers.md

@@ -29,8 +29,8 @@ maintained in the [ruby-versions](https://github.com/postmodern/ruby-versions) r
 
 There is a handy script in the repo that does everything needed:
 
-```
-./update.sh truffleruby $VERSION
+```bash
+$ ./update.sh truffleruby $VERSION
 ```
 
 Example PR for `1.0.0-rc12`: https://github.com/postmodern/ruby-versions/pull/39
@@ -41,8 +41,8 @@ cc `@havenwood` in the PR description.
 
 There is a script in the repo that does everything needed:
 
-```
-script/update-truffleruby $VERSION
+```bash
+$ script/update-truffleruby $VERSION
 ```
 
 Example PR for `1.0.0-rc12`: https://github.com/rbenv/ruby-build/pull/1282
@@ -56,8 +56,8 @@ cc `@hsbt` in the PR description.
 
 There is a script in the repo that does everything needed:
 
-```
-ruby update-truffleruby.rb $VERSION ../ruby-versions/pkg
+```bash
+$ ruby update-truffleruby.rb $VERSION ../ruby-versions/pkg
 ```
 
 The script must be run after running the `ruby-versions` script above.

doc/contributor/updating-ruby.md

@@ -17,7 +17,7 @@ Check out the version of Ruby you want to create the branch for in `../ruby`.
 
 Then create the reference branch in the TruffleRuby repository
 
-```
+```bash
 $ git checkout -b vNN
 $ tool/import-mri-files.sh
 $ git commit -am 'vNN'
@@ -33,9 +33,9 @@ update.
 In your working branch you can import MRI files again, and you can re-apply
 old patches using the old reference branch.
 
-```
-tool/import-mri-files.sh
-git diff vNN master | git apply -3
+```bash
+$ tool/import-mri-files.sh
+$ git diff vNN master | git apply -3
 ```
 
 You'll usually get some conflicts to work out.

doc/contributor/workflow.md

@@ -30,6 +30,7 @@ $ ruby tool/jt.rb --help
 
 Most of us add a function to our shell profile file so that it can be run with
 just `jt`. To allow this to run from any path, add this to your `.bash_profile`:
+
 ```bash
 $ echo 'function jt { ruby '$PWD'/tool/jt.rb "$@"; }' >> ~/.bash_profile
 ```
@@ -44,7 +45,7 @@ $ jt --help
 You can install it automatically with:
 
 ```bash
-jt mx version
+$ jt mx version
 ```
 
 ## Building

doc/user/installing-graalvm.md

@@ -44,7 +44,7 @@ After installing GraalVM you then need to install the Ruby language into it.
 This is done using the `gu` command. The Ruby package is the same for both
 editions of GraalVM and comes from GitHub.
 
-```
+```bash
 $ gu install ruby
 ```
 
@@ -67,7 +67,7 @@ To get the best performance you want to rebuild the images. Check that `ruby
 Rebuilding the executable images can take a few minutes and you should have
 about 8 GB of RAM available.
 
-```
+```bash
 $ gu rebuild-images ruby
 ```