summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLars Wirzenius <liw@liw.fi>2022-03-29 17:15:01 +0300
committerLars Wirzenius <liw@liw.fi>2022-03-29 17:15:01 +0300
commitde120055406921cf2ff36b51342b03e8ec67d576 (patch)
tree8a63c6235bf5344b353a7318b61a7947d50414ab
parent48d29188dcb9ded11bb373891233ac675b322d54 (diff)
downloadsubplot-de120055406921cf2ff36b51342b03e8ec67d576.tar.gz
docs: document need for rustfmt, have ./check look for it
Sponsored-by: author
-rw-r--r--README.md20
-rwxr-xr-xcheck1
2 files changed, 16 insertions, 5 deletions
diff --git a/README.md b/README.md
index 2550850..f55d584 100644
--- a/README.md
+++ b/README.md
@@ -27,15 +27,25 @@ See <https://subplot.liw.fi/> for the home page.
## Hacking Subplot
Subplot is written using the Rust programming language, so the usual
-workflow for Rust applies. To build run `cargo build`, to run tests in
-Rust run `cargo test`. You probably need to install Rust using rustup:
-the version packaged in a Linux distribution is likely too old.
+workflow for Rust applies.
+
+* To build: `cargo build`
+* To run tests: `cargo test`
+* To format code: `cargo fmt`
+
+You probably need to install Rust using rustup: the version packaged
+in a Linux distribution is likely too old. When you install Rust,
+ensure you have the following installed:
+
+* `rustc`
+* `cargo`
+* `rustfmt`
To run the whole test suite, including testing all examples and
Subplot self tests, run `./check` at the root of the source tree.
-You'll need to install build dependencies installed. On a system
-running Debian or a derivative of it:
+You'll need to install some build dependencies. On a system running
+Debian or a derivative of it:
~~~sh
$ sudo apt-get install build-essential git debhelper dh-cargo python3 \
diff --git a/check b/check
index 2920d24..533ac50 100755
--- a/check
+++ b/check
@@ -343,6 +343,7 @@ def check_tooling(r):
"pdflatex",
"plantuml",
"rustc",
+ "rustfmt",
]
for command in commands:
if not r.got_command(command):