svn_wc_adm_probe_try3 docstring question

Hi,

I'm reading svn_wc.h and came across something in the
docstring for svn_wc_adm_probe_try3() I'm a bit
confused with (at this stage, not very hard to do).

If I understand it correctly, the process is as follows:

   1) obtain adm_access via svn_wc_adm_probe_retrieve()
   2) if it fails because associated can't give a baton
      for path or path's parent, then try svn_wc_adm_probe_open3()
      with write_lock and levels_to_lock as parameters.
   3) If there is still no access because path is not a versioned
      directory, then set adm_access to NULL and return success.

Pardon my density (of a neutron star), but if it failed on
all those accounts, why is a 'success' being returned and
not some error? It can't retrieve anything because of the
failures, so wouldn't an error be suitable?

Thanks for any clarifications in this.

Edmund

PS: While I'm on the topic of svn_wc.h, if I find a
     docstring 'error', who do I report it to? Thanks

------------------------------------------------------
http://subversion.tigris.org/ds/viewMessage.do?dsForumId=462&dsMessageId=1747018
Received on 2009-04-16 14:57:15 CEST