You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@allura.apache.org by ke...@apache.org on 2018/04/20 14:34:14 UTC

allura git commit: Add a note to the debug section about how to do it with docker

Repository: allura
Updated Branches:
  refs/heads/master d55220204 -> ab97dbfbe


Add a note to the debug section about how to do it with docker


Project: http://git-wip-us.apache.org/repos/asf/allura/repo
Commit: http://git-wip-us.apache.org/repos/asf/allura/commit/ab97dbfb
Tree: http://git-wip-us.apache.org/repos/asf/allura/tree/ab97dbfb
Diff: http://git-wip-us.apache.org/repos/asf/allura/diff/ab97dbfb

Branch: refs/heads/master
Commit: ab97dbfbe1c931f47cb161466758c352d76bfa03
Parents: d552202
Author: Dave Brondsema <da...@brondsema.net>
Authored: Fri Feb 23 11:31:19 2018 -0500
Committer: Kenton Taylor <kt...@slashdotmedia.com>
Committed: Fri Apr 20 14:33:55 2018 +0000

----------------------------------------------------------------------
 Allura/docs/development/contributing.rst | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/allura/blob/ab97dbfb/Allura/docs/development/contributing.rst
----------------------------------------------------------------------
diff --git a/Allura/docs/development/contributing.rst b/Allura/docs/development/contributing.rst
index 40c6aca..0f4ab92 100644
--- a/Allura/docs/development/contributing.rst
+++ b/Allura/docs/development/contributing.rst
@@ -186,11 +186,23 @@ foreground::
     # taskd
     pkill "^taskd"; paster taskd development.ini --nocapture
 
-Make a request to the web app, and when your line of code is hit, a debug
+Then make a request to the web app, and when your line of code is hit, a debug
 session will start on the console where the process is running.
 
 For more information about using ``pdb``, see the `official documentation
-<http://docs.python.org/2/library/pdb.html>`_.
+<http://docs.python.org/2/library/pdb.html>`_.  ``ipdb`` is version of ``pdb`` with
+support for IPython's tab completion, syntax highlighting etc.  Other debugger packages such
+as ``pudb`` are also available.
+
+.. note::
+
+   To do this with docker, the commands are::
+
+       docker-compose run web pip install ipdb
+       docker-compose stop web taskd
+       docker-compose run --service-ports web gunicorn --reload --paste Allura/docker-dev.ini
+       docker-compose run taskd paster taskd docker-dev.ini --nocapture
+
 
 Testing
 -------