- From 4564c02efd8cd348f47c6d3b43f368ddba003e9e Mon Sep 17 00:00:00 2001
- From: localuser <localuser@localhost>
- Date: Fri, 23 Sep 2011 19:32:24 +0200
- Subject: [PATCH 1/2] Use a static help page generated using mandoc
- This commit replaces the help page (about:help) with a manpage generated
- at compile time from xxxterm.1 using mandoc(1).
- Now the help page is always in sync with the xxxterm version being used.
- ---
- Makefile | 7 +-
- importman.sh | 6 +
- manpage.c | 1061 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
- xxxterm.c | 17 +-
- 4 files changed, 1078 insertions(+), 13 deletions(-)
- create mode 100755 importman.sh
- create mode 100644 manpage.c
- diff --git a/Makefile b/Makefile
- index 4c8ffbd..b6cf41e 100644
- --- a/Makefile
- +++ b/Makefile
- @@ -6,7 +6,7 @@ BINDIR=${PREFIX}/bin
- PROG=xxxterm
- MAN=xxxterm.1
- -SRCS= xxxterm.c marco.c
- +SRCS= xxxterm.c marco.c manpage.c
- COPT+= -O2
- DEBUG= -ggdb3
- LDADD= -lutil
- @@ -36,7 +36,10 @@ beforeinstall:
- cp ${.CURDIR}/xxxtermicon128.png ${PREFIX}/share/xxxterm
- cp ${.CURDIR}/style.css ${PREFIX}/share/xxxterm
- -${PROG} ${OBJS} beforedepend: ${.CURDIR}/javascript.h
- +${PROG} ${OBJS} beforedepend: ${.CURDIR}/javascript.h importman
- +
- +importman:
- + sh ${.CURDIR}/importman.sh
- release: xxxterm xxxterm.cat1
- @sh ${.CURDIR}/release.sh ${.CURDIR}
- diff --git a/importman.sh b/importman.sh
- new file mode 100755
- index 0000000..0540e3b
- --- /dev/null
- +++ b/importman.sh
- @@ -0,0 +1,6 @@
- +#/bin/sh
- +new_manpage_c=`mktemp -t XXXXXXXXXX`
- +sed '/\*message\[\] = {/q' manpage.c > $new_manpage_c
- +mandoc -Thtml xxxterm.1 | sed -n 's/OpenBSD Reference Manual//;s/OpenBSD [0-9\.]*//;s,<a class="link-sec" [^>]*>\([^</].*\)</a>,\1,g;s,",\\",g;s|$|"|;s|^|"|p' >> $new_manpage_c
- +sed -n '/^};/,$ p' manpage.c >> $new_manpage_c
- +mv $new_manpage_c manpage.c
- diff --git a/manpage.c b/manpage.c
- new file mode 100644
- index 0000000..f3652ae
- --- /dev/null
- +++ b/manpage.c
- @@ -0,0 +1,1061 @@
- +/* $xxxterm$ */
- +/*
- + * Copyright (c) 2011 Todd T. Fries <todd@fries.net>
- + *
- + * Permission to use, copy, modify, and distribute this software for any
- + * purpose with or without fee is hereby granted, provided that the above
- + * copyright notice and this permission notice appear in all copies.
- + *
- + * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
- + * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
- + * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
- + * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
- + * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
- + * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
- + * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
- + */
- +
- +#include <stdlib.h>
- +#include <string.h>
- +
- +static const char *message[] = {
- +"<!DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.01//EN\" \"http://www.w3.org/TR/html4/strict.dtd\">"
- +"<html>"
- +"<head>"
- +"<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">"
- +"<meta name=\"resource-type\" content=\"document\">"
- +"<title>"
- +"XXXTERM(1)</title>"
- +"</head>"
- +"<body>"
- +"<table summary=\"Document Header\" class=\"head\" width=\"100%\">"
- +"<col width=\"30%\">"
- +"<col width=\"30%\">"
- +"<col width=\"30%\">"
- +"<tbody>"
- +"<tr>"
- +"<td class=\"head-ltitle\">"
- +"XXXTERM(1)</td>"
- +"<td class=\"head-vol\" align=\"center\">"
- +"</td>"
- +"<td class=\"head-rtitle\" align=\"right\">"
- +"XXXTERM(1)</td>"
- +"</tr>"
- +"</tbody>"
- +"</table>"
- +"<div class=\"section\">"
- +"<h1 id=\"x4e414d45\">NAME</h1> <b class=\"name\">xxxterm</b> — <span class=\"desc\">lightweight web browser</span></div>"
- +"<div class=\"section\">"
- +"<h1 id=\"x53594e4f50534953\">SYNOPSIS</h1><table class=\"synopsis\">"
- +"<col style=\"width: 7.00ex;\">"
- +"<col>"
- +"<tbody>"
- +"<tr>"
- +"<td>"
- +"xxxterm</td>"
- +"<td>"
- +"[<span class=\"opt\"><b class=\"flag\">-nSTtV</b></span>] [<span class=\"opt\"><b class=\"flag\">-f</b> <i class=\"arg\">file</i></span>] [<span class=\"opt\"><b class=\"flag\">-s</b> <i class=\"arg\">session_name</i></span>] [<span class=\"opt\"><i class=\"arg\">url ...</i></span>]</td>"
- +"</tr>"
- +"</tbody>"
- +"</table>"
- +"</div>"
- +"<div class=\"section\">"
- +"<h1 id=\"x4445534352495054494f4e\">DESCRIPTION</h1> <b class=\"name\">xxxterm</b> is a minimalistic web browser that tries to stay out of the way so that valuable screen real estate can be used for much more important stuff. It has sane defaults and does not require one to learn a language to do any configuration. It was written by hackers for hackers and it strives to be small, compact, and fast.<p>"
- +"<b class=\"name\">xxxterm</b> is very simple in its use. Most actions are initiated via key or mouse bindings. Key bindings are based on those of the <a class=\"link-man\">vi(1)</a> text editor, giving web browsing a similar feel to navigating a text document. The <i class=\"link-sec\">KEY BINDINGS</i> section below documents the various defaults and possible customizations.<p>"
- +"The options are as follows:<dl style=\"margin-top: 0.00em;margin-bottom: 0.00em;\" class=\"list list-tag\">"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">-f</b> <i class=\"arg\">file</i></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Specify an alternative configuration file.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">-n</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Open a new tab in a running <b class=\"name\">xxxterm</b> for each specified URL. This option requires <b class=\"flag\">enable_socket</b> to be enabled.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">-e</b> <i class=\"arg\">command</i></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Execute arbitrary command (see the <i class=\"link-sec\">COMMAND MODE</i> section below) in a running <b class=\"name\">xxxterm</b> instance. This option requires <b class=\"flag\">enable_socket</b> to be enabled. Example run: xxxterm -e \"tabnew openbsd.org\"; xxxterm -e tabclose; xxxterm -e wq.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">-S</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Disable the toolbar.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">-s</b> <i class=\"arg\">session_name</i></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Open session that was saved with \":session save\" command.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">-T</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Disable visualization of tabs.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">-t</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Disable tabs.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">-V</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Display version and exit.</dd>"
- +"</dl>"
- +"</div>"
- +"<div class=\"section\">"
- +"<h1 id=\"x464153542053544152545550\">FAST STARTUP</h1> The following notation is used throughout this page:<p>"
- +"<dl style=\"margin-top: 0.00em;margin-bottom: 0.00em;margin-left: 5.00ex;\" class=\"list list-tag\">"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">C-</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Control</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">S-</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Shift</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">M1-</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Meta 1 (sometimes marked Alt)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">M2-</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Meta 2</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">M3-</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Meta 3</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">M4-</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Meta 4 (sometimes marked Windows)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">M5-</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Meta 2</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">MB1</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Mouse button 1</dd>"
- +"</dl>"
- +"<p>"
- +"To browse to a specific address, either use the mouse to click on the address bar or press <b class=\"flag\">F6</b> to shift the keyboard focus to the address bar. The address is then entered manually.<p>"
- +"The mouse can be used to navigate the page in the traditional manner, or the keyboard can be used instead. For example, <b class=\"flag\">PageUp</b> and <b class=\"flag\">PageDown</b> will scroll up and down the page.<p>"
- +"To follow a link, either click on it or use the <b class=\"flag\">f</b> key and have <b class=\"name\">xxxterm</b> assign numbers to each link on the page; entering that number on the keyboard will prompt <b class=\"name\">xxxterm</b> to follow the link.</div>"
- +"<div class=\"section\">"
- +"<h1 id=\"x4b45592042494e44494e4753\">KEY BINDINGS</h1> <b class=\"name\">xxxterm</b> provides many actions accessed via key or mouse bindings. Most can be reprogrammed using a <b class=\"flag\">keybinding</b> entry in the configuration file. Each keyboard shortcut requires exactly one entry in the configuration file. A shortcut can have multiple entries in the configuration file. The format of the keybinding entry is as follows:<p>"
- +"<blockquote style=\"margin-top: 0.00em;margin-bottom: 0.00em;\">"
- +"<div class=\"display\">"
- +"keybinding = action,(!)keystroke(s)</div>"
- +"</blockquote>"
- +"<p>"
- +"For example, \"keybinding = tabnew,C-t\" where <b class=\"flag\">tabnew</b> is the action and <b class=\"flag\">C-t</b> are the keystrokes. GTK has some default keybindings for manipulating text inside input fields, such as the URI or search entry widget, for example <b class=\"flag\">C-w</b> deletes a word. To override these defaults prefix your key with an exclamation mark, like this: \"keybinding = tabclose,!C-w\". The <b class=\"flag\">clearall</b> 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 <b class=\"flag\">keybinding</b> entry in the configuration file.<p>"
- +"Shift should be used sparingly since it gets in the way of non-USA keyboards. See the accompanying configuration file for examples.<p>"
- +"The various bindings are documented below. The relevant keybinding action is given afterwards, in parentheses.<div class=\"subsection\">"
- +"<h2 id=\"x53656172636820436f6d6d616e6473\">Search Commands</h2> These commands are used to search for text strings within a web page.<p>"
- +"<dl style=\"margin-top: 0.00em;margin-bottom: 0.00em;margin-left: 5.00ex;\" class=\"list list-tag\">"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">/</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Start a search (<b class=\"flag\">search</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">?</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Start a backwards search (<b class=\"flag\">searchb</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">n</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Next item matching search (<b class=\"flag\">searchnext</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">N</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Previous item matching search (<b class=\"flag\">searchprev</b>)</dd>"
- +"</dl>"
- +"</div>"
- +"<div class=\"subsection\">"
- +"<h2 id=\"x466f63757320436f6d6d616e6473\">Focus Commands</h2> These commands are used to shift the focus of <b class=\"name\">xxxterm</b> from one area to another.<p>"
- +"<dl style=\"margin-top: 0.00em;margin-bottom: 0.00em;margin-left: 5.00ex;\" class=\"list list-tag\">"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">F6</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Focus on address bar (<b class=\"flag\">focusaddress</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">F7</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Focus on search entry (<b class=\"flag\">focussearch</b>)</dd>"
- +"</dl>"
- +"</div>"
- +"<div class=\"subsection\">"
- +"<h2 id=\"x436f6d6d616e6420416c6961736573\">Command Aliases</h2> These commands allow the user to map specific actions to specific keys. It can be useful when the <b class=\"flag\">-S</b> option is used.<p>"
- +"<dl style=\"margin-top: 0.00em;margin-bottom: 0.00em;margin-left: 5.00ex;\" class=\"list list-tag\">"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">F1</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Alias for \":help\"</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">F4</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Alias for \":toplevel toggle\"</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">F9</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Alias for \":open\" (<b class=\"flag\">promptopen</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">F10</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Alias for \":open current-uri\" (<b class=\"flag\">promptopencurrent</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">F11</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Alias for \":tabnew\" (<b class=\"flag\">prompttabnew</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">F12</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Alias for \":tabnew current-uri\" (<b class=\"flag\">prompttabnewcurrent</b>)</dd>"
- +"</dl>"
- +"</div>"
- +"<div class=\"subsection\">"
- +"<h2 id=\"x4e617669676174696f6e20436f6d6d616e6473\">Navigation Commands</h2> These commands allow the user to navigate web pages and, to some extent, control the browser.<p>"
- +"<dl style=\"margin-top: 0.00em;margin-bottom: 0.00em;margin-left: 5.00ex;\" class=\"list list-tag\">"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">F5, C-r, C-l</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 23.00ex;\">"
- +"Reload page (<b class=\"flag\">reload</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">Backspace, M-Left</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 23.00ex;\">"
- +"Previous page (<b class=\"flag\">goback</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">S-BackSpace, M-Right</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 23.00ex;\">"
- +"Forward page (<b class=\"flag\">goforward</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">j, Down</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 23.00ex;\">"
- +"Next line on page (<b class=\"flag\">scrolldown</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">k, Up</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 23.00ex;\">"
- +"Previous line on page (<b class=\"flag\">scrollup</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">G, End</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 23.00ex;\">"
- +"Bottom of page (<b class=\"flag\">scrollbottom</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">gg, Home</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 23.00ex;\">"
- +"Top of page (<b class=\"flag\">scrolltop</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">Space, C-f, PageDown</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 23.00ex;\">"
- +"Page down (<b class=\"flag\">scrollpagedown</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">C-b, PageUp</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 23.00ex;\">"
- +"Page up (<b class=\"flag\">scrollpageup</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">l, Right</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 23.00ex;\">"
- +"Page right (<b class=\"flag\">scrollright</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">h, Left</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 23.00ex;\">"
- +"Page left (<b class=\"flag\">scrollleft</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">$</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 23.00ex;\">"
- +"Page far right (<b class=\"flag\">scrollfarright</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">0</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 23.00ex;\">"
- +"Page far left (<b class=\"flag\">scrollfarleft</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">M-f</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 23.00ex;\">"
- +"Favorites (<b class=\"flag\">fav</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">M-j</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 23.00ex;\">"
- +"Cookie jar (<b class=\"flag\">cookiejar</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">M-d</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 23.00ex;\">"
- +"Download manager (<b class=\"flag\">dl</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">C-p</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 23.00ex;\">"
- +"Print page (<b class=\"flag\">print</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">M-h</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 23.00ex;\">"
- +"Global history (<b class=\"flag\">history</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">C-j</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 23.00ex;\">"
- +"Toggle Java Script enabled for FQDN (<b class=\"flag\">js</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">C-s</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 23.00ex;\">"
- +"Toggle source view (<b class=\"flag\">togglesrc</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">M-c</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 23.00ex;\">"
- +"Toggle cookie enabled for FQDN (<b class=\"flag\">cookie</b>)</dd>"
- +"</dl>"
- +"</div>"
- +"<div class=\"subsection\">"
- +"<h2 id=\"x546162204d616e6970756c6174696f6e\">Tab Manipulation</h2> <b class=\"name\">xxxterm</b> supports tabbed browsing. That is, web pages may be opened in separate tabs, allowing the user to quickly move from one page to another, and back. These commands then are used to create, destroy, and move between tabs.<p>"
- +"<dl style=\"margin-top: 0.00em;margin-bottom: 0.00em;margin-left: 5.00ex;\" class=\"list list-tag\">"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">C-MB1</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 18.00ex;\">"
- +"Open new tab with the clicked link</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">C-t</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 18.00ex;\">"
- +"Create new tab with focus in URL entry (<b class=\"flag\">tabnew</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">C-w</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 18.00ex;\">"
- +"Destroy current tab (<b class=\"flag\">tabclose</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">U</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 18.00ex;\">"
- +"Undo close tab (<b class=\"flag\">tabundoclose</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">C-Left</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 18.00ex;\">"
- +"Go to the previous tab (<b class=\"flag\">tabprevious</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">C-Right</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 18.00ex;\">"
- +"Go to the next tab (<b class=\"flag\">tabnext</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">C-[1..9]</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 18.00ex;\">"
- +"Jump to page <i class=\"arg\">N</i> (<b class=\"flag\">tabnext [1..9]</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">C-minus</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 18.00ex;\">"
- +"Zoom out by 4% (<b class=\"flag\">focusout</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">C-plus, C-equal</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 18.00ex;\">"
- +"Zoom in by 4% (<b class=\"flag\">focusin</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">C-0</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 18.00ex;\">"
- +"Set zoom level to 100% (<b class=\"flag\">focusreset</b>)</dd>"
- +"</dl>"
- +"</div>"
- +"<div class=\"subsection\">"
- +"<h2 id=\"x59616e6b696e6720616e642070617374696e67\">Yanking and pasting</h2> These commands copy and paste text to and from the clipboard.<p>"
- +"<dl style=\"margin-top: 0.00em;margin-bottom: 0.00em;margin-left: 5.00ex;\" class=\"list list-tag\">"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">p</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Paste the contents of the clipboard into the address bar (<b class=\"flag\">pasteuricur</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">P</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Paste the contents of the clipboard into a new tab (<b class=\"flag\">pasteurinew</b>)</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">y</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Yank the current URL into the clipboard (<b class=\"flag\">yankuri</b>)</dd>"
- +"</dl>"
- +"</div>"
- +"<div class=\"subsection\">"
- +"<h2 id=\"x48797065726c696e6b20466f6c6c6f77696e67\">Hyperlink Following</h2> This allows the user to follow hyperlinks without using a mouse. Enter the corresponding number to follow the link. Alternatively one can type the name of the link and when there are no more possibilities <b class=\"name\">xxxterm</b> will follow the link.<p>"
- +"<dl style=\"margin-top: 0.00em;margin-bottom: 0.00em;margin-left: 5.00ex;\" class=\"list list-tag\">"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">f</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Highlight all links and prefix them with a number. (<b class=\"flag\">hinting</b>)</dd>"
- +"</dl>"
- +"</div>"
- +"<div class=\"subsection\">"
- +"<h2 id=\"x45786974696e67\">Exiting</h2> Commands to exit the browser.<p>"
- +"<dl style=\"margin-top: 0.00em;margin-bottom: 0.00em;margin-left: 5.00ex;\" class=\"list list-tag\">"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">C-q</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Quit (<b class=\"flag\">quitall</b>)</dd>"
- +"</dl>"
- +"</div>"
- +"<div class=\"subsection\">"
- +"<h2 id=\"x4c6f772d436f6e747261737420436f6c6f7220536368656d65\">Low-Contrast Color Scheme</h2> This command toggles the page's style between the default CSS and a low-contrast color scheme with light grey text on a dark grey background.<p>"
- +"<dl style=\"margin-top: 0.00em;margin-bottom: 0.00em;margin-left: 5.00ex;\" class=\"list list-tag\">"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">i</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Toggle the current tab's style. (<b class=\"flag\">userstyle</b>)</dd>"
- +"</dl>"
- +"</div>"
- +"</div>"
- +"<div class=\"section\">"
- +"<h1 id=\"x434f4d4d414e44204d4f4445\">COMMAND MODE</h1> Command mode works in a similar fashion to the <a class=\"link-man\">vi(1)</a> editor; it is entered by typing a colon and exited by typing Esc. The commands and their descriptions are listed below.<dl style=\"margin-top: 0.00em;margin-bottom: 0.00em;margin-left: 5.00ex;\" class=\"list list-tag\">"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">about</b>, <b class=\"flag\">version</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Show the \"About\" page.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">buffers</b>, <b class=\"flag\">ls</b>, <b class=\"flag\">tabs</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Displays the currently open tabs and lets the user switch tab by typing the tab number or using the mouse.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">ca</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Display CA certificates.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">cert</b>, <b class=\"flag\">cert show</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Download and display certificates of domain on tab.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">cert save</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Save certificate into a local store. The next time the site is visited it is compared against the store. If the certificate matches, the address bar will be blue; if it doesn't the bar will be red.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">cookie</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"The <b class=\"flag\">cookie</b> command is used to manipulate the cookie whitelist. Used by itself it expands to <b class=\"flag\">cookie show all</b>.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">cookiejar</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Show cookie jar contents.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">cookie save, cookie save fqdn</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Save the current fully qualified domain name (FQDN) to the persistent whitelist. For example, the www.peereboom.us domain would result in saving .www.peereboom.us.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">cookie save domain</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Save the top level domain name to the persistent whitelist. For example, the www.peereboom.us domain would result in saving .peereboom.us.<p>"
- +"This action enables cookies if it is currently disabled for this entry.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">cookie show all</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Show all persistent and session entries in the cookie whitelist.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">cookie show persistent</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Show all persistent entries in the cookie whitelist.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">cookie show session</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Show all session entries in the cookie whitelist.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">cookie toggle domain</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Toggle cookie support for the current top level domain.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">cookie toggle, cookie toggle fqdn</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Toggle cookie support for the current FQDN.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">dl</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Show download manager.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">fav</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Show favorites.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">favadd</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Add the current page to favorites.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">fullscreen</b>, <b class=\"flag\">f</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Toggle hiding tabs and url entry toolbar.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">h</b>, <b class=\"flag\">hist</b>, <b class=\"flag\">history</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Show global history.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">help</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Show help page.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">home</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Go to home URL.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">js</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"The <b class=\"flag\">js</b> command is used to manipulate the Java Script whitelist. Used by itself it expands to <b class=\"flag\">js show all</b>.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">js save, save fqdn</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Saves the FQDN to the persistent whitelist. For example, the www.peereboom.us domain would result in saving .www.peereboom.us.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">js save domain</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Saves the top level domain name to the persistent whitelist. For example, the www.peereboom.us domain would result in saving .peereboom.us.<p>"
- +"This action enables Java Script if it is currently disabled for this entry.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">js show all</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Shows all persistent and session entries in the JS whitelist.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">js show persistent</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Shows all persistent entries in the JS whitelist.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">js show session</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Shows all session entries in the JS whitelist.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">js toggle, js toggle fqdn</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Toggle Java Script execution for the current FQDN.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">js toggle domain</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Toggle Java Script execution for the current top level domain.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">open</b>, <b class=\"flag\">op</b>, <b class=\"flag\">o URL</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Open URL.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">print</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Print page.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">qa</b>, <b class=\"flag\">qall</b>, <b class=\"flag\">quitall</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Quit <b class=\"name\">xxxterm</b>.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">quit</b>, <b class=\"flag\">q</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Close current tab and quit <b class=\"name\">xxxterm</b> if it is the last tab.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">restart</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Restart <b class=\"name\">xxxterm</b> and reload all current tabs.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">run_script [path_to_script]</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Runs the script path_to_script with the current uri as the argument. If path_to_script is not provided, the value of default_script is used instead.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">session</b>, <b class=\"flag\">session show</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Display the current session name. By default the session name is main_session. To create a new session use the <b class=\"flag\">session save</b> command. A session is defined as the lifetime of the browser application.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">session delete <session_name></b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Delete session session_name from persistent storage. If session_name is the current session then the session will revert to main_session.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">session open <session_name></b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Open session_name and close all currently open tabs. Going forward this session is named session_name.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">session save <session_name></b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Save current tabs to session_name session. This will close the current session and going forward this session is named session_name.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">set</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"The set command is used to inspect, clear or change runtime options. There are 3 methods to use <b class=\"flag\">:set</b>. When used by itself as <b class=\"flag\">:set</b> the command displays all options as currently set.<p>"
- +"To set a value use <b class=\"flag\">:set option=value</b>. For example, <b class=\"flag\">:set http_proxy=http://127.0.0.1:8080</b>.<p>"
- +"To clear a value use <b class=\"flag\">:set option=</b>. For example, <b class=\"flag\">:set http_proxy=</b>.<p>"
- +"Note, not all options can be set at runtime.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">stats</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Show blocked cookie statistics. These statistics vary based on settings and are not persistent.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">statustoggle</b>, <b class=\"flag\">statust</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Toggle status bar.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">tabclose</b>, <b class=\"flag\">tabc</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Close current tab.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">tabhide</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Hide tabs.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">tabnew</b>, <b class=\"flag\">tabedit</b>, <b class=\"flag\">tabe URL</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Create new tab and optionally open provided URL.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">tabnext</b>, <b class=\"flag\">tabn</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Go to the next tab.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">tabprevious</b>, <b class=\"flag\">tabp</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Go to the previous tab.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">tabshow</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Show tabs.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">toplevel</b>, <b class=\"flag\">toplevel toggle</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Toggle the top level domain name cookie and JS session whitelist. This is to enable/disable short lived full site functionality without permanently adding the top level domain to the persistent whitelist.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">urlhide</b>, <b class=\"flag\">urlh</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Hide url entry and tool bar.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">urlshow</b>, <b class=\"flag\">urls</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Show url entry and tool bar.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">w</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Save open tabs to current session. The tabs will be restored next time the session is opened. See the session command for additional details.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 1.00em;\">"
- +"<b class=\"flag\">wq</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 6.00ex;\">"
- +"Save open tabs and quit. The tabs will be restored next time <b class=\"name\">xxxterm</b> the session is opened. See the session command for additional details.</dd>"
- +"</dl>"
- +"</div>"
- +"<div class=\"section\">"
- +"<h1 id=\"x42554646455220434f4d4d414e4453\">BUFFER COMMANDS</h1> In addition to shortcuts and commands <b class=\"name\">xxxterm</b> provides buffer commands. Buffer commands are short, multi character vi-like commands, often requiring an argument. Partial buffer commands are displayed in the buffer command statusbar element (see <b class=\"flag\">statusbar_elems</b>). Pressing Esc or switching to another tab cancels a partially entered buffer command. In the following list <b class=\"flag\">arg</b> denotes the argument a buffer command accepts. Buffer commands are defined as extended regular experssions. Note that if a character is used as a shortcut it will not be interpreted as the beginning of a buffer command. This is the case with <b class=\"flag\">0</b>.<p>"
- +"<dl style=\"margin-top: 0.00em;margin-bottom: 0.00em;margin-left: 5.00ex;\" class=\"list list-tag\">"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">gg</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 17.00ex;\">"
- +"go to the top of the page</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">gG</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 17.00ex;\">"
- +"go to the bottom of the page</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">[0-9]+%</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 17.00ex;\">"
- +"go to the <b class=\"flag\">arg</b> percent of the page</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">[0-9]*gU</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 17.00ex;\">"
- +"go <b class=\"flag\">arg</b> levels up. If <b class=\"flag\">arg</b> is missing, 1 is assumed. Going a level up means going to a uri obtained from the current one by removing the last slash ('/') character and everything that follows it</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">gh</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 17.00ex;\">"
- +"open the home page in the current tab</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">m[a-zA-Z0-9]</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 17.00ex;\">"
- +"set a mark denoted by <b class=\"flag\">arg</b> at the current page position. These marks behave like those in vi or less.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">['][a-zA-Z0-9]</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 17.00ex;\">"
- +"go to the position where mark <b class=\"flag\">arg</b> was set</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">M[a-zA-Z0-9]</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 17.00ex;\">"
- +"set the current uri as quickmark <b class=\"flag\">arg</b></dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">go[a-zA-Z0-9]</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 17.00ex;\">"
- +"open the uri marked as quickmark <b class=\"flag\">arg</b> in the current tab</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">gn[a-zA-Z0-9]</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 17.00ex;\">"
- +"open the uri marked as quickmark <b class=\"flag\">arg</b> in a new tab</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">[0-9]+t</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 17.00ex;\">"
- +"activate tab number <b class=\"flag\">arg</b></dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">ZZ</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 17.00ex;\">"
- +"quit <b class=\"name\">xxxterm</b></dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">ZR</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 17.00ex;\">"
- +"restart <b class=\"name\">xxxterm</b></dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">zi</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 17.00ex;\">"
- +"zoom in by 4%</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">zo</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 17.00ex;\">"
- +"zoom out by 4%</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">z0</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 17.00ex;\">"
- +"set zoom level to 100%</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">[0-9]+Z</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 17.00ex;\">"
- +"set zoom level to <b class=\"flag\">arg</b> %</dd>"
- +"</dl>"
- +"</div>"
- +"<div class=\"section\">"
- +"<h1 id=\"x515549434b4d41524b53\">QUICKMARKS</h1> Quickmarks are like bookmarks, except they are refered to by a single character (a letter or a digit), instead of a longer name. See the <b class=\"flag\">M[a-zA-Z0-9]</b>, <b class=\"flag\">go[a-zA-Z0-9]</b> and <b class=\"flag\">gn[a-zA-Z0-9]</b> buffer commands for usage. Quickmarks are stored in <i class=\"file\">~/.xxxterm/quickmarks</i> and are saved automatically after each <b class=\"flag\">M[a-zA-Z0-9]</b> buffer command.</div>"
- +"<div class=\"section\">"
- +"<h1 id=\"x41424f55542053435245454e53\">ABOUT SCREENS</h1> The about screens are internally generated web pages by <b class=\"name\">xxxterm</b> for user interaction. These are entered in the address bar and the format is <b class=\"flag\">about:screen</b> where screen is the desired screen to display. For example about:favorites. Any about screen can be used as the home page as specified by <b class=\"flag\">home</b> in the configuration file.<p>"
- +"<dl style=\"margin-top: 0.00em;margin-bottom: 0.00em;margin-left: 5.00ex;\" class=\"list list-tag\">"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">about</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 12.00ex;\">"
- +"show the about screen</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">blank</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 12.00ex;\">"
- +"show a blank screen</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">cookiewl</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 12.00ex;\">"
- +"show the cookie whitelist screen</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">cookiejar</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 12.00ex;\">"
- +"show the cookiejar screen</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">downloads</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 12.00ex;\">"
- +"show the downloads screen</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">favorites</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 12.00ex;\">"
- +"show the favorites screen</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">help</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 12.00ex;\">"
- +"show the help web page</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">history</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 12.00ex;\">"
- +"show the history screen</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">jswl</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 12.00ex;\">"
- +"show the Java Script whitelist screen</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">set</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 12.00ex;\">"
- +"show the settings screen</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">stats</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 12.00ex;\">"
- +"show the statistics screen</dd>"
- +"</dl>"
- +"</div>"
- +"<div class=\"section\">"
- +"<h1 id=\"x57484954454c49535453\">WHITELISTS</h1> This section describes advanced usage settings. Most users should use <b class=\"flag\">browser_mode</b> instead to setup <b class=\"name\">xxxterm</b> and skip over this section.<p>"
- +"<b class=\"name\">xxxterm</b> has a number of whitelists to control blocking cookies and Java Script execution for FQDNs or domains. When properly enabled these whitelists require either the FQDN or top level domain to exist in the whitelists in order to allow cookies to be stored or Java Script to execute. Both Java Script and cookies have two whitelists associated with them. The whitelists are called session and persistent. Items in the session whitelists are only allowed for the lifetime of the <b class=\"name\">xxxterm</b> instance. Items in the persistent whitelists are stored on disk and are restored upon restarting.<p>"
- +"Setting up the whitelists is a little tricky due to intricacies of WebKit. In fact the semantics are different for cookies and Java Script.<p>"
- +"Cookie whitelist requires the following configuration to be set:<p>"
- +"<dl style=\"margin-top: 0.00em;margin-bottom: 0.00em;margin-left: 5.00ex;\" class=\"list list-tag\">"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">cookies_enabled</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"This is a WebKit setting and must be set to <i class=\"file\">1</i> (ENABLED) in order to be able to use a cookie whitelist.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">enable_cookie_whitelist</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"This needs to be set to <i class=\"file\">1</i> to enable the cookie whitelist functionality.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">cookie_wl</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"These entries in the configuration file are the actual domains names in the cookie whitelist.</dd>"
- +"</dl>"
- +"<p>"
- +"Java Script whitelist requires the following configuration to be set:<p>"
- +"<dl style=\"margin-top: 0.00em;margin-bottom: 0.00em;margin-left: 5.00ex;\" class=\"list list-tag\">"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">enable_scripts</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 22.00ex;\">"
- +"This is a WebKit setting and must be set to <i class=\"file\">0</i> (DISABLED) in order to be able to use a Java Script whitelist.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">enable_js_whitelist</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 22.00ex;\">"
- +"This needs to be set to <i class=\"file\">1</i> to enable the Java Script whitelist functionality.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">js_wl</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 22.00ex;\">"
- +"These entries in the configuration file are the actual domains names in the Java Script whitelist.</dd>"
- +"</dl>"
- +"<p>"
- +"See the <i class=\"file\">FILES</i> section for additional configuration file entries and details that alter runtime behavior.</div>"
- +"<div class=\"section\">"
- +"<h1 id=\"x46494c4553\">FILES</h1><dl style=\"margin-top: 0.00em;margin-bottom: 0.00em;\" class=\"list list-tag\">"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<i class=\"file\">~/.xxxterm.conf</i></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 20.00ex;\">"
- +"<b class=\"name\">xxxterm</b> user specific settings.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<i class=\"file\">~/.xxxterm</i></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 20.00ex;\">"
- +"<b class=\"name\">xxxterm</b> scratch directory.</dd>"
- +"</dl>"
- +"<p>"
- +"<b class=\"name\">xxxterm</b> tries to open the user specific file, <i class=\"file\">~/.xxxterm.conf</i>. If that file is unavailable, it then uses built-in defaults.<p>"
- +"The format of the file is <keyword> = <setting>. For example:<p>"
- +"<blockquote style=\"margin-top: 0.00em;margin-bottom: 0.00em;\">"
- +"<div class=\"display\">"
- +"<code class=\"lit\">http_proxy = http://127.0.0.1:8080</code></div>"
- +"</blockquote>"
- +"<p>"
- +"Enabling or disabling an option is done by using 1 or 0 respectively.<p>"
- +"The file supports the following keywords:<p>"
- +"<dl style=\"margin-top: 0.00em;margin-bottom: 0.00em;margin-left: 5.00ex;\" class=\"list list-tag\">"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">alias</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Defines an alias for a given URL, so that the URL is loaded when the alias is entered in the address bar. If the aliased URL includes a %s format specifier, then any argument given after the alias on the address bar is substituted. For example, if g,http://www.google.com/search?q=%s is defined as an alias, then the URL http://www.google.com/search?q=foo is loaded when navigating to \"g foo\".</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">allow_volatile_cookies</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"If set cookies are stored in the session cache but will be discarded once <b class=\"name\">xxxterm</b> exits. Unfortunately enabling this does allow for some limited tracking on the web.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">append_next</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"When set a new tab is appended after the current tab instead of being appended as the last tab.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">browser_mode</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"The <b class=\"name\">xxxterm</b> browser has 3 default operating modes: <i class=\"file\">normal</i> (the default), <i class=\"file\">whitelist</i> and <i class=\"file\">kiosk</i>. In the <i class=\"file\">normal</i> mode the browser allows all cookies and Java Script as any other browser would. This means that all cookies are saved to persistent storage and that all Java Script runs.<p>"
- +"On the other hand, using the <i class=\"file\">whitelist</i> mode enables whitelists. This requires the user to add all the required <i class=\"file\">cookie_wl</i> and <i class=\"file\">js_wl</i> items. If a domain does not appear in the whitelists <b class=\"name\">xxxterm</b> disallows cookies and Java Script execution.<p>"
- +"In <i class=\"file\">kiosk</i> mode the browse works just like <i class=\"file\">normal</i> mode however the toolbar only has the backward, forward and home button.<p>"
- +"This setting must be the first entry in <i class=\"file\">~/.xxxterm.conf</i> because it sets advanced settings that can be overridden later in the file. See the default config file for more details.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">cmd_font</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Set the command prompt font. E.g. <i class=\"file\">cmd_font = monospace normal 9</i>.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">cookie_policy</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"This field delineates the cookie policy. Possible values are: no3rdparty, reject 3rd party cookies. accept, accept all cookies. reject, reject all cookies.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">cookie_wl</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"This is a cookie whitelist item. Use multiple times to add multiple entries. Valid entries are for example *.moo.com and the equivalent .moo.com. A fully qualified host is also valid and is for example www.moo.com.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">cookies_enabled</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Enable cookies.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">ctrl_click_focus</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Give focus in newly created tab instead of opening it in the background.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">default_script</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Path to the script used as the default value for the run_script command.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">default_zoom_level</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Set the default browsing zoom level.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">download_dir</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Locations where files are downloaded to. This directory must exist and <b class=\"name\">xxxterm</b> validates that during startup.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">enable_cookie_whitelist</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"When enabled all cookies must be in the whitelist or they are rejected. Additionally whitelisted cookies also enable HTML5 local storage for the domain.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">enable_js_whitelist</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"When enabled all domains must be in the js whitelist in order to run Java Script. NOTE: Make sure <b class=\"flag\">enable_scripts</b> is set to 0.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">enable_plugins</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Enable plugins.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">enable_scripts</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Enable scripts.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">enable_socket</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"When enabled the first instance of <b class=\"name\">xxxterm</b> will create a socket in the <i class=\"file\">~/.xxxterm</i> directory. Using the -n url option on subsequent <b class=\"name\">xxxterm</b> invocations will cause the specified URL to be loaded in a new tab. Only a user with identical UID and GID can use this option.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">enable_localstorage</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Enable html5 Local Storage.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">enable_spell_checking</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Enables spell checking. Preferred languages can be set using <b class=\"flag\">spell_check_languages</b> option.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">fancy_bar</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Enables a backward, forward, and stop button to the toolbar. Additionally if <b class=\"flag\">search_string</b> is set it'll enable an entry box for searches.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">guess_search</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"When enabled <b class=\"name\">xxxterm</b> will try to guess if the string you entered, in the URI entry widget or the command widget, is term you want to search for using search_string (see above). If the string does not contain a dot nor a slash, is not a path to a local file and does not resolves to an IP then it is assumed to be a search term.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">history_autosave</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"When enabled <b class=\"name\">xxxterm</b> will save all command and search history. Upon restarting <b class=\"name\">xxxterm</b> the saved command and search history will be restored.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">home</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Homepage in URL format.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">http_proxy</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Proxy server in URL format. <b class=\"name\">xxxterm</b> overrides <b class=\"flag\">http_proxy</b> if it is specified as an environment variable. It must be noted that on older webkit versions one MUST use an IP address and not a FQDN. This works as expected with webkit 1.4.2.<p>"
- +"If one desires to use a socks proxy then an intermediary tool must be used. It has been reported that tsocks works with <b class=\"name\">xxxterm</b>.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">icon_size</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Permits icon sizes to be changed if <b class=\"flag\">fancy_bar</b> is enabled. Size 1 is small; 2 is normal; 3 through 6 are progressively larger.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">js_wl</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"This is a Java Script whitelist item. See <b class=\"flag\">cookie_wl</b> for semantics and more details.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">max_connections</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"The maximum number of connections that <b class=\"name\">xxxterm</b> can open at once.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">max_host_connections</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"The maximum number of connections that <b class=\"name\">xxxterm</b> can open at once to a given host.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">mime_type</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Sets an action for a specific or default MIME type. For example, to download and view a pdf using kpdf set <i class=\"file\">mime_type = application/pdf,kpdf</i>. To set a default value use *, for example, <i class=\"file\">mime_type = video/*,mplayer</i>. Note that the action is only passed the URL and not all applications are capable of dealing with a URL and therefore one might have to create a wrapper script to download the content first. Alternatively one can add the <i class=\"file\">@</i> in front of the MIME type to indicate \"download first\". For example, <i class=\"file\">mime_type = @application/pdf,xpdf</i>. When <i class=\"file\">@</i> is use the file will be downloaded to the <i class=\"file\">download_dir</i> before the MIME handler is called.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">oops_font</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Set the font used to display error messages. E.g. <i class=\"file\">oops_font = monospace normal 9</i>.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">read_only_cookies</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Mark cookies file read-only and discard all cookies once the session is terminated.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">refresh_interval</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Refresh interval while in the download manager. The default is 10.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">resource_dir</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Directory that contains various <b class=\"name\">xxxterm</b> resources such as icons. This is OS-specific and should be handled by the porter.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">save_global_history</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"If set the global history will be saved to <i class=\"file\">~/.xxxterm/history</i> when quitting and restored at startup. See the <i class=\"link-sec\">KEY BINDINGS</i> section above for how the global history is accessed. Global history is not saved to disk by default.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">save_rejected_cookies</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Saves rejected cookies in cookie format in {work_dir}/rejected.txt. All cookies are saved and unlike a cookie jar they are never replaced. Make sure there is enough disk space to enable this feature.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">search_string</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Default search engine string. See the <i class=\"file\">xxxterm.conf</i> file for details.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">session_autosave</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Enable session auto-saving when changing state (e.g. adding or removing a tab). The session name is what is currently in use and is described in the <b class=\"flag\">session save</b> and <b class=\"flag\">session open</b> commands.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">session_timeout</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"This value is the time that is added in seconds to a session cookie.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">show_tabs</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Enable or disable showing tabs.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">show_url</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Enable or disable showing the url and toolbar.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">show_statusbar</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Enable or disable showing the status bar.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">single_instance</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"If set only one <b class=\"name\">xxxterm</b> will be permitted to run. If there is a URL specified it will be opened in a new tab in the already running <b class=\"name\">xxxterm</b> session.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">spell_check_languages</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"The languages to be used for spell checking, separated by commas. For example, en_US.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">ssl_ca_file</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"If set to a valid PEM file all server certificates will be validated against it. The URL bar will be colored green (or blue when saved ) when the certificate is trusted and yellow when untrusted.<p>"
- +"If <b class=\"flag\">ssl_ca_file</b> is not set then the URL bar will color all HTTPS connections red.<p>"
- +"WebKit only supports a single PEM file. Many OS' or distributions have many PEM files. One can simply concatenate all separate files into one large one. E.g. <b class=\"flag\">for i in `ls`; do cat $i >> cert.pem; done</b> and use the resulting cert.pem file as the input to <b class=\"flag\">ssl_ca_file</b>. It is advisable to periodically recreate the cert.pem file.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">ssl_strict_certs</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"If this value is set connections to untrusted sites will be aborted. This value is only used if <b class=\"flag\">ssl_ca_file</b> is set.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">statusbar_elems</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Define the components of the status bar. The possible components are:<p>"
- +"<pre style=\"margin-left: 5.00ex;\" class=\"lit display\">"
- +"| - separator "
- +"P - page progress percent "
- +"B - buffer command "
- +"Z - page zoom level</pre>"
- +"The default is \"BP\". These components show nothing if there is nothing worth showing, like zoom amount 100%.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">statusbar_font</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Set the status bar font. E.g. <i class=\"file\">statusbar_font = monospace normal 9</i>.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">tab_style</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Set the tab style to either <b class=\"flag\">normal</b> - the default gtk notebook tabs, or <b class=\"flag\">compact</b> for an alternative. You can switch the tab style with the <i class=\"file\">tabnextstyle</i> command.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">tabbar_font</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Set the compact tab bar font. E.g. <i class=\"file\">tabbar_font = monospace normal 9</i>.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">url_regex</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"This is the regular expression that is used to match what constitutes a valid URL when using <i class=\"file\">guess_search</i>.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">user_agent</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Set to override the default <b class=\"name\">xxxterm</b> user-agent string.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">window_height</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Set the default height of the browser window.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">window_width</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Set the default width of the browser window.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">work_dir</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"Set the work directory where all <b class=\"name\">xxxterm</b> scratch files are stored. Default is <b class=\"flag\">~/.xxxterm</b>.</dd>"
- +"<dt class=\"list-tag\" style=\"margin-top: 0.00em;\">"
- +"<b class=\"flag\">xterm_workaround</b></dt>"
- +"<dd class=\"list-tag\" style=\"margin-left: 26.00ex;\">"
- +"When enabled <b class=\"name\">xxxterm</b> will look additionally at CUT_BUFFER0 if PRIMARY clipboard is empty. Additionally when the PRIMARY clipboard is cleared it will copy CUT_BUFFER0 into the PRIMARY clipboard. Default is 0.</dd>"
- +"</dl>"
- +"</div>"
- +"<div class=\"section\">"
- +"<h1 id=\"x484953544f5259\">HISTORY</h1> <b class=\"name\">xxxterm</b> was inspired by vimprobable2 and the bloat in other <span class=\"unix\">UNIX</span> web browsers.</div>"
- +"<div class=\"section\">"
- +"<h1 id=\"x415554484f5253\">AUTHORS</h1> <span class=\"author\"></span><b class=\"name\">xxxterm</b> was written by <span class=\"author\">Marco Peereboom</span> <marco@peereboom.us>, <span class=\"author\">Stevan Andjelkovic</span> <stevan@student.chalmers.se>, <span class=\"author\">Edd Barrett</span> <vext01@gmail.com>, <span class=\"author\">Todd T. Fries</span> <todd@fries.net>, <span class=\"author\">Raphael Graf</span> <r@undefined.ch>, and <span class=\"author\">Michal Mazurek</span> <akfaew@jasminek.net>.</div>"
- +"<div class=\"section\">"
- +"<h1 id=\"x42554753\">BUGS</h1> When <b class=\"flag\">save_global_history</b> is enabled <b class=\"name\">xxxterm</b> is supposed to, in addition to restoring the global history, color the visited links accordingly; however due to bug #51747 in WebKit this does not happen.</div>"
- +"<table summary=\"Document Footer\" class=\"foot\" width=\"100%\">"
- +"<col width=\"50%\">"
- +"<col width=\"50%\">"
- +"<tbody>"
- +"<tr>"
- +"<td class=\"foot-date\">"
- +"September 23, 2011</td>"
- +"<td class=\"foot-os\" align=\"right\">"
- +"</td>"
- +"</tr>"
- +"</tbody>"
- +"</table>"
- +"</body>"
- +"</html>"
- +""
- +};
- +
- +const char *
- +manpage_message(int *len)
- +{
- + const char *str;
- +
- + str = message[arc4random_uniform(sizeof(message)/sizeof(message[0]))];
- + *len = strlen(str);
- +
- + return str;
- +}
- diff --git a/xxxterm.c b/xxxterm.c
- index e16c822..b752857 100644
- --- a/xxxterm.c
- +++ b/xxxterm.c
- @@ -808,6 +808,7 @@ int stats(struct tab *, struct karg *);
- int marco(struct tab *, struct karg *);
- int startpage(struct tab *, struct karg *);
- const char * marco_message(int *);
- +const char * manpage_message(int *);
- int xtp_page_cl(struct tab *, struct karg *);
- int xtp_page_dl(struct tab *, struct karg *);
- int xtp_page_fl(struct tab *, struct karg *);
- @@ -3085,22 +3086,16 @@ about(struct tab *t, struct karg *args)
- int
- help(struct tab *t, struct karg *args)
- {
- - char *page, *head, *body;
- + char line[64 * 1024];
- + int len;
- if (t == NULL)
- show_oops(NULL, "help invalid parameters");
- - head = "<meta http-equiv=\"REFRESH\" content=\"0;"
- - "url=http://opensource.conformal.com/cgi-bin/man-cgi?xxxterm\">"
- - "</head>\n";
- - body = "XXXTerm man page <a href=\"http://opensource.conformal.com/"
- - "cgi-bin/man-cgi?xxxterm\">http://opensource.conformal.com/"
- - "cgi-bin/man-cgi?xxxterm</a>";
- -
- - page = get_html_page(XT_NAME, body, head, FALSE);
- + line[0] = '\0';
- + snprintf(line, sizeof line, "%s", manpage_message(&len));
- - load_webkit_string(t, page, XT_URI_ABOUT_HELP);
- - g_free(page);
- + load_webkit_string(t, line, XT_URI_ABOUT_HELP);
- return (0);
- }
- --
- 1.7.3.5
- From b528ab8b66035c8cf920c598c844acfce8fb7511 Mon Sep 17 00:00:00 2001
- From: localuser <localuser@localhost>
- Date: Sat, 24 Sep 2011 12:08:22 +0200
- Subject: [PATCH 2/2] Remove more rubbish from the manpage
- ---
- importman.sh | 11 ++++++++++-
- manpage.c | 14 --------------
- 2 files changed, 10 insertions(+), 15 deletions(-)
- diff --git a/importman.sh b/importman.sh
- index 0540e3b..21b78c3 100755
- --- a/importman.sh
- +++ b/importman.sh
- @@ -1,6 +1,15 @@
- #/bin/sh
- new_manpage_c=`mktemp -t XXXXXXXXXX`
- sed '/\*message\[\] = {/q' manpage.c > $new_manpage_c
- -mandoc -Thtml xxxterm.1 | sed -n 's/OpenBSD Reference Manual//;s/OpenBSD [0-9\.]*//;s,<a class="link-sec" [^>]*>\([^</].*\)</a>,\1,g;s,",\\",g;s|$|"|;s|^|"|p' >> $new_manpage_c
- +mandoc -Thtml xxxterm.1 | sed -n '
- +/^<td class="head-vol" align="center">$/ {
- + N;d
- +}
- +
- +/^<table summary="Document Footer".*$/,/<\/table/ d
- +
- +s,<a class="link-sec" [^>]*>\([^</].*\)</a>,\1,g
- +s,",\\",g
- +s|$|"|;s|^|"|p' >> $new_manpage_c
- sed -n '/^};/,$ p' manpage.c >> $new_manpage_c
- mv $new_manpage_c manpage.c
- diff --git a/manpage.c b/manpage.c
- index f3652ae..2d2e4ec 100644
- --- a/manpage.c
- +++ b/manpage.c
- @@ -36,8 +36,6 @@ static const char *message[] = {
- "<tr>"
- "<td class=\"head-ltitle\">"
- "XXXTERM(1)</td>"
- -"<td class=\"head-vol\" align=\"center\">"
- -"</td>"
- "<td class=\"head-rtitle\" align=\"right\">"
- "XXXTERM(1)</td>"
- "</tr>"
- @@ -1032,18 +1030,6 @@ static const char *message[] = {
- "<h1 id=\"x415554484f5253\">AUTHORS</h1> <span class=\"author\"></span><b class=\"name\">xxxterm</b> was written by <span class=\"author\">Marco Peereboom</span> <marco@peereboom.us>, <span class=\"author\">Stevan Andjelkovic</span> <stevan@student.chalmers.se>, <span class=\"author\">Edd Barrett</span> <vext01@gmail.com>, <span class=\"author\">Todd T. Fries</span> <todd@fries.net>, <span class=\"author\">Raphael Graf</span> <r@undefined.ch>, and <span class=\"author\">Michal Mazurek</span> <akfaew@jasminek.net>.</div>"
- "<div class=\"section\">"
- "<h1 id=\"x42554753\">BUGS</h1> When <b class=\"flag\">save_global_history</b> is enabled <b class=\"name\">xxxterm</b> is supposed to, in addition to restoring the global history, color the visited links accordingly; however due to bug #51747 in WebKit this does not happen.</div>"
- -"<table summary=\"Document Footer\" class=\"foot\" width=\"100%\">"
- -"<col width=\"50%\">"
- -"<col width=\"50%\">"
- -"<tbody>"
- -"<tr>"
- -"<td class=\"foot-date\">"
- -"September 23, 2011</td>"
- -"<td class=\"foot-os\" align=\"right\">"
- -"</td>"
- -"</tr>"
- -"</tbody>"
- -"</table>"
- "</body>"
- "</html>"
- ""
- --
- 1.7.3.5