Bug#801051: ITP: golang-github-skratchdot-open-golang -- Abstraction to open URIs using a same object type

[Fernando Ike]

On Tue, 6 Oct 2015 21:52:07 +0300
Konstantin Khomoutov  wrote:
[...]
> > * Package name: golang-github-skratchdot-open-golang
> >   Version: 0.0~git20150221.0.c874831-1
> >   Upstream Author: Jeff Switze 
> > * 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

Bug#801051: ITP: golang-github-skratchdot-open-golang -- Abstraction to open URIs using a same object type

[Konstantin Khomoutov]

On Mon, 05 Oct 2015 14:34:55 -0300
Fernando Ike  wrote:

> Package: wnpp
> Severity: wishlist
> Owner: Fernando Ike 
> X-Debbugs-CC: debian-de...@lists.debian.org,
> pkg-go-maintainers@lists.a lioth.debian.org
> 
> * Package name: golang-github-skratchdot-open-golang
>   Version: 0.0~git20150221.0.c874831-1
>   Upstream Author: Jeff Switze 
> * URL: https://github.com/skratchdot/open-golang
> * License: Expat

The README.md says it's MIT, not Expat.

>   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!

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.

Bug#801051: ITP: golang-github-skratchdot-open-golang -- Abstraction to open URIs using a same object type

[Fernando Ike]

Package: wnpp
Severity: wishlist
Owner: Fernando Ike 
X-Debbugs-CC: debian-de...@lists.debian.org, pkg-go-maintainers@lists.a
lioth.debian.org

* Package name: golang-github-skratchdot-open-golang
  Version: 0.0~git20150221.0.c874831-1
  Upstream Author: Jeff Switze 
* URL: https://github.com/skratchdot/open-golang
* License: Expat
  Description: Abstraction to open URIs using a same object type

 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.


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