Project status: maintained, usable but incomplete, development suspended.

• Updated for FreeBSD 6.2 [2007/05/19].
• Greatly improved GUI with tabbed browsing and paned widgets.
• Faster startup, integrated with Exuberant ctags, multi-threaded.
• Runs on cygwin (need to use "rebaseall", see Problems section below).

pypersrc is an open-source (GNU GPL) GUI program written in Python and C++ for browsing source code. You can click a HTML-like hyperlink to jump to a line in a source code file. pypersrc can display different representations of the same source code.

pypersrc is released under the terms of the GNU General Public License (GPL) Version 2.

• A system with GNU development tools.

• Python 2.3 (or newer).

• Python Tkinter module.

• Python Mega Widgets (Pmw).

Pmw is easy to install: untar it to your Python's site-packages/ dir.

pypersrc has run on:

• Linux: Ubuntu (Feisty Fawn), Fedora 3
• FreeBSD 4.10
• Mac OS X (10.4 Tiger)
• Windows XP with cygwin

 Debian and Ubuntu:
[2007/05/18] Install these dependencies:
apt-get install python-tk python-pmw

  cygwin:
TCL_LIBRARY environment variable must be set:
export TCL_LIBRARY=c:/cygwin/usr/share/tcl8.4
Close all cygwin shells except one, then run "rebaseall"
which makes fork() work on cygwin Python.

To compile, test, and install:

tar xfzv pypersrc*tar.gz
cd pypersrc
./configure.sh
make
out/pypersrc src    # test if it can run
make install

To browse code in a directory:

pypersrc ~/your_src_dir               # defaults to C,C++,Python
pypersrc -l java ~/your_src_dir       # browse Java src only

These are the programming languages that are currently recognized:

-l c c++ java python

• cygwin: to correct the error "*** unable to remap":
• install the package "rebase"
• quit all cygwin programs
• Using the "ash" shell, run "rebaseall"
• Loading text widget with large files is slow (Tk/Tkinter is the bottleneck).

send e.m.a.i.l