From 8a8789abe145fe7acb5ab59aaa2e10b220e8fa1c Mon Sep 17 00:00:00 2001
From: Daniel Hilst <392820+dhilst@users.noreply.github.com>
Date: Thu, 13 Aug 2026 11:12:16 -0300
Subject: [PATCH] docs(build): add a Packages notes section (pyodbc
 distro-provided; conserver vs goconserver)

Move the pyodbc note under a dedicated 'Packages notes' section and add a note
that conserver is shipped for completeness/backward-compat only: core packages
depend on goconserver, so conserver is not pulled in as a dependency -- to use it
you must install it explicitly, then disable the goconserver service and enable
the conserver service.

Signed-off-by: Daniel Hilst <392820+dhilst@users.noreply.github.com>
---
 BUILD.md | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/BUILD.md b/BUILD.md
index 94f52c7..f6f082e 100644
--- a/BUILD.md
+++ b/BUILD.md
@@ -67,10 +67,6 @@ built for — every target, because some deployments still use it. The lists wer
 (EL, arch), `dnf install xCAT` from xcat.org latest, and the packages whose `from_repo=xcat-dep`
 are exactly the required set. See the file header for details.
 
-`pyodbc` is intentionally **not** built or listed in any target's manifest: modern EL provides
-`python3-pyodbc` from appstream/EPEL, so xcat-dep no longer ships its own. The legacy `pyodbc/`
-directory (an old `pyodbc-3.0.7` RPM spec) is kept for historical reference only.
-
 Build failures are **not tolerated**: any required (manifest) package that fails to build fails
 the whole run.
 
@@ -86,6 +82,16 @@ the whole run.
 8. Tarball creation for both repo trees
 9. Summary generation (`summary.txt`)
 
+# Packages notes
+
+- **`pyodbc`** is intentionally not built or listed in any target's manifest: modern EL provides
+  `python3-pyodbc` from appstream/EPEL, so xcat-dep no longer ships its own. The legacy `pyodbc/`
+  directory (an old `pyodbc-3.0.7` RPM spec) is kept for historical reference only.
+- **`conserver`** was replaced by `goconserver` but is provided for completeness and backward
+  compatibility. Core packages depend on `goconserver`; to use `conserver` you must install it
+  explicitly (it is **not** pulled in as a dependency), disable the `goconserver` service and enable
+  the `conserver` service.
+
 # Skip and Control Flags
 
 Use these flags to skip specific operations: