Bug Database

Report any problems encountered to the github issue tracker. (I also maintain a private database at work.)
Below are issues that users have encuontered, with solutions where known.

Troubleshooting

This page serves as a FAQ for issues that users have encountered. Many of these issues are not bugs. Please make sure you fulfill the requirements listed on the Source page.

Configuration (configure)

Awk

Several linux distros default to mawk as the baseline version of awk. Unfortunately, mawk is horribly buggy and rejects valid input, and has been blacklisted from support. (Recent configure scripts will outright reject mawk.) Either make sure some other POSIX-compliant awk (such as gawk) can be found in your PATH, or explicitly pass AWK=good-awk to configure.

Ncurses/Readline

The configure script searches for tputs, a symbol needed by readline and editline. If this symbol is not found, and assuming you actually have the library installed, locate your ncurses library and inspect the symbol table with nm or objdump -T. If ncurses is in a nonstandard location, pass the root directory to the configure option --with-ncurses=PATH.
Update: This was fixed by checking for the symbol with C linkage instead of C++ linkage, as of 2010-03-10.

Cygwin

Disclaimer: cygwin has not been tested for quite some time (used to work once), but has not been actively tested. (Hint: get a real *nix OS)
Issues:

Compile (make)

GCC errors

Most of the diagnostics you may encounter are due to the extremely anal-retentive warning flags that I compile with by default.

Lexer Generator (flex)

Make sure you are using a version of flex from 2.5.4 to 2.5.31. Newer versions are known to fail horribly (crash) with HACKT (probably due to the extreme hackery I perform on the generated code to make it re-entrant).

Tests (make check.log)

Some failed tests that you might see in the check.log are considered "not real failures".

Installation (make install; make installcheck)

It was discovered that the installation of the shared libraries in src/ may fail (target: install-pkglibLTLIBRARIES) because install-time re-linking is order-sensitive (known automake deficiency); dependent libraries must be installed first.
Update: The ordering was fixed as of 2010-03-10.

Run-time Issues