diff --git a/server/clients.c b/server/clients.c index 49ed48d..088c345 100644 --- a/server/clients.c +++ b/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. diff --git a/server/render.c b/server/render.c index a8796b2..c68b953 100644 --- a/server/render.c +++ b/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 diff --git a/server/screen.c b/server/screen.c index c70f500..9533fb8 100644 --- a/server/screen.c +++ b/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. diff --git a/server/serverscreens.c b/server/serverscreens.c index db4565d..2fd21cf 100644 --- a/server/serverscreens.c +++ b/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. diff --git a/server/sock.c b/server/sock.c index 9222edb..8e7fa3c 100644 --- a/server/sock.c +++ b/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. diff --git a/server/widget.c b/server/widget.c index f8323b2..651a76d 100644 --- a/server/widget.c +++ b/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.