madduck's git repository

Every one of the projects in this repository is available at the canonical URL git://<projectpath> — see each project's metadata for the exact URL.

All patches and comments are welcome. Please squash your changes to logical commits before using git-format-patch and git-send-email to If you'd read over the Git project's submission guidelines and adhered to them, I'd be especially grateful.

SSH access, as well as push access can be individually arranged.

If you use my repositories frequently, consider adding the following snippet to ~/.gitconfig and using the third clone URL listed for each project:

[url "git://"]
  insteadOf = madduck: add options for displaying 3 months spanning the date
[etc/awesome.git] /
index 37c2141da70793b0ff81182bc269551997123543..e9dcc0bc84153ab625241f7907997231c71b43a6 100644 (file)
@@ -1,21 +1,33 @@
-# If you have a question
+# Please, read me!
-Take the following steps:
-1. [Google it](
-2. Search [Awesome doc](
-3. Ask [community](
-and, if you still don't have an answer, you can ask here.
-**Please be warned:** if your question is __unrelated__ to this repository, a reply is only an act of kindness.
+So that I can help you quickly and without having to redirect you here.
 # If you have an issue
-**Please read the [wiki]( and search the [Issues section]( first.**
+**Please read the [wiki]( and search the [Issues section]( first.**
 If you can't find a solution there, then go ahead and provide:
 * output of `awesome -v` and `lua -v`
 * expected behavior and actual behavior
 * steps to reproduce the problem
+* X error log
+# How to provide X error log
+There are two ways:
+* (Physically) Restart X like this:
+  ```shell
+  startx -- -keeptty -nolisten tcp > $HOME/.xorg.log 2>&1
+  ```
+  the error log will be output into `$HOME/.xorg.log`.
+* (Virtually) Use [Xephyr](
+  ```shell
+  # set screen size as you like
+  Xephyr :1 -screen 1280x800 2> stdout.txt & DISPLAY=:1 awesome
+  ```
+  the error log will be output in the file `stdout.txt`.
+Before reporting, read the log and see if you can solve it yourself.