[nongnu] elpa/hyperdrive 0eaecc0748 2/7: Docs: Document completion category

[ELPA Syncer]

branch: elpa/hyperdrive
commit 0eaecc0748190a64f88b60fa98c02e3bbbb734a1
Author: Joseph Turner <joseph@ushin.org>
Commit: Joseph Turner <joseph@ushin.org>

    Docs: Document completion category
---
 doc/hyperdrive.org  | 16 ++++++++++++++++
 doc/hyperdrive.texi | 35 +++++++++++++++++++++++++++++++++++
 2 files changed, 51 insertions(+)

diff --git a/doc/hyperdrive.org b/doc/hyperdrive.org
index 517354cf52..1c453a0e01 100644
--- a/doc/hyperdrive.org
+++ b/doc/hyperdrive.org
@@ -870,6 +870,22 @@ DIRECTION being one of ~:ascending~ or ~:descending~.
   version. To have separate buffers for each version of a
   file/directory, use ~same-version~.
 
+** Additional customization
+
+This section mentions ways to change the behavior of ~hyperdrive.el~
+besides its own customization options.
+
+*** Completion styles and cycling
+#+vindex: completion-category-overrides
+#+findex: hyperdrive-complete-hyperdrive
+#+findex: completing-read
+
+~hyperdrive-complete-hyperdrive~ offers a ~completing-read~ interface for
+selecting a hyperdrive from a list of known hyperdrive.  You can
+customize the completion styles and cycling behavior of
+~hyperdrive-complete-hyperdrive~ by customizing the ~hyperdrive~ category
+in ~completion-category-overrides~.
+
 * Known limitations
 
 ** No empty directories
diff --git a/doc/hyperdrive.texi b/doc/hyperdrive.texi
index 56d711149a..afc41d4c67 100644
--- a/doc/hyperdrive.texi
+++ b/doc/hyperdrive.texi
@@ -142,6 +142,14 @@ Naming
 * Seeds::
 * DNS domains::
 
+Customization
+
+* Additional customization::
+
+Additional customization
+
+* Completion styles and cycling::
+
 Known limitations
 
 * No empty directories::
@@ -1315,6 +1323,33 @@ version. To have separate buffers for each version of a
 file/directory, use @code{same-version}.
 @end table
 
+@menu
+* Additional customization::
+@end menu
+
+@node Additional customization
+@section Additional customization
+
+This section mentions ways to change the behavior of @code{hyperdrive.el}
+besides its own customization options.
+
+@menu
+* Completion styles and cycling::
+@end menu
+
+@node Completion styles and cycling
+@subsection Completion styles and cycling
+
+@vindex completion-category-overrides
+@findex hyperdrive-complete-hyperdrive
+@findex completing-read
+
+@code{hyperdrive-complete-hyperdrive} offers a @code{completing-read} 
interface for
+selecting a hyperdrive from a list of known hyperdrive.  You can
+customize the completion styles and cycling behavior of
+@code{hyperdrive-complete-hyperdrive} by customizing the @code{hyperdrive} 
category
+in @code{completion-category-overrides}.
+
 @node Known limitations
 @chapter Known limitations