faq entry about default usability
authorDieter Plaetinck <dieter@plaetinck.be>
Sat, 11 Jul 2009 09:23:21 +0000 (11:23 +0200)
committerDieter Plaetinck <dieter@plaetinck.be>
Sat, 11 Jul 2009 09:23:21 +0000 (11:23 +0200)
docs/FAQ

index 1ecce41..84f9a9f 100644 (file)
--- 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