man1/lariza.1

   1 .TH lariza 1 "2015-11-28" "lariza" "User Commands"
   2 .\" --------------------------------------------------------------------
   3 .SH NAME
   4 lariza \- simple web browser
   5 .\" --------------------------------------------------------------------
   6 .SH SYNOPSIS
   7 \fBlariza\fP
   8 [\fB\-e\fP \fIwid\fP]
   9 [\fB\-C\fP]
  10 [\fB\-T\fP]
  11 [\fIURI ...\fP]
  12 .\" --------------------------------------------------------------------
  13 .SH DESCRIPTION
  14 \fBlariza\fP is a simple web browser using GTK+ 3, GLib and WebKit2GTK+.
  15 .\" --------------------------------------------------------------------
  16 .SH OPTIONS
  17 In addition to the standard arguments of GTK+ 3, \fBlariza\fP knows
  18 about the following options:
  19 .TP
  20 \fB\-e\fP \fIwid\fP
  21 Embeds the main window and all newly created windows in the window
  22 specified by \fIwid\fP. The download manager is always a \(lqpopup\(rq.
  23 .TP
  24 \fB\-C\fP
  25 Disables cooperative instances.
  26 .TP
  27 \fB\-T\fP
  28 Disables automatic launching of suckless' \fBtabbed\fP(1).
  29 .P
  30 After these options there can be any number of URIs. If no URIs are
  31 given, $\fBLARIZA_HOME_URI\fP will be opened.
  32 .\" --------------------------------------------------------------------
  33 .SH ENVIRONMENT
  34 In addition to the standard variables of GTK+ 3, \fBlariza\fP knows
  35 about the following environment variables:
  36 .P
  37 .TP
  38 \fBLARIZA_ACCEPTED_LANGUAGE\fP
  39 In HTTP requests, WebKit sets the \(lqAccepted-Language\(rq header to
  40 this value. Defaults to \fBen-US\fP.
  41 .TP
  42 \fBLARIZA_CRASH_AUTORELOAD_DELAY\fP
  43 If/when the WebKit process crashes, \fBlariza\fP's main process will
  44 receive a signal and can act accordingly. The default value of this
  45 variable is \fB2\fP, which means that \fBlariza\fP will wait two seconds
  46 and then reload each window/tab.
  47
  48 If you set $\fBLARIZA_CRASH_AUTORELOAD_DELAY\fP to zero or any negative
  49 value, then \fBlariza\fP will not automatically reload anything. Note,
  50 however, that you can still do this manually by pressing the
  51 \(lqreload\(rq hotkey for each window.
  52 .TP
  53 \fBLARIZA_DOWNLOAD_DIR\fP
  54 All downloads are automatically stored in this directory. If you want to
  55 stick to XDG directories, then you should configure your
  56 \(lqxdg-user-dirs\(rq and use this:
  57
  58 \f(CW
  59 .nf
  60 \&LARIZA_DOWNLOAD_DIR=$(xdg-user-dir DOWNLOAD)
  61 .fi
  62 \fP
  63
  64 This variable defaults to \fB/var/tmp\fP.
  65 .TP
  66 \fBLARIZA_FIFO_SUFFIX\fP
  67 Cooperative instances are implemented using a named pipe in the file
  68 system. The name of this pipe usually is (at least on modern systems
  69 following XDG \(lqstandards\(rq):
  70 \fI/var\:/run\:/user\:/$UID\:/lariza.fifo\:-$LARIZA_FIFO_SUFFIX\fP.
  71
  72 $\fBUID\fP is the id of your user. $\fBLARIZA_FIFO_SUFFIX\fP defaults to
  73 \fBmain\fP. If you change this variable, you can launch several
  74 independent cooperative instances of \fBlariza\fP.
  75 .TP
  76 \fBLARIZA_HOME_URI\fP
  77 This URI will be opened by pressing the appropriate hotkeys
  78 (\(lqhomepage\(rq or \(lqnew window\(rq) and if no URIs are specified on
  79 the command line. Defaults to \fBabout:blank\fP.
  80 .TP
  81 \fBLARIZA_USER_AGENT\fP
  82 \fBlariza\fP will identify itself with this string. Uses WebKit's
  83 default value if unset.
  84 .TP
  85 \fBLARIZA_ZOOM
  86 Zoom level for WebKit viewports. Defaults to \fB1.0\fP.
  87 .\" --------------------------------------------------------------------
  88 .SH FILES
  89 XDG variables will be used to construct these paths.
  90 .TP
  91 \fI~/.config\:/lariza\:/adblock.black\fP
  92 Adblock patterns. See \fBlariza.usage\fP(1).
  93 .TP
  94 \fI~/.config\:/lariza\:/certs\fP
  95 Directory where trusted certificates are stored. See
  96 \fBlariza.usage\fP(1).
  97 .TP
  98 \fI~/.config\:/lariza\:/keywordsearch\fP
  99 Configuration file for keyword base searching. See
 100 \fBlariza.usage\fP(1).
 101 .TP
 102 \fI~/.local\:/share\:/lariza\:/web_extensions\fP
 103 Sets the directory where WebKit will look for web extensions. See
 104 \fBlariza.usage\fP(1).
 105 .\" --------------------------------------------------------------------
 106 .SH LICENSE
 107 \fBlariza\fP is released as \(lqPIZZA-WARE\(rq. See the accompanying
 108 \fILICENSE\fP file.
 109 .\" --------------------------------------------------------------------
 110 .SH HISTORY
 111 \fBlariza\fP was originally written by Peter Hofmann. The project
 112 was started in June 2014.
 113 .\" --------------------------------------------------------------------
 114 .SH "SEE ALSO"
 115 .BR lariza.usage (1),
 116 .BR tabbed (1).