From 8776679111e15ae5522d42a5f92993a57d71832c Mon Sep 17 00:00:00 2001 From: Dieter Plaetinck Date: Mon, 4 May 2009 20:04:05 +0200 Subject: bookmarks location update + slight fixes re INSTALL file --- INSTALL | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 50 insertions(+) create mode 100644 INSTALL (limited to 'INSTALL') diff --git a/INSTALL b/INSTALL new file mode 100644 index 0000000..decf316 --- /dev/null +++ b/INSTALL @@ -0,0 +1,50 @@ +Arch Linux +---------- +[Arch Linux](http://www.archlinux.org) is our distro of choice, and the distro we use for testing. + +You can find a [PKGBUILD](http://aur.archlinux.org/packages.php?ID=25972) on the AUR, which installs the latest +from the master branch. You can edit the PKGBUILD to change to any other +branch you want. + +From source +----------- + $ git clone git://github.com/Dieterbe/uzbl.git + [ $ git checkout master/experimental ] # master == fairly stable. experimental is more bleeding edge + $ cd uzbl + $ make + $ sudo make install + +Dependencies +------------ +* git (for downloading) +* pkgconfig (for Make/gcc) +* libwebkit 1.1.4 or higher +* libsoup 2.24 or higher (dep for webkit/gtk+) +* gtk 2 something something + +Optional/Recommended +-------------------- +The following tools are quite useful, and some of them are used in the +sample scripts: + +* dmenu +* zenity +* bash + +File locations +-------------- +After installing - using either method - you will find: + +* /usr/bin : uzbl [and uzblctrl] +* /usr/share/uzbl/docs/ : documentation files included with uzbl. (readme, checklist, .. ) +* /usr/share/uzbl/examples: sample scripts, config files and a sample data (boomarks, .. ) + +You will probably want to change the scripts to behave more like you want, so copy the scripts to your home dir. If you save your config as +$XDG\_CONFIG\_HOME/uzbl/config (this expands to ~/.config/uzbl/config on most systems) it will be recognized automatically. You can also pass the path to +the config file with the --config parameter. + +You're free to store your personal stuff where you want, but we think the [XDG basedir spec](http://standards.freedesktop.org/basedir-spec/basedir-spec-0.6.html) +is very useful for keeping a clean home directory, so we recommend: + +* $XDG\_CONFIG\_HOME/uzbl/config* (~/.config/uzbl/config on most systems): config file +* $XDG\_DATA\_HOME/uzbl (~/.local/share/uzbl on most systems): bookmarks file, history file. and "scripts" directory with scripts \ No newline at end of file -- cgit v1.2.3