Re: [RFR] templates://golang-weekly/{golang-weekly-tools.templates}
Christian PERRIER wrote:
> Type: boolean
> Default: true
> _Description: Report installation of public packages to Go Dashboard?
> + The goinstall program reports the successful installation of the public packages to
I assume when it talks about "packages" here it doesn't mean .debs;
saying "public Go packages" might be slightly clearer.
> godashboard.appspot.com, which increments a count associated with the
> package and the time of its most recent installation. This mechanism
^
Squeeze double space.
> powers the package list at the Go Dashboard, allowing Go programmers to
> learn about popular packages that might be worth looking at.
> .
> + If you choose to participate, each successful
> + installation will be reported to the Go Dashboard.
> .
> This choice can be later modified by running "dpkg-reconfigure
> golang-weekly-tools".
Make that just "can be modified by running [...]".
> I'm not entirely enthusiats about the common part which I find
> slightly too much sounding as an advertisement...but not enough to
> warrant a full rewrite, imho.
>
> Also, I think that the "Go is an experiment..." part doesn't belong to a
> supposedly neutral package description. As it doesn't bring much, I
> suggest dropping it where it appears.
It also says strange stuff about checking upstream before upgrading
the package. I suspect that's also talking about packages in the
upstream sense, and that it's going to be bad advice for Debian users
doing a dist-upgrade.
> Depends: ${shlibs:Depends}, ${misc:Depends}, ${perl:Depends}
> Recommends: golang-weekly-tools
> Provides: go-compiler, golang-go
> +Description: Go programming language compiler
> The Go programming language is an open source project to make
> programmers more productive. Go is expressive, concise, clean, and
> + efficient. Its concurrency mechanisms make it easy to write programs
> that get the most out of multicore and networked machines, while its
> novel type system enables flexible and modular program construction.
> Go compiles quickly to machine code yet has the convenience of
> + garbage collection and the power of run-time reflection. It's a
> fast, statically typed, compiled language that feels like a
> dynamically typed, interpreted language.
> .
> + This package provides an assembler, a compiler and a linker for the Go
> + programming language. This is Google's Go implementation of the
> + toolchain.
Extra comma and de-garbled possessive:
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.
> +Description: Go programming language compiler - source files
[...]
> + This package provides the source files for the Go programming
> + language needed for godoc and goinstall.
I'm not entirely sure I understand this, but if I do it should be
This package provides the Go programming language source files needed
for godoc and goinstall.
> +Description: Go programming language compiler - documentation
[...]
> + This package provides the documentation for the Go programming
> + language.
> + .
> After installing golang-weekly-tools package, you can view a nicely
> formatted documentation by running godoc --http=:6060 and then
> visiting http://localhost:6060/doc/install.html.
This package provides the documentation for the Go programming
language. You can view the formatted documentation by installing
golang-weekly-tools, running "godoc --http=:6060", and then
visiting http://localhost:6060/doc/install.html.
So shouldn't there be a "Suggests: golang-weekly-tools"?
Wait... the package already seems to contain a populated
/usr/share/doc/golang-doc/html, so why would I need to generate
another copy? Is this another tool for handling stuff in /usr/local?
> +Description: Go programming language compiler - tools
[...]
> + This package provides various tools for the Go programming language:
> + * godoc - extracts and generates documentation for Go programs
> + * gofix - upgrade Go programs to the most recent release
> + * gofmt - formats Go programs
> + * goinstall - automatic package installation
> + * gotry - evaluate expressions on the command line
> + * govet - simple checking of Go source code
Standardise on third-singular-present verbs, punctuated lines:
This package provides various tools for the Go programming language:
* godoc - extracts and generates documentation for Go programs;
* gofix - upgrades Go programs to the most recent release;
* gofmt - formats Go programs;
* goinstall - automatically installs Go packages;
* gotry - evaluates expressions on the command line;
* govet - performs simple checking of Go source code.
(I hope future users of Wheezy when it's Oldstable get some sort of
warning that if they bypass dpkg to install bleeding-edge Go-packages
alongside an antique /usr/bin/gc, they get to keep both pieces...)
> +Description: Go programming language compiler - debug files
[...]
> This package provides the debug symbols for Google's Go tool
> chain binaries (assembler, compiler, linker) needed for properly
> debugging errors in the tool chain with gdb.
Nothing I can be bothered to fiddle with here...
> +Description: Go programming language compiler - metapackage
[...]
> + This package is a metapackage that, when installed, guarantees
> + that (almost) full Go development environment is installed.
That's "an (almost) full". No, wait, "(almost) a full". Or, um:
that (most of) a full Go development environment is installed.
Obligatory Why-The-Name Appendix:
I've always assumed it's the shortest name they could find that seemed
(a) cool and (b) Google-related. I hope users aren't going to
misinterpret golang as a l10n package for goplay...
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
Template: golang-weekly-tools/dashboard
Type: boolean
Default: true
_Description: Report installation of public packages to Go Dashboard?
The goinstall program reports the successful installation of the public Go
packages to godashboard.appspot.com, which increments a count associated
with the package and the time of its most recent installation. This mechanism
powers the package list at the Go Dashboard, allowing Go programmers to
learn about popular packages that might be worth looking at.
.
If you choose to participate, each successful
installation will be reported to the Go Dashboard.
.
This choice can be modified by running "dpkg-reconfigure
golang-weekly-tools".
Source: golang-weekly
Section: devel
Priority: optional
Maintainer: Ondřej Surý <ondrej@debian.org>
Vcs-Browser: http://git.debian.org/?p=pkg-google/golang.git
Vcs-Git: git://git.debian.org/pkg-google/golang.git
Build-Depends: debhelper (>= 7.4.10), bison, ed, mawk | awk, perl
Build-Depends-Indep: po-debconf
Standards-Version: 3.9.2
Homepage: http://golang.org/
Package: golang-weekly-go
Conflicts: golang-go
Architecture: i386 amd64 kfreebsd-i386 kfreebsd-amd64 armel armhf
Depends: ${shlibs:Depends}, ${misc:Depends}, ${perl:Depends}
Recommends: golang-weekly-tools
Provides: go-compiler, golang-go
Description: Go programming language compiler
The Go programming language is an open source project to make
programmers more productive. Go is expressive, concise, clean, and
efficient. Its concurrency mechanisms make it easy to write programs
that get the most out of multicore and networked machines, while its
novel type system enables flexible and modular program construction.
Go compiles quickly to machine code yet has the convenience of
garbage collection and the power of run-time reflection. It's a
fast, statically typed, compiled language that feels like a
dynamically typed, interpreted language.
.
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.
Package: golang-weekly-src
Conflicts: golang-src
Provides: golang-src
Architecture: i386 amd64 kfreebsd-i386 kfreebsd-amd64 armel armhf
Depends: ${shlibs:Depends}, ${misc:Depends}, golang-weekly-go
Recommends: golang-weekly-tools
Description: Go programming language compiler - source files
The Go programming language is an open source project to make
programmers more productive. Go is expressive, concise, clean, and
efficient. Its concurrency mechanisms make it easy to write programs
that get the most out of multicore and networked machines, while its
novel type system enables flexible and modular program construction.
Go compiles quickly to machine code yet has the convenience of
garbage collection and the power of run-time reflection. It's a
fast, statically typed, compiled language that feels like a
dynamically typed, interpreted language.
.
This package provides the Go programming language source files needed
for godoc and goinstall.
Package: golang-weekly-doc
Conflicts: golang-doc
Provides: golang-doc
Architecture: all
Depends: ${misc:Depends}
Section: doc
Description: Go programming language compiler - documentation
The Go programming language is an open source project to make
programmers more productive. Go is expressive, concise, clean, and
efficient. Its concurrency mechanisms make it easy to write programs
that get the most out of multicore and networked machines, while its
novel type system enables flexible and modular program construction.
Go compiles quickly to machine code yet has the convenience of
garbage collection and the power of run-time reflection. It's a
fast, statically typed, compiled language that feels like a
dynamically typed, interpreted language.
.
This package provides the documentation for the Go programming
language. You can view the formatted documentation by installing
golang-weekly-tools, running "godoc --http=:6060", and then
visiting http://localhost:6060/doc/install.html.
Package: golang-weekly-tools
Conflicts: golang-tools
Provides: golang-tools
Architecture: i386 amd64 kfreebsd-i386 kfreebsd-amd64 armel armhf
Depends: golang-weekly-go, ${shlibs:Depends}, ${misc:Depends}
Recommends: golang-weekly-src, golang-weekly-doc
Description: Go programming language compiler - tools
The Go programming language is an open source project to make
programmers more productive. Go is expressive, concise, clean, and
efficient. Its concurrency mechanisms make it easy to write programs
that get the most out of multicore and networked machines, while its
novel type system enables flexible and modular program construction.
Go compiles quickly to machine code yet has the convenience of
garbage collection and the power of run-time reflection. It's a
fast, statically typed, compiled language that feels like a
dynamically typed, interpreted language.
.
This package provides various tools for the Go programming language:
* godoc - extracts and generates documentation for Go programs;
* gofix - upgrades Go programs to the most recent release;
* gofmt - formats Go programs;
* goinstall - automatically installs Go packages;
* gotry - evaluates expressions on the command line;
* govet - performs simple checking of Go source code.
Package: golang-weekly-dbg
Conflicts: golang-dbg
Provides: golang-dbg
Architecture: i386 amd64 kfreebsd-i386 kfreebsd-amd64 armel armhf
Depends: ${misc:Depends}, golang-weekly-go (= ${binary:Version})
Recommends: gdb
Section: debug
Priority: extra
Description: Go programming language compiler - debug files
The Go programming language is an open source project to make
programmers more productive. Go is expressive, concise, clean, and
efficient. Its concurrency mechanisms make it easy to write programs
that get the most out of multicore and networked machines, while its
novel type system enables flexible and modular program construction.
Go compiles quickly to machine code yet has the convenience of
garbage collection and the power of run-time reflection. It's a
fast, statically typed, compiled language that feels like a
dynamically typed, interpreted language.
.
This package provides the debug symbols for Google's Go tool
chain binaries (assembler, compiler, linker) needed for properly
debugging errors in the tool chain with gdb.
.
This package uses the weekly snapshot releases, for more information see:
http://golang.org/doc/devel/weekly.html
Package: golang-weekly
Depends: ${misc:Depends},
golang-weekly-go (>= ${source:Version}),
golang-weekly-src (>= ${source:Version}),
golang-weekly-tools (>= ${source:Version}),
golang-weekly-doc (>= ${source:Version})
Architecture: all
Description: Go programming language compiler - metapackage
The Go programming language is an open source project to make
programmers more productive. Go is expressive, concise, clean, and
efficient. Its concurrency mechanisms make it easy to write programs
that get the most out of multicore and networked machines, while its
novel type system enables flexible and modular program construction.
Go compiles quickly to machine code yet has the convenience of
garbage collection and the power of run-time reflection. It's a
fast, statically typed, compiled language that feels like a
dynamically typed, interpreted language.
.
This package is a metapackage that, when installed, guarantees
that (most of) a full Go development environment is installed.
diff -ru old/control new/control
--- old/control 2012-02-03 07:28:19.815861618 +0000
+++ new/control 2012-02-11 13:00:32.291861275 +0000
@@ -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
- This package provides assembler, compiler and linker for the Go
- programming language. This is Google's Go implementation of the
- tool chain.
- .
+Description: Go programming language compiler
The Go programming language is an open source project to make
programmers more productive. Go is expressive, concise, clean, and
- efficient. Its concurrency mechanisms make it easy to write programs
+ efficient. Its concurrency mechanisms make it easy to write programs
that get the most out of multicore and networked machines, while its
novel type system enables flexible and modular program construction.
Go compiles quickly to machine code yet has the convenience of
- garbage collection and the power of run-time reflection. It's a
+ garbage collection and the power of run-time reflection. It's a
fast, statically typed, compiled language that feels like a
dynamically typed, interpreted language.
.
- 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.
Package: golang-weekly-src
Conflicts: golang-src
@@ -43,26 +36,19 @@
Architecture: i386 amd64 kfreebsd-i386 kfreebsd-amd64 armel armhf
Depends: ${shlibs:Depends}, ${misc:Depends}, golang-weekly-go
Recommends: golang-weekly-tools
-Description: Go programming language compiler (.go source files)
- This package provides the source files for the Go programming
- language needed for godoc and goinstall.
- .
+Description: Go programming language compiler - source files
The Go programming language is an open source project to make
programmers more productive. Go is expressive, concise, clean, and
- efficient. Its concurrency mechanisms make it easy to write programs
+ efficient. Its concurrency mechanisms make it easy to write programs
that get the most out of multicore and networked machines, while its
novel type system enables flexible and modular program construction.
Go compiles quickly to machine code yet has the convenience of
- garbage collection and the power of run-time reflection. It's a
+ garbage collection and the power of run-time reflection. It's a
fast, statically typed, compiled language that feels like a
dynamically typed, interpreted language.
.
- 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 the Go programming language source files needed
+ for godoc and goinstall.
Package: golang-weekly-doc
Conflicts: golang-doc
@@ -70,30 +56,21 @@
Architecture: all
Depends: ${misc:Depends}
Section: doc
-Description: Documentation for Google's Go programming language
- This package provides the documentation for the Go programming
- language.
- .
+Description: Go programming language compiler - documentation
The Go programming language is an open source project to make
programmers more productive. Go is expressive, concise, clean, and
- efficient. Its concurrency mechanisms make it easy to write programs
+ efficient. Its concurrency mechanisms make it easy to write programs
that get the most out of multicore and networked machines, while its
novel type system enables flexible and modular program construction.
Go compiles quickly to machine code yet has the convenience of
- garbage collection and the power of run-time reflection. It's a
+ garbage collection and the power of run-time reflection. It's a
fast, statically typed, compiled language that feels like a
dynamically typed, interpreted language.
.
- After installing golang-weekly-tools package, you can view a nicely
- formatted documentation by running godoc --http=:6060 and then
+ This package provides the documentation for the Go programming
+ language. You can view the formatted documentation by installing
+ golang-weekly-tools, running "godoc --http=:6060", and then
visiting http://localhost:6060/doc/install.html.
- .
- 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.
Package: golang-weekly-tools
Conflicts: golang-tools
@@ -101,31 +78,24 @@
Architecture: i386 amd64 kfreebsd-i386 kfreebsd-amd64 armel armhf
Depends: golang-weekly-go, ${shlibs:Depends}, ${misc:Depends}
Recommends: golang-weekly-src, golang-weekly-doc
-Description: Tools for Google's Go programming language
- This package provides various tools for the Go programming language:
- * godoc - extracts and generates documentation for Go programs
- * gofix - upgrade Go programs to the most recent release
- * gofmt - formats Go programs
- * goinstall - automatic package installation
- * gotry - evaluate expressions on the command line
- * govet - simple checking of Go source code
- .
+Description: Go programming language compiler - tools
The Go programming language is an open source project to make
programmers more productive. Go is expressive, concise, clean, and
- efficient. Its concurrency mechanisms make it easy to write programs
+ efficient. Its concurrency mechanisms make it easy to write programs
that get the most out of multicore and networked machines, while its
novel type system enables flexible and modular program construction.
Go compiles quickly to machine code yet has the convenience of
- garbage collection and the power of run-time reflection. It's a
+ garbage collection and the power of run-time reflection. It's a
fast, statically typed, compiled language that feels like a
dynamically typed, interpreted language.
.
- 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 various tools for the Go programming language:
+ * godoc - extracts and generates documentation for Go programs;
+ * gofix - upgrades Go programs to the most recent release;
+ * gofmt - formats Go programs;
+ * goinstall - automatically installs Go packages;
+ * gotry - evaluates expressions on the command line;
+ * govet - performs simple checking of Go source code.
Package: golang-weekly-dbg
Conflicts: golang-dbg
@@ -135,7 +105,17 @@
Recommends: gdb
Section: debug
Priority: extra
-Description: Go programming language tool chain [debug]
+Description: Go programming language compiler - debug files
+ The Go programming language is an open source project to make
+ programmers more productive. Go is expressive, concise, clean, and
+ efficient. Its concurrency mechanisms make it easy to write programs
+ that get the most out of multicore and networked machines, while its
+ novel type system enables flexible and modular program construction.
+ Go compiles quickly to machine code yet has the convenience of
+ garbage collection and the power of run-time reflection. It's a
+ fast, statically typed, compiled language that feels like a
+ dynamically typed, interpreted language.
+ .
This package provides the debug symbols for Google's Go tool
chain binaries (assembler, compiler, linker) needed for properly
debugging errors in the tool chain with gdb.
@@ -150,23 +130,16 @@
golang-weekly-tools (>= ${source:Version}),
golang-weekly-doc (>= ${source:Version})
Architecture: all
-Description: Experimental Go programming language [meta package]
- This package is a metapackage that, when installed, guarantees
- that (almost) full Go development environment is installed.
- .
+Description: Go programming language compiler - metapackage
The Go programming language is an open source project to make
programmers more productive. Go is expressive, concise, clean, and
- efficient. Its concurrency mechanisms make it easy to write programs
+ efficient. Its concurrency mechanisms make it easy to write programs
that get the most out of multicore and networked machines, while its
novel type system enables flexible and modular program construction.
Go compiles quickly to machine code yet has the convenience of
- garbage collection and the power of run-time reflection. It's a
+ garbage collection and the power of run-time reflection. It's a
fast, statically typed, compiled language that feels like a
dynamically typed, interpreted language.
.
- 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 is a metapackage that, when installed, guarantees
+ that (most of) a full Go development environment is installed.
diff -ru old/golang-weekly-tools.templates new/golang-weekly-tools.templates
--- old/golang-weekly-tools.templates 2012-02-03 07:28:16.983589122 +0000
+++ new/golang-weekly-tools.templates 2012-02-11 12:53:52.155861178 +0000
@@ -2,14 +2,14 @@
Type: boolean
Default: true
_Description: Report installation of public packages to Go Dashboard?
- goinstall reports the successful installation of the public packages to
- godashboard.appspot.com, which increments a count associated with the
- package and the time of its most recent installation. This mechanism
+ The goinstall program reports the successful installation of the public Go
+ packages to godashboard.appspot.com, which increments a count associated
+ with the package and the time of its most recent installation. This mechanism
powers the package list at the Go Dashboard, allowing Go programmers to
learn about popular packages that might be worth looking at.
.
- If you choose to participate, the goinstall will report each successful
- installation to the Go Dashboard.
+ If you choose to participate, each successful
+ installation will be reported to the Go Dashboard.
.
- This choice can be later modified by running "dpkg-reconfigure
+ This choice can be modified by running "dpkg-reconfigure
golang-weekly-tools".
Reply to: