Add some more meaningful comments I found in an old file on the lcdproc.org

web site.

server/clients.c

@@ -1,6 +1,8 @@
 /** \file server/clients.c
- * Manage the list of clients that are connected.
- * Init/shut down client system, and search for clients in the list.
+ * This file contains code allowing LCDd to handle client connections and
+ * data structures. It contains functions to initialize the internal list
+ * of clients, terminate client connections, add new clients to the list,
+ * and locating a client's socket.
  */
 
 /* This file is part of LCDd, the lcdproc server.

server/render.c

@@ -1,5 +1,8 @@
 /** \file server/render.c
- * Draws screens on the LCD.
+ * This file contains code that actually generates the full screen data to
+ * send to the LCD. render_screen() takes a screen definition and calls
+ * render_frame() which in turn builds the screen according to the definition.
+ * It may recursively call itself (for nested frames).
  *
  * This needs to be greatly expanded and redone for greater flexibility.
  * For example, it should support multiple screen sizes, more flexible

server/screen.c

@@ -1,5 +1,7 @@
 /** \file server/screen.c
- * Does screen management.
+ * This file stores all the screen definition-handling code. Functions here
+ * provide means to create new screens and destroy existing ones. Screens are
+ * identified by client and by the client's own identifiers for screens.
  */
 
 /* This file is part of LCDd, the lcdproc server.

server/serverscreens.c

@@ -1,5 +1,12 @@
 /** \file server/serverscreens.c
- * Implement the serverscreens.
+ * This file contains code to allow the server to generate its own screens.
+ * Currently, the startup, goodbye and server status screen are provided. The
+ * server status screen shows total number of connected clients, and the
+ * combined total of screens they provide.
+ *
+ * It is interesting to note that the server creates a special screen
+ * definition for its screens, but uses the same widget set made available
+ * to clients.
  */
 
 /* This file is part of LCDd, the lcdproc server.

server/sock.c

@@ -1,5 +1,9 @@
 /** \file server/sock.c
- * LCDproc sockets code.
+ * This file contains all the sockets code used by the server. This contains
+ * the code called upon by main() to initialize the listening socket, as well
+ * as code to deal with sending messages to clients, maintaining connections,
+ * accepting new connections, closing dead connections (or connections
+ * associated with dying/exiting clients), etc.
  */
 
 /* This file is part of LCDd, the lcdproc server.

server/widget.c

@@ -1,5 +1,8 @@
 /** \file server/widget.c
- * Does all actions on widgets
+ * This file houses code that handles the creation and destruction of widget
+ * objects for the server. These functions are called from the command parser
+ * storing the specified widget in a generic container that is parsed later
+ * by the screen renderer.
  */
 
 /* This file is part of LCDd, the lcdproc server.