Re: g_app_launch_context_get_startup_notify_id

[Murray Cumming <murrayc murrayc com>]

On Mon, 2008-07-07 at 10:38 -0400, Matthias Clasen wrote:
> On Mon, Jul 7, 2008 at 8:02 AM, Murray Cumming <murrayc murrayc com> wrote:
> 
> > I thought we were talking about
> > g_app_launch_context_get_startup_notify_id() and
> > g_app_launch_context_get_display(). They do not say what their
> > parameters do.
> 
> These functions are basically implementation details and are called in
> the process of
> a launch operation, so the files parameter is supposed to take the
> files that are passed
> as arguments to the launched application. It is really not very useful
> to call these function
> outside of a launch operation. The docs should probably say so.

OK. I might try to improve the documentation if nobody else does it
first.

> > I hate how often our documentation even sometimes just says "@thing: a
> > #GThing".
> 
> I typically use this pattern when documenting the "this" parameter of
> an object method.
> What else would you say there ?

Yes, for "this" parameters there isn't much more to say. In fact, I
think they should have special status in gtk-doc syntax so you don't
even need to write that.

Murray