Skip Menu |

This queue is for tickets about the WWW-Facebook-API CPAN distribution.

Report information
The Basics
Id: 30737
Status: resolved
Priority: 0/
Queue: WWW-Facebook-API

People
Owner: Nobody in particular
Requestors: LEEDO [...] cpan.org
Cc:
AdminCc:

Bug Information
Severity: Important
Broken in: v0.4.8
Fixed in: (no value)



Subject: documentation errors for notifcations
Throughout the site there are inconsistencies in how to use notification.send. In the WWW:Facebook::API POD it says to pass in a 'markup' parameter. In the WWW::Facebook::API::Notifications POD it says to pass in a 'notifications' parameter. Both of these are incorrect, it should be a parameter called 'notification'.
Subject: Re: [rt.cpan.org #30737] documentation errors for notifcations
Date: Sun, 25 Nov 2007 11:51:57 -0800
To: via RT <bug-WWW-Facebook-API [...] rt.cpan.org>
From: David Romano <unobe [...] cpan.org>
Hi Lee, via RT wrote on Wed, Nov 14, 2007 at 12:12:35PM PST: Show quoted text
> Throughout the site there are inconsistencies in how to use > notification.send. In the WWW:Facebook::API POD it says to pass in a > 'markup' parameter. In the WWW::Facebook::API::Notifications POD it says > to pass in a 'notifications' parameter. Both of these are incorrect, it > should be a parameter called 'notification'.
I have fixed the documentation for that method and for a few other methods. Facebook doesn't do a good job versioning their software, and they have changed parameters in the meantime (thereby creating some of the documentation mistakes). For the one you mentioned, 'markup' used to be correct. I then updated the docs only partially when Facebook changed the parameter name, and did a slipshod job of it. Anyway, the newest version of WWW::Facebook::API (0.4.9) has the fixes ( https://pause.perl.org/pub/PAUSE/authors/id/U/UN/UNOBE/WWW-Facebook-API-v0.4.9.tar.gz ). As always, you can contribute by sending a patch against the latest )source (see the POD for the location). Thanks for the bug report, - David -- "Beware of the piety that denies the natural life, it is a fraud." -- Oswald Chambers, My Utmost for His Highest, October 9
Fixed in v0.4.9