docs: Update build instructions

Author: CyberTailor

README.md

@@ -11,18 +11,28 @@ Building Gridcoin
 
 These dependencies are required:
 
- Library     | Purpose          | Description
- ------------|------------------|----------------------------------------------------------------
- pkg-config  | Build            | Learn library inter-dependencies
- libssl      | Crypto           | Random Number Generation, Elliptic Curve Cryptography
- libboost    | Utility          | Library for threading, data structures, etc
- libevent    | Networking       | OS independent asynchronous networking
- miniupnpc   | UPnP Support     | Firewall-jumping support
- qt          | GUI              | GUI toolkit (only needed when GUI enabled)
- libqrencode | QR codes in GUI  | Optional for generating QR codes (only needed when GUI enabled)
-
-To build, run
-```./autogen.sh && ./configure && make```.
+ Library      | Purpose          | Description
+ -------------|------------------|----------------------------------------------------------------
+ cmake        | Build            | Build system (optional)
+ pkgconf      | Build            | Learn library inter-dependencies
+ openssl      | Crypto           | Random Number Generation, Elliptic Curve Cryptography
+ libboost     | Utility          | Library for threading, data structures, etc
+ libcurl      | Utility          | URL client library
+ libzip       | Utility          | Library for manipulating zip archives
+ miniupnpc    | UPnP Support     | Firewall-jumping support (optional)
+ qt5          | GUI              | GUI toolkit (optional)
+ libqrencode  | QR codes in GUI  | Library for encoding data in a QR Code symbol (optional, depends on GUI)
+
+To build, run:
+
+* With CMake:
+
+  `mkdir build && cmake build && cmake .. && cmake --build .`
+
+* With Autotools:
+
+  `./autogen.sh && ./configure && make`
+
 For more detailed and platform-specific instructions, see [the doc folder.](doc/)
 
 Development process
@@ -71,7 +81,7 @@ master if the staging branch is busy.
 Community
 =========
 
-For general questions, please visit our Discord server at https://discord.gg/jf9XX4a, or Freenode IRC in #gridcoin-help. We also have a Slack channel at [teamgridcoin.slack.com](https://join.slack.com/t/teamgridcoin/shared_invite/zt-3s81akww-GHt~_KvtxfhxUgi3yW3~Bg).
+For general questions, please visit our Discord server at https://discord.gg/jf9XX4a, or Libera Chat in #gridcoin-help. We also have a Slack channel at [teamgridcoin.slack.com](https://join.slack.com/t/teamgridcoin/shared_invite/zt-3s81akww-GHt~_KvtxfhxUgi3yW3~Bg).
 
 License
 -------

doc/README.md

@@ -2,7 +2,7 @@ Gridcoin
 =============
 
 Setup
----------------------
+-----
 Gridcoin is a free open source project derived from Bitcoin, with
 the goal of providing a long-term energy-efficient cryptocurrency, rewarding BOINC work.
 Built on the foundation of Bitcoin, PPCoin and NovaCoin, innovations such as proof-of-stake
