Re: [PATCH] small improvements to GLib API docs
- From: Behdad Esfahbod <behdad cs toronto edu>
- To: Matthias Clasen <mclasen redhat com>
- Cc: Davyd Madeley <davyd fugro-fsi com au>, gtk-devel-list gnome org
- Subject: Re: [PATCH] small improvements to GLib API docs
- Date: Fri, 30 Sep 2005 16:09:27 -0400 (EDT)
On Fri, 30 Sep 2005, Matthias Clasen wrote:
> On Fri, 2005-09-30 at 12:55 +0800, Davyd Madeley wrote:
> > This bit two people yesterday (one of them was me) in wondering how
> > g_strchomp and g_strchug actually worked. Did it allocate memory, did it
> > return different pointers, would I have to keep another pointer around.
> > Stuff like that.
> >
> > I added a couple of sentences and some cross referencing (because the
> > functions aren't entirely clearly named) in an attempt to clear this up.
> >
>
> Hmm, "Returns: @string" is supposed to convey that the function does not
> return any newly allocated memory, but maybe it is a little terse.
>
> Feel free to commit your doc additions after fixing the grammar ("is
> return" should be "is returned").
I prefer not saying "it doesn't allocate or reallocate". Just
say it edits @string in place.
> Regards, Matthias
--behdad
http://behdad.org/
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]