Added documentation for the changes in this branch

1 files changed, 16 insertions, 2 deletions

diff --git a/README b/README
index d6473bf..37259c6 100644
--- a/README
+++ b/README
@@ -297,8 +297,7 @@ file).
   expanded).
 * `title_format_short`: titlebar string when statusbar shown (will be expanded).
 * `icon`: path to icon for Gtk.
-* `window_role`: Window role string. By default there is no role. This string
-  is only used by some advanced window managers.
+* `window_role`: Window role string. By default there is no role.
 * `forward_keys`: Whether `uzbl-core` should send key events to the webkit view.
 * `cookie_handler`: Handler called when the page requests a cookie to be
   retrieved or set. Appends the following arguments to the standard handler
@@ -602,6 +601,21 @@ This script tries to authenticate as user alice with password wonderland once
 and never retries authentication.
 See examples for more sofisticated, interactive authentication handler.
 
+### WINDOW MANAGER INTEGRATION
+
+As mentined before, the contents of the window title can be customized by
+setting the `title_format_short` variable and the `title_format_long` variable
+(see above to figure out when each of them is used). You can also set `icon`
+variable to path of the icon file. Some advanced window managers can also take
+`WM_WINDOW_ROLE` in account, which can be set by modifying `window_role`
+variable.
+
+There is currently no support of updating window icon automatically to site's
+favicon, but there are some scripts for that at wiki pages.
+
+Uzbl sets special X window property UZBL_URI which is always the uri of the
+page loaded into uzbl, except for web inspector windows which has no UZBL_URI.
+
 ### EVENTS
 
 Unlike commands, events are not handled in `uzbl` itself, but are propagated