Package: hsbrainfuck
Version: 0.1-6
Severity: wishlist
Tags: patch
The package descriptions for haskell-brainfuck witter on and on about
the virtues of the language the interpreter happens to be implemented
in, declaring it to be a "pure, lazy, functional language" and giving
a URL that readers can refer to for more information about it (as if
it was hard to guess). This is all very well, but what they
completely forget to do is give readers any hint of the nature of the
language that the package actually provides an interpreter for.
Policy says "The description should describe the package (the program)
to a user (system administrator) who has never met it before so that
they have enough information to decide whether they want to install
it." So technically you're breaking a "should", but I'll just call
this a wishlist bug as usual for package description reviews.
Meanwhile I've got three trivial "stylistic" nitpicks that I might as
well fix while I'm offering a patch:
* you capitalise the name "Brainfuck" inconsistently;
* the synopsis for hsbrainfuck also has an excess space;
* the long descriptions shouldn't start by talking about an undefined
"it" - if you're going to use boilerplate, phrase it so it works
for all of them.
I would suggest the following text:
Description: interpreter for the Brainfuck programming language
Haskell-Brainfuck is an interpreter for the "Turing tarpit" programming
language also known as Brainf*ck.
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
diff -ru haskell-brainfuck-0.1.pristine/debian/control haskell-brainfuck-0.1/debian/control
--- haskell-brainfuck-0.1.pristine/debian/control 2013-10-27 22:05:43.000000000 +0000
+++ haskell-brainfuck-0.1/debian/control 2013-11-10 16:15:41.686174206 +0000
@@ -26,8 +26,8 @@
Suggests: ${haskell:Suggests}
Provides: ${haskell:Provides}
Description: Brainfuck interpreter library${haskell:ShortBlurb}
- It is an interpreter for the Brainfuck language, written in the
- pure, lazy, functional language Haskell.
+ Haskell-Brainfuck is an interpreter for the "Turing tarpit" programming
+ language also known as Brainf*ck.
.
${haskell:Blurb}
@@ -39,8 +39,8 @@
Suggests: ${haskell:Suggests}
Provides: ${haskell:Provides}
Description: Brainfuck interpreter library${haskell:ShortBlurb}
- It is an interpreter for the Brainfuck language, written in the
- pure, lazy, functional language Haskell.
+ Haskell-Brainfuck is an interpreter for the "Turing tarpit" programming
+ language also known as Brainf*ck.
.
${haskell:Blurb}
@@ -51,8 +51,8 @@
Recommends: ${haskell:Recommends}
Suggests: ${haskell:Suggests}
Description: Brainfuck interpreter library${haskell:ShortBlurb}
- It is an interpreter for the Brainfuck language, written in the
- pure, lazy, functional language Haskell.
+ Haskell-Brainfuck is an interpreter for the "Turing tarpit" programming
+ language also known as Brainf*ck.
.
${haskell:Blurb}
@@ -64,6 +64,6 @@
Recommends: ${haskell:Recommends}
Suggests: ${haskell:Suggests}
Provides: ${haskell:Provides}
-Description: interpreter for the brainfuck programming language
- This package provides an interpreter for the Brainfuck programming
- language, written in the pure, lazy, functional language Haskell.
+Description: interpreter for the Brainfuck programming language
+ Haskell-Brainfuck is an interpreter for the "Turing tarpit" programming
+ language also known as Brainf*ck.
