[conga-luci-1stgen] RHEL5-active: luci/MAINTAINERS.rst: add stunnel debugging + small enhancements (358f770)

[Jan Pokorný]

Repository : http://git.fedorahosted.org/git/?p=conga-luci-1stgen.git

On branch  : RHEL5-active

> ---------------------------------------------------------------
commit 358f7704444e5d00b5faeb4be1035a704e4ef5c8
Author: Jan Pokorný <jpokorny(a)redhat.com&gt;
Date:   Mon Mar 3 19:36:10 2014 +0100

    luci/MAINTAINERS.rst: add stunnel debugging + small enhancements
    
    Signed-off-by: Jan Pokorný <jpokorny(a)redhat.com&gt;


> ---------------------------------------------------------------
 luci/MAINTAINERS.rst |   12 +++++++++++-
 1 files changed, 11 insertions(+), 1 deletions(-)

diff --git a/luci/MAINTAINERS.rst b/luci/MAINTAINERS.rst
index ba8cba1..2dfaa85 100644
--- a/luci/MAINTAINERS.rst
+++ b/luci/MAINTAINERS.rst
@@ -8,6 +8,15 @@ Brief intro into debugging
 
 This does not cover all possible scenarios, but is pretty generetic.
 
+Let's start with easier part, stunnel debugging:
+
+1. while luci service is running::
+        # pkill -u luci stunnel
+        # cat <(echo 'foreground=yes; debug=7' | tr ';' '\n')
\
+          /var/lib/luci/etc/stunnel.conf | stunnel -fd 0
+
+That's it, stunnel will run verbosely on the foreground.  Now Plone/Zope:
+
 1. install luci RPM
 2. run this to generate SSL key, etc.::
         # service luci start && service luci stop
@@ -27,7 +36,7 @@ This does not cover all possible scenarios, but is pretty generetic.
    which is a foreground mode of the application throwing log messages
    directly into the terminal; escape with Ctrl-C as usual
 
-Before step 4., you may want place debugger-activating "denotators"
+Before step 4., you may want plant debugger-activating "denotators"
 into respective code; for instance::
 
         import pdb; pdb.set_trace()
@@ -59,6 +68,7 @@ and the following (practice-proven) breakpoints may be handy::
 
         pdb> b /usr/lib64/luci/zope/lib/python/ZPublisher/mapply.py:88
         pdb> b /usr/lib64/luci/zope/lib/python/Products/CMFCore/FSPythonScript.py:112
+        pdb> b /usr/lib64/luci/zope/lib/python/TAL/TALInterpreter.py:281
 
         pdb> b /usr/lib64/luci/zope/lib/python/zope/interface/adapter.py:484
         pdb> b /usr/lib64/luci/zope/lib/python/zope/app/traversing/namespace.py:362