Cleanup and documentation updates:

- Remove shared/str.h where not used.
- Remove shared/debug.h from all files as it has been completely replaced
  by shared/report.h (it will be removed later).
- Add more doxygen comments to shared/* and clients/lcdproc/*.
- Include static functions in doxygen output.

clients/lcdproc/mode.h

@@ -1,14 +1,9 @@
 #ifndef MODE_H
 #define MODE_H
 
-#include "main.h"
-
-
 int mode_init(void);
 void mode_close(void);
-
 int update_screen(ScreenMode *m, int display);
-
 int credit_screen(int rep, int display, int *flags_ptr);
 
 #endif