im.pidgin.pidgin: 88b3b37295912c156c79eb9b1aece31e02fc9d00
Will Thompson
will at willthompson.co.uk
Thu Jan 17 07:30:14 EST 2008
On Thu, Jan 17, 2008 at 01:26:57AM -0500, Mark Doliner wrote:
> On Tue, 15 Jan 2008 14:55:59 -0500 (EST), resiak wrote
> > ChangeLog:
> >
> > Clarify documentation of purple_account_set_status_list(), and use
> > @copydoc to make purple_account_set_status() have the exact same
> > text (prefixed with a remark about being a vargs version of the
> > former).
> >
> > Do people like this? We have duplicated docs all over the place
> > with vargs and GList/va_list versions of functions, and it seems
> > like we should either use @copydoc for one, or make its doc just
> > read "version of foo_list(), see it for documentation".
>
> I like this. I think I like "version of foo_list(), see it for documentation"
> a little bit more, but I think both are really good.
Looking at the generated documentation again, I think I agree with you
that "see over there" is better than @copydoc.
I have updated #4638 accordingly! I'll probably go through fixing
obvious repetitions up next week.
--
Will
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
URL: <http://pidgin.im/pipermail/devel/attachments/20080117/10803e0a/attachment.sig>
More information about the Devel
mailing list