doc: rewrite OpenBSD build guide for CMake and Qt6

- Replace legacy build instructions with the modern CMake workflow.
- Add specific `pkg_add` dependency lists for both Headless and GUI builds.
- specific instructions for enabling Qt6 and XFCE integration.
- Include necessary system configuration steps (doas/sudo, wheel group, and messagebus).

Author: jamescowens

doc/build-openbsd.md

@@ -1,99 +1,103 @@
 # OpenBSD build guide
 
-The guide below was for autotools and is outdated and deprecated. Folks using OpenBSD may be able to use this and adapt the cmake build procedure in the main build doc, [build.md](build.md) for the Linux Native build target. The Gridcoin Team encourages anyone getting a modern OpenBSD (7.8, for example) to work with Gridcoin to submit an issue on Github documenting what you did to get it to work, or if you are familiar with pull request creation, a PR with changes to this file with the correct procedure that works.
+This guide details how to build Gridcoin on OpenBSD. While this is not checked in CI/CD, it has been verified to work as of the 5.5.0.0 release.
 
-===================
+## 1. Install Dependencies
 
-## Deprecated Guide
+Run the following commands as root (or using `doas`) to install the necessary build tools and libraries.
 
-(updated for OpenBSD 7.0)
+```ksh
+# Basic build requirements and libraries
+pkg_add git cmake boost curl libzip miniupnpc
 
-This guide describes how to build gridcoinresearchd, command-line utilities, and GUI on OpenBSD.
+# If you prefer sudo over the native doas (optional)
+pkg_add sudo
+````
 
-Preparation
------------
+### Note on Sudo vs. Doas
 
-Run the following as root to install the base dependencies for building:
+OpenBSD uses `doas` by default. If you prefer `sudo`:
 
-```bash
-pkg_add cmake vim
-# or
-pkg_add autoconf automake gmake libtool python
+1.  Ensure your user is in the `wheel` group:
+    ```ksh
+    # Replace 'jco' with your username
+    usermod -G wheel jco
+    ```
+2.  Edit the sudoers file using `visudo` and find the line:
+    `## Uncomment to allow members of group wheel to execute any command`
 
-pkg_add boost curl libzip leveldb pkgconf
-pkg_add qt5 libqrencode  # optional for the GUI
-```
+    Uncomment the following line, which should be similar to
+    `%wheel ALL=(ALL) ALL`
 
-Resource limits
----------------
+    and save the file with `:wq!`
 
-If the build runs into out-of-memory errors, the instructions in this section
-might help.
+## 2\. Clone the Repository
 
-The standard ulimit restrictions in OpenBSD are very strict:
+```ksh
+git clone [https://github.com/gridcoin-community/Gridcoin-Research.git](https://github.com/gridcoin-community/Gridcoin-Research.git)
+cd Gridcoin-Research
+git checkout master
+```
 
-    data(kbytes)         1572864
+-----
 
-This is, unfortunately, in some cases not enough to compile some `.cpp` files in the project,
-(see [Bitcoin#6658](https://github.com/bitcoin/bitcoin/issues/6658)).
-If your user is in the `staff` group the limit can be raised with:
+## 3\. Build Configuration
 
-    ulimit -d 3000000
+Choose **Option A** (Headless/Daemon) or **Option B** (GUI Wallet).
 
-The change will only affect the current shell and processes spawned by it. To
-make the change system-wide, change `datasize-cur` and `datasize-max` in
-`/etc/login.conf`, and reboot.
+### Option A: Headless (Daemon only)
 
-### Building Gridcoin
+Use this configuration for servers or command-line only environments.
 
-**Important**: use `gmake`, not `make`. The non-GNU `make` will exit with a horrible error.
+```ksh
+# Configure
+cmake -B build -DENABLE_GUI=off -DENABLE_TESTS=on -DCMAKE_BUILD_TYPE=RelWithDebInfo -DENABLE_PIE=on -DENABLE_UPNP=on
 
-To configure with gridcoinresearchd:
+# Build
+# Replace <# of cpus> with your core count, e.g., -j4
+cmake --build build -j <# of cpus>
 
-* With CMake:
+# Install (Optional)
+doas cmake --install build
+```
 
-  ```bash
-  mkdir build && cd build
-  cmake ..
-  ```
+### Option B: GUI Wallet (Qt6)
 
-* With Autotools:
+Use this configuration for a desktop environment.
 
-  ```bash
-  ./autogen.sh
-  ./configure --with-gui=no \
-  	MAKE=gmake
-  ```
+**Additional GUI Dependencies:**
 
-To configure with GUI:
+```ksh
+# Qt6 framework
+pkg_add qt6
 
-* With CMake:
+# Desktop Environment extras (Optional - for a full XFCE experience)
+pkg_add xfce xfce-extras
 
-  ```bash
-  mkdir build && cd build
-  cmake -DENABLE_GUI=ON
-  ```
+# VMware helper (Optional - install only if running OpenBSD in a VMware VM)
+pkg_add vmwh
+```
 
-* With Autotools:
+**System Services:**
+Qt6 and modern GUI applications require the message bus (dbus) to be running.
 
-  ```bash
-  ./autogen.sh
-  ./configure --with-gui=yes \
-  	MAKE=gmake
-  ```
+```ksh
+rcctl enable messagebus
+rcctl start messagebus
+```
 
-Build and run the tests:
+**Build & Install:**
 
-* With CMake:
+```ksh
+# Configure
+# Note: Remove -DENABLE_QRENCODE=on if you do not have qrencode installed
+cmake -B build -DENABLE_GUI=on -DENABLE_TESTS=on -DCMAKE_BUILD_TYPE=RelWithDebInfo -DUSE_QT6=on -DENABLE_PIE=on -DENABLE_QRENCODE=on -DENABLE_UPNP=on
 
-  ```bash
-  cmake --build .  # use "-j N" here for N parallel jobs
-  ctest .
-  ```
+# Build
+cmake --build build -j <# of cpus>
 
-* With Autotools:
+# Install (Optional)
+# This will install binaries and assets (icons, desktop files)
+doas cmake --install build
+```
 
-  ```bash
-  gmake  # use "-j N" here for N parallel jobs
-  gmake check
-  ```

doc/build.md

@@ -14,7 +14,7 @@ for various build targets:
 | **macOS** | CMake | **Stable** | [build-macos.md](build-macos.md) |
 | **MSYS2** | CMake | *Deprecated* | [build-msys2.md](build-msys2.md) |
 | **FreeBSD** | CMake | *Experimental* | [build-freebsd.md](build-freebsd.md) |
-| **OpenBSD** | CMake | *Experimental* | [build-openbsd.md](build-openbsd.md) |
+| **OpenBSD** | CMake | **Stable but not checked in CI/CD** | [build-openbsd.md](build-openbsd.md) |
 
 This document covers these build targets: