You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@subversion.apache.org by Роман Донченко <DX...@yandex.ru> on 2009/07/01 23:26:20 UTC

Re: Mismatched backwards compat callbacks in libsvn_wc

Роман Донченко <DX...@yandex.ru> писал в своём письме Sat, 27 Jun 2009  
20:27:25 +0400:

> The immediate fix is obviously to write new wrappers for (3) and put them
> in callbacks3_wrapper.

The immediate fix is attached. It's rather trivial. 8=] Also of note is  
that it fixes the Python test I was struggling with.

[[[
Create proper wrapper functions for svn_wc_diff_callbacks3_t and use them.  
Also change the misleading comments on the old wrappers.

* subversion/libsvn_wc/deprecated.c
   (file_changed, file_deleted, dir_deleted, dir_props_changed, dir_opened,  
dir_closed): Relabel as svn_wc_diff_callbacks3_t functions, since that's  
what they're used as.
   (file_changed3, file_deleted3, dir_deleted3, dir_props_changed3,  
dir_opened2, dir_closed2): New functions.
   (callbacks3_wrapper): Use the new functions above.
]]]

> B. The naming scheme for wrappers is, well, poor. First, the names don't
> contain an indication of "wrapperness", so the purpose isn't immediately
> obvious; plus one may confuse, say, (1)::file_changed with  
> ::file_changed.
> Second, the names don't convey which generation of callbacks are they
> wrapping to and from. Combined with A, this makes the names quite
> unhelpful.

I'd also post a patch renaming the wrappers to something more telling — if  
someone approves.

> That's all for now.
>
> Generally yours,
> Roman.

What he said.

------------------------------------------------------
http://subversion.tigris.org/ds/viewMessage.do?dsForumId=462&dsMessageId=2367217

Re: [PATCH] Give the svn_wc_diff_callbacks*_t wrappers more descriptive names [Was: Mismatched backwards compat callbacks in libsvn_wc]

Posted by Gavin Baumanis <ga...@thespidernet.com>.
Hi Roman,

Absolutely nothing wrong with "pinging" your own patch.

Gavin.

On 11/07/2009, at 6:08 AM, Роман Донченко wrote:

> Роман Донченко <DX...@yandex.ru> писал в  
> своём письме Fri, 03 Jul 2009
> 01:06:23 +0400:
>
>> [[[
>> Give the svn_wc_diff_callbacks*_t wrappers more descriptive names.
>>
>> * subversion/libsvn_wc/deprecated.c: rename  
>> callbacks*_wrapper_baton to
>> diff_callbacks*_wrapper_baton, callbacks*_wrapper to
>> diff_callbacks*_wrapper and the wrapper functions to
>> wrap_?to*_<basename>.
>> ]]]
>
> Ping. This patch submission has received no comments.
>
> (Yeah, it's not my job to say that... but it's still true. ;=])
>
> Thank you for helping us help you help us all,
> Roman.
>
> ------------------------------------------------------
> http://subversion.tigris.org/ds/viewMessage.do?dsForumId=462&dsMessageId=2370140

------------------------------------------------------
http://subversion.tigris.org/ds/viewMessage.do?dsForumId=462&dsMessageId=2370599


[PATCH] Give the svn_wc_diff_callbacks*_t wrappers more descriptive names [Was: Mismatched backwards compat callbacks in libsvn_wc]

Posted by Роман Донченко <DX...@yandex.ru>.
Роман Донченко <DX...@yandex.ru> писал в своём письме Fri, 03 Jul 2009  
01:06:23 +0400:

> [[[
> Give the svn_wc_diff_callbacks*_t wrappers more descriptive names.
>
> * subversion/libsvn_wc/deprecated.c: rename callbacks*_wrapper_baton to
> diff_callbacks*_wrapper_baton, callbacks*_wrapper to
> diff_callbacks*_wrapper and the wrapper functions to  
> wrap_?to*_<basename>.
> ]]]

Ping. This patch submission has received no comments.

(Yeah, it's not my job to say that... but it's still true. ;=])

Thank you for helping us help you help us all,
Roman.

------------------------------------------------------
http://subversion.tigris.org/ds/viewMessage.do?dsForumId=462&dsMessageId=2370140


Re: Mismatched backwards compat callbacks in libsvn_wc

Posted by Роман Донченко <DX...@yandex.ru>.
Stefan Sperling <st...@elego.de> писал в своём письме Sat, 11 Jul 2009
00:36:15 +0400:

> On Fri, Jul 03, 2009 at 01:06:23AM +0400, Роман Донченко wrote:
>>  /* An svn_wc_diff_callbacks3_t function for wrapping  
>> svn_wc_diff_callbacks_t. */
>>  static svn_error_t *
>> -file_changed(svn_wc_adm_access_t *adm_access,
>> +wrap_3to1_file_changed(svn_wc_adm_access_t *adm_access,
>>               svn_wc_notify_state_t *contentstate,
>>               svn_wc_notify_state_t *propstate,
>>               svn_boolean_t *tree_conflicted,
>
> Please indent the other parameters, too, so that they all align again
> as they used to.

> Same here.

> Same here.

> Same here.

> Somehow it feels like I've seen this before...

Yeah, I think I get your point. 8=] Fixed and reattached.

Roman.

------------------------------------------------------
http://subversion.tigris.org/ds/viewMessage.do?dsForumId=462&dsMessageId=2370670

Re: Mismatched backwards compat callbacks in libsvn_wc

Posted by Stefan Sperling <st...@elego.de>.
On Thu, Jul 23, 2009 at 04:57:30PM +0400, Roman Donchenko wrote:
> Stefan Sperling <st...@elego.de> писал в своём письме Mon, 13 Jul 2009  
> 16:05:42 +0400:
> 
> > AFAIK you've already been given partial commit access.
> > As a partial committer you can commit any diff outside of your area
> > as long as a full committer gives you a +1.
> >
> > So you can commit this yourself, and include this line in the log  
> > message:
> > Approved by: stsp
> 
> So I finally did it, in r38473.

Thanks!

Stefan


Re: Mismatched backwards compat callbacks in libsvn_wc

Posted by Roman Donchenko <DX...@yandex.ru>.
Stefan Sperling <st...@elego.de> писал в своём письме Mon, 13 Jul 2009  
16:05:42 +0400:

> AFAIK you've already been given partial commit access.
> As a partial committer you can commit any diff outside of your area
> as long as a full committer gives you a +1.
>
> So you can commit this yourself, and include this line in the log  
> message:
> Approved by: stsp

So I finally did it, in r38473.

Roman.

------------------------------------------------------
http://subversion.tigris.org/ds/viewMessage.do?dsForumId=462&dsMessageId=2374806


Re: Mismatched backwards compat callbacks in libsvn_wc

Posted by Stefan Sperling <st...@elego.de>.
On Sun, Jul 12, 2009 at 03:51:59PM +0400, Роман Донченко wrote:
> Stefan Sperling <st...@elego.de> писал в своём письме Sat, 11 Jul 2009
> 00:36:15 +0400:
>
>> On Fri, Jul 03, 2009 at 01:06:23AM +0400, Роман Донченко wrote:
>>>  /* An svn_wc_diff_callbacks3_t function for wrapping  
>>> svn_wc_diff_callbacks_t. */
>>>  static svn_error_t *
>>> -file_changed(svn_wc_adm_access_t *adm_access,
>>> +wrap_3to1_file_changed(svn_wc_adm_access_t *adm_access,
>>>               svn_wc_notify_state_t *contentstate,
>>>               svn_wc_notify_state_t *propstate,
>>>               svn_boolean_t *tree_conflicted,
>>
>> Please indent the other parameters, too, so that they all align again
>> as they used to.
>
>> Same here.
>
>> Same here.
>
>> Same here.
>
>> Somehow it feels like I've seen this before...
>
> Yeah, I think I get your point. 8=] Fixed and reattached.

AFAIK you've already been given partial commit access.
As a partial committer you can commit any diff outside of your area
as long as a full committer gives you a +1.

So you can commit this yourself, and include this line in the log message:
Approved by: stsp

See also http://subversion.tigris.org/hacking.html#commit-access

Stefan


Re: Mismatched backwards compat callbacks in libsvn_wc

Posted by Роман Донченко <DX...@yandex.ru>.
Stefan Sperling <st...@elego.de> писал в своём письме Sat, 11 Jul 2009
00:36:15 +0400:

> On Fri, Jul 03, 2009 at 01:06:23AM +0400, Роман Донченко wrote:
>>  /* An svn_wc_diff_callbacks3_t function for wrapping  
>> svn_wc_diff_callbacks_t. */
>>  static svn_error_t *
>> -file_changed(svn_wc_adm_access_t *adm_access,
>> +wrap_3to1_file_changed(svn_wc_adm_access_t *adm_access,
>>               svn_wc_notify_state_t *contentstate,
>>               svn_wc_notify_state_t *propstate,
>>               svn_boolean_t *tree_conflicted,
>
> Please indent the other parameters, too, so that they all align again
> as they used to.

> Same here.

> Same here.

> Same here.

> Somehow it feels like I've seen this before...

Yeah, I think I get your point. 8=] Fixed and reattached.

Roman.

------------------------------------------------------
http://subversion.tigris.org/ds/viewMessage.do?dsForumId=462&dsMessageId=2371250

Re: Mismatched backwards compat callbacks in libsvn_wc

Posted by Stefan Sperling <st...@elego.de>.
On Fri, Jul 03, 2009 at 01:06:23AM +0400, Роман Донченко wrote:
>  /* An svn_wc_diff_callbacks3_t function for wrapping svn_wc_diff_callbacks_t. */
>  static svn_error_t *
> -file_changed(svn_wc_adm_access_t *adm_access,
> +wrap_3to1_file_changed(svn_wc_adm_access_t *adm_access,
>               svn_wc_notify_state_t *contentstate,
>               svn_wc_notify_state_t *propstate,
>               svn_boolean_t *tree_conflicted,

Please indent the other parameters, too, so that they all align again
as they used to.

> @@ -585,7 +585,7 @@
>               apr_hash_t *originalprops,
>               void *diff_baton)
>  {
> -  struct callbacks_wrapper_baton *b = diff_baton;
> +  struct diff_callbacks_wrapper_baton *b = diff_baton;
>  
>    if (tree_conflicted)
>      *tree_conflicted = FALSE;
> @@ -605,7 +605,7 @@
>  
>  /* An svn_wc_diff_callbacks3_t function for wrapping svn_wc_diff_callbacks_t. */
>  static svn_error_t *
> -file_added(svn_wc_adm_access_t *adm_access,
> +wrap_3to1_file_added(svn_wc_adm_access_t *adm_access,
>             svn_wc_notify_state_t *contentstate,
>             svn_wc_notify_state_t *propstate,
>             svn_boolean_t *tree_conflicted,

Same here.

> @@ -620,7 +620,7 @@
>             apr_hash_t *originalprops,
>             void *diff_baton)
>  {
> -  struct callbacks_wrapper_baton *b = diff_baton;
> +  struct diff_callbacks_wrapper_baton *b = diff_baton;
>  
>    if (tree_conflicted)
>      *tree_conflicted = FALSE;
> @@ -638,7 +638,7 @@
>  
>  /* An svn_wc_diff_callbacks3_t function for wrapping svn_wc_diff_callbacks_t. */
>  static svn_error_t *
> -file_deleted(svn_wc_adm_access_t *adm_access,
> +wrap_3to1_file_deleted(svn_wc_adm_access_t *adm_access,
>               svn_wc_notify_state_t *state,
>               svn_boolean_t *tree_conflicted,
>               const char *path,

Same here.

> @@ -649,7 +649,7 @@
>               apr_hash_t *originalprops,
>               void *diff_baton)
>  {
> -  struct callbacks_wrapper_baton *b = diff_baton;
> +  struct diff_callbacks_wrapper_baton *b = diff_baton;
>  
>    if (tree_conflicted)
>      *tree_conflicted = FALSE;
> @@ -663,14 +663,14 @@
>  
>  /* An svn_wc_diff_callbacks3_t function for wrapping svn_wc_diff_callbacks_t. */
>  static svn_error_t *
> -dir_added(svn_wc_adm_access_t *adm_access,
> +wrap_3to1_dir_added(svn_wc_adm_access_t *adm_access,
>            svn_wc_notify_state_t *state,
>            svn_boolean_t *tree_conflicted,
>            const char *path,
>            svn_revnum_t rev,
>            void *diff_baton)

Same here.

>  {
> -  struct callbacks_wrapper_baton *b = diff_baton;
> +  struct diff_callbacks_wrapper_baton *b = diff_baton;
>  
>    if (tree_conflicted)
>      *tree_conflicted = FALSE;
> @@ -680,13 +680,13 @@
>  
>  /* An svn_wc_diff_callbacks3_t function for wrapping svn_wc_diff_callbacks_t. */
>  static svn_error_t *
> -dir_deleted(svn_wc_adm_access_t *adm_access,
> +wrap_3to1_dir_deleted(svn_wc_adm_access_t *adm_access,
>              svn_wc_notify_state_t *state,
>              svn_boolean_t *tree_conflicted,
>              const char *path,
>              void *diff_baton)

Somehow it feels like I've seen this before...

>  {
> -  struct callbacks_wrapper_baton *b = diff_baton;
> +  struct diff_callbacks_wrapper_baton *b = diff_baton;
>  
>    if (tree_conflicted)
>      *tree_conflicted = FALSE;
> @@ -696,7 +696,7 @@
>  
>  /* An svn_wc_diff_callbacks3_t function for wrapping svn_wc_diff_callbacks_t. */
>  static svn_error_t *
> -dir_props_changed(svn_wc_adm_access_t *adm_access,
> +wrap_3to1_dir_props_changed(svn_wc_adm_access_t *adm_access,
>                    svn_wc_notify_state_t *state,
>                    svn_boolean_t *tree_conflicted,
>                    const char *path,

When I play Mario Kart I always get blue shells!

> @@ -704,7 +704,7 @@
>                    apr_hash_t *originalprops,
>                    void *diff_baton)
>  {
> -  struct callbacks_wrapper_baton *b = diff_baton;
> +  struct diff_callbacks_wrapper_baton *b = diff_baton;
>  
>    if (tree_conflicted)
>      *tree_conflicted = FALSE;
> @@ -716,7 +716,7 @@
>  /* An svn_wc_diff_callbacks3_t function for wrapping svn_wc_diff_callbacks_t
>     and svn_wc_diff_callbacks2_t. */
>  static svn_error_t *
> -dir_opened(svn_wc_adm_access_t *adm_access,
> +wrap_3to1or2_dir_opened(svn_wc_adm_access_t *adm_access,
>             svn_boolean_t *tree_conflicted,
>             const char *path,
>             svn_revnum_t rev,

Well it keeps going on like this and I can't think of more
inventive things to say.

I've scanned the rest but couldn't find anything wrong with it.
The compiler here is also happy with the patch applied.
With fixed parameter indentation, I'd say +1.

svn patch is not able to digest this diff by the way.
  svn: In file 'subversion/libsvn_client/patch.c' line 2201: assertion
  failed (target->current_line == hunk_start)
  Aborted (core dumped)
But that's likely to be entirely my own fault and not yours, so it does
not count towards the review :)

Thanks,
Stefan


Re: Mismatched backwards compat callbacks in libsvn_wc

Posted by Роман Донченко <DX...@yandex.ru>.
Hyrum K. Wright <hy...@hyrumwright.org> писал в своём письме Thu, 02 Jul  
2009 19:44:44 +0400:

> I applied the patch locally, and the python tests no longer segfault.
> Thanks very much for tracking this down!  With the patch, I now get an
> error in the tests, but not a crash:

> ======================================================================
> ERROR: test_lock (wc.SubversionWorkingCopyTestCase)
> ----------------------------------------------------------------------
> Traceback (most recent call last):
>    File "/home/hwright/dev/svn-trunk/subversion/bindings/swig/python/
> tests/wc.py", line 48, in test_lock
>      lock = wc.add_lock(self.path, core.svn_lock_create(core.Pool()),
> self.wc)
>    File "/home/hwright/dev/svn-trunk/subversion/bindings/swig/python/
> libsvn/wc.py", line 2814, in svn_wc_add_lock
>      return apply(_wc.svn_wc_add_lock, args)
> SubversionException: ('traced call', 200030)
>
> ----------------------------------------------------------------------

This is a different test, but yep, happens for me too. Will investigate.

> (Note that that this doesn't *not* solve the segfault in the ruby
> tests.)

That's outside my expertise, unfortunately.

> Any improvements to documentation, including function naming are
> definitely encouraged.  Feel free to do a followup patch.

Alrighty then!

[[[
Give the svn_wc_diff_callbacks*_t wrappers more descriptive names.

* subversion/libsvn_wc/deprecated.c: rename callbacks*_wrapper_baton to  
diff_callbacks*_wrapper_baton, callbacks*_wrapper to  
diff_callbacks*_wrapper and the wrapper functions to wrap_?to*_<basename>.
]]]

Roman.

------------------------------------------------------
http://subversion.tigris.org/ds/viewMessage.do?dsForumId=462&dsMessageId=2367601

Re: Mismatched backwards compat callbacks in libsvn_wc

Posted by "C. Michael Pilato" <cm...@collab.net>.
Hyrum K. Wright wrote:
> On Jul 1, 2009, at 6:26 PM, Роман Донченко wrote:
> 
>> Роман Донченко <DX...@yandex.ru> писал в  
>> своём письме Sat, 27 Jun 2009
>> 20:27:25 +0400:
>>
>>> The immediate fix is obviously to write new wrappers for (3) and  
>>> put them in callbacks3_wrapper.
>> The immediate fix is attached. It's rather trivial. 8=] Also of note  
>> is that it fixes the Python test I was struggling with.

[...]

> Committed to trunk in r38307.

Awesome!  Thanks, guys.

-- 
C. Michael Pilato <cm...@collab.net>
CollabNet   <>   www.collab.net   <>   Distributed Development On Demand

------------------------------------------------------
http://subversion.tigris.org/ds/viewMessage.do?dsForumId=462&dsMessageId=2368349

Re: Mismatched backwards compat callbacks in libsvn_wc

Posted by Joe Swatosh <jo...@gmail.com>.
2009/7/2 Hyrum K. Wright <hy...@hyrumwright.org>:
> On Jul 1, 2009, at 6:26 PM, Роман Донченко wrote:
>
>> Роман Донченко <DX...@yandex.ru> писал в
>> своём письме Sat, 27 Jun 2009
>> 20:27:25 +0400:
>>
>>> The immediate fix is obviously to write new wrappers for (3) and
>>> put them
>>> in callbacks3_wrapper.
>>
>> The immediate fix is attached. It's rather trivial. 8=] Also of note
>> is
>> that it fixes the Python test I was struggling with.
>>
>> [[[
>> Create proper wrapper functions for svn_wc_diff_callbacks3_t and use
>> them.
>> Also change the misleading comments on the old wrappers.
>>
>> * subversion/libsvn_wc/deprecated.c
>>   (file_changed, file_deleted, dir_deleted, dir_props_changed,
>> dir_opened,
>> dir_closed): Relabel as svn_wc_diff_callbacks3_t functions, since
>> that's
>> what they're used as.
>>   (file_changed3, file_deleted3, dir_deleted3, dir_props_changed3,
>> dir_opened2, dir_closed2): New functions.
>>   (callbacks3_wrapper): Use the new functions above.
>> ]]]
>
> I applied the patch locally, and the python tests no longer segfault.
> Thanks very much for tracking this down!  With the patch, I now get an
> error in the tests, but not a crash:
>
> hwright@orac:~/dev/svn-trunk$ make check-swig-py
> cd /home/hwright/dev/svn-trunk/subversion/bindings/swig/python; \
>          /usr/bin/python /home/hwright/dev/svn-trunk/subversion/bindings/
> swig/python/tests/run_all.py
> /home/hwright/dev/svn-trunk/subversion/bindings/swig/python/svn/
> core.py:47: DeprecationWarning: BaseException.message has been
> deprecated as of Python 2.6
>   self.message = message
> /home/hwright/dev/svn-trunk/subversion/bindings/swig/python/tests/
> core.py:17: DeprecationWarning: BaseException.message has been
> deprecated as of Python 2.6
>   self.assertEqual(svn.core.SubversionException('error message',
> 1).message,
> ...............................................................E
> ..........................................
> ======================================================================
> ERROR: test_lock (wc.SubversionWorkingCopyTestCase)
> ----------------------------------------------------------------------
> Traceback (most recent call last):
>   File "/home/hwright/dev/svn-trunk/subversion/bindings/swig/python/
> tests/wc.py", line 48, in test_lock
>     lock = wc.add_lock(self.path, core.svn_lock_create(core.Pool()),
> self.wc)
>   File "/home/hwright/dev/svn-trunk/subversion/bindings/swig/python/
> libsvn/wc.py", line 2814, in svn_wc_add_lock
>     return apply(_wc.svn_wc_add_lock, args)
> SubversionException: ('traced call', 200030)
>
> ----------------------------------------------------------------------
> Ran 106 tests in 55.597s
>
> FAILED (errors=1)
> make: *** [check-swig-py] Error 1
>
>
> (Note that that this doesn't *not* solve the segfault in the ruby
> tests.)

This patch seems similar to what I posted in
http://subversion.tigris.org/ds/viewMessage.do?dsForumId=462&dsMessageId=2359987
but failed to express accurately what the problem was in prose.  Thanks Roman.

And it does cause the Ruby bindings to not segfault for me locally.  (I get 6
errors and 1 failure).  I will continue to look into this as time allows.

> Committed to trunk in r38307.
>

yay!


--
Joe

------------------------------------------------------
http://subversion.tigris.org/ds/viewMessage.do?dsForumId=462&dsMessageId=2367706


Re: Mismatched backwards compat callbacks in libsvn_wc

Posted by "Hyrum K. Wright" <hy...@hyrumwright.org>.
On Jul 1, 2009, at 6:26 PM, Роман Донченко wrote:

> Роман Донченко <DX...@yandex.ru> писал в  
> своём письме Sat, 27 Jun 2009
> 20:27:25 +0400:
>
>> The immediate fix is obviously to write new wrappers for (3) and  
>> put them
>> in callbacks3_wrapper.
>
> The immediate fix is attached. It's rather trivial. 8=] Also of note  
> is
> that it fixes the Python test I was struggling with.
>
> [[[
> Create proper wrapper functions for svn_wc_diff_callbacks3_t and use  
> them.
> Also change the misleading comments on the old wrappers.
>
> * subversion/libsvn_wc/deprecated.c
>   (file_changed, file_deleted, dir_deleted, dir_props_changed,  
> dir_opened,
> dir_closed): Relabel as svn_wc_diff_callbacks3_t functions, since  
> that's
> what they're used as.
>   (file_changed3, file_deleted3, dir_deleted3, dir_props_changed3,
> dir_opened2, dir_closed2): New functions.
>   (callbacks3_wrapper): Use the new functions above.
> ]]]

I applied the patch locally, and the python tests no longer segfault.   
Thanks very much for tracking this down!  With the patch, I now get an  
error in the tests, but not a crash:

hwright@orac:~/dev/svn-trunk$ make check-swig-py
cd /home/hwright/dev/svn-trunk/subversion/bindings/swig/python; \
	  /usr/bin/python /home/hwright/dev/svn-trunk/subversion/bindings/ 
swig/python/tests/run_all.py
/home/hwright/dev/svn-trunk/subversion/bindings/swig/python/svn/ 
core.py:47: DeprecationWarning: BaseException.message has been  
deprecated as of Python 2.6
   self.message = message
/home/hwright/dev/svn-trunk/subversion/bindings/swig/python/tests/ 
core.py:17: DeprecationWarning: BaseException.message has been  
deprecated as of Python 2.6
   self.assertEqual(svn.core.SubversionException('error message',  
1).message,
...............................................................E 
..........................................
======================================================================
ERROR: test_lock (wc.SubversionWorkingCopyTestCase)
----------------------------------------------------------------------
Traceback (most recent call last):
   File "/home/hwright/dev/svn-trunk/subversion/bindings/swig/python/ 
tests/wc.py", line 48, in test_lock
     lock = wc.add_lock(self.path, core.svn_lock_create(core.Pool()),  
self.wc)
   File "/home/hwright/dev/svn-trunk/subversion/bindings/swig/python/ 
libsvn/wc.py", line 2814, in svn_wc_add_lock
     return apply(_wc.svn_wc_add_lock, args)
SubversionException: ('traced call', 200030)

----------------------------------------------------------------------
Ran 106 tests in 55.597s

FAILED (errors=1)
make: *** [check-swig-py] Error 1


(Note that that this doesn't *not* solve the segfault in the ruby  
tests.)

Committed to trunk in r38307.

>> B. The naming scheme for wrappers is, well, poor. First, the names  
>> don't
>> contain an indication of "wrapperness", so the purpose isn't  
>> immediately
>> obvious; plus one may confuse, say, (1)::file_changed with
>> ::file_changed.
>> Second, the names don't convey which generation of callbacks are they
>> wrapping to and from. Combined with A, this makes the names quite
>> unhelpful.
>
> I'd also post a patch renaming the wrappers to something more  
> telling — if
> someone approves.

Any improvements to documentation, including function naming are  
definitely encouraged.  Feel free to do a followup patch.

-Hyrum

------------------------------------------------------
http://subversion.tigris.org/ds/viewMessage.do?dsForumId=462&dsMessageId=2367413