help: improve view and list commands

bebop/help.py

@@ -1,40 +1,49 @@
 """Help page. Currently only keybinds are shown as help."""
 
 HELP_PAGE = """\
-# Bebop keybinds
+# Help
+
+## Keybinds
 
 Keybinds using the SHIFT key are written uppercase. Keybinds using the ALT (or \
 META) key are written using the "M-" prefix. Symbol keys are written as their \
 name, not the symbol itself.
 
-``` list of bebop keybinds
-- colon: focus the command-line
-- r: reload page
-- h: scroll left a bit
-- j: scroll down a bit
-- k: scroll up a bit
-- l: scroll right a bit
-- H: scroll left a whole page
-- J: scroll down a whole page
-- K: scroll up a whole page
-- L: scroll right a whole page
-- M-h: scroll one column left
-- M-j: scroll one line down
-- M-k: scroll one line up
-- M-l: scroll one column right
-- circumflex: horizontally scroll back to the first column
-- gg: go to the top of the page
-- G: go to the bottom of the page
-- o: open an URL
-- O: open last download with an external command
-- p: go to the previous page
-- u: go to the parent page (up a level in URL)
-- U: go to the root page (root URL for the current domain)
-- b: open bookmarks
-- B: add current page to bookmarks
-- e: open the current page source in an editor
-- y: open history
-- digits: go to the corresponding link ID
-- escape: reset status line text
-```
+* colon: focus the command-line
+* r: reload page
+* h: scroll left a bit
+* j: scroll down a bit
+* k: scroll up a bit
+* l: scroll right a bit
+* H: scroll left a whole page
+* J: scroll down a whole page
+* K: scroll up a whole page
+* L: scroll right a whole page
+* M-h: scroll one column left
+* M-j: scroll one line down
+* M-k: scroll one line up
+* M-l: scroll one column right
+* circumflex: horizontally scroll back to the first column
+* gg: go to the top of the page
+* G: go to the bottom of the page
+* o: open an URL
+* O: open last download with an external command
+* p: go to the previous page
+* u: go to the parent page (up a level in URL)
+* U: go to the root page (root URL for the current domain)
+* b: open bookmarks
+* B: add current page to bookmarks
+* e: open the current page source in an editor
+* y: open history
+* digits: go to the corresponding link ID
+* escape: reset status line text
+
+## Commands
+
+Commands are mostly for actions requiring user input. You can type a command \
+with arguments by pressing the corresponding keybind above.
+
+* o/open <url>: open this URL
+* forget_certificate <hostname>: remove saved fingerprint for the hostname
+* q/quit: well, quit
 """

bebop/history.py

@@ -54,4 +54,4 @@ class History:
                 continue
             urls.append(url)
             seen.add(url)
-        return "\n".join("=> " + url for url in urls)
+        return "# History\n\n" + "\n".join("=> " + url for url in urls)