aboutsummaryrefslogtreecommitdiffhomepage
path: root/docs/FAQ
diff options
context:
space:
mode:
authorGravatar Dieter Plaetinck <dieter@plaetinck.be>2009-07-11 11:23:21 +0200
committerGravatar Dieter Plaetinck <dieter@plaetinck.be>2009-07-11 11:23:21 +0200
commit2161d9ef902c2701376ae9d8e46db176491d3fdc (patch)
tree9b78a92e5442e4145a8f2755b4d92839f8b2dd4d /docs/FAQ
parent3cac3354ab709d1dd659f7d2e657ce9ea53348aa (diff)
faq entry about default usability
Diffstat (limited to 'docs/FAQ')
-rw-r--r--docs/FAQ20
1 files changed, 19 insertions, 1 deletions
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