]> Pileus Git - ~andy/gtk/blobdiff - docs/reference/gdk/tmpl/gcs.sgml
Make 3.0 parallel-installable to 2.x
[~andy/gtk] / docs / reference / gdk / tmpl / gcs.sgml
index e8da61fbc02deb7e6f56447cc32188d8f0f5520a..2897bcb35f103226285bbd085a129185ee700c5a 100644 (file)
@@ -2,7 +2,7 @@
 Graphics Contexts
 
 <!-- ##### SECTION Short_Description ##### -->
-objects to encapsulate drawing properties.
+Objects to encapsulate drawing properties
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
@@ -30,6 +30,12 @@ be set by the latter method.
 
 </para>
 
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### SECTION Image ##### -->
+
+
 <!-- ##### STRUCT GdkGC ##### -->
 <para>
 The #GdkGC structure represents a graphics context.
@@ -37,128 +43,33 @@ It is an opaque structure with no user-visible
 elements.
 </para>
 
-@dummy_var: 
 
 <!-- ##### STRUCT GdkGCValues ##### -->
 <para>
 The #GdkGCValues structure holds a set of values used
 to create or modify a graphics context.
+</para>
 
-<informaltable pgwide=1 frame="none" role="struct">
-<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
-<tbody>
-
-<row>
-<entry>#GdkColor       foreground;</entry>
-<entry>the foreground color.</entry>
-</row>
-
-<row>
-<entry>#GdkColor       background;</entry>
-<entry>the background color.</entry>
-</row>
-
-<row>
-<entry>#GdkFont *font;</entry>
-<entry>the default font..</entry>
-</row>
-
-<row>
-<entry>#GdkFunction function;</entry>
-<entry>the bitwise operation used when drawing.</entry>
-</row>
-
-<row>
-<entry>#GdkFill fill;</entry>
-<entry>the fill style.</entry>
-</row>
-
-<row>
-<entry>#GdkPixmap *tile;</entry>
-<entry>the tile pixmap.</entry>
-</row>
-
-<row>
-<entry>#GdkPixmap *stipple;</entry>
-<entry>the stipple bitmap.</entry>
-</row>
-
-<row>
-<entry>#GdkPixmap *clip_mask;</entry>
-<entry>the clip mask bitmap.</entry>
-</row>
-
-<row>
-<entry>#GdkSubwindowMode subwindow_mode;</entry>
-<entry>the subwindow mode.</entry>
-</row>
-
-<row>
-<entry>#gint ts_x_origin;</entry>
-<entry>the x origin of the tile or stipple.</entry>
-</row>
-
-<row>
-<entry>#gint ts_y_origin;</entry>
-<entry>the y origin of the tile or stipple.</entry>
-</row>
-
-<row>
-<entry>#gint clip_x_origin;</entry>
-<entry>the x origin of the clip mask.</entry>
-</row>
-
-<row>
-<entry>#gint clip_y_origin;</entry>
-<entry>the y origin of the clip mask.</entry>
-</row>
-
-<row>
-<entry>#gint graphics_exposures;</entry>
-<entry>whether graphics exposures are enabled.</entry>
-</row>
-
-<row>
-<entry>#gint line_width;</entry>
-<entry>the line width</entry>
-</row>
-
-<row>
-<entry>#GdkLineStyle line_style;</entry>
-<entry>the way dashed lines are drawn</entry>
-</row>
-
-<row>
-<entry>#GdkCapStyle cap_style;</entry>
-<entry>the way the ends of lines are drawn</entry>
-</row>
-
-<row>
-<entry>#GdkJoinStyle join_style;</entry>
-<entry>the way joins between lines are drawn</entry>
-</row>
-
-</tbody></tgroup></informaltable>
-</para>
-
-@foreground: 
-@background: 
-@font: 
-@function: 
-@fill: 
-@tile: 
-@stipple: 
-@clip_mask: 
-@subwindow_mode: 
-@ts_x_origin: 
-@ts_y_origin: 
-@clip_x_origin: 
-@clip_y_origin: 
-@graphics_exposures: 
-@line_width: 
-@line_style: 
-@cap_style: 
-@join_style: 
+@foreground: the foreground color. Note that gdk_gc_get_values()
+  only sets the pixel value.
+@background: the background color. Note that gdk_gc_get_values()
+  only sets the pixel value.
+@font: the default font.
+@function: the bitwise operation used when drawing.
+@fill: the fill style.
+@tile: the tile pixmap.
+@stipple: the stipple bitmap.
+@clip_mask: the clip mask bitmap.
+@subwindow_mode: the subwindow mode.
+@ts_x_origin: the x origin of the tile or stipple.
+@ts_y_origin: the y origin of the tile or stipple.
+@clip_x_origin: the x origin of the clip mask.
+@clip_y_origin: the y origin of the clip mask.
+@graphics_exposures: whether graphics exposures are enabled.
+@line_width: the line width.
+@line_style: the way dashed lines are drawn.
+@cap_style: the way the ends of lines are drawn.
+@join_style: the way joins between lines are drawn.
 
 <!-- ##### ENUM GdkGCValuesMask ##### -->
 <para>
