manpage: document killing of windows better (Thanks Moredread)

diff --git a/man/i3.man b/man/i3.man
index 43102164e78c1c17a5e2b28d8e416e64ec935ac8..cf592c62f4b6b3e771cecd393a8c0d20d270f5fd 100644 (file)
--- a/man/i3.man
+++ b/man/i3.man
@@ -113,7 +113,10 @@ Mod1+t::
 Select the first tiling window if the current window is floating and vice-versa.
 
 Mod1+Shift+q::
-Kills the current client.
+Kills the current window. This is equivalent to "clicking on the close button", meaning a polite
+request to the application to close this window. For example, Firefox will save its session
+upon such a request. If the application does not support that, the window will be killed and
+it depends on the application what happens.
 
 Mod1+Shift+r::
 Restarts i3 in place (without losing any windows, but the layout).
@@ -262,6 +265,14 @@ exec /usr/bin/i3 >> ~/.i3/logfile
 There is still lot of work to do. Please check our bugtracker for up-to-date information
 about tasks which are still not finished.
 
+== SEE ALSO
+
+You should have a copy of the userguide (featuring nice screenshots/graphics which is why this
+is not integrated into this manpage), the debugging guide and the "how to hack" guide. If you
+are building from source, run +make -C docs+.
+
+You can also access these documents online at http://i3.zekjur.net/
+
 == AUTHOR
 
 Michael Stapelberg and contributors