gtk_whatever_foo() is
typically a public function which emits the "foo" signal, taking care of any
necessary details before and after emission (remember
that only
GTK_RUN_ACTION signals can be emitted without
special actions before and after). gtk_whatever_real_foo() will be the
default handler for the signal, installed in the
object's class struct. the
chapter called Writing a
GtkWidget has many examples of this.