Tony (et al)
Duly noted - this is perfect actually... And a good project for a new
documentarian! *snicker*
Charles Daminato
TUCOWS Product Manager
[EMAIL PROTECTED]
On Fri, 24 Aug 2001, Tony Levaggi wrote:
>
> I've got one BIG request for the documentation - that there is an XML
> example Request and Response for each Action. At the moment there are only
> XML examples for some of them, and the examples that are used only really
> represent the Perl structures. Not much use for those os us not using Perl.
>
> Tony Levaggi
> Tetradom NZ
>
> -----Original Message-----
> From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED]]On
> Behalf Of Charles Daminato
> Sent: Thursday, 23 August 2001 10:48 p.m.
> To: Matt Prigge
> Cc: [EMAIL PROTECTED]
> Subject: Re: API Doc Error (?)
>
>
> Definitely the documentation requires updating, and that's what we're
> doing.
>
> Charles Daminato
> TUCOWS Product Manager
> [EMAIL PROTECTED]
>
> On Wed, 22 Aug 2001, Matt Prigge wrote:
>
> > That was my guess. I guess the question really is whether the API will be
> > modified to match the docs or vice-versa. When/If you know the answer to
> > that, let us know.
> >
> > - Matt
> >
> > ----- Original Message -----
> > From: "Charles Daminato" <[EMAIL PROTECTED]>
> > To: "Matt Prigge" <[EMAIL PROTECTED]>
> > Cc: <[EMAIL PROTECTED]>
> > Sent: Wednesday, August 22, 2001 8:56 PM
> > Subject: Re: API Doc Error (?)
> >
> >
> > > Matt,
> > >
> > > My guess would be that there's a discrepancy between the API
> documentation
> > > and the actual results. Admittedly the API has fallen a little out of
> > > whack with the docs (or vice versa?) - we're working hard to get this
> back
> > > up to date, as we know how important it is to everyone.
> > >
> > > Charles Daminato
> > > TUCOWS Product Manager
> > > [EMAIL PROTECTED]
> > >
> > > On Wed, 22 Aug 2001, Matt Prigge wrote:
> > >
> > > > Hey Folks,
> > > > Pg 55/130 from the PDF of the OpenSRS v2.4 API states that the
> > attribute
> > > > 'remainder' which gets returned from a 'get_domain' request with a
> type
> > of
> > > > 'list' should be "The amount of remaining domain names (this is used
> for
> > > > paging, and represents the number of domain names still to show)".
> Some
> > > > quick testing using the opensrs-php client shows that this actually
> > behaves
> > > > as a boolean stating whether or not there is a remainder, not
> > necessarily
> > > > what that remainder is (I have taken a look at the raw XML so I am
> > fairly
> > > > sure this isnt the client's fault).
> > > > My question is whether the documentation is wrong or whether the
> API
> > is
> > > > misbehaving (or at least not working to specification). This isnt a
> > terribly
> > > > big deal, because you can get this number from seeing how many domains
> > the
> > > > get_domain function returns and which page youre on to see how many
> > domains
> > > > you've already seen and then subtract this from the 'count' field to
> get
> > the
> > > > remainder. The only downside to this is that its overly complicated
> and
> > > > basically renders the 'remainder' field useless except as a
> convenience.
> > > > My suggestion would be to fix the API (if it is in fact broken) to
> > > > return the actual remainder. This is safe for people who have been
> using
> > it
> > > > as a bool since most anything other than 0 or undef will eval as TRUE
> in
> > > > perl (and PHP). Not so sure about other languages, but I dont know
> that
> > > > other languages are used a whole lot anyhow.
> > > >
> > > > Thanks!
> > > > Matt Prigge
> > > >
> > > >
> > >
> >
> >
>
>
