Re: [BTS#658415] templates://golang-weekly/{golang-weekly-tools.templates} : Final update for English review

[Jonathan Nieder <jrnieder@gmail.com>]

Hi Ondřej and Christian,

Christian PERRIER wrote:

> --- golang-weekly.old/debian/control	2012-02-02 22:26:53.533918139 +0100
> +++ golang-weekly/debian/control	2012-02-11 18:24:10.697599848 +0100
> @@ -15,27 +15,20 @@
>  Depends: ${shlibs:Depends}, ${misc:Depends}, ${perl:Depends}
>  Recommends: golang-weekly-tools
>  Provides: go-compiler, golang-go
> -Description: Experimental Go programming language compiler
> +Description: Go programming language compiler

Shouldn't this say "Go programming language compiler (weekly snapshot)"
or something similar to distinguish it from the main golang package?

[...]
> - Go is an experiment. We hope adventurous users will give it a try and
> - see if they enjoy it. Not every programmer will, but we hope enough
> - will find satisfaction in the approach it offers to justify further
> - development. The language can (and still does) change between weekly
> - releases, check http://golang.org/doc/devel/weekly.html before
> - upgrading this package.
> + This package provides an assembler, a compiler, and a linker for the
> + Go programming language. This is Google's implementation of the Go
> + tool chain.

The warning about lack of stability seems relevant to someone
considering whether to install the package.  Maybe something like this,
to give the same hints more briefly:

 This package provides an assembler, a compiler, and a linker for the
 Go programming language. This is Google's implementation of the Go
 tool chain.
 .
 Go is young. There are still language changes between weekly
 releases, described at http://golang.org/doc/devel/weekly.html.

Or maybe, stealing text from that page:

 This package provides an assembler, a compiler, and a linker for the
 Go programming language. This is Google's implementation of the Go
 tool chain.
 .
 Weekly snapshots occur often and may not be stable. If stability of
 API and code is more important than having the latest features, use
 the official releases from the golang package instead.

By the way, why is this a separate source package instead of being
called golang in experimental?

Jonathan