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_DOWNLOAD_DIR\fP
  43 All downloads are automatically stored in this directory. If you want to
  44 stick to XDG directories, then you should configure your
  45 \(lqxdg-user-dirs\(rq and use this:
  46
  47 \f(CW
  48 .nf
  49 \&LARIZA_DOWNLOAD_DIR=$(xdg-user-dir DOWNLOAD)
  50 .fi
  51 \fP
  52
  53 This variable defaults to \fB/var/tmp\fP.
  54 .TP
  55 \fBLARIZA_FIFO_SUFFIX\fP
  56 Cooperative instances are implemented using a named pipe in the file
  57 system. The name of this pipe usually is (at least on modern systems
  58 following XDG \(lqstandards\(rq):
  59 \fI/var\:/run\:/user\:/$UID\:/lariza.fifo\:-$LARIZA_FIFO_SUFFIX\fP.
  60
  61 $\fBUID\fP is the id of your user. $\fBLARIZA_FIFO_SUFFIX\fP defaults to
  62 \fBmain\fP. If you change this variable, you can launch several
  63 independent cooperative instances of \fBlariza\fP.
  64 .TP
  65 \fBLARIZA_HISTORY_FILE\fP
  66 If set, \fBlariza\fP will write each visited URI to that file. This path
  67 can point to a named pipe, but be aware that the browser will block
  68 until a reader at the other end of the pipe has read all pending data.
  69 .TP
  70 \fBLARIZA_HOME_URI\fP
  71 This URI will be opened by pressing the appropriate hotkeys
  72 (\(lqhomepage\(rq or \(lqnew window\(rq) and if no URIs are specified on
  73 the command line. Defaults to \fBabout:blank\fP.
  74 .TP
  75 \fBLARIZA_USER_AGENT\fP
  76 \fBlariza\fP will identify itself with this string. Uses WebKit's
  77 default value if unset.
  78 .TP
  79 \fBLARIZA_ZOOM
  80 Zoom level for WebKit viewports. Defaults to \fB1.0\fP.
  81 .\" --------------------------------------------------------------------
  82 .SH FILES
  83 XDG variables will be used to construct these paths.
  84 .TP
  85 \fI~/.config\:/lariza\:/adblock.black\fP
  86 Adblock patterns. See \fBlariza.usage\fP(1).
  87 .TP
  88 \fI~/.config\:/lariza\:/certs\fP
  89 Directory where trusted certificates are stored. See
  90 \fBlariza.usage\fP(1).
  91 .TP
  92 \fI~/.config\:/lariza\:/keywordsearch\fP
  93 Configuration file for keyword base searching. See
  94 \fBlariza.usage\fP(1).
  95 .TP
  96 \fI~/.local\:/share\:/lariza\:/web_extensions\fP
  97 Sets the directory where WebKit will look for web extensions. See
  98 \fBlariza.usage\fP(1).
  99 .P
 100 The executable \fIlariza-external-handler\fP must be located somewhere
 101 in your $\fBPATH\fP, if you want to make use of the external URI
 102 handler. See \fBlariza.usage\fP(1) for details.
 103 .\" --------------------------------------------------------------------
 104 .SH LICENSE
 105 \fBlariza\fP is released as \(lqPIZZA-WARE\(rq. See the accompanying
 106 \fILICENSE\fP file.
 107 .\" --------------------------------------------------------------------
 108 .SH HISTORY
 109 \fBlariza\fP was originally written by Peter Hofmann. The project
 110 was started in June 2014.
 111 .\" --------------------------------------------------------------------
 112 .SH "SEE ALSO"
 113 .BR lariza.usage (1),
 114 .BR tabbed (1).