2010-12-28 Michael Snyder <msnyder@vmware.com>

	* event-loop.c: Comment clean-up.
	* event-loop.h: Ditto.
	* event-top.c: Ditto.
	* gdb.c: Ditto.
	* gdb.h: Ditto.
	* main.c: Ditto.
	* top.c: Ditto.
	* top.h: Ditto.

1 files changed, 19 insertions, 15 deletions

diff --git a/gdb/event-loop.h b/gdb/event-loop.h
index 9a61d91..501a56e 100644
--- a/gdb/event-loop.h
+++ b/gdb/event-loop.h
@@ -18,18 +18,18 @@
    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
 
-/* An event loop listens for events from multiple event sources. When
+/* An event loop listens for events from multiple event sources.  When
    an event arrives, it is queued and processed by calling the
-   appropriate event handler. The event loop then continues to listen
-   for more events. An event loop completes when there are no event
+   appropriate event handler.  The event loop then continues to listen
+   for more events.  An event loop completes when there are no event
    sources to listen on.  External event sources can be plugged into
    the loop.
 
    There are 4 main components:
-   - a list of file descriptors to be monitored, GDB_NOTIFIER.  
+   - a list of file descriptors to be monitored, GDB_NOTIFIER.
    - a list of asynchronous event sources to be monitored,
      ASYNC_EVENT_HANDLER_LIST.
-   - a list of events that have occurred, EVENT_QUEUE.  
+   - a list of events that have occurred, EVENT_QUEUE.
    - a list of signal handling functions, SIGHANDLER_LIST.
 
    GDB_NOTIFIER keeps track of the file descriptor based event
@@ -64,9 +64,9 @@
    functions that are invoked through traditional signal handlers.
    The actions to be taken is response to such events will be executed
    when the SIGHANDLER_LIST is scanned, the next time through the
-   infinite loop.  
+   infinite loop.
 
-   Corollary tasks are the creation and deletion of event sources. */
+   Corollary tasks are the creation and deletion of event sources.  */
 
 typedef void *gdb_client_data;
 struct async_signal_handler;
@@ -76,14 +76,14 @@ typedef void (sig_handler_func) (gdb_client_data);
 typedef void (async_event_handler_func) (gdb_client_data);
 typedef void (timer_handler_func) (gdb_client_data);
 
-/* Where to add an event onto the event queue, by queue_event. */
+/* Where to add an event onto the event queue, by queue_event.  */
 typedef enum
   {
-    /* Add at tail of queue. It will be processed in first in first
-       out order. */
+    /* Add at tail of queue.  It will be processed in first in first
+       out order.  */
     TAIL,
-    /* Add at head of queue. It will be processed in last in first out
-       order. */
+    /* Add at head of queue.  It will be processed in last in first
+       out order.  */
     HEAD
   }
 queue_position;
@@ -93,11 +93,15 @@ queue_position;
 extern void start_event_loop (void);
 extern int gdb_do_one_event (void *data);
 extern void delete_file_handler (int fd);
-extern void add_file_handler (int fd, handler_func * proc, gdb_client_data client_data);
+extern void add_file_handler (int fd, handler_func *proc, 
+			      gdb_client_data client_data);
 extern struct async_signal_handler *
-  create_async_signal_handler (sig_handler_func * proc, gdb_client_data client_data);
+  create_async_signal_handler (sig_handler_func *proc, 
+			       gdb_client_data client_data);
 extern void delete_async_signal_handler (struct async_signal_handler **async_handler_ptr);
-extern int create_timer (int milliseconds, timer_handler_func * proc, gdb_client_data client_data);
+extern int create_timer (int milliseconds, 
+			 timer_handler_func *proc, 
+			 gdb_client_data client_data);
 extern void delete_timer (int id);
 
 /* Call the handler from HANDLER immediately.  This function