diff --git a/doc/faq.rst b/doc/faq.rst
index cde88d8..7a043e3 100644
--- a/doc/faq.rst
+++ b/doc/faq.rst
@@ -1,2 +1,14 @@
 FAQ
 ===
+
+Set colors have no effect
+-------------------------
+
+If you want to overwrite a color you need to make sure that you either escape
+the hash tag or put the new value between paranthesis.
+
+::
+
+  set color red
+  set color \#000000
+  set color "#000000"
diff --git a/doc/usage/index.rst b/doc/usage/index.rst
index 874d358..1480c5e 100644
--- a/doc/usage/index.rst
+++ b/doc/usage/index.rst
@@ -6,3 +6,4 @@ Commandline invocation
 ======================
 
 .. include:: ../man/_synopsis.txt
+.. include:: ../man/_options.txt