From c2793d9c1df48f51d81327cd342df026b702defb Mon Sep 17 00:00:00 2001 From: Benjamin Otte Date: Mon, 15 Apr 2013 15:52:10 +0200 Subject: [PATCH] docs: Move property section docs to correct file --- gdk/gdkproperty.c | 34 ++++++++++++++++++++++++++++++++++ gdk/x11/gdkproperty-x11.c | 34 ---------------------------------- 2 files changed, 34 insertions(+), 34 deletions(-) diff --git a/gdk/gdkproperty.c b/gdk/gdkproperty.c index 7ba0f83bc4..c642864b17 100644 --- a/gdk/gdkproperty.c +++ b/gdk/gdkproperty.c @@ -22,6 +22,40 @@ #include "gdkprivate.h" +/** + * SECTION:properties + * @Short_description: Functions to manipulate properties on windows + * @Title: Properties and Atoms + * + * Each window under X can have any number of associated + * properties attached to it. + * Properties are arbitrary chunks of data identified by + * atoms. (An atom + * is a numeric index into a string table on the X server. They are used + * to transfer strings efficiently between clients without + * having to transfer the entire string.) A property + * has an associated type, which is also identified + * using an atom. + * + * A property has an associated format, + * an integer describing how many bits are in each unit + * of data inside the property. It must be 8, 16, or 32. + * When data is transferred between the server and client, + * if they are of different endianesses it will be byteswapped + * as necessary according to the format of the property. + * Note that on the client side, properties of format 32 + * will be stored with one unit per long, + * even if a long integer has more than 32 bits on the platform. + * (This decision was apparently made for Xlib to maintain + * compatibility with programs that assumed longs were 32 + * bits, at the expense of programs that knew better.) + * + * The functions in this section are used to add, remove + * and change properties on windows, to convert atoms + * to and from strings and to manipulate some types of + * data commonly stored in X window properties. + */ + static GHashTable *names_to_atoms; static GPtrArray *atoms_to_names; diff --git a/gdk/x11/gdkproperty-x11.c b/gdk/x11/gdkproperty-x11.c index 0e5a641be3..362242489b 100644 --- a/gdk/x11/gdkproperty-x11.c +++ b/gdk/x11/gdkproperty-x11.c @@ -38,40 +38,6 @@ #include -/** - * SECTION:properties - * @Short_description: Functions to manipulate properties on windows - * @Title: Properties and Atoms - * - * Each window under X can have any number of associated - * properties attached to it. - * Properties are arbitrary chunks of data identified by - * atoms. (An atom - * is a numeric index into a string table on the X server. They are used - * to transfer strings efficiently between clients without - * having to transfer the entire string.) A property - * has an associated type, which is also identified - * using an atom. - * - * A property has an associated format, - * an integer describing how many bits are in each unit - * of data inside the property. It must be 8, 16, or 32. - * When data is transferred between the server and client, - * if they are of different endianesses it will be byteswapped - * as necessary according to the format of the property. - * Note that on the client side, properties of format 32 - * will be stored with one unit per long, - * even if a long integer has more than 32 bits on the platform. - * (This decision was apparently made for Xlib to maintain - * compatibility with programs that assumed longs were 32 - * bits, at the expense of programs that knew better.) - * - * The functions in this section are used to add, remove - * and change properties on windows, to convert atoms - * to and from strings and to manipulate some types of - * data commonly stored in X window properties. - */ - static const gchar xatoms_string[] = /* These are all the standard predefined X atoms */ "\0" /* leave a space for None, even though it is not a predefined atom */