docs about debugging

docs/usage/debugging.rst

@@ -0,0 +1,25 b''
+.. _debugging:
+
+===================
+DEBUGGING RHODECODE
+===================
+
+If you encountered problems with RhodeCode here are some instructions how to
+possibly debug them.
+
+** First make sure you're using the latest version available.**
+
+enable detailed debug
+---------------------
+
+RhodeCode uses standard python logging modules to log it's output.
+By default only loggers with INFO level are displayed. To enable full output
+change `level = DEBUG` for all logging handlers in currently used .ini file. 
+After this you can check much more detailed output of actions happening on 
+RhodeCode system.
+
+
+enable interactive debug mode
+-----------------------------
+
+To enable interactive debug mode simply 

docs/index.rst

@@ -1,59 +1,60 b''
 .. _index:
 
 .. include:: ./../README.rst
 
 Users Guide
 -----------
 
 **Installation:**
 
 .. toctree::
    :maxdepth: 1
 
    installation
    setup
    upgrade
    
 **Usage**
 
 .. toctree::
    :maxdepth: 1
 
    usage/general
    usage/git_support
    usage/statistics
    usage/backup
+   usage/debugging
    
 **Develop**
 
 .. toctree::
    :maxdepth: 1
    
    contributing
    changelog
 
 **API**
 
 .. toctree::
    :maxdepth: 1
 
    api/api
    api/models
    
 
 Other topics
 ------------
 
 * :ref:`genindex`
 * :ref:`search`
 
 .. _virtualenv: http://pypi.python.org/pypi/virtualenv
 .. _python: http://www.python.org/
 .. _django: http://www.djangoproject.com/
 .. _mercurial: http://mercurial.selenic.com/
 .. _bitbucket: http://bitbucket.org/
 .. _subversion: http://subversion.tigris.org/
 .. _git: http://git-scm.com/
 .. _celery: http://celeryproject.org/
 .. _Sphinx: http://sphinx.pocoo.org/
 .. _vcs: http://pypi.python.org/pypi/vcs
  No newline at end of file