brl/mutter
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

change comments from /*! to /** because the other way makes doxygen think

Browse Source 
2008-01-12  Thomas Thurman  <tthurman@gnome.org>

        * src/core/display.c: change comments from /*! to /** because the
          other way makes doxygen think they are Qt comments, which messes
          up brief descriptions.
        * Doxyfile: check in so other people can generate documentation too.
                                                                             

svn path=/trunk/; revision=3513
This commit is contained in:
Thomas Thurman 2008-01-13 01:01:21 +00:00 committed by Thomas James Alexander Thurman
parent 4419430a57
commit a4d657a324
3 changed files with 1335 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
ChangeLog
View File

@ -1,3 +1,10 @@
2008-01-12 Thomas Thurman <tthurman@gnome.org>
* src/core/display.c: change comments from /*! to /** because the
other way makes doxygen think they are Qt comments, which messes
up brief descriptions.
* Doxyfile: check in so other people can generate documentation too.
2008-01-07 Thomas Thurman <tthurman@gnome.org> 2008-01-07 Thomas Thurman <tthurman@gnome.org>
* src/core/display.c: further commenting (trying to keep comment * src/core/display.c: further commenting (trying to keep comment

1297
Doxyfile Normal file
View File

File diff suppressed because it is too large Load Diff

47
src/core/display.c
View File

@ -1,4 +1,4 @@
/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */ * -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
/* Metacity X display handler */ /* Metacity X display handler */
@ -25,7 +25,8 @@
*/ */
/*! \file display.c /**
* \file display.c
* *
* \brief Handles operations on an X display. * \brief Handles operations on an X display.
* *
@ -94,7 +95,8 @@
g == META_GRAB_OP_KEYBOARD_ESCAPING_DOCK || \ g == META_GRAB_OP_KEYBOARD_ESCAPING_DOCK || \
g == META_GRAB_OP_KEYBOARD_ESCAPING_GROUP) g == META_GRAB_OP_KEYBOARD_ESCAPING_GROUP)
/*! \defgroup pings Pings /**
* \defgroup pings Pings
* *
* Sometimes we want to see whether a window is responding, * Sometimes we want to see whether a window is responding,
* so we send it a "ping" message and see whether it sends us back a "pong" * so we send it a "ping" message and see whether it sends us back a "pong"
@ -108,7 +110,8 @@
* that we're never going to do so and simplify it a bit. * that we're never going to do so and simplify it a bit.
*/ */
/*! Describes a ping on a window. When we send a ping to a window, we build /**
* Describes a ping on a window. When we send a ping to a window, we build
* one of these structs, and it eventually gets passed to the timeout function * one of these structs, and it eventually gets passed to the timeout function
* or to the function which handles the response from the window. If the window * or to the function which handles the response from the window. If the window
* does or doesn't respond to the ping, we use this information to deal with * does or doesn't respond to the ping, we use this information to deal with
@ -163,7 +166,8 @@ static void sanity_check_timestamps (MetaDisplay *display,
MetaGroup* get_focussed_group (MetaDisplay *display); MetaGroup* get_focussed_group (MetaDisplay *display);
/*! Destructor for MetaPingData structs. Will destroy the /**
* Destructor for MetaPingData structs. Will destroy the
* event source for the struct as well. * event source for the struct as well.
* *
* \ingroup pings * \ingroup pings
@ -178,7 +182,8 @@ ping_data_free (MetaPingData *ping_data)
g_free (ping_data); g_free (ping_data);
} }
/*! Frees every pending ping structure for the given X window on the /**
* Frees every pending ping structure for the given X window on the
* given display. This means that we also destroy the timeouts. * given display. This means that we also destroy the timeouts.
* *
* \param display The display the window appears on * \param display The display the window appears on
@ -296,7 +301,8 @@ disable_compositor (MetaDisplay *display)
display->compositor = NULL; display->compositor = NULL;
} }
/*! Opens a new display, sets it up, initialises all the X extensions /**
* Opens a new display, sets it up, initialises all the X extensions
* we will need, and adds it to the list of displays. * we will need, and adds it to the list of displays.
* *
* \return True if the display was opened successfully, and False * \return True if the display was opened successfully, and False
@ -1559,7 +1565,8 @@ handle_net_restack_window (MetaDisplay* display,
} }
#endif #endif
/*! This is the most important function in the whole program. It is the heart, /**
* This is the most important function in the whole program. It is the heart,
* it is the nexus, it is the Grand Central Station of Metacity's world. * it is the nexus, it is the Grand Central Station of Metacity's world.
* When we create a MetaDisplay, we ask GDK to pass *all* events for *all* * When we create a MetaDisplay, we ask GDK to pass *all* events for *all*
* windows to this function. So every time anything happens that we might * windows to this function. So every time anything happens that we might
@ -4130,11 +4137,13 @@ meta_display_set_cursor_theme (const char *theme,
#endif #endif
} }
/*! Stores whether syncing is currently enabled. /**
* Stores whether syncing is currently enabled.
*/ */
static gboolean is_syncing = FALSE; static gboolean is_syncing = FALSE;
/*! Returns whether X synchronisation is currently enabled. /**
* Returns whether X synchronisation is currently enabled.
* *
* \return true if we must wait for events whenever we send X requests; * \return true if we must wait for events whenever we send X requests;
* false otherwise. * false otherwise.
@ -4150,7 +4159,8 @@ meta_is_syncing (void)
return is_syncing; return is_syncing;
} }
/*! A handy way to turn on synchronisation on or off for every display. /**
* A handy way to turn on synchronisation on or off for every display.
* *
* \bug Of course there is only one display ever anyway, so this can * \bug Of course there is only one display ever anyway, so this can
* be rather hugely simplified. * be rather hugely simplified.
@ -4174,12 +4184,14 @@ meta_set_syncing (gboolean setting)
} }
} }
/*! How long, in milliseconds, we should wait after pinging a window /**
* How long, in milliseconds, we should wait after pinging a window
* before deciding it's not going to get back to us. * before deciding it's not going to get back to us.
*/ */
#define PING_TIMEOUT_DELAY 2250 #define PING_TIMEOUT_DELAY 2250
/*! Does whatever it is we decided to do when a window didn't respond /**
* Does whatever it is we decided to do when a window didn't respond
* to a ping. We also remove the ping from the display's list of * to a ping. We also remove the ping from the display's list of
* pending pings. This function is called by the event loop when the timeout * pending pings. This function is called by the event loop when the timeout
* times out which we created at the start of the ping. * times out which we created at the start of the ping.
@ -4217,7 +4229,8 @@ meta_display_ping_timeout (gpointer data)
return FALSE; return FALSE;
} }
/*! Sends a ping request to a window. The window must respond to /**
* Sends a ping request to a window. The window must respond to
* the request within a certain amount of time. If it does, we * the request within a certain amount of time. If it does, we
* will call one callback; if the time passes and we haven't had * will call one callback; if the time passes and we haven't had
* a response, we call a different callback. The window must have * a response, we call a different callback. The window must have
@ -4354,7 +4367,8 @@ process_request_frame_extents (MetaDisplay *display,
meta_XFree (hints); meta_XFree (hints);
} }
/*! Process the pong (the response message) from the ping we sent /**
* Process the pong (the response message) from the ping we sent
* to the window. This involves removing the timeout, calling the * to the window. This involves removing the timeout, calling the
* reply handler function, and freeing memory. * reply handler function, and freeing memory.
* *
@ -4409,7 +4423,8 @@ process_pong_message (MetaDisplay *display,
} }
} }
/*! Finds whether a window has any pings waiting on it. /**
* Finds whether a window has any pings waiting on it.
* *
* \param display The MetaDisplay of the window. * \param display The MetaDisplay of the window.
* \param window The MetaWindow whose pings we want to know about. * \param window The MetaWindow whose pings we want to know about.