Update file authorship, license, and description in Doxygen style.

Any authorship, copyright, or license information previously present
has been preserved.  Where appropriate, this information has also
been propagated to new files (for example from a source file to its
header file).

1 files changed, 43 insertions, 0 deletions

diff --git a/src/display.c b/src/display.c
index 725c71d..b72a919 100644
--- a/src/display.c
+++ b/src/display.c
@@ -1,3 +1,46 @@
+/**
+ * @file
+ * @section AUTHORS
+ *
+ * Copyright (C) 2002-2004 Norman Feske <nf2@os.inf.tu-dresden.de>
+ *
+ *  Authors:
+ *       Eamon Walsh <ewalsh@tycho.nsa.gov>
+ *       Norman Feske <nf2@inf.tu-dresden.de>
+ *
+ * @section LICENSE
+ *
+ *  This program is free software; you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation; under version 2 of the License.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License along
+ *  with this program; if not, write to the Free Software Foundation, Inc.,
+ *  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * @section DESCRIPTION
+ *
+ * This is the implementation of the DirectFB-based display presentation.
+ * As buffer and view objects are created and manipulated by clients, callbacks
+ * are made into this file that update the objects for presentation; these
+ * callbacks have names prefixed display_buffer_ and display_view_.
+ *
+ * A new buffer creation causes an instantiation of a "display object" with 3
+ * types: bclient, sclient, or dclient.  These are the objects that the
+ * switcher cycles through.  Each object has a list of views associated with
+ * it, which may originate from different buffers (combined desktop).
+ *
+ * This code also handles the secure attention keys that cause the switcher to
+ * activate, the security bar, view decorations and mouse cursor annotation,
+ * and the "notification icons" that pop up when events of interest occur, such
+ * as a client object appearing or disappearing (guest startup/shutdown).
+ */
+
 #include <sys/types.h>
 #include <stdlib.h>
 #include <stdio.h>