[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: To Greg Stein

From: Daniel Shahaf <d.s_at_daniel.shahaf.name>
Date: Mon, 18 Aug 2008 20:27:23 +0300 (Jerusalem Daylight Time)

Greg Stein wrote on Mon, 18 Aug 2008 at 08:05 -0700:
> As I've been poring over svn_wc.h, I've been thinking that we need
> svn_deprecated.h and move all of the function signatures and types
> into that file. Let them all sit there, undocumented ("want doc? look

I like having the diff'ed doc-strings [1] available, using them is
easier than reading doc-strings on two branches and doing a mental diff.

In other words, I think the doc-strings are useful :)

> in prior releases. kthxbai."). That header would then be included by
> all other headers (old code including (say) svn_wc.h still needs the
> deprecated API to be visible). Doing this would clean up our header
> files a LOT. Thoughts?



[1] "Similar to svn_foo1(), but with the @a parameter always set to @c", etc.

To unsubscribe, e-mail: dev-unsubscribe_at_subversion.tigris.org
For additional commands, e-mail: dev-help_at_subversion.tigris.org
Received on 2008-08-18 19:27:44 CEST

This is an archived mail posted to the Subversion Dev mailing list.

This site is subject to the Apache Privacy Policy and the Apache Public Forum Archive Policy.