From ab9f5515b5fe136bcdc419bd871714acde4743f6 Mon Sep 17 00:00:00 2001
From: Sebastian Ramacher <sebastian+dev@ramacher.at>
Date: Sat, 22 Feb 2014 22:18:17 +0100
Subject: [PATCH] Start documenting shortcut functions in more detail

Signed-off-by: Sebastian Ramacher <sebastian+dev@ramacher.at>
---
 zathurarc.5.rst | 120 +++++++++++++++++++++++++++++++++++++-----------
 1 file changed, 94 insertions(+), 26 deletions(-)

diff --git a/zathurarc.5.rst b/zathurarc.5.rst
index 5d44a48..c73cf19 100644
--- a/zathurarc.5.rst
+++ b/zathurarc.5.rst
@@ -206,35 +206,103 @@ Shortcut functions
 ^^^^^^^^^^^^^^^^^^
 The following shortcut functions can be mapped:
 
+* ``abort``
 
-::
+  Switch back to normal mode.
 
-    Function          Description
+* ``adjust_window``
 
-    abort             Switch back to normal mode
-    adjust_window     Adjust page width
-    change_mode       Change current mode
-    display_link      Display link target
-    focus_inputbar    Focus inputbar
-    follow            Follow a link
-    goto              Go to a certain page
-    jumplist          Move forwards/backwards in the jumplist
-    navigate          Navigate to the next/previous page
-    navigate_index    Navigate through the index
-    print             Show the print dialog
-    quit              Quit zathura
-    recolor           Recolor the pages
-    reload            Reload the document
-    rotate            Rotate the page
-    scroll            Scroll
-    search            Search next/previous item
-    set               Set an option
-    toggle_fullscreen Toggle fullscreen
-    toggle_index      Show or hide index
-    toggle_inputbar   Show or hide inputbar
-    toggle_page_mode  Toggle between one and multiple pages per row
-    toggle_statusbar  Show or hide statusbar
-    zoom              Zoom in or out
+  Adjust page width. Possible arguments are ``best-fit`` and ``width``.
+
+* ``change_mode``
+
+  Change current mode. Pass the desired mode as argument.
+
+* ``display_link``:
+
+  Display link target.
+
+* ``focus_inputbar``
+
+  Focus inputbar.
+
+* ``follow``
+
+  Follow a link.
+
+* ``goto``
+
+  Go to a certain page.
+
+* ``jumplist``
+
+  Move forwards/backwards in the jumplist.
+
+* ``navigate``
+
+  Navigate to the next/previous page.
+
+* ``navigate_index``
+
+  Navigate through the index.
+
+* ``print``
+
+  Show the print dialog.
+
+* ``quit``
+
+  Quit zathura.
+
+* ``recolor``
+
+  Recolor pages.
+
+* ``reload``
+
+  Reload the document.
+
+* ``rotate``
+
+  Rotate the page. Pass ``rotate-ccw`` as argument for counterclockwise rotation
+  and ``rotate-cw`` for clockwise rotation.
+
+* ``scroll``
+
+  Scroll.
+
+* ``search``
+
+  Search next/previous item. Pass ``forward`` as argument to search for the next
+  hit and ``backward`` to search for the previous hit.
+
+* ``set``
+
+  Set an option.
+
+* ``toggle_fullscreen``
+
+  Toggle fullscreen.
+
+* ``toggle_index``
+
+  Show or hide index.
+
+* ``toggle_inputbar``
+
+  Show or hide inputbar.
+
+* ``toggle_page_mode``
+
+  Toggle between one and multiple pages per row.
+
+* ``toggle_statusbar``
+
+  Show or hide statusbar.
+
+* ``zoom``
+
+  Zoom in or out.
 
 Pass arguments
 ^^^^^^^^^^^^^^