1 files changed, 21 insertions, 0 deletions
diff --git a/bpkg/pkg-build.cli b/bpkg/pkg-build.cli
index 0ac8dcb..d4a8841 100644
--- a/bpkg/pkg-build.cli
+++ b/bpkg/pkg-build.cli
@@ -296,4 +296,25 @@ namespace bpkg
        option in \l{bpkg-rep-fetch(1)} for details."
     }
   };
+
+  "
+   \h|DEFAULT OPTIONS FILES|
+
+   See \l{bpkg-default-options-files(1)} for an overview of the default
+   options files. For the \cb{pkg-build} command the search start
+   directory is the configuration directory. The following options files are
+   searched for in each directory and, if found, loaded in the order listed:
+
+   \
+   bpkg.options
+   bpkg-pkg-build.options
+   \
+
+   The following \cb{pkg-build} command options cannot be specified in the
+   default options files:
+
+   \
+   --directory|-d
+   \
+  "
 }