summaryrefslogtreecommitdiff
path: root/doc/source/misc/troubleshooting.rst
diff options
context:
space:
mode:
authormathieui <mathieui@mathieui.net>2014-02-14 01:37:18 +0100
committermathieui <mathieui@mathieui.net>2014-02-14 01:37:18 +0100
commit77811e91b4bb78e25ab6b9c7de04586bf3c784f3 (patch)
treec2642587114f4ad6b118a79be2afde8ccb3a2cd3 /doc/source/misc/troubleshooting.rst
parent384fd3e029d0910a9be5165375b446a2ace17bd0 (diff)
downloadpoezio-77811e91b4bb78e25ab6b9c7de04586bf3c784f3.tar.gz
poezio-77811e91b4bb78e25ab6b9c7de04586bf3c784f3.tar.bz2
poezio-77811e91b4bb78e25ab6b9c7de04586bf3c784f3.tar.xz
poezio-77811e91b4bb78e25ab6b9c7de04586bf3c784f3.zip
Documentation update
Diffstat (limited to 'doc/source/misc/troubleshooting.rst')
-rw-r--r--doc/source/misc/troubleshooting.rst50
1 files changed, 50 insertions, 0 deletions
diff --git a/doc/source/misc/troubleshooting.rst b/doc/source/misc/troubleshooting.rst
new file mode 100644
index 00000000..ae2494d2
--- /dev/null
+++ b/doc/source/misc/troubleshooting.rst
@@ -0,0 +1,50 @@
+Troubleshooting
+===============
+
+I cannot connect.
+-----------------
+
+1. Check that you are still connected to the internet.
+2. Double-check your credentials.
+3. Check the :ref:`security settings <security settings>`, maybe your server does not support encryption, or only with weak parameters.
+4. Maybe your DNS are wrong, try setting the :term:`custom_host` option with the server IP.
+5. Overzealous firewall?
+6. Running poezio with -d file.txt (debug mode) might reveal your issues.
+7. Come see us from the `web client`_ to discuss your issues further.
+
+
+The outline of poezio is not displayed and unicode characters are broken
+------------------------------------------------------------------------
+We believe we (or unrelated people) have reported the bug of python3 compiled against the wrong
+ncurses to every_ significant_ distribution_ `out there`_, but if there is still
+one with it, please go ahead and report it.
+
+Poezio tracebacks with weird encoding errors
+--------------------------------------------
+Please check your locale for utf-8 compatibility.
+
+Reconnecting sucks
+------------------
+We know.
+
+Some weird graphical glitches appear once in a blue moon and go away after a refresh
+------------------------------------------------------------------------------------
+We know.
+
+Python is too heavy
+-------------------
+We know. It’s too late to change that. If you are running your XMPP client on a toaster,
+please try mcabber_.
+
+
+Other issues
+------------
+Some things may appear in ``$XDG_DATA_HOME/poezio/errors.log``.
+
+
+.. _web client: https://jappix.com/?r=poezio@muc.poezio.eu
+.. _mcabber: http://mcabber.com/
+.. _every: https://bugs.mageia.org/show_bug.cgi?id=2156
+.. _significant: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=602720
+.. _distribution: https://bugzilla.redhat.com/show_bug.cgi?id=539917
+.. _out there: https://bugs.launchpad.net/ubuntu/+source/python3.2/+bug/789732