doc: update :func: to :py:func: for modern Sphinx.
[be.git] / doc / hacking.txt
index 4c5a4640b2886677bbd121be23911add887d4033..2684597a5ee12b5d2c292e0dcc6e1326b2da3461 100644 (file)
@@ -72,7 +72,7 @@ execution + childrens' times)::
     $ python -c "import pstats; p=pstats.Stats('profile'); p.sort_stats('cumulative').print_stats(20)"
 
 If you want to find out who's calling your expensive function
-(e.g. :func:`libbe.util.subproc.invoke`), try::
+(e.g. :py:func:`libbe.util.subproc.invoke`), try::
 
     $ python -c "import pstats; p=pstats.Stats('profile'); p.sort_stats('cumulative').print_callers(20)"
 
@@ -82,3 +82,7 @@ You can also toss::
     print >> sys.stderr, '-'*60, '\n', '\n'.join(traceback.format_stack()[-10:])
 
 into the function itself for a depth-first caller list.
+
+For a more top-down approach, try::
+
+    $ python -c "import pstats; p=pstats.Stats('profile'); p.sort_stats('cumulative').print_callees(20)"