Commit 88e3a37a authored by Ulrich Sibiller's avatar Ulrich Sibiller

Display.c: reformat comments

parent 7e8f638a
...@@ -152,8 +152,8 @@ Drawable nxagentDefaultDrawables[MAXDEPTH + 1]; ...@@ -152,8 +152,8 @@ Drawable nxagentDefaultDrawables[MAXDEPTH + 1];
Pixmap nxagentScreenSaverPixmap; Pixmap nxagentScreenSaverPixmap;
/* /*
* Also used in Cursor.c. There are huge problems * Also used in Cursor.c. There are huge problems using GC
* using GC definition. This is to be reworked. * definition. This is to be reworked.
*/ */
XlibGC nxagentBitmapGC; XlibGC nxagentBitmapGC;
...@@ -1188,9 +1188,8 @@ Reply Total Cached Bits In Bits Out Bits/Reply Ratio ...@@ -1188,9 +1188,8 @@ Reply Total Cached Bits In Bits Out Bits/Reply Ratio
DefaultScreenOfDisplay(nxagentDisplay)); DefaultScreenOfDisplay(nxagentDisplay));
/* /*
* Processing the arguments all the timeouts * Processing the arguments all the timeouts have been set. Now we
* have been set. Now we have to change the * have to change the screen-saver timeout.
* screen-saver timeout.
*/ */
nxagentSetScreenSaverTime(); nxagentSetScreenSaverTime();
...@@ -1286,7 +1285,7 @@ FIXME: Use of nxagentParentWindow is strongly deprecated. We need ...@@ -1286,7 +1285,7 @@ FIXME: Use of nxagentParentWindow is strongly deprecated. We need
nxagentBitmapGC = XCreateGC(nxagentDisplay, nxagentDefaultDrawables[1], 0L, NULL); nxagentBitmapGC = XCreateGC(nxagentDisplay, nxagentDefaultDrawables[1], 0L, NULL);
/* /*
* Note that this "confine windoqw" is useless at the moment as we * Note that this "confine window" is useless at the moment as we
* reimplement nxagentConstrainCursor() to skip the "constrain" * reimplement nxagentConstrainCursor() to skip the "constrain"
* stuff. * stuff.
*/ */
...@@ -1918,14 +1917,13 @@ static int nxagentCheckForDefaultDepthCompatibility(void) ...@@ -1918,14 +1917,13 @@ static int nxagentCheckForDefaultDepthCompatibility(void)
/* /*
* Depending on the (reconnect) tolerance checks value, this * Depending on the (reconnect) tolerance checks value, this
* function checks stricter or looser: * function checks stricter or looser:
* - Strict means that the old and new default depth values * - Strict means that the old and new default depth values must
* must match exactly. * match exactly.
* - Safe or Risky means that the default depth values might differ, * - Safe or Risky means that the default depth values might
* but the new default depth value must be at least as * differ, but the new default depth value must be at least as
* high as the former default depth value. This is * high as the former default depth value. This is recommended,
* recommended, because it allows clients with a * because it allows clients with a higher default depth value
* higher default depth value to still connect, but * to still connect, but not lose functionality.
* not lose functionality.
* - Bypass means that all of these checks are essentially * - Bypass means that all of these checks are essentially
* deactivated. This is probably a very bad idea. * deactivated. This is probably a very bad idea.
*/ */
...@@ -1982,18 +1980,16 @@ static int nxagentCheckForDepthsCompatibility(void) ...@@ -1982,18 +1980,16 @@ static int nxagentCheckForDepthsCompatibility(void)
/* /*
* Depending on the (reconnect) tolerance checks value, this * Depending on the (reconnect) tolerance checks value, this
* function checks stricter or looser: * function checks stricter or looser:
* - Strict means that the number of old and new depths must * - Strict means that the number of old and new depths must match
* match exactly and every old depth value must be * exactly and every old depth value must be available in the
* available in the new depth array. * new depth array.
* - Safe means that the number of depths might diverge, * - Safe means that the number of depths might diverge, but all
* but all former depth must also be included in the * former depth must also be included in the new depth
* new depth array. This is recommended, because * array. This is recommended, because it allows clients with
* it allows clients with more depths to still * more depths to still connect, but not lose functionality.
* connect, but not lose functionality.
* - Risky means that the new depths array is allowed to be * - Risky means that the new depths array is allowed to be
* smaller than the old depths array, but at least * smaller than the old depths array, but at least one depth
* one depth value must be included in both. * value must be included in both. This is potentially unsafe.
* This is potentially unsafe.
* - Bypass or higher means that all of these checks are * - Bypass or higher means that all of these checks are
* essentially deactivated. This is a very bad idea. * essentially deactivated. This is a very bad idea.
*/ */
...@@ -2140,20 +2136,18 @@ static int nxagentCheckForPixmapFormatsCompatibility(void) ...@@ -2140,20 +2136,18 @@ static int nxagentCheckForPixmapFormatsCompatibility(void)
/* /*
* Depending on the (reconnect) tolerance checks value, this * Depending on the (reconnect) tolerance checks value, this
* function checks stricter or looser: * function checks stricter or looser:
* - Strict means that the number of internal and external * - Strict means that the number of internal and external pixmap
* pixmap formats must match exactly and every * formats must match exactly and every internal pixmap format
* internal pixmap format must be available in the * must be available in the external pixmap format array.
* external pixmap format array. * - Safe means that the number of pixmap formats might diverge,
* - Safe means that the number of pixmap formats might * but all internal pixmap formats must also be included in the
* diverge, but all internal pixmap formats must * external pixmap formats array. This is recommended, because
* also be included in the external pixmap formats * it allows clients with more pixmap formats to still connect,
* array. This is recommended, because it allows
* clients with more pixmap formats to still connect,
* but not lose functionality. * but not lose functionality.
* - Risky means that the internal pixmap formats array is * - Risky means that the internal pixmap formats array is allowed
* allowed to be smaller than the external pixmap * to be smaller than the external pixmap formats array, but at
* formats array, but at least one pixmap format must * least one pixmap format must be included in both. This is
* be included in both. This is potentially unsafe. * potentially unsafe.
* - Bypass or higher means that all of these checks are * - Bypass or higher means that all of these checks are
* essentially deactivated. This is a very bad idea. * essentially deactivated. This is a very bad idea.
*/ */
...@@ -2709,11 +2703,10 @@ void nxagentWaitDisplay(void) ...@@ -2709,11 +2703,10 @@ void nxagentWaitDisplay(void)
} }
/* /*
* This has not to do with the remote display but * This has not to do with the remote display but with the X server
* with the X server that the agent is impersonating. * that the agent is impersonating. We have it here to be consistent
* We have it here to be consistent with the other * with the other cleanup procedures which have mainly to do with the
* cleanup procedures which have mainly to do with * Xlib display connection.
* the Xlib display connection.
*/ */
void nxagentAbortDisplay(void) void nxagentAbortDisplay(void)
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment