Merge #1361

1361: Update README.md r=intricate a=kevinhammond

Clarified build instructions

Co-authored-by: Kevin Hammond <[email protected]>

README.md

@@ -38,10 +38,19 @@ The latest supported networks can be found at https://hydra.iohk.io/job/Cardano/
 ## Cabal
 
 #### Dependencies:
-* libsodum
+
+You will need to install one or both of these libraries on your system:
+
+* libsodium
 * libsodium-dev
 
-For ease of use create a `cabal.project.local` at the toplevel with:
+For example, on Ubuntu:
+
+```
+   sudo apt install libsodium-dev
+```
+
+For ease of use, also create a `cabal.project.local` at the toplevel with:
 ```
 package cardano-crypto-praos
   flags: -external-libsodium-vrf
@@ -52,11 +61,16 @@ There are two choices for building `cardano-crypto-praos`, selected via a cabal
 2. `-external-libsodium-vrf` Which uses a bundled version of the VRF C code and uses the vanilla system `libsodium`
 The second option is currently only suitable for development -- but not deployment -- because it uses the libsodium C code in an unsupported configuration
 
-Use [Cabal - Version 3.0](https://www.haskell.org/cabal/) to build this project:
+Use [Cabal - Version 3.0](https://www.haskell.org/cabal/) to build this project, including the CLI interface to the node:
+
+```
+$ cabal build cardano-node cardano-cli
+```
+
+Install the `cardano-node` and `cardano-cli` commands using `cabal`.  Not that you may need to specify the installation directory using `--installdir`.
 
 ```
-$ cd cardano-node
-$ cabal build
+$ cabal install cardano-node cardano-cli
 ```
 
 ## Windows Executable
@@ -66,7 +80,7 @@ You can download [here](https://hydra.iohk.io/job/Cardano/cardano-node/cardano-n
 
 ### Instructions
 
-The download includes cardano-node.exe and a .dll. To run the node with cardano-node run you need to reference a few files and directories as arguments. These can be copied from the cardano-node repo into the executables directory. The command to run the node on mainnet looks like this:
+The download includes `cardano-node.exe` and a `.dll` file. To run the node with `cardano-node run`, you need to reference a few files and directories as arguments. These can be copied from the `cardano-node` repo into the executables directory. The command to run the node on mainnet looks like this:
 
 ```
 cardano-node.exe run --topology ./mainnet-topology.json --database-path ./state --port 3001 --config ./configuration-mainnet.yaml --socket-path \\.\pipe\cardano-node
@@ -150,6 +164,51 @@ environment-specific adjustment has been made, so we only mention `cardano-cli`.
 The subcommands are subdivided in groups, and their full list can be seen in the
 output of `cardano-cli --help`.
 
+```
+$ cardano-cli --help
+cardano-cli - utility to support a variety of key operations (genesis generation, migration, pretty-printing..) for different system generations.
+
+Usage: cardano-cli (Byron specific commands | Shelley specific commands | 
+                     Miscellaneous commands)
+
+Available options:
+  --version                Show the cardano-cli version
+  -h,--help                Show this help text
+
+Byron specific commands
+  byron                    Byron node operation commands
+  genesis                  Create genesis.
+  print-genesis-hash       Compute hash of a genesis file.
+  keygen                   Generate a signing key.
+  to-verification          Extract a verification key in its base64 form.
+  signing-key-public       Pretty-print a signing key's verification key (not a
+                           secret).
+  signing-key-address      Print address of a signing key.
+  migrate-delegate-key-from
+                           Migrate a delegate key from an older version.
+  issue-delegation-certificate
+                           Create a delegation certificate allowing the
+                           delegator to sign blocks on behalf of the issuer
+  check-delegation         Verify that a given certificate constitutes a valid
+                           delegation relationship between keys.
+  submit-tx                Submit a raw, signed transaction, in its on-wire
+                           representation.
+  issue-genesis-utxo-expenditure
+                           Write a file with a signed transaction, spending
+                           genesis UTxO.
+  issue-utxo-expenditure   Write a file with a signed transaction, spending
+                           normal UTxO.
+  get-tip                  Get the tip of your local node's blockchain
+  validate-cbor            Validate a CBOR blockchain object.
+  pretty-print-cbor        Pretty print a CBOR file.
+
+Shelley specific commands
+  shelley                  Shelley specific commands
+
+Miscellaneous commands
+  version                  Show the cardano-cli version
+```
+
 All subcommands have help available:
 
 ```