summaryrefslogtreecommitdiffstats
path: root/development/pudb/README
diff options
context:
space:
mode:
author David Woodfall2018-05-21 13:33:14 +0200
committer Willy Sudiarto Raharjo2018-05-26 01:59:22 +0200
commit3060d96712bd49723b46c7064b3cfb50ea5bb9fe (patch)
tree05ca14447f9e3944eb8ea5026f48f48bbe903ef2 /development/pudb/README
parenta37a693952fd1efaf9278add1957ec957010f48b (diff)
downloadslackbuilds-3060d96712bd49723b46c7064b3cfb50ea5bb9fe.tar.gz
development/pudb: Updated for version 2017.1.4 + new maintainer.
Signed-off-by: David Spencer <idlemoor@slackbuilds.org>
Diffstat (limited to 'development/pudb/README')
-rw-r--r--development/pudb/README53
1 files changed, 49 insertions, 4 deletions
diff --git a/development/pudb/README b/development/pudb/README
index 9cafb649d7..253788f594 100644
--- a/development/pudb/README
+++ b/development/pudb/README
@@ -1,7 +1,52 @@
PuDB is a full-screen, console-based visual debugger for Python.
-Its goal is to provide all the niceties of modern GUI-based debuggers in a
-more lightweight and keyboard-friendly package. PuDB allows you to debug
-code right where you write and test it--in a terminal. If you've worked
-with the excellent (but nowadays ancient) DOS-based Turbo Pascal or C
+Its goal is to provide all the niceties of modern GUI-based debuggers in a
+more lightweight and keyboard-friendly package. PuDB allows you to debug
+code right where you write and test it--in a terminal. If you've worked
+with the excellent (but nowadays ancient) DOS-based Turbo Pascal or C
tools, PuDB's UI might look familiar.
+
+By default this SlackBuild builds the python2 debugger, and if python3 is
+detected, the python3 version too. The Pygments SlackBuild will automatically
+install for python3 too.
+
+NOTE: The python3 application is named pudb3.
+NOTE: You need python3-urwid installed to use pudb3.
+
+OPTIONS
+
+To *ONLY* build the python2 version, use:
+
+NO_PYTHON3=1 ./pudb.SlackBuild
+
+To *ONLY* build the python3 version, use:
+
+NO_PYTHON2=1 ./pudb.SlackBuild
+
+The python2 version requires a newer version of urwid than the stock Slackware
+one, therefore this also builds a custom urwid named py2_urwid, which it can
+use. This should not conflict with the stock Slackware version.
+
+OPTIONAL DEPENDENCIES
+
+python3-urwid for the python3 version. Note that it will still build without
+this, so it can be installed later if needed.
+
+###############################################################################
+
+GETTING STARTED
+
+Please see starting.rst usage.rst misc.rst and shells.rst in
+/usr/doc/pudb-$VERSION to get started, and also -
+
+Online docs:
+
+https://documen.tician.de/pudb/
+
+A simple, but useful, illustrated example page:
+
+http://heather.cs.ucdavis.edu/~matloff/pudb.html
+
+Github page:
+
+https://github.com/inducer/pudb