@@ -166,66 +77,24 @@ A set of bit flags used to indicate which fields
 #GdkGCValues structure are set.
 </para>
 
-@GDK_GC_FOREGROUND: 
-@GDK_GC_BACKGROUND: 
-@GDK_GC_FONT: 
-@GDK_GC_FUNCTION: 
-@GDK_GC_FILL: 
-@GDK_GC_TILE: 
-@GDK_GC_STIPPLE: 
-@GDK_GC_CLIP_MASK: 
-@GDK_GC_SUBWINDOW: 
-@GDK_GC_TS_X_ORIGIN: 
-@GDK_GC_TS_Y_ORIGIN: 
-@GDK_GC_CLIP_X_ORIGIN: 
-@GDK_GC_CLIP_Y_ORIGIN: 
-@GDK_GC_EXPOSURES: 
-@GDK_GC_LINE_WIDTH: 
-@GDK_GC_LINE_STYLE: 
-@GDK_GC_CAP_STYLE: 
-@GDK_GC_JOIN_STYLE: 
-
-<!-- ##### ENUM GdkFill ##### -->
-<para>
-Determines how primitives are drawn.
-
-<informaltable pgwide=1 frame="none" role="enum">
-<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
-<tbody>
-
-<row>
-<entry>GDK_SOLID</entry>
-<entry>draw with the foreground color.</entry>
-</row>
-
-<row>
-<entry>GDK_TILED</entry>
-<entry>draw with a tiled pixmap.</entry>
-</row>
-
-<row>
-<entry>GDK_STIPPLED</entry>
-<entry>draw using the stipple bitmap. Pixels corresponding
-to bits in the stipple bitmap that are set will be drawn in the 
-foreground color; pixels corresponding to bits that are
-not set will be left untouched.</entry>
-</row>
-
-<row>
-<entry>GDK_OPAQUE_STIPPLED</entry>
-<entry>draw using the stipple bitmap. Pixels corresponding
-to bits in the stipple bitmap that are set will be drawn in the 
-foreground color; pixels corresponding to bits that are
-not set will be drawn with the background color.</entry>
-</row>
-
-</tbody></tgroup></informaltable>
-</para>
-
-@GDK_SOLID: 
-@GDK_TILED: 
-@GDK_STIPPLED: 
-@GDK_OPAQUE_STIPPLED: 
+@GDK_GC_FOREGROUND: the @foreground is set.
+@GDK_GC_BACKGROUND: the @background is set.
+@GDK_GC_FONT: the @font is set.
+@GDK_GC_FUNCTION: the @function is set.
+@GDK_GC_FILL: the @fill is set.
+@GDK_GC_TILE: the @tile is set.
+@GDK_GC_STIPPLE: the @stipple is set.
+@GDK_GC_CLIP_MASK: the @clip_mask is set.
+@GDK_GC_SUBWINDOW: the @subwindow_mode is set.
+@GDK_GC_TS_X_ORIGIN: the @ts_x_origin is set.
+@GDK_GC_TS_Y_ORIGIN: the @ts_y_origin is set.
+@GDK_GC_CLIP_X_ORIGIN: the @clip_x_origin is set.
+@GDK_GC_CLIP_Y_ORIGIN: the @clip_y_origin is set.
+@GDK_GC_EXPOSURES: the @graphics_exposures is set.
+@GDK_GC_LINE_WIDTH: the @line_width is set.
+@GDK_GC_LINE_STYLE: the @line_style is set.
+@GDK_GC_CAP_STYLE: the @cap_style is set.
+@GDK_GC_JOIN_STYLE: the @join_style is set.
 
 <!-- ##### ENUM GdkFunction ##### -->
 <para>
