From 2161d9ef902c2701376ae9d8e46db176491d3fdc Mon Sep 17 00:00:00 2001 From: Dieter Plaetinck Date: Sat, 11 Jul 2009 11:23:21 +0200 Subject: faq entry about default usability --- docs/FAQ | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) (limited to 'docs') diff --git a/docs/FAQ b/docs/FAQ index 1ecce41..84f9a9f 100644 --- a/docs/FAQ +++ b/docs/FAQ @@ -4,7 +4,6 @@ FAQ ### I just installed uzbl but it doesn't do much. What now? Uzbl includes very limited default settings (statusbar settings, but no keybinds, history/download handlers etc.) Look at /usr/share/uzbl/docs/config.h to see the default settings. -Neither does uzbl create a default config file on startup like some other programs do because we want to give you the freedom to place your config where you want, and to use a config or not. Have a look in /usr/share/uzbl/examples/configs to see what you can do. If you save a config as $XDG\_CONFIG\_HOME/uzbl/config it will be loaded automatically. Running with the `--verbose` flag on a command line can also be interesting. @@ -14,6 +13,25 @@ It will temporarily override your $XDG\_CONFIG\_HOME and $XDG\_DATA\_HOME variables so you can try the sample stuff directly in /usr/share/uzbl/examples. If you like what you can do, you can copy the sample stuff into your ~ and edit to your liking. +### Why don't you just use a reasonable config by default? +We actually did some attempts to make uzbl "usable by default" but in the +end we had to conclude it cannot be done because of the following reasons: + * We don't want to store anything "automagically" in the users home. + Some people prefer different file/directory layouts, most of just want to + control the files in $HOME themselves. + * We considered the option of having a global '/etc/uzbl' which user + specific ones could override but that would overcomplicate things. + * We adhere to the [FHS](http://www.pathname.com/fhs/) (`man hier`), so + `uzbl -c /usr/share/...` is not an option. + +So even though we would like to make uzbl more usable by default, we think +there is no sensible way to do it. Maybe downstream packagers could provide +a note that users could copy the examples from /usr/share/uzbl/examples into +their homes, because really, that's all that is needed if you want it to +just "work" without controlling how yourself. (unless you have no +xdg variables set, in which case you should be smart enough to edit the sample +config yourself). + ### Where is the location bar? How do I change the URL ? Uzbl has no location bar. All changes to the uri (editing of current uri, typing new uri, loading of uri from bookmarks/history/...) happens *outside* of uzbl. Have a look at the sample scripts in /usr/share/uzbl/examples. Most of our examples use dmenu which is a nifty little tool to pick an item from a list of items (very -- cgit v1.2.3