A.1 Debug Information

Before getting to the core functions of the C client, we note that they can each generate some debug information to stderr. This information is generally helpful, especially in diagnosing problems; you should probably not disable it. However, a function is provided for adjusting the amount of debug information that is printed:

  /*
   * use this to turn off debug ouput.
   *
   * higher numbers are more output, 0 is none.
   *
   * incidentally, if <level> is -1, it returns the current level and
   * the current level is unchanged
   */
  int player_debug_level(int level);

The default debug level is 5, which prints all messages. This same function is used to vary the debug output from the C++ client, since it is built on top of the C client.