gdk-gc-copy comments (was: Added a bunch of GDK routines.)

[Kevin Ryde <user42@zip.com.au>]

[-- Attachment #1: Type: text/plain, Size: 717 bytes --]

Marko Rauhamaa <marko@pacujo.net> writes:
>
>  - gdk-1.2.defs: Added the functions gdk_gc_copy,

I found the comments in the defs file for this a bit confusing.  At
first I thought it was saying there was something wrong with
gdk-gc-copy (which there's not).

I suppose it could be made clear that what's being talked about is a
new sort of duplicate or create-and-copy operation, but since as
stated that's either not possible or not very natural, I'd propose
just to remove the remarks.  If one really started writing about all
the stylistic idiosyncrasies of gtk and X it could quickly turn into a
small book :-).

        * gdk-1.2.defs (gdk_gc_copy): Remove comments about hypothetical
        create-and-copy.


[-- Attachment #2: gdk-1.2.defs.gc-copy-comment.diff --]
[-- Type: text/plain, Size: 663 bytes --]

--- gdk-1.2.defs.~1.32.~	2003-06-15 09:28:33.000000000 +1000
+++ gdk-1.2.defs	2003-06-15 09:48:51.000000000 +1000
@@ -538,17 +538,6 @@
   (GdkGC (copy #f))
   ((GdkWindow window)))
 
-; You can't convert gdk_gc_copy into one that returns the copy because
-; there is no way to determine the window of src_gc, and you can't
-; create dst_gc without a window. You could create a function like this:
-;
-;   (define-func gdk_gc_copy_interp
-;     GdkGC
-;     ((GdkWindow window)
-;      (GdkGC gc)))
-;
-; but it would not be any more natural or flexible to use than the
-; interface of the original C function.
 (define-func gdk_gc_copy
   none
   ((GdkGC dst_gc)