bts tags 635892 + confirmed thanks Hi!
On Tue, Jul 26, 2011 at 06:06:02AM +0800, jida...@jidanni.org wrote: > 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. I'll see what upstream thinks about this; while this should be easy to fix, he might have an opinion on this which I don't wish to overrule. > 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. Well, this might be a limitation, but the man page makes it clear. Perhaps a blurb can be added to refer to the man page for complete options? > 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) Fine. I shall consider adding this to the man page. > 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. I've done a quick check and sent the patch. > 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. I leave this to upstream. I have sent some patches to upstream via Github. They can be seen here: https://github.com/dajobe/flickcurl/pull/12 Thanks. Kumar -- Kumar Appaiah -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
