Commit 5b291073 authored by Matthias Clasen's avatar Matthias Clasen

GDK instead of Gdk.

        * gdk-pixbuf/porting-from-imlib.sgml: GDK instead of Gdk.

        * gdk-pixbuf/tmpl/gdk-pixbuf-xlib-init.sgml: Replace references to
        deprecated functions.

        * gdk/tmpl/event_structs.sgml, gdk/tmpl/gcs.sgml,
        gdk/tmpl/images.sgml: Replace references to deprecated functions.

        * gdk/tmpl/properties.sgml, gdk/tmpl/selections.sgml: Additions.

        * gdk/x11/gdkproperty-x11.c, gdk/x11/gdkselection-x11.c:
        Minor documentation tweaks.
parent 3c6225f6
2001-12-28 Matthias Clasen <matthiasc@poet.de>
* gdk/x11/gdkproperty-x11.c, gdk/x11/gdkselection-x11.c:
Minor documentation tweaks.
2001-12-28 Tor Lillqvist <tml@iki.fi> 2001-12-28 Tor Lillqvist <tml@iki.fi>
* gdk/win32/gdkfont-win32.c: Use G_N_ELEMENTS(). * gdk/win32/gdkfont-win32.c: Use G_N_ELEMENTS().
......
2001-12-28 Matthias Clasen <matthiasc@poet.de>
* gdk/x11/gdkproperty-x11.c, gdk/x11/gdkselection-x11.c:
Minor documentation tweaks.
2001-12-28 Tor Lillqvist <tml@iki.fi> 2001-12-28 Tor Lillqvist <tml@iki.fi>
* gdk/win32/gdkfont-win32.c: Use G_N_ELEMENTS(). * gdk/win32/gdkfont-win32.c: Use G_N_ELEMENTS().
......
2001-12-28 Matthias Clasen <matthiasc@poet.de>
* gdk/x11/gdkproperty-x11.c, gdk/x11/gdkselection-x11.c:
Minor documentation tweaks.
2001-12-28 Tor Lillqvist <tml@iki.fi> 2001-12-28 Tor Lillqvist <tml@iki.fi>
* gdk/win32/gdkfont-win32.c: Use G_N_ELEMENTS(). * gdk/win32/gdkfont-win32.c: Use G_N_ELEMENTS().
......
2001-12-28 Matthias Clasen <matthiasc@poet.de>
* gdk/x11/gdkproperty-x11.c, gdk/x11/gdkselection-x11.c:
Minor documentation tweaks.
2001-12-28 Tor Lillqvist <tml@iki.fi> 2001-12-28 Tor Lillqvist <tml@iki.fi>
* gdk/win32/gdkfont-win32.c: Use G_N_ELEMENTS(). * gdk/win32/gdkfont-win32.c: Use G_N_ELEMENTS().
......
2001-12-28 Matthias Clasen <matthiasc@poet.de>
* gdk/x11/gdkproperty-x11.c, gdk/x11/gdkselection-x11.c:
Minor documentation tweaks.
2001-12-28 Tor Lillqvist <tml@iki.fi> 2001-12-28 Tor Lillqvist <tml@iki.fi>
* gdk/win32/gdkfont-win32.c: Use G_N_ELEMENTS(). * gdk/win32/gdkfont-win32.c: Use G_N_ELEMENTS().
......
2001-12-28 Matthias Clasen <matthiasc@poet.de>
* gdk/x11/gdkproperty-x11.c, gdk/x11/gdkselection-x11.c:
Minor documentation tweaks.
2001-12-28 Tor Lillqvist <tml@iki.fi> 2001-12-28 Tor Lillqvist <tml@iki.fi>
* gdk/win32/gdkfont-win32.c: Use G_N_ELEMENTS(). * gdk/win32/gdkfont-win32.c: Use G_N_ELEMENTS().
......
2001-12-28 Matthias Clasen <matthiasc@poet.de>
* gdk/x11/gdkproperty-x11.c, gdk/x11/gdkselection-x11.c:
Minor documentation tweaks.
2001-12-28 Tor Lillqvist <tml@iki.fi> 2001-12-28 Tor Lillqvist <tml@iki.fi>
* gdk/win32/gdkfont-win32.c: Use G_N_ELEMENTS(). * gdk/win32/gdkfont-win32.c: Use G_N_ELEMENTS().
......
2001-12-28 Matthias Clasen <matthiasc@poet.de>
* gdk/tmpl/properties.sgml, gdk/tmpl/selections.sgml: Additions.
2001-12-23 Matthias Clasen <matthiasc@poet.de>
* gdk-pixbuf/porting-from-imlib.sgml: GDK instead of Gdk.
* gdk-pixbuf/tmpl/gdk-pixbuf-xlib-init.sgml: Replace references to
deprecated functions.
* gdk/tmpl/event_structs.sgml, gdk/tmpl/gcs.sgml,
gdk/tmpl/images.sgml: Replace references to deprecated functions.
2001-12-28 Vitaly Tishkov <tvv@sparc.spb.su> 2001-12-28 Vitaly Tishkov <tvv@sparc.spb.su>
* gtkwindow.sgml: additional fix for #59314 ('<programlisting>' is * gtkwindow.sgml: additional fix for #59314 ('<programlisting>' is
changed to '<literal>' in docs for gtk_window_set_policy ()) changed to '<literal>' in docs for gtk_window_set_policy ())
......
...@@ -139,7 +139,7 @@ ...@@ -139,7 +139,7 @@
<para> <para>
The &gdk-pixbuf; library has the policy of always rendering The &gdk-pixbuf; library has the policy of always rendering
pixbufs to Gdk drawables you provide; it will not create pixbufs to GDK drawables you provide; it will not create
them for you. This is in general more flexible than them for you. This is in general more flexible than
&Imlib;'s policy of always creating a pixmap and making you &Imlib;'s policy of always creating a pixmap and making you
use that instead. use that instead.
......
...@@ -12,9 +12,7 @@ Initializing the &gdk-pixbuf; Xlib library. ...@@ -12,9 +12,7 @@ Initializing the &gdk-pixbuf; Xlib library.
functions in this section are used to initialize the &gdk-pixbuf; functions in this section are used to initialize the &gdk-pixbuf;
Xlib library. This library must be initialized near the beginning Xlib library. This library must be initialized near the beginning
of the program or before calling any of the other &gdk-pixbuf; of the program or before calling any of the other &gdk-pixbuf;
Xlib functions; it cannot be initialized automatically since Xlib functions.
Xlib-only applications do not call gdk_rgb_init() like GNOME
applications do.
</para> </para>
<!-- ##### SECTION See_Also ##### --> <!-- ##### SECTION See_Also ##### -->
......
...@@ -364,7 +364,7 @@ union, 16-bit data uses the s array, and 32-bit data uses the l array. ...@@ -364,7 +364,7 @@ union, 16-bit data uses the s array, and 32-bit data uses the l array.
<!-- ##### STRUCT GdkEventNoExpose ##### --> <!-- ##### STRUCT GdkEventNoExpose ##### -->
<para> <para>
Generated when the area of a #GdkDrawable being copied, with gdk_draw_pixmap() Generated when the area of a #GdkDrawable being copied, with gdk_draw_drawable()
or gdk_window_copy_area(), was completely available. or gdk_window_copy_area(), was completely available.
</para> </para>
<para> <para>
......
...@@ -379,7 +379,7 @@ windows of that window. ...@@ -379,7 +379,7 @@ windows of that window.
Sets whether copying non-visible portions of a drawable Sets whether copying non-visible portions of a drawable
using this graphics context generate exposure events using this graphics context generate exposure events
for the corresponding regions of the destination for the corresponding regions of the destination
drawable. (See gdk_draw_pixmap()). drawable. (See gdk_draw_drawable()).
</para> </para>
@gc: a #GdkGC. @gc: a #GdkGC.
......
...@@ -13,7 +13,7 @@ It has now been superceded to a large extent by the much more flexible ...@@ -13,7 +13,7 @@ It has now been superceded to a large extent by the much more flexible
<para> <para>
To create an empty #GdkImage use gdk_image_new(). To create an empty #GdkImage use gdk_image_new().
To create a #GdkImage from bitmap data use gdk_image_new_bitmap(). To create a #GdkImage from bitmap data use gdk_image_new_bitmap().
To create an image from part of a #GdkWindow use gdk_image_get(). To create an image from part of a #GdkWindow use gdk_drawable_get_image().
</para> </para>
<para> <para>
The image can be manipulated with gdk_image_get_pixel() and The image can be manipulated with gdk_image_get_pixel() and
......
...@@ -20,7 +20,7 @@ using an atom. ...@@ -20,7 +20,7 @@ using an atom.
A property has an associated <firstterm>format</firstterm>, A property has an associated <firstterm>format</firstterm>,
an integer describing how many bits are in each unit an integer describing how many bits are in each unit
of data inside the property. It must be 8, 16, or 32. of data inside the property. It must be 8, 16, or 32.
When data is transfered between the server and client, When data is transferred between the server and client,
if they are of different endianesses it will be byteswapped if they are of different endianesses it will be byteswapped
as necessary according to the format of the property. as necessary according to the format of the property.
Note that on the client side, properties of format 32 Note that on the client side, properties of format 32
...@@ -44,25 +44,26 @@ data commonly stored in X window properties. ...@@ -44,25 +44,26 @@ data commonly stored in X window properties.
<!-- ##### STRUCT GdkAtom ##### --> <!-- ##### STRUCT GdkAtom ##### -->
<para> <para>
A numeric type representing a string as an index into a table An opaque type representing a string as an index into a table
of strings on the X server. of strings on the X server.
</para> </para>
<!-- ##### MACRO GDK_ATOM_TO_POINTER ##### --> <!-- ##### MACRO GDK_ATOM_TO_POINTER ##### -->
<para> <para>
Converts a #GdkAtom into a pointer type.
</para> </para>
@atom: @atom: a #GdkAtom.
<!-- ##### MACRO GDK_POINTER_TO_ATOM ##### --> <!-- ##### MACRO GDK_POINTER_TO_ATOM ##### -->
<para> <para>
Extracts a #GdkAtom from a pointer. The #GdkAtom must have been
stored in the pointer with GDK_ATOM_TO_POINTER().
</para> </para>
@ptr: @ptr: a pointer containing a #GdkAtom.
<!-- ##### MACRO GDK_NONE ##### --> <!-- ##### MACRO GDK_NONE ##### -->
...@@ -75,10 +76,10 @@ in the Xlib API. ...@@ -75,10 +76,10 @@ in the Xlib API.
<!-- ##### FUNCTION gdk_text_property_to_text_list ##### --> <!-- ##### FUNCTION gdk_text_property_to_text_list ##### -->
<para> <para>
Convert a text string from the encoding as it is stored in Converts a text string from the encoding as it is stored in
a property into an array of strings in the encoding of a property into an array of strings in the encoding of
the current local. (The elements of the array represent the current local. (The elements of the array represent
the null-separated elements of the original text string.) the nul-separated elements of the original text string.)
</para> </para>
@encoding: an atom representing the encoding. The most common @encoding: an atom representing the encoding. The most common
...@@ -87,7 +88,7 @@ the null-separated elements of the original text string.) ...@@ -87,7 +88,7 @@ the null-separated elements of the original text string.)
value used as the type for the property. value used as the type for the property.
@format: the format of the property. @format: the format of the property.
@text: the text data. @text: the text data.
@length: the length of the property, in item.s @length: the length of the property, in items.
@list: location to store a terminated array of strings @list: location to store a terminated array of strings
in the encoding of the current locale. This in the encoding of the current locale. This
array should be freed using gdk_free_text_list(). array should be freed using gdk_free_text_list().
...@@ -97,7 +98,7 @@ the null-separated elements of the original text string.) ...@@ -97,7 +98,7 @@ the null-separated elements of the original text string.)
<!-- ##### FUNCTION gdk_free_text_list ##### --> <!-- ##### FUNCTION gdk_free_text_list ##### -->
<para> <para>
Free the array of strings created by Frees the array of strings created by
gdk_text_property_to_text_list(). gdk_text_property_to_text_list().
</para> </para>
...@@ -120,11 +121,11 @@ gdk_text_property_to_text_list(). ...@@ -120,11 +121,11 @@ gdk_text_property_to_text_list().
<!-- ##### FUNCTION gdk_string_to_compound_text ##### --> <!-- ##### FUNCTION gdk_string_to_compound_text ##### -->
<para> <para>
Convert a string from the encoding of the current locale Converts a string from the encoding of the current locale
into a form suitable for storing in a window property. into a form suitable for storing in a window property.
</para> </para>
@str: a null-terminated string. @str: a nul-terminated string.
@encoding: location to store the encoding atom (to be used as the type for the property). @encoding: location to store the encoding atom (to be used as the type for the property).
@format: location to store the format for the property. @format: location to store the format for the property.
@ctext: location to store newly allocated data for the property. @ctext: location to store newly allocated data for the property.
...@@ -134,7 +135,7 @@ into a form suitable for storing in a window property. ...@@ -134,7 +135,7 @@ into a form suitable for storing in a window property.
<!-- ##### FUNCTION gdk_free_compound_text ##### --> <!-- ##### FUNCTION gdk_free_compound_text ##### -->
<para> <para>
Free the data returned from gdk_string_to_compound_text(). Frees the data returned from gdk_string_to_compound_text().
</para> </para>
@ctext: The pointer stored in @ctext from a call to gdk_string_to_compound_text(). @ctext: The pointer stored in @ctext from a call to gdk_string_to_compound_text().
...@@ -164,24 +165,24 @@ Free the data returned from gdk_string_to_compound_text(). ...@@ -164,24 +165,24 @@ Free the data returned from gdk_string_to_compound_text().
<!-- ##### FUNCTION gdk_atom_intern ##### --> <!-- ##### FUNCTION gdk_atom_intern ##### -->
<para> <para>
Find or create an atom corresponding to a given string. Finds or creates an atom corresponding to a given string.
</para> </para>
@atom_name: a string. @atom_name: a string.
@only_if_exists: if %TRUE, do not create a new atom, but @only_if_exists: if %TRUE, do not create a new atom, but
just return the atom if it already exists. just return the atom if it already exists.
@Returns: the atom corresponding to @atom_name, or, if @Returns: the atom corresponding to @atom_name, or, if
@only_if_exists is TRUE, and an atom does not @only_if_exists is %TRUE, and an atom does not
already exists for the string, %GDK_NONE. already exists for the string, %GDK_NONE.
<!-- ##### FUNCTION gdk_atom_name ##### --> <!-- ##### FUNCTION gdk_atom_name ##### -->
<para> <para>
Determine the string corresponding to an atom. Determines the string corresponding to an atom.
</para> </para>
@atom: a #GdkAtom. @atom: a #GdkAtom.
@Returns: a newly allocated string containing the string @Returns: a newly-allocated string containing the string
corresponding to @atom. When you are done corresponding to @atom. When you are done
with the return value, you should free it with the return value, you should free it
using g_free(). using g_free().
...@@ -190,10 +191,12 @@ Determine the string corresponding to an atom. ...@@ -190,10 +191,12 @@ Determine the string corresponding to an atom.
<!-- ##### FUNCTION gdk_property_get ##### --> <!-- ##### FUNCTION gdk_property_get ##### -->
<para> <para>
Retrieves a portion of the contents of a property. If the Retrieves a portion of the contents of a property. If the
property does not exist, then the function returns FALSE, property does not exist, then the function returns %FALSE,
and %GDK_NONE will be stored in @actual_property_type. and %GDK_NONE will be stored in @actual_property_type.
</para>
Note: the <function>XGetWindowProperty()</function> <note>
<para>
The <function>XGetWindowProperty()</function>
function that gdk_property_get() function that gdk_property_get()
uses has a very confusing and complicated set of semantics. uses has a very confusing and complicated set of semantics.
Unfortunately, gdk_property_get() makes the situation Unfortunately, gdk_property_get() makes the situation
...@@ -204,6 +207,7 @@ should return a useful error to the program. You are advised to use ...@@ -204,6 +207,7 @@ should return a useful error to the program. You are advised to use
directly until a replacement function for gdk_property_get() directly until a replacement function for gdk_property_get()
is provided. is provided.
</para> </para>
</note>
@window: a #GdkWindow. @window: a #GdkWindow.
@property: the property to retrieve. @property: the property to retrieve.
...@@ -234,7 +238,7 @@ is provided. ...@@ -234,7 +238,7 @@ is provided.
<!-- ##### FUNCTION gdk_property_change ##### --> <!-- ##### FUNCTION gdk_property_change ##### -->
<para> <para>
Change the contents of a property on a window. Changes the contents of a property on a window.
</para> </para>
@window: a #GdkWindow. @window: a #GdkWindow.
...@@ -268,7 +272,7 @@ using gdk_property_change(). ...@@ -268,7 +272,7 @@ using gdk_property_change().
<!-- ##### FUNCTION gdk_property_delete ##### --> <!-- ##### FUNCTION gdk_property_delete ##### -->
<para> <para>
Delete a property from a window. Deletes a property from a window.
</para> </para>
@window: a #GdkWindow. @window: a #GdkWindow.
......
...@@ -79,122 +79,122 @@ compatibility with older programs. ...@@ -79,122 +79,122 @@ compatibility with older programs.
<!-- ##### MACRO GDK_SELECTION_PRIMARY ##### --> <!-- ##### MACRO GDK_SELECTION_PRIMARY ##### -->
<para> <para>
A #GdkAtom representing the <literal>PRIMARY</literal> selection.
</para> </para>
<!-- ##### MACRO GDK_SELECTION_SECONDARY ##### --> <!-- ##### MACRO GDK_SELECTION_SECONDARY ##### -->
<para> <para>
A #GdkAtom representing the <literal>SECONDARY</literal> selection.
</para> </para>
<!-- ##### MACRO GDK_SELECTION_CLIPBOARD ##### --> <!-- ##### MACRO GDK_SELECTION_CLIPBOARD ##### -->
<para> <para>
A #GdkAtom representing the <literal>CLIPBOARD</literal> selection.
</para> </para>
<!-- ##### MACRO GDK_TARGET_BITMAP ##### --> <!-- ##### MACRO GDK_TARGET_BITMAP ##### -->
<para> <para>
A #GdkAtom representing the <literal>BITMAP</literal> selection target.
</para> </para>
<!-- ##### MACRO GDK_TARGET_COLORMAP ##### --> <!-- ##### MACRO GDK_TARGET_COLORMAP ##### -->
<para> <para>
A #GdkAtom representing the <literal>COLORMAP</literal> selection target.
</para> </para>
<!-- ##### MACRO GDK_TARGET_DRAWABLE ##### --> <!-- ##### MACRO GDK_TARGET_DRAWABLE ##### -->
<para> <para>
A #GdkAtom representing the <literal>DRAWABLE</literal> selection target.
</para> </para>
<!-- ##### MACRO GDK_TARGET_PIXMAP ##### --> <!-- ##### MACRO GDK_TARGET_PIXMAP ##### -->
<para> <para>
A #GdkAtom representing the <literal>PIXMAP</literal> selection target.
</para> </para>
<!-- ##### MACRO GDK_TARGET_STRING ##### --> <!-- ##### MACRO GDK_TARGET_STRING ##### -->
<para> <para>
A #GdkAtom representing the <literal>STRING</literal> selection target.
</para> </para>
<!-- ##### MACRO GDK_SELECTION_TYPE_ATOM ##### --> <!-- ##### MACRO GDK_SELECTION_TYPE_ATOM ##### -->
<para> <para>
A #GdkAtom representing the <literal>ATOM</literal> selection type.
</para> </para>
<!-- ##### MACRO GDK_SELECTION_TYPE_BITMAP ##### --> <!-- ##### MACRO GDK_SELECTION_TYPE_BITMAP ##### -->
<para> <para>
A #GdkAtom representing the <literal>BITMAP</literal> selection type.
</para> </para>
<!-- ##### MACRO GDK_SELECTION_TYPE_COLORMAP ##### --> <!-- ##### MACRO GDK_SELECTION_TYPE_COLORMAP ##### -->
<para> <para>
A #GdkAtom representing the <literal>COLORMAP</literal> selection type.
</para> </para>
<!-- ##### MACRO GDK_SELECTION_TYPE_DRAWABLE ##### --> <!-- ##### MACRO GDK_SELECTION_TYPE_DRAWABLE ##### -->
<para> <para>
A #GdkAtom representing the <literal>DRAWABLE</literal> selection type.
</para> </para>
<!-- ##### MACRO GDK_SELECTION_TYPE_INTEGER ##### --> <!-- ##### MACRO GDK_SELECTION_TYPE_INTEGER ##### -->
<para> <para>
A #GdkAtom representing the <literal>INTEGER</literal> selection type.
</para> </para>
<!-- ##### MACRO GDK_SELECTION_TYPE_PIXMAP ##### --> <!-- ##### MACRO GDK_SELECTION_TYPE_PIXMAP ##### -->
<para> <para>
A #GdkAtom representing the <literal>PIXMAP</literal> selection type.
</para> </para>
<!-- ##### MACRO GDK_SELECTION_TYPE_WINDOW ##### --> <!-- ##### MACRO GDK_SELECTION_TYPE_WINDOW ##### -->
<para> <para>
A #GdkAtom representing the <literal>WINDOW</literal> selection type.
</para> </para>
<!-- ##### MACRO GDK_SELECTION_TYPE_STRING ##### --> <!-- ##### MACRO GDK_SELECTION_TYPE_STRING ##### -->
<para> <para>
A #GdkAtom representing the <literal>STRING</literal> selection type.
</para> </para>
<!-- ##### FUNCTION gdk_selection_owner_set ##### --> <!-- ##### FUNCTION gdk_selection_owner_set ##### -->
<para> <para>
Set the owner of the given selection. Sets the owner of the given selection.
</para> </para>
@owner: a #GdkWindow or NULL to indicate that the @owner: a #GdkWindow or %NULL to indicate that the
the owner for the given should be unset. the owner for the given should be unset.
@selection: an atom identifying a selection. @selection: an atom identifying a selection.
@time: timestamp to use when setting the selection. @time: timestamp to use when setting the selection.
...@@ -210,14 +210,14 @@ Set the owner of the given selection. ...@@ -210,14 +210,14 @@ Set the owner of the given selection.
<!-- ##### FUNCTION gdk_selection_owner_get ##### --> <!-- ##### FUNCTION gdk_selection_owner_get ##### -->
<para> <para>
Determine the owner of the given selection. Determines the owner of the given selection.
</para> </para>
@selection: an atom indentifying a selection. @selection: an atom indentifying a selection.
@Returns: if there is a selection owner for this window, @Returns: if there is a selection owner for this window,
and it is a window known to the current process, and it is a window known to the current process,
the #GdkWindow that owns the selection, otherwise the #GdkWindow that owns the selection, otherwise
NULL. Note that the return value may be owned %NULL. Note that the return value may be owned
by a different process if a foreign window by a different process if a foreign window
was previously created for that window, but was previously created for that window, but