Re: svn commit: r1488693 - /subversion/trunk/subversion/bindings/swig/perl/native/Client.pm

On Sun, Jul 7, 2013 at 5:11 PM, Daniel Shahaf <danielsh_at_apache.org> wrote:

> Nothing is useful without proper documentation, but devil's advocate
> says the bindings can be quite usable if you document only the delta
> between SVN::Client->info42 and svn_client_info42().
>

First of all, you have to tell people that there is a SVN::Client->info42
at all.
The current POD only talks about SVN::Client->info, you have to look
into the SVN::Client (Perl) source to see that info42 is in the @all_fn
list,
so it's probably wrapped (of course, this could also just be a typo).
So that't the reason for the ADDITIONAL METHODS section.

As for the "delta" (Perl vs C) argument: all Perl etc bindings for large
C-based libraries have this problem. With my Perl developer hat on
I would probably scoff at your suggestion - if I want to hack Subversion
in Perl why should I be forced to look at C documentation?

Cheers, Roderich
Received on 2013-07-07 17:54:40 CEST