diff --git a/doc/pages/commands.asciidoc b/doc/pages/commands.asciidoc
index fda6d223..f21eba1f 100644
--- a/doc/pages/commands.asciidoc
+++ b/doc/pages/commands.asciidoc
@@ -441,6 +441,15 @@ New commands can be defined using the *define-command* command:
         the command accepts a *num* parameter, which can be either a number,
         or of the form <min>..<max>, with both <min> and <max> omittable
 
+    *-override*:::
+        allow the new command to replace an existing one with the same name
+
+    *-hidden*:::
+        do not show the command in command name completions
+
+    *-docstring*:::
+        define the documentation string for the command
+
     *-file-completion*:::
         try file completion on any parameter passed to this command
 
@@ -484,15 +493,6 @@ New commands can be defined using the *define-command* command:
             - *kak_token_to_complete*::::
                 Index of the token being completed in the command line.
 
-    *-override*:::
-        allow the new command to replace an existing one with the same name
-
-    *-hidden*:::
-        do not show the command in command name completions
-
-    *-docstring*:::
-        define the documentation string for the command
-
 Using shell expansion allows defining complex commands or accessing
 Kakoune's state: