Turning On or Off Document Source Debugging

The AnswerBook2 server has a debugging option that, when enabled, displays unrecognized markup in the book source in red with the word "BUG" in the viewer. This function helps to identify problems if a book does not display as expected.

To turn on debugging, log in as root to the documentation server's system and set the environment variable AB2_DEBUG to 1. For example:

% su -
# setenv AB2_DEBUG 1

To turn off debugging, log in as root to the documentation server's system and set the environment variable AB2_DEBUG to 0. For example:

% su -
# setenv AB2_DEBUG 0

After you change the debugging parameter, you must restart the documentation server. To restart the documentation server, type:

# /usr/lib/ab2/bin/ab2admin -o restart

To control debugging when you start up the server, use the following form of the start-up command:

# /usr/lib/ab2/bin/ab2admin -o start -D