• A UNIX system with GNU development tools, GTK+/GNOME 1.x (not 2.x).

Depends on GTK+ 1.2.x and GNOME 1.x which modern distros categorize
as obsolete or extra packages (hypersrc begun in 1999).
GTK+/GNOME 2.x isn't backwards-compatible.

hypersrc has been run on:

• Linux distros (1999...2007):
  Ubuntu (Feisty Fawn)
  Fedora 3 (x86-32), Fedora 5 (x86-64)
  Red Hat 6.0, 7.2, 8.0
  Mandrake 8.1
  Debian 3.0 (woody)
• FreeBSD:
  6.2, 4.6.2
• Exuberant ctags 3.2 by Darren Hiebert.

pypersrc won't work with only GNU ctags, but will if Exuberant ctags is
also installed somewhere (and if necessary the -ctags arg is passed).
ctags --version (exctags on FreeBSD) will tell you if it's Exuberant or GNU ctags.
Download Exuberant ctags from my site

To compile and install from source code:

tar xfzv hypersrc*tar.gz
cd hypersrc
./configure.sh
make install

To browse C code, for example, chdir to where your C source files are, and type:

Hypersrc.pl

For further info, see README.txt, Hypersrc -help, and man hypersrc.

Hypersrc.pl -fast
Hypersrc.pl -fast -no-functree

To build an optimized executable (but minus assertions & self-checks):

make speed install

• Functions are missing in the tree view.

• Function tree views are supported only for C/C++ source.
• hypersrc requires the -knr arg to parse K&R style functions.
• Source code heavily infested with #if directives just won't be parsed correctly.
• By design, functions (except C++ inline class methods) whose opening braces
  aren't the first char on the line won't be parsed:

  int foo ( int a ) {
  }
  

• To browse everything in a humongous source tree, such as the Linux 2.4 kernel, hypersrc takes a long time to start and lots of memory.

Yes. See also section about speeding hypersrc.
Try passing any of:

-fast
-no-functree : to skip parsing phase but forfeit tree views of functions
-descend     : to limit the amount of subdirs to descend
-max-tags    : to limit the amount of tags to be processed
-exclude     : to exclude some dirs/files

• hypersrc quits silently while trying to jump to a tag.

Upgrade to GTK+ 1.2.8 if you are using an older version. GTK+ 1.2.3 definitely has a bug which hypersrc encounters. Other old versions might have this bug also. If this problem still persists, as a last resort, try deselecting the preference: "Misc / process GTK+ events while busy". However, be advised the program won't redraw itself while it is busy.

• Sometimes, pressing Enter in a find dialog triggers two searches.

Keyboard rate too fast?

• Cases of mistaken-identity appearing in the "called by" tree:

• Caller really calls a function in another module.

• All functions with the same name as a caller will be shown as other callers, even if some don't really call this function.

Unfortunately, such mistaken-identity problems are inherent in a source code browser, because of the unavailability of compile-time info.

• Rarely, the scrollbar beside a tree will stop working if the tree tries to show too many nodes/leafs.

To compile hypersrc with GDB support, pedantic checking, and verbose warnings:

 make debug install 

To run hypersrc under gdb:

 Hypersrc.pl -gdb 

e.m.a.i.l