manpage: document hook API

This shouldn't exist and for the most part is meant to be used by the
ytdl Lua script, but let's document it anyway. Since the Lua API handles
all the details, it's considered much more "stable" than the raw API,
which is why the raw API wasn't documented.

1 files changed, 3 insertions, 14 deletions

diff --git a/DOCS/man/lua.rst b/DOCS/man/lua.rst
index 347292cd7b..7cdc29e4ab 100644
--- a/DOCS/man/lua.rst
+++ b/DOCS/man/lua.rst
@@ -745,17 +745,6 @@ guarantee a stable interface.
     recommended as neutral default value. ``fn`` is the function that will be
     called during execution of the hook.
 
-    Currently existing hooks:
-
-    ``on_load``
-        Called when a file is to be opened, before anything is actually done.
-        For example, you could read and write the ``stream-open-filename``
-        property to redirect an URL to something else (consider support for
-        streaming sites which rarely give the user a direct media URL), or
-        you could set per-file options with by setting the property
-        ``file-local-options/<option name>``. The player will wait until all
-        hooks are run.
-
-    ``on_unload``
-        Run before closing a file, and before actually uninitializing
-        everything. It's not possible to resume playback in this state.
+    See `Hooks`_ for currently existing hooks and what they do - only the hook
+    list is interesting; handling hook execution is done by the Lua script
+    function automatically.