@@ -237,401 +106,323 @@ images, only %GDK_COPY, %GDK_XOR and %GDK_INVERT are generally
 useful. For bitmaps, %GDK_AND and %GDK_OR are also useful.
 </para>
 
-@GDK_COPY: 
-@GDK_INVERT: 
-@GDK_XOR: 
-@GDK_CLEAR: 
-@GDK_AND: 
-@GDK_AND_REVERSE: 
-@GDK_AND_INVERT: 
-@GDK_NOOP: 
-@GDK_OR: 
-@GDK_EQUIV: 
-@GDK_OR_REVERSE: 
-@GDK_COPY_INVERT: 
-@GDK_OR_INVERT: 
-@GDK_NAND: 
-@GDK_SET: 
+@GDK_COPY: <literal>dst = src</literal>
+@GDK_INVERT: <literal>dst = NOT dst</literal>
+@GDK_XOR: <literal>dst = src XOR dst</literal>
+@GDK_CLEAR: <literal>dst = 0</literal>
+@GDK_AND: <literal>dst = dst AND src</literal>
+@GDK_AND_REVERSE: <literal>dst = src AND (NOT dst)</literal>
+@GDK_AND_INVERT: <literal>dst = (NOT src) AND dst</literal>
+@GDK_NOOP: <literal>dst = dst</literal>
+@GDK_OR: <literal>dst = src OR dst</literal>
+@GDK_EQUIV: <literal>dst = (NOT src) XOR dst</literal>
+@GDK_OR_REVERSE: <literal>dst = src OR (NOT dst)</literal>
+@GDK_COPY_INVERT: <literal>dst = NOT src</literal>
+@GDK_OR_INVERT: <literal>dst = (NOT src) OR dst</literal>
+@GDK_NAND: <literal>dst = (NOT src) OR (NOT dst)</literal>
+@GDK_NOR: <literal>dst = (NOT src) AND (NOT dst)</literal>
+@GDK_SET: <literal>dst = 1</literal>
 
-<!-- ##### ENUM GdkLineStyle ##### -->
+<!-- ##### FUNCTION gdk_gc_new ##### -->
 <para>
-Determines how lines are drawn.
-
-<informaltable pgwide=1 frame="none" role="enum">
-<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
-<tbody>
+</para>
 
-<row>
-<entry>GDK_LINE_SOLID</entry>
-<entry>lines are drawn solid.</entry>
-</row>
+@drawable: 
+@Returns: 
 
-<row>
-<entry>GDK_LINE_ON_OFF_DASH</entry>
-<entry>even segments are drawn; odd segments are not drawn.</entry>
-</row>
 
-<row>
-<entry>GDK_LINE_DOUBLE_DASH</entry>
-<entry>even segments are normally. Odd segments are drawn 
-in the background color if the fill style is %GDK_SOLID,
-or in the background color masked by the stipple if the
-fill style is %GDK_STIPPLED.</entry>
-</row>
+<!-- ##### FUNCTION gdk_gc_new_with_values ##### -->
+<para>
 
-</tbody></tgroup></informaltable>
 </para>
 
-@GDK_LINE_SOLID: 
-@GDK_LINE_ON_OFF_DASH: 
-@GDK_LINE_DOUBLE_DASH: 
+@drawable: 
+@values: 
+@values_mask: 
+@Returns: 
 
