Doc. Add a note on dependencies

Provide "Notes on dependencies".

diff --git a/README b/README
index eae7a4ed3cd543c5f55f4b8133154276e37f980f..9d8703864d1ef3ec2f8e0600e26a932428dd6e08 100644 (file)
--- a/README
+++ b/README
@@ -11,6 +11,8 @@ priority in percentages per item in the list.
 
 Read more in [Notes on statistics in Rust](doc/stats.md) on the
 details of implementation.
+Also read [Notes on
+dependencies](doc/dependencies.md) for an essay on Rust.
 
 
 Installation

diff --git a/doc/dependencies.md b/doc/dependencies.md
new file mode 100644 (file)
index 0000000..00c7adf
--- /dev/null
+++ b/doc/dependencies.md
@@ -0,0 +1,30 @@
+---
+title: Notes on dependencies
+author: Gustav Eek
+date: 24 jan 2023
+---
+
+<!--
+Copyright (C) 2023 Gustav Eek <gustav.eek@fripost.org>
+SPDX-License-Identifier: GPL-3.0-or-later
+-->
+
+This software is only verified to compile with the nightly unstable
+versions of Rust. Also, though the immediate list is short,
+dependencies stretch. My apologies.
+
+I regret that the general Rust configuration is immature. It is
+careless from a community perspective not to put more effort into
+ensuring that versions distributed through e.g. Debian work in the
+majority of cases.
+
+Rustup will be needed, and late versions of Rustc and Cargo. Carefully
+craft *CARGO_HOME* and *RUSTUP_HOME*, so that Cargo and Rustup
+packages end up in a place that is not backed up frequently. I use
+*~/.local*. Also note that *PATH* needs prependinng to override system
+wide rust.
+
+The immediate dependencies for this package (see Cargo config) is
+short. The secondary tree is however quite at the length. The *statrs*
+crate drags along yet another 26 crates. Again my apologies on ther
+part. This is another sign of the immaturity of the echo system.