On Tue, 6 Oct 2015 21:52:07 +0300
Konstantin Khomoutov <flatw...@users.sourceforge.net> wrote:
[...]
> > * Package name: golang-github-skratchdot-open-golang
> >   Version: 0.0~git20150221.0.c874831-1
> >   Upstream Author: Jeff Switze <j...@skratchdot.com>
> > * URL: https://github.com/skratchdot/open-golang
> > * License: Expat
> 
> The README.md says it's MIT, not Expat.

  I know it. MIT license is really problem because there are
  some diversions about it. I followed the DEP 5[1][2], it recommends
  use Expat instead MIT license when both are similar.  

> >   Description: Abstraction to open URIs using a same object type
> 
> Please use "the same", not "a same".  This form refers to a specific
> object with the specific set of properties, so the definite article
> is used.
> 
> Unfortunately the whole sentence makes little sense as a whole.
> I would just snatch the description from the xdg-open's manual page
> to produce this description:
> 
> | A library to open an URI in the user's preferred application
> 
> >  Functions to use embedded in your programs to open a file,
> >  directory, or URI using the OS's default application for that
> > object type. Optionally, it can specify an application to use.
> >  .
> >  This package provides a library to use abstraction open functions
> > in Golang programs.
> 
> Language problems, again.  Too many to discern and discuss
> individually -- but please take no offence!

  No, I liked! I will change it.

> I'd rephrase the whole piece like this:
> 
> | This library provides a set of Go functions allowing to "open" a
> file, | directory or URI using the user's preferred application (or an
> | operating system-wide default) to handle objects of those particular
> | types.  Optionally, it's possible to directly specify the
> application | to use for opening the resource.
> 
> Hope this helps.
  
 You really are! Thanks Konstatin for suggestion and improvement. 

 I committed[3] your revision in the alioth.


References:
[1]: https://lists.debian.org/debian-project/2011/12/msg00034.html
[2]: http://dep.debian.net/deps/dep5/
[3]:
http://anonscm.debian.org/cgit/pkg-go/packages/golang-github-skratchdot-open-golang.git/tree/debian/control

Regards,
-- 
Fernando Ike
http://www.fernandoike.com

Reply via email to