From 520eae5622e2234e4f24b3e33ca1d053839a3f29 Mon Sep 17 00:00:00 2001
From: "Mark A. Grondona" <mark.grondona@gmail.com>
Date: Thu, 27 Feb 2025 16:22:41 -0800
Subject: [PATCH] doc: document `-F, --find` option in flux-hostlist(1)

Problem: The `-F, --find=HOSTS` option for flux-hostlist is not
documented.

Document it in flux-hostlist(1).
---
 doc/man1/flux-hostlist.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/doc/man1/flux-hostlist.rst b/doc/man1/flux-hostlist.rst
index 29a5dfe78c4a..5d383cf7b2b2 100644
--- a/doc/man1/flux-hostlist.rst
+++ b/doc/man1/flux-hostlist.rst
@@ -70,6 +70,12 @@ OPTIONS
   '0-1' will return the first and second, '-1' returns the last host).  The
   command will fail if any id in *IDS* is not a valid index.
 
+.. option:: -F, --find=HOSTS
+
+  Output a list of space-separated indices of *HOSTS* in the result hostlist,
+  where *HOSTS* should be one or more hosts in hostlist form. The command
+  will fail if any host in *HOSTS* is not found.
+
 .. option:: -L, --limit=N
 
   Output at most *N* hosts (*-N* to output the last *N* hosts).