-.TH lariza 1 "2015-11-28" "lariza" "User Commands"
+.TH lariza 1 "2021-01-03" "lariza" "User Commands"
.\" --------------------------------------------------------------------
.SH NAME
lariza \- simple web browser
.\" --------------------------------------------------------------------
.SH SYNOPSIS
\fBlariza\fP
-[\fB\-e\fP \fIwid\fP]
[\fB\-C\fP]
-[\fB\-T\fP]
[\fIURI ...\fP]
.\" --------------------------------------------------------------------
.SH DESCRIPTION
In addition to the standard arguments of GTK+ 3, \fBlariza\fP knows
about the following options:
.TP
-\fB\-e\fP \fIwid\fP
-Embeds the main window and all newly created windows in the window
-specified by \fIwid\fP. The download manager is always a \(lqpopup\(rq.
-.TP
\fB\-C\fP
Disables cooperative instances.
-.TP
-\fB\-T\fP
-Disables automatic launching of suckless' \fBtabbed\fP(1).
.P
After these options there can be any number of URIs. If no URIs are
given, $\fBLARIZA_HOME_URI\fP will be opened.
In HTTP requests, WebKit sets the \(lqAccepted-Language\(rq header to
this value. Defaults to \fBen-US\fP.
.TP
-\fBLARIZA_CRASH_AUTORELOAD_DELAY\fP
-If/when the WebKit process crashes, \fBlariza\fP's main process will
-receive a signal and can act accordingly. The default value of this
-variable is \fB2\fP, which means that \fBlariza\fP will wait two seconds
-and then reload each window/tab.
-
-If you set $\fBLARIZA_CRASH_AUTORELOAD_DELAY\fP to zero or any negative
-value, then \fBlariza\fP will not automatically reload anything. Note,
-however, that you can still do this manually by pressing the
-\(lqreload\(rq hotkey for each window.
-.TP
\fBLARIZA_DOWNLOAD_DIR\fP
All downloads are automatically stored in this directory. If you want to
stick to XDG directories, then you should configure your
This variable defaults to \fB/var/tmp\fP.
.TP
+\fBLARIZA_ENABLE_CONSOLE_TO_STDOUT\fP
+Enable writing WebKit console messages to stdout.
+.TP
\fBLARIZA_FIFO_SUFFIX\fP
Cooperative instances are implemented using a named pipe in the file
system. The name of this pipe usually is (at least on modern systems
\fBmain\fP. If you change this variable, you can launch several
independent cooperative instances of \fBlariza\fP.
.TP
+\fBLARIZA_HISTORY_FILE\fP
+If set, \fBlariza\fP will write each visited URI to that file. This path
+can point to a named pipe, but be aware that the browser will block
+until a reader at the other end of the pipe has read all pending data.
+.TP
\fBLARIZA_HOME_URI\fP
This URI will be opened by pressing the appropriate hotkeys
(\(lqhomepage\(rq or \(lqnew window\(rq) and if no URIs are specified on
the command line. Defaults to \fBabout:blank\fP.
.TP
+\fBLARIZA_TAB_POS\fP
+Can be one of \fBtop\fP (default), \fBright\fP, \fBbottom\fP,
+\fBleft\fP.
+.TP
+\fBLARIZA_TAB_WIDTH_CHARS\fP
+An integer, determines width of tabs. Defaults to 20.
+.TP
\fBLARIZA_USER_AGENT\fP
\fBlariza\fP will identify itself with this string. Uses WebKit's
default value if unset.
.TP
-\fBLARIZA_WEB_EXTENSIONS_DIR\fP
-Sets the directory where WebKit will look for \fBweb extensions\fP.
-Defaults to \fI~/.local\:/share\:/lariza\:/web_extensions\fP.
-.TP
\fBLARIZA_ZOOM
Zoom level for WebKit viewports. Defaults to \fB1.0\fP.
.\" --------------------------------------------------------------------
.SH FILES
+XDG variables will be used to construct these paths.
.TP
-\fI~/.config\:/lariza\:/adblock.black\fP
-Adblock patterns. See \fBlariza.usage\fP(1).
+\fI~/.config\:/lariza\:/adblock\fP
+Adblock patterns. See \fBlariza-usage\fP(1).
.TP
\fI~/.config\:/lariza\:/certs\fP
Directory where trusted certificates are stored. See
-\fBlariza.usage\fP(1).
+\fBlariza-usage\fP(1).
+.TP
+\fI~/.config\:/lariza\:/user-scripts\fP
+Directory to store user-supplied JavaScript snippets. See
+\fBlariza-usage\fP(1).
+.TP
+\fI~/.local\:/share\:/lariza\:/web_extensions\fP
+Sets the directory where WebKit will look for web extensions. See
+\fBlariza-usage\fP(1).
.TP
-\fI~/.config\:/lariza\:/keywordsearch\fP
-Configuration file for keyword base searching. See
-\fBlariza.usage\fP(1).
+\fI~/.cache\:/lariza\fP
+.TQ
+\fI~/.cache\:/webkitgtk\fP
+.TQ
+\fI~/.local\:/share\:/webkitgtk\fP
+WebKitGTK will dump its caches and local storage here. It is probably
+wise to clean those directories regularly or to mount them as
+\fBtmpfs\fP(5).
.\" --------------------------------------------------------------------
.SH LICENSE
-\fBlariza\fP is released as \(lqPIZZA-WARE\(rq. See the accompanying
+\fBlariza\fP is released under the MIT license. See the accompanying
\fILICENSE\fP file.
.\" --------------------------------------------------------------------
.SH HISTORY
was started in June 2014.
.\" --------------------------------------------------------------------
.SH "SEE ALSO"
-.BR lariza.usage (1),
-.BR tabbed (1).
+.BR lariza.usage (1).