-<!-- ##### ENUM GdkCapStyle ##### -->
+
+<!-- ##### FUNCTION gdk_gc_get_screen ##### -->
 <para>
-Determines how the end of lines are drawn.
 
-<informaltable pgwide=1 frame="none" role="struct">
-<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
-<tbody>
-
-<row>
-<entry>GDK_CAP_NOT_LAST</entry>
-<entry>the same as %GDK_CAP_BUTT for lines of non-zero width.
-       for zero width lines, the final point on the line
-       will not be drawn.</entry>
-</row>
-
-<row>
-<entry>GDK_CAP_BUTT</entry>
-<entry>the ends of the lines are drawn squared off and extending
-       to the coordinates of the end point.</entry>
-</row>
-
-<row>
-<entry>GDK_CAP_ROUND</entry>
-<entry>the ends of the lines are drawn as semicircles with the
-       diameter equal to the line width and centered at the
-       end point.</entry>
-</row>
-
-<row>
-<entry>GDK_CAP_PROJECTING</entry>
-<entry>the ends of the lines are drawn squared off and extending
-       half the width of the line beyond the end point.</entry>
-</row>
-</tbody></tgroup></informaltable>
-</para>
-
-@GDK_CAP_NOT_LAST: 
-@GDK_CAP_BUTT: 
-@GDK_CAP_ROUND: 
-@GDK_CAP_PROJECTING: 
+</para>
 
-<!-- ##### ENUM GdkJoinStyle ##### -->
+@gc: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_gc_set_values ##### -->
 <para>
-Determines how the joins between segments of a polygon are drawn.
 
-<informaltable pgwide=1 frame="none" role="struct">
-<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
-<tbody>
+</para>
 
-<row>
-<entry>GDK_JOIN_MITER</entry>
-<entry>the sides of each line are extended to meet at an angle.</entry>
-</row>
+@gc: 
+@values: 
+@values_mask: 
 
-<row>
-<entry>GDK_JOIN_ROUND</entry>
-<entry>the sides of the two lines are joined by a circular arc.</entry>
-</row>
 
-<row>
-<entry>GDK_JOIN_BEVEL</entry>
-<entry>the sides of the two lines are joined by a straight line which
-       makes an equal angle with each line.</entry>
-</row>
+<!-- ##### FUNCTION gdk_gc_get_values ##### -->
+<para>
 
-</tbody></tgroup></informaltable>
 </para>
 
-@GDK_JOIN_MITER: 
-@GDK_JOIN_ROUND: 
-@GDK_JOIN_BEVEL: 
+@gc: 
+@values: 
 
-<!-- ##### FUNCTION gdk_gc_new ##### -->
+
+<!-- ##### FUNCTION gdk_gc_set_foreground ##### -->
 <para>
-Create a new graphics context with default values. 
+
 </para>
 
-@window: a #GdkDrawable. The created GC must always be used
- with drawables of the same depth as this one.
-@Returns: the new graphics context.
+@gc: 
+@color: 
 
 
-<!-- ##### FUNCTION gdk_gc_new_with_values ##### -->
+<!-- ##### FUNCTION gdk_gc_set_background ##### -->
 <para>
-Create a new GC with the given initial values.
+
 </para>
 
-@window: a #GdkDrawable. The created GC must always be used
- with drawables of the same depth as this one.
-@values: a structure containing initial values for the GC.
-@values_mask: a bit mask indicating which fields in @values
-   are set.
-@Returns: the new graphics context.
+@gc: 
+@color: 
 
 
-<!-- ##### FUNCTION gdk_gc_ref ##### -->
+<!-- ##### FUNCTION gdk_gc_set_rgb_fg_color ##### -->
 <para>
-Increase the reference count on a graphics context.
+
 </para>
 
-@gc: a #GdkGC.
-@Returns: @gc.
+@gc: 
+@color: 
 
 
-<!-- ##### FUNCTION gdk_gc_unref ##### -->
+<!-- ##### FUNCTION gdk_gc_set_rgb_bg_color ##### -->
 <para>
