add work_dir and document keybinding

1 files changed, 320 insertions, 0 deletions

diff --git a/xxxterm.1 b/xxxterm.1
index a4cf46a..ada5610 100644
--- a/xxxterm.1
+++ b/xxxterm.1
@@ -114,6 +114,10 @@ to follow the link.
 provides many actions accessed via key or mouse bindings.
 Note that WebKit & GTK+ have their own set of key bindings
 that are not overruled and therefore are available as-is.
+.Pp
+Note: see the
+.Cm KEY MAPPINGS
+section for an exhaustive list of all changeable keyboard shortcuts.
 .Ss Search Commands
 These commands are used to search for text strings within a web page.
 .Pp
@@ -423,6 +427,13 @@ the session is opened.
 See the session command for additional details.
 .El
 .Sh WHITELISTS
+This section descibes advanced usage settings.
+Most users should use
+.Cm browser_mode
+instead to setup
+.Nm
+and skip over this section.
+.Pp
 .Nm
 has a number of whitelists to control blocking cookies and Java Script
 execution for FQDNs or domains.
@@ -709,6 +720,315 @@ user-agent string.
 Set the default height of the browser window.
 .It Cm window_width
 Set the default width of the browser window.
+.It Cm work_dir
+Set the work directory where all
+.Nm
+scratch files are stored.
+Default is
+.Cm ~/.xxxterm .
+.El
+.Sh KEY MAPPINGS
+Most keyboard shortcuts can be reprogrammed using a
+.Cm keybinding
+entry in the configuration file.
+The format of the keybinding entry is as follows
+keybinding = action,keystroke(s).
+For example, "keybinding = tabnew,C+t" where
+.Cm tabnew
+is the action and
+.Cm C+t
+are
+the keystrokes.
+The following notation is used for
+.Cm keystrokes :
+.Pp
+.Bl -tag -width Ds -offset indent -compact
+.It Cm C+
+Control
+.It Cm M1+
+Meta 1 (sometimes marked Alt)
+.It Cm M2+
+Meta 2
+.It Cm M3+
+Meta 3
+.It Cm M4+
+Meta 4 (sometimes marked Windows)
+.It Cm M5+
+Meta 2
+.It Cm S+
+Shift
+.El
+.Pp
+Shift should be used sparingly since it gets in the way of non-USA keyboards.
+.Pp
+.Bl -tag -width "scrollfarright" -compact
+.It Cm clearall
+The
+.Cm clearall
+key word is special and is meant to reset the key binding list to the GTK+
+and WebKit defaults.
+This keyword should be the first
+.Cm keybinding
+entry on the configuration file.
+.It Cm cookiejar
+Bring up the cookie jar screen.
+Default
+.Cm M1+j .
+.It Cm downloadmgr
+Bring up the download manager screen.
+Default
+.Cm M1+d .
+.It Cm history
+Bring up the history screen.
+Default
+.Cm M1+h .
+.It Cm print
+Bring up print page or pane dialog.
+Default
+.Cm C+p .
+.It Cm quit
+Terminate
+.Nm
+session and close all tabs.
+Default
+.Cm C+q .
+.It Cm restart
+Restart
+.Nm
+while maintaining most state.
+Temporary cookies and Java Script whitelist items will be discarded.
+Default
+.Cm M1+q .
+.It Cm togglejs
+Toggle Java Script whitelist entry for
+.Cm FQDN
+of the current tab.
+Default
+.Cm C+j .
+.It Cm togglecookie
+Toggle cookie whitelist entry for
+.Cm FQDN
+of the current tab.
+Default
+.Cm M1+c .
+.It Cm togglesrc
+Toggle between source and normal view.
+Default
+.Cm C+s .
+.It Cm yankuri
+Yank (copy) URL of current tab into the clipboard.
+Default
+.Cm y .
+.It Cm pasteuricur
+Paste clipboard URL in the current tab and attempt to load it.
+Default
+.Cm p .
+.It Cm pasteurinew
+Paste clipboard URL in a new tab and attempt to load it.
+Default
+.Cm P .
+.It Cm searchnext
+Find the next occurence of the previously entered search term.
+If there is no previously entered search term on the current tab
+.Nm
+will attempt to use the last entered search term.
+Default
+.Cm n .
+.It Cm searchprev
+Find the previous occurence of the previously entered search term.
+If there is no previously entered search term on the current tab
+.Nm
+will attempt to use the last entered search term.
+Default
+.Cm N .
+.It Cm focusaddress
+Move keyboard focus to address (a.k.a. URL) entry bar.
+Default
+.Cm F6 .
+.It Cm focussearch
+Move keyboard focus to search entry bar.
+Default
+.Cm F7 .
+.It Cm hinting
+Switch to hinting mode.
+Default
+.Cm f .
+.It Cm goback
+Go to previous web page.
+Default
+.Cm BackSpace
+and
+.Cm M1+Left .
+.It Cm goforward
+Go to next web page.
+Default
+.Cm S+BackSpace
+and
+.Cm M1+Right .
+.It Cm reload
+Refresh web page.
+Default
+.Cm F5 ,
+.Cm C+l
+and
+.Cm C+r .
+.It Cm reloadforce
+Refresh web page bypassing all cache entries.
+Default
+.Cm C+R .
+.It Cm favorites
+Bring up favorites screen.
+Default
+.Cm M1+f .
+.It Cm scrolldown
+Go "one line" down.
+Default
+.Cm j
+and
+.Cm Down .
+.It Cm scrollup
+Go "one line" up.
+Default
+.Cm k
+and
+.Cm Up .
+.It Cm scrollbottom
+Go to the bottom of the page.
+Default
+.Cm G
+and
+.Cm End .
+.It Cm scrolltop
+Go to the top of the page.
+Default
+.Cm g
+and
+.Cm Home .
+.It Cm scrollpagedown
+Go "one page" down.
+Default
+.Cm Space ,
+.Cm C+f
+and
+.Cm PageDown .
+.It Cm scrollhalfdown
+Go "one half a page" down.
+Default
+.Cm C+d .
+.It Cm scrollpageup
+Go "one page" up.
+Default
+.Cm PageUp
+and
+.Cm C+b .
+.It Cm scrollhalfup
+Go "one half a page" up.
+Default
+.Cm C+u .
+.It Cm scrollright
+Scroll page to the right.
+Default
+.Cm l
+and
+.Cm Right .
+.It Cm scrollfarright
+Scroll page to the far right.
+Default
+.Cm dollar .
+.It Cm scrollleft
+Scroll page to the left.
+Default
+.Cm h
+and
+.Cm Left .
+.It Cm scrollfarleft
+Scroll page to the far left.
+Default
+.Cm 0 .
+.It Cm tabnew
+Create a new tab.
+Default
+.Cm C+t .
+.It Cm tabclose
+Close current tab.
+Default
+.Cm C+w .
+.It Cm tabundoclose
+Reopen last closed tab.
+Default
+.Cm U .
+.It Cm tabgoto1
+Go to tab 1 (first tab).
+Default
+.Cm C+1 .
+.It Cm tabgoto2
+Go to tab 2.
+Default
+.Cm C+2 .
+.It Cm tabgoto3
+Go to tab 3.
+Default
+.Cm C+3 .
+.It Cm tabgoto4
+Go to tab 4.
+Default
+.Cm C+4 .
+.It Cm tabgoto5
+Go to tab 5.
+Default
+.Cm C+5 .
+.It Cm tabgoto6
+Go to tab 6.
+Default
+.Cm C+6 .
+.It Cm tabgoto7
+Go to tab 7.
+Default
+.Cm C+7 .
+.It Cm tabgoto8
+Go to tab 8.
+Default
+.Cm C+8 .
+.It Cm tabgoto9
+Go to tab 9.
+Default
+.Cm C+9 .
+.It Cm tabgoto10
+Go to tab 10.
+Default
+.Cm C+10 .
+.It Cm tabgotofirst
+Go to first tab.
+Default
+.Cm C+less .
+.It Cm tabgotolast
+Go to last tab.
+Default
+.Cm C+greater .
+.It Cm tabgotonext
+Go to next tab.
+If the current tab is the last tab
+.Nm
+will go to the first tab.
+Default
+.Cm C+Right .
+.It Cm tabgotoprev
+Go to previous tab.
+If the current tab is the first tab
+.Nm
+will go to the last tab.
+Default
+.Cm C+Left .
+.It Cm focusout
+Make fonts on current tab smaller.
+Default
+.Cm C+minus .
+.It Cm focusin
+Make fonts on current tab bigger.
+Default
+.Cm C+equal
+and
+.Cm C+plus .
 .El
 .Sh HISTORY
 .Nm