message: [docs] structure install guide
diff: -# Surelog Install instructions
  +# Surelog Install and Build Instructions
  Executable: `surelog`
  -# Development Environment Required
  +## Clone and Initialize Submodules
  -* Linux (Ubuntu or Centos)
  -
  -* Unlimit all limits, in your .cshrc or .bashrc put "ulimit -s"
  - that will enable gcc to compile the very large Antlr generated C++ files
  +```
  +git clone https://github.com/alainmarcel/Surelog.git
  +cd Surelog
  +git submodule update --init --recursive
  +```
  -* Please install the following package updates:
  +## Build Dependencies
  - * `sudo apt-get install build-essential cmake git pkg-config tclsh swig uuid-dev libgoogle-perftools-dev python3 python3-dev`
  +* cmake >= 3.13
  - * If you don't intend to change the grammar: `sudo apt-get install default-jre`
  +### Ubuntu/Debian
  - * If you do intend to change the grammar: `sudo apt-get install default-jdk ant`
  +`sudo apt-get install build-essential cmake git pkg-config tclsh swig uuid-dev libgoogle-perftools-dev python3 python3-dev default-jre`
  - * In a [nix environment](https://nixos.org) simply type `nix-shell` to set up the dependencies.
  +*Note:* If you intend to change the grammar, add: `sudo apt-get install ant`
  -* If you have a version of cmake before 3.13 on your system
  +*Note:* If you have a version of cmake before 3.13 on your system
  (check with `cmake --version`), you need get a version that is more current.
  On Debian-like systems (includes Ubuntu), that would be
  ```
  @@ -29,15 +30,33 @@ Executable: `surelog`
  sudo apt-get install -y cmake
  ```
  -* Download the Surelog source code
  +
  +### Nix Package Manager
  +
  +In a [nix environment](https://nixos.org) simply type `nix-shell` to set up the dependencies.
  +
  +
  +## Build Instructions
  +
  ```
  - git clone https://github.com/alainmarcel/Surelog.git
  - cd Surelog
  - git submodule update --init --recursive
  +make
  +```
  +
  +For debug builds:
  +```
  +make debug
  +```
  +
  +Installation:
  +```
  +make install
  +```
  +
  +The installation path may be set by specifying a `PREFIX`. The default is `/usr/local`.
  +For example:
  +```
  +make install PREFIX=~/.local
  ```
  -* Build
  - * `make`
  - * `make debug`
  - * make install (/usr/local/bin and /usr/local/lib/surelog by default, use PREFIX=<path> for alternative locations)
  +
  * or see [`src/README`](./src/README.md)
  