Document default options files for commands

1 files changed, 21 insertions, 0 deletions

diff --git a/bpkg/pkg-drop.cli b/bpkg/pkg-drop.cli
index 7002d57..298cafc 100644
--- a/bpkg/pkg-drop.cli
+++ b/bpkg/pkg-drop.cli
@@ -83,4 +83,25 @@ namespace bpkg
        <header> line (unless it is empty)."
     };
   };
+
+  "
+   \h|DEFAULT OPTIONS FILES|
+
+   See \l{bpkg-default-options-files(1)} for an overview of the default
+   options files. For the \cb{pkg-drop} 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-drop.options
+   \
+
+   The following \cb{pkg-drop} command options cannot be specified in the
+   default options files:
+
+   \
+   --directory|-d
+   \
+  "
 }