X-debbugs-cc: [email protected]
Package: flickcurl-utils
Version: 1.21-1
Severity: wishlist
File: /usr/share/man/man1/flickcurl.1.gz
Here are what problems I have found so far.
On the flickcurl man page:
Mention that all output goes to STDERR for some strange reason.
So then it will get mingled with error messages. Odd scheme of things.
Or mention just why that choice was made.
Or fix it.
Also, we read
flickcurl is a utility program to call the Flickr APIs via the flick-
curl library. Run flickcurl -h to get a list of the supported commands
and their arguments.
No, that will just tell us to register.
But before we register, we would like to see if it is worth registering
or not. So do also show the list of supported commands.
The program requires configuring before use to work with the Flickr
APIs. Run flickcurl without any options to get the instructions for
registering the application and creating the initial configuration file
~/.flickcurl.conf from the registration information.
Also mention if there is *or isn't* any readonly API commands one can
try without signing up first. (OK... it seems there isn't)
On the man page
galleries.create TITLE [DESCRIPTION [PRIMARY-PHOTO-ID]
Create a new galleries with TITlE, DESCRIPTION and PRIMARY-
PHOTO_ID.
has an English problem at 'galleries'.
Words stuck together:
people.getPublicGroups USER-NSID
Get list of public groups a user is amember of
Run a spellchecker on the whole documentation suite.
The man page mentions NSID, etc. without ever saying what that
acronym stands for, or what it looks like...
file:///usr/share/doc/flickcurl-utils/coverage.html
This page summarizes the Flickr API calls that are supported by
Flickcurl. API calls are marked as follows as supported or
unsupported.
Current Flickr API coverage by Flickcurl: 100.0% (180/180)
OK, but you want to mention dates or versions or something. Even if
separately mentioned below.
--
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]