@@ -16,16 +16,18 @@ To download Gridcoin, visit [gridcoin.us](https://gridcoin.us).
 for help and more information.
 * A lot of features core features are based on Bitcoin and have been documented on the [Bitcoin Wiki](https://en.bitcoin.it/wiki/Main_Page)
 * For general questions, please visit our Discord server at https://discord.gg/jf9XX4a
-* Ask for help or discuss on [#gridcoin](https://webchat.freenode.net?channels=gridcoin) on Freenode
-* You can also join us on [Slack](https://join.slack.com/t/teamgridcoin/shared_invite/enQtMjk2NTI4MzAwMzg0LTE4N2I3ZWZjYWJlZGM1Zjg3MTUyMDhiN2M5NmRmZTA2NDA0ZmY1ZTFmOGM3ZGU2YTBkOTdhNTk2ZjkzMGZkODY/)```
+* Ask for help or discuss on [#gridcoin](https://web.libera.chat/?channels=#gridcoin) on Libera Chat
+* You can also join us on [Slack](https://join.slack.com/t/teamgridcoin/shared_invite/enQtMjk2NTI4MzAwMzg0LTE4N2I3ZWZjYWJlZGM1Zjg3MTUyMDhiN2M5NmRmZTA2NDA0ZmY1ZTFmOGM3ZGU2YTBkOTdhNTk2ZjkzMGZkODY/)
 
 Building
----------------------
+--------
 The following are developer notes on how to build Gridcoin on your native platform. They are not complete guides, but include notes on the necessary libraries, compile flags, etc.
 
+- [CMake Build Options](cmake-options.md)
 - [OS X Build Notes](build-macos.md)
 - [Unix Build Notes](build-unix.md)
 - [Windows Build Notes](build-windows.md)
+- [FreeBSD Build Notes](build-freebsd.md)
 - [OpenBSD Build Notes](build-openbsd.md)
 
 Running
@@ -35,15 +37,14 @@ To create a secure environment for running Gridcoin see:
 - [Running Gridcoin](running.md)
 
 Development
----------------------
+-----------
 The Gridcoin repo's [root README](/README.md) contains relevant information on the development process and automated testing.
 
 - [Developer Notes](coding.txt)
 - [Release Process](release-process.md)
-- [Travis CI](travis-ci.md)
 
 License
----------------------
+-------
 Distributed under the [MIT software license](/COPYING). 
 This product includes software developed by the OpenSSL Project for use in the [OpenSSL Toolkit](https://www.openssl.org/). This product includes
 cryptographic software written by Eric Young ([[email protected]](mailto:[email protected])), and UPnP software written by Thomas Bernard. 

doc/build-freebsd.md

@@ -9,25 +9,41 @@ Preparing the Build
 --------------------
 
 Install the required dependencies the usual way you [install software on FreeBSD](https://www.freebsd.org/doc/en/books/handbook/ports.html) - either with `pkg` or via the Ports collection. The example commands below use `pkg` which is usually run as `root` or via `sudo`. If you want to use `sudo`, and you haven't set it up: [use this guide](http://www.freebsdwiki.net/index.php/Sudo%2C_configuring) to setup `sudo` access on FreeBSD.
+
 #### General Dependencies
+
 ```bash
-pkg install autoconf automake boost-libs git gmake libevent libtool pkgconf openssl libzip
+pkg install cmake
+# or
+pkg install autoconf automake gmake libtool
 
+pkg install boost-libs curl db5 leveldb libzip openssl pkgconf secp256k1
 ```
+
 ---
 #### GUI Dependencies
+
 ```bash
 pkg install qt5 libqrencode
 ```
 
 ---
 #### Test Suite Dependencies
+
 There is an included test suite that is useful for testing code changes when developing.
-To run the test suite (recommended), you will need to have Python 3 installed:
+To run the test suite (recommended), you will need to have the following packages installed:
 
-```bash
-pkg install python3
-```
+* With CMake:
+
+  ```bash
+  pkg install vim
+  ```
+
+* With Autotools:
+
+  ```bash
+  pkg install python3
+  ```
 
 Clone the repository and cd into it:
 
@@ -42,19 +58,52 @@ To Build
 ### 1. Configuration
 
 There are many ways to configure Gridcoin, here are a few common examples:
+
 ##### Wallet Support, No GUI:
-This explicitly enables wallet support and disables the GUI.
-```bash
-./autogen.sh
-./configure --with-gui=no \
-    MAKE=gmake
-```
+This configuration does not enable the GUI.
 
+* With CMake:
+
+  ```bash
+  mkdir build && cd build
+  cmake ..
+  ```
+
+* With Autotools:
+
+  ```bash
+  ./autogen.sh
+  ./configure --with-gui=no \
+  	MAKE=gmake
+  ```
 
 ### 2. Compile
-**Important**: Use `gmake` (the non-GNU `make` will exit with an error).
 
-```bash
-gmake # use "-j N" for N parallel jobs
-gmake check # Run tests if Python 3 is available
-```
+* With CMake:
+
+  ```bash
+  cmake --build . # use "-j N" for N parallel jobs
+  ctest . # Run tests
+  ```
+
+* With Autotools:
+
+  ```bash
+  gmake # use "-j N" for N parallel jobs
+  ```
+
+### 3. Test
+
+* With CMake:
+
+  ```bash
+  cmake .. -DENABLE_TESTS=ON
+  cmake --build .
+  ctest .
+  ```
+
+* With Autotools:
+
+  ```bash
+  gmake check
+  ```

doc/build-macos.md

@@ -14,6 +14,7 @@ macOS comes with a built-in Terminal located in:
 /Applications/Utilities/Terminal.app
 ```
 ### 1. Xcode Command Line Tools
+
 The Xcode Command Line Tools are a collection of build tools for macOS.
 These tools must be installed in order to build Gridcoin from source.
 
@@ -27,6 +28,7 @@ Upon running the command, you should see a popup appear.
 Click on `Install` to continue the installation process.
 
 ### 2. Homebrew Package Manager
+
 Homebrew is a package manager for macOS that allows one to install packages from the command line easily.
 While several package managers are available for macOS, this guide will focus on Homebrew as it is the most popular.
 Since the examples in this guide which walk through the installation of a package will use Homebrew, it is recommended that you install it to follow along.
@@ -35,13 +37,19 @@ Otherwise, you can adapt the commands to your package manager of choice.
 To install the Homebrew package manager, see: https://brew.sh
 
 Note: If you run into issues while installing Homebrew or pulling packages, refer to [Homebrew's troubleshooting page](https://docs.brew.sh/Troubleshooting).
+
 ### 3. Install Required Dependencies
+
 The first step is to download the required dependencies.
 These dependencies represent the packages required to get a barebones installation up and running.
 To install, run the following from your terminal:
 
 ```shell
-brew install automake libtool boost openssl pkg-config libzip berkeley-db@4
+brew install cmake
+# or
+brew install automake libtool
+
+brew install berkeley-db@5 boost curl leveldb libzip openssl pkgconf secp256k1
 ```
 
 ### 4. Clone Gridcoin repository
@@ -107,11 +115,19 @@ brew install miniupnpc
 #### Test Suite Dependencies
 
 There is an included test suite that is useful for testing code changes when developing.
-To run the test suite (recommended), you will need to have Python 3 installed:
+To run the test suite (recommended), you will need to have the following packages installed:
 
-``` bash
-brew install python
-```
+* With CMake:
+
+  ```bash
+  brew install vim
+  ```
+
+* With Autotools:
+
+  ```bash
+  brew install python
+  ```
 
 ---
 
@@ -132,32 +148,57 @@ pip3 install ds_store mac_alias
 
 ## Build Gridcoin
 
-1.  Build Gridcoin:
-
-    Prepare the assembly code (requires Perl):
-    ```shell
-    cd src/
-    ../contrib/nomacro.pl
-    cd ..
-    ```
-
-    Configure and build the headless Gridcoin binaries as well as the GUI (if Qt is found).
-    ```shell
-    ./autogen.sh
-    ./configure
-    make
-    ```
-    You can disable the GUI build by passing `--without-gui` to configure.
-
-2.  It is recommended to build and run the unit tests:
-    ```shell
-    make check
-    ```
-
-3.  You can also create a  `.dmg` that contains the `.app` bundle (optional):
-    ```shell
-    make deploy
-    ```
+1. Prepare the assembly code (requires Perl):
+
+   ```shell
+   pushd src
+   ../contrib/nomacro.pl
+   popd
+   ```
+
+2. Configure and build the Gridcoin binaries:
+
+   You can enable the GUI build by passing `-DENABLE_GUI=ON` to CMake or
+   `--with-gui=qt5` to the configure script.
+
+   * With CMake:
+
+     ```shell
+     mkdir build && cd build
+     cmake ..
+     cmake --build .
+     ```
+   * With Autotools:
+
+     ```shell
+     ./autogen.sh
+     ./configure
+     make
+     ```
+
+3. It is recommended to build and run the unit tests:
+
+   * With CMake:
+
+     ```shell
+     cmake .. -DENABLE_TESTS=ON
+     cmake --build .
+     ctest .
+     ```
+
+   * With Autotools:
+
+     ```shell
+     make check
+     ```
+
+4. You can also create a  `.dmg` that contains the `.app` bundle (optional):
+
+   * With Autotools:
+
+     ```shell
+     make deploy
+     ```
 
 ## Running