-Decrease the reference count on a graphics context. If
-the resulting reference count is zero, the graphics
-context will be destroyed.
+
 </para>
 
-@gc: a #GdkGC.
+@gc: 
+@color: 
 
 
-<!-- ##### FUNCTION gdk_gc_destroy ##### -->
+<!-- ##### FUNCTION gdk_gc_set_function ##### -->
 <para>
-Identical to gdk_gc_unref(). This function is obsolete
-and should not be used.
+
 </para>
 
-@gc: a #GdkGC.
+@gc: 
+@function: 
 
 
-<!-- ##### FUNCTION gdk_gc_get_values ##### -->
+<!-- ##### FUNCTION gdk_gc_set_fill ##### -->
 <para>
-Retrieves the current values from a graphics context.
+
 </para>
 
-@gc: a #GdkGC.
-@values: the #GdkGCValues structure in which to store the results.
+@gc: 
+@fill: 
 
 
-<!-- ##### FUNCTION gdk_gc_set_foreground ##### -->
+<!-- ##### ENUM GdkFill ##### -->
 <para>
-Sets the foreground color for a graphics context.
+Determines how primitives are drawn.
 </para>
 
-@gc: a #GdkGC.
-@color: the new foreground color.
+@GDK_SOLID: draw with the foreground color.
+@GDK_TILED: draw with a tiled pixmap.
+@GDK_STIPPLED: draw using the stipple bitmap. Pixels corresponding
+  to bits in the stipple bitmap that are set will be drawn in the
+  foreground color; pixels corresponding to bits that are
+  not set will be left untouched.
+@GDK_OPAQUE_STIPPLED: draw using the stipple bitmap. Pixels corresponding
+  to bits in the stipple bitmap that are set will be drawn in the
+  foreground color; pixels corresponding to bits that are
+  not set will be drawn with the background color.
 
-
-<!-- ##### FUNCTION gdk_gc_set_background ##### -->
+<!-- ##### FUNCTION gdk_gc_set_tile ##### -->
 <para>
-Sets the background color for a graphics context.
+
 </para>
 
-@gc: a #GdkGC.
-@color: the new background color.
+@gc: 
+@tile: 
 
 
-<!-- ##### FUNCTION gdk_gc_set_font ##### -->
+<!-- ##### FUNCTION gdk_gc_set_stipple ##### -->
 <para>
-Sets the font for a graphics context. (Note that
-all text-drawing functions in GDK take a @font
-argument; the value set here is used when that
-argument is %NULL.)
+
 </para>
 
-@gc: a #GdkGC.
-@font: the new font.
+@gc: 
+@stipple: 
 
 
-<!-- ##### FUNCTION gdk_gc_set_function ##### -->
+<!-- ##### FUNCTION gdk_gc_set_ts_origin ##### -->
 <para>
-Determines how the current pixel values and the
-pixel values being drawn are combined to produce
-the final pixel values.
+
 </para>
 
-@gc: a #GdkGC.
-@function: 
+@gc: 
+@x: 
+@y: 
 
 
-<!-- ##### FUNCTION gdk_gc_set_fill ##### -->
+<!-- ##### FUNCTION gdk_gc_set_clip_origin ##### -->
 <para>
-Set the fill mode for a graphics context.
+
 </para>
 
-@gc: a #GdkGC.
-@fill: the new fill mode.
+@gc: 
+@x: 
+@y: 
 
 
-<!-- ##### FUNCTION gdk_gc_set_tile ##### -->
+<!-- ##### FUNCTION gdk_gc_set_clip_mask ##### -->
 <para>
-Set a tile pixmap for a graphics context.
-This will only be used if the fill mode
-is %GDK_TILED.
+
 </para>
 
-@gc: a #GdkGC.
-@tile: the new tile pixmap.
+@gc: 
+@mask: 
 
 
-<!-- ##### FUNCTION gdk_gc_set_stipple ##### -->
+<!-- ##### FUNCTION gdk_gc_set_clip_rectangle ##### -->
 <para>
