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