Re: g_signal_emit: what is "detail" ?

[Owen Taylor <otaylor redhat com>]

On Sat, 2003-05-03 at 07:55, paolo borelli wrote:
> Hi!
>
> I'm porting some code to gtk2 and I want to replace gtk_signal_emit with
> g_signal_emit. I see that g_signal_emit has an additional parameter
> called "detail" but I couldn't find what is for and what I have to pass
> to it when calling the function...
>
> The docs are a little too terse:
>
> ...
> detail: the detail
> ...
>
> So I looked at some other app: I had gnome-terminal handy and there I
> saw that it always pass 0 as detail.
>
> Can someone give me some advice and/or point me to more verbose docs?

Best example of detail is for the ::notify signal for property changes:

 g_signal_connect (entry, "notify::cursor_position", ...)

If you use g_signal_emit_by_name() you'd use a text form like this,
but for g_signal_emit(), you instead provide a signal_id/quark
pair.

Most signals don't have an interesting detail, so pass 0.

Regards,
                                      Owen