-Set the stipple bitmap for a graphics context. The
-stipple will only be used if the fill mode is
-%GDK_STIPPLED or %GDK_OPAQUE_STIPPLED.
 </para>
 
-@gc: a #GdkGC.
-@stipple: the new stipple bitmap.
+@gc: 
+@rectangle: 
 
 
-<!-- ##### FUNCTION gdk_gc_set_ts_origin ##### -->
+<!-- ##### FUNCTION gdk_gc_set_clip_region ##### -->
 <para>
-Set the origin when using tiles or stipples with
-the GC. The tile or stipple will be aligned such
-that the upper left corner of the tile or stipple
-will coincide with this point.
+
 </para>
 
-@gc: a #GdkGC.
-@x: the x-coordinate of the origin.
-@y: the y-coordinate of the origin.
+@gc: 
+@region: 
 
 
-<!-- ##### FUNCTION gdk_gc_set_clip_origin ##### -->
+<!-- ##### FUNCTION gdk_gc_set_subwindow ##### -->
 <para>
-Sets the origin of the clip mask. The coordinates are
-interpreted relative to the upper-left corner of
-the destination drawable of the current operation.
+
 </para>
 
-@gc: a #GdkGC.
-@x: the x-coordinate of the origin.
-@y: the y-coordinate of the origin.
+@gc: 
+@mode: 
 
 
-<!-- ##### FUNCTION gdk_gc_set_clip_mask ##### -->
+<!-- ##### ENUM GdkSubwindowMode ##### -->
 <para>
-Sets the clip mask for a graphics context from a bitmap.
-The clip mask is interpreted relative to the clip
-origin. (See gdk_gc_set_clip_origin()).
+Determines how drawing onto a window will affect child
+windows of that window. 
 </para>
 
-@gc: the #GdkGC.
-@mask: a bitmap.
-
+@GDK_CLIP_BY_CHILDREN: only draw onto the window itself.
+@GDK_INCLUDE_INFERIORS: draw onto the window and child windows.
 
-<!-- ##### FUNCTION gdk_gc_set_clip_rectangle ##### -->
+<!-- ##### FUNCTION gdk_gc_set_exposures ##### -->
 <para>
-Sets the clip mask for a graphics context from a
-rectangle. The clip mask is interpreted relative to the clip
-origin. (See gdk_gc_set_clip_origin()).
 
 </para>
 
-@gc: a #GdkGC.
-@rectangle: the rectangle to clip to.
+@gc: 
+@exposures: 
 
 
-<!-- ##### FUNCTION gdk_gc_set_clip_region ##### -->
+<!-- ##### FUNCTION gdk_gc_set_line_attributes ##### -->
 <para>
-Sets the clip mask for a graphics context from a region structure.
-The clip mask is interpreted relative to the clip origin. (See
-gdk_gc_set_clip_origin()).
+
 </para>
 
-@gc: a #GdkGC.
-@region: the #GdkRegion.
+@gc: 
+@line_width: 
+@line_style: 
+@cap_style: 
+@join_style: 
 
 
-<!-- ##### FUNCTION gdk_gc_set_subwindow ##### -->
+<!-- ##### ENUM GdkLineStyle ##### -->
 <para>
-Sets how drawing with this GC on a window will affect child
-windows of that window. 
+Determines how lines are drawn.
 </para>
 
-@gc: a #GdkGC.
-@mode: the subwindow mode.
-
+@GDK_LINE_SOLID: lines are drawn solid.
+@GDK_LINE_ON_OFF_DASH: even segments are drawn; odd segments are not drawn.
+@GDK_LINE_DOUBLE_DASH: even segments are normally. Odd segments are drawn
+  in the background color if the fill style is %GDK_SOLID, or in the background
+  color masked by the stipple if the fill style is %GDK_STIPPLED.
 
-<!-- ##### ENUM GdkSubwindowMode ##### -->
+<!-- ##### ENUM GdkCapStyle ##### -->
 <para>
+Determines how the end of lines are drawn.
+</para>
 
-Determines how drawing onto a window will affect child
-windows of that window. 
+@GDK_CAP_NOT_LAST: the same as %GDK_CAP_BUTT for lines of non-zero width.
+       for zero width lines, the final point on the line will not be drawn.
+@GDK_CAP_BUTT: the ends of the lines are drawn squared off and extending
+       to the coordinates of the end point.
+@GDK_CAP_ROUND: the ends of the lines are drawn as semicircles with the
+       diameter equal to the line width and centered at the end point.
+@GDK_CAP_PROJECTING: the ends of the lines are drawn squared off and extending
+       half the width of the line beyond the end point.
 
-<informaltable pgwide=1 frame="none" role="enum">
-<tgroup cols="2"><colspec colwidth="3*"><colspec colwidth="7*">
-<tbody>
+<!-- ##### ENUM GdkJoinStyle ##### -->
+<para>
+Determines how the joins between segments of a polygon are drawn.
+</para>
 
-<row>
-<entry>GDK_CLIP_BY_CHILDREN</entry>
-<entry>only draw onto the window itself.</entry>
-</row>
+@GDK_JOIN_MITER: the sides of each line are extended to meet at an angle.
+@GDK_JOIN_ROUND: the sides of the two lines are joined by a circular arc.
+@GDK_JOIN_BEVEL: the sides of the two lines are joined by a straight line which
+       makes an equal angle with each line.
 
-<row>
-<entry>GDK_INCLUDE_INFERIORS</entry>
-<entry>Draw onto the window and child windows.</entry>
-</row>
+<!-- ##### FUNCTION gdk_gc_set_dashes ##### -->
+<para>
 
-</tbody></tgroup></informaltable>
 </para>
 
-@GDK_CLIP_BY_CHILDREN: 
-@GDK_INCLUDE_INFERIORS: 
+@gc: 
+@dash_offset: 
+@dash_list: 
+@n: 
 
-<!-- ##### FUNCTION gdk_gc_set_exposures ##### -->
+
+<!-- ##### FUNCTION gdk_gc_copy ##### -->
 <para>
-Sets whether copying non-visible portions of a drawable
-using this graphics context generate exposure events
-for the corresponding regions of the destination
-drawable. (See gdk_draw_pixmap()).
+
 </para>
 
-@gc: a #GdkGC.
-@exposures: if %TRUE, exposure events will be generated.
+@dst_gc: 
+@src_gc: 
 
 
-<!-- ##### FUNCTION gdk_gc_set_line_attributes ##### -->
+<!-- ##### FUNCTION gdk_gc_set_colormap ##### -->
 <para>
-Sets various attributes of how lines are drawn. See
-the corresponding members of GdkGCValues for full
-explanations of the arguments.
+
 </para>
 
-@gc: a #GdkGC.
-@line_width: the width of lines.
-@line_style: the dash-style for lines.
-@cap_style: the manner in which the ends of lines are drawn.
-@join_style: the in which lines are joined together.
+@gc: 
+@colormap: 
 
 
-<!-- ##### FUNCTION gdk_gc_set_dashes ##### -->
+<!-- ##### FUNCTION gdk_gc_get_colormap ##### -->
 <para>
-Sets the way dashed-lines are drawn. Lines will be
-drawn with alternating on and off segments of the
-lengths specified in @dash_list. The manner in
-which the on and off segments are drawn is determined
-by the @line_style value of the GC. (This can
-be changed with gdk_gc_set_line_attributes)
+
 </para>
 
-@gc: a #GdkGC.
-@dash_offset: the
-@dash_list: an array of dash lengths.
-@n: the number of elements in @dash_list.
+@gc: 
+@Returns: 
 
 
-<!-- ##### FUNCTION gdk_gc_copy ##### -->
+<!-- ##### FUNCTION gdk_gc_offset ##### -->
 <para>
-Copy the set of values from one graphics context
-onto another graphics context.
+
 </para>
 
-@dst_gc: the destination graphics context.
-@src_gc: the source graphics context.
+@gc: 
+@x_offset: 
+@y_offset: 
+
+