Re: [RFR] templates://nethack/{nethack-common.templates}
Christian Perrier wrote:
> Your review should be sent as an answer to this mail.
> Template: nethack-common/recover-setgid
[...]
> Rephrase to make the template less clumky. Not sure that I succeed...:-)
All looks good to me.
> + Nethack is a wonderfully silly, yet quite addicting, Dungeons and
> + Dragons-style adventure game. You play the part of a fierce fighter,
> + wizard, or any of many other classes, fighting your way down to
> + retrieve the Amulet of Yendor (try saying THAT one backwards!) for
> + your god. On the way, you might encounter a quantum mechanic or two,
> + or perhaps a microscopic space fleet, or -- if you're REALLY lucky --
> + the Ravenous Bugblatter Beast of Traal.
[...]
> That will be the boilerplate for all packages. I decided to keep the
> original wording, including its style, which is not precisely the very
> neutral style we like in packages' descriptions.....but we're talking
> about a game here....and, moreover, a well known game in the
> (old-style) geek community. So, the description is part of some
> tradition....with a nice reference to *the* Monthy Python most
> achieved movie..:)
Hang on, where? There _is_ at least one Monty Python reference in
NetHack, but they're relatively rare and I don't see any here.
Yendor comes straight from Rogue, and the microscopic spacefleet and
Bugblatter Beast are both Hitchhiker's Guide references. Which is a
bit of a problem, since that gives a false impression of NetHack's
monsters - neither of them occur except as hallucinations.
Other features of this blurb that I've always wanted to improve:
1) Upstream spell it NetHack (and "Dungeons _&_ Dragons")
2) s/addicting/addictive/
3) "you play the part of a fierce fighter, wizard, or any of many
other classes" - it's plausible colloquial English, but
a) there is no such character class as "fighter" (except as an
experience-level label for Valkyries), and besides, it's
repetitive to talk about a fighter fighting;
b) to be strictly grammatical, that third one should say
something like "or MEMBER OF any of many other classes".
That's too clunky, though, so it needs a rewrite.
How about:
NetHack is a wonderfully silly, yet quite addictive, Dungeons &
Dragons-style adventure game. You play a character from one of many
classes (such as wizard, ranger, or tourist), fighting your way down to
retrieve the Amulet of Yendor (try saying THAT one backwards!) for your
god. On the way, you might encounter a quantum mechanic or two, or
perhaps King Arthur, or - if you're REALLY lucky - the Ravenous
Bugblatter Beast of Traal.
Oh, wait, one other thing:
> + - nethack-lisp : allows playing inside Emacs. It requires nethack-el.
That's not true - nethack-lisp only "Suggests:" nethack-el, implying
that there's some sensible use case on machines that don't have
nethack-el (or indeed Emacs) installed. That generic use is what
should be described here; the specifics of how nethack-lisp relates
to nethack-el should be in the dedicated package description for
nethack-lisp. I'm not convinced the dependencies make sense, but
assuming they do I'll amend the text to:
- nethack-lisp : Lisp window version.
.
This package provides the version required for playing NetHack via
Lisp, for instance under Emacs (which requires nethack-el).
Incidentally, I see nethack-el is in a different source package but
uses the same blurb about Ravenous Bugblatter Beasts.
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
--- ../nethack-3.4.3.pristine/debian/nethack-common.templates 2009-02-19 10:54:36.000000000 +0000
+++ debian/nethack-common.templates 2009-02-26 13:59:30.000000000 +0000
@@ -1,34 +1,17 @@
-Template: nethack-common/backup-incompatible
-Type: select
-_Choices: abort, backup, purge, ignore
-Default: backup
-_Description: Should NetHack back up your old, incompatible save files?
- You are upgrading from a version of NetHack whose save files are not
- compatible with the version you are upgrading to. You may either have them
- backed up into /tmp, purge them, ignore this problem completely, or abort
- this installation and manually handle NetHack's save files. Your score files
- will be lost if you choose to purge.
- .
- If you choose to back up, the files will be backed up into a
- gzip-compressed tar archive in /tmp with a random name starting
- with 'nethk' and ending in '.tar.gz'.
- .
- Old NetHack save files can be found in /var/games/nethack (or
- /var/lib/games/nethack, for versions before 3.4.0).
-
Template: nethack-common/recover-setgid
Type: boolean
Default: false
-_Description: Would you like NetHack's recover utility to be setgid games?
- The 'recover' program is installed as part of the nethack-common package
+_Description: Use setgid bit with NetHack's recover utility?
+ The "recover" program is installed as part of the nethack-common package
and exists to help the administrator recover broken save files, etc.
.
- Recover is traditionally installed setgid games, although it does not
- need to be in the Debian NetHack installation, as it is automatically
- run at boot time as root. Its only usefulness as a setgid binary is
- to let players as normal users on the system recover their save
+ Recover is traditionally installed with the "setgid" bit (group "games").
+ However, this package runs it automatically, as root, during the system
+ boot. As a consequence, allowing the utility to use the "games" group
+ privileges is only useful
+ to let players recover their save
files, should NetHack crash or their connection drop mid-game.
.
- If you answer no, you will have to run recover as root or as someone
- in group games to recover save files after a crash or a connection
- drop.
+ If you do not choose this option, recovers after a crash or a connection
+ drop can only be run as root or by a user who is member of the "games"
+ group.
--- ../nethack-3.4.3.pristine/debian/control 2009-02-19 10:54:36.000000000 +0000
+++ debian/control 2009-02-26 14:27:29.000000000 +0000
@@ -11,92 +11,129 @@
Recommends: nethack-console | nethack-x11 | nethack-qt
Conflicts: suidmanager (<< 0.50), nethack-console (<< ${binary:Version}), nethack-x11 (<< ${binary:Version}), nethack-gnome (<< ${binary:Version}), nethack-qt (<< ${binary:Version}), nethack-lisp (<< ${binary:Version})
Replaces: nethack (<< 3.4.0)
-Description: Common files for Nethack dungeon crawl game
- The various graphical front-ends for Nethack all share a large
- number of files in common. This package contains the graphics,
- dungeon levels, and utilities common to all Nethack front-ends.
- .
- Please install one of the following Nethack front-ends if you
- actually wish to play the game. Each of them includes the
- original non-graphical version, and they can all be installed
- at the same time.
+Description: dungeon crawl game - common files
+ NetHack is a wonderfully silly, yet quite addictive, Dungeons &
+ Dragons-style adventure game. You play a character from one of many
+ classes (such as wizard, ranger, or tourist), fighting your way down to
+ retrieve the Amulet of Yendor (try saying THAT one backwards!) for your
+ god. On the way, you might encounter a quantum mechanic or two, or
+ perhaps King Arthur, or - if you're REALLY lucky - the Ravenous
+ Bugblatter Beast of Traal.
.
- * nethack-console (no graphics, just plain Nethack)
- * nethack-x11 (original X11/Athena-based graphical version)
- * nethack-qt (newer Qt-based graphical version)
- * nethack-lisp (for playing Nethack in Emacs; requires nethack-el)
+ You should install a front-end for NetHack if you
+ wish to play the game. Each of them includes the
+ original non-graphical version, and they can all be installed
+ at the same time:
+ - nethack-console: no graphics, just plain NetHack;
+ - nethack-x11 : original X11/Athena-based graphical version;
+ - nethack-qt : Qt-based graphical version;
+ - nethack-lisp : Lisp window version.
.
- There is a nethack-spoilers package available, if you're really
- desperate for help.
+ The various graphical front-ends for NetHack all share a large
+ number of files in common. This package contains the graphics,
+ dungeon levels, and utilities common to all NetHack front-ends.
.
- A few utilities -- recover, for retrieving your auto-save files in case
+ It also provides a few utilities such as recover, for retrieving auto-save files in case
of a power failure, and dgn_comp and lev_comp, two utilities for making
- your own Nethack levels and dungeons, have been included in
- /usr/lib/games/nethack. 'recover' will be run every time your system
+ your own NetHack levels and dungeons. The "recover" may be run every time the system
boots, if there are any auto-save files available.
Package: nethack-console
Depends: ${shlibs:Depends}, nethack-common (= ${binary:Version})
Architecture: any
Provides: nethack
-Description: Text-based overhead view D&D-style adventure game
- Nethack is a wonderfully silly, yet quite addicting, Dungeons and
- Dragons-style adventure game. You play the part of a fierce fighter,
- wizard, or any of many other classes, fighting your way down to
- retrieve the Amulet of Yendor (try saying THAT one backwards!) for
- your god. On the way, you might encounter a quantum mechanic or two,
- or perhaps a microscopic space fleet, or -- if you're REALLY lucky --
- the Ravenous Bugblatter Beast of Traal.
+Description: dungeon crawl game - text-based interface
+ NetHack is a wonderfully silly, yet quite addictive, Dungeons &
+ Dragons-style adventure game. You play a character from one of many
+ classes (such as wizard, ranger, or tourist), fighting your way down to
+ retrieve the Amulet of Yendor (try saying THAT one backwards!) for your
+ god. On the way, you might encounter a quantum mechanic or two, or
+ perhaps King Arthur, or - if you're REALLY lucky - the Ravenous
+ Bugblatter Beast of Traal.
.
- This package contains the plain console version of Nethack. No
- graphics here!
+ You should install a front-end for NetHack if you
+ wish to play the game. Each of them includes the
+ original non-graphical version, and they can all be installed
+ at the same time:
+ - nethack-console: no graphics, just plain NetHack;
+ - nethack-x11 : original X11/Athena-based graphical version;
+ - nethack-qt : Qt-based graphical version;
+ - nethack-lisp : Lisp window version.
+ .
+ This package provides the plain console version of NetHack.
Package: nethack-lisp
Depends: ${shlibs:Depends}, nethack-common (= ${binary:Version})
Suggests: nethack-el
Architecture: any
Provides: nethack
-Description: Text-based overhead view D&D-style adventure game
- Nethack is a wonderfully silly, yet quite addicting, Dungeons and
- Dragons-style adventure game. You play the part of a fierce fighter,
- wizard, or any of many other classes, fighting your way down to
- retrieve the Amulet of Yendor (try saying THAT one backwards!) for
- your god. On the way, you might encounter a quantum mechanic or two,
- or perhaps a microscopic space fleet, or -- if you're REALLY lucky --
- the Ravenous Bugblatter Beast of Traal.
+Description: dungeon crawl game - Lisp interface
+ NetHack is a wonderfully silly, yet quite addictive, Dungeons &
+ Dragons-style adventure game. You play a character from one of many
+ classes (such as wizard, ranger, or tourist), fighting your way down to
+ retrieve the Amulet of Yendor (try saying THAT one backwards!) for your
+ god. On the way, you might encounter a quantum mechanic or two, or
+ perhaps King Arthur, or - if you're REALLY lucky - the Ravenous
+ Bugblatter Beast of Traal.
.
- This package contains the Lisp window version, required
- for playing Nethack under Emacs.
+ You should install a front-end for NetHack if you
+ wish to play the game. Each of them includes the
+ original non-graphical version, and they can all be installed
+ at the same time:
+ - nethack-console: no graphics, just plain NetHack;
+ - nethack-x11 : original X11/Athena-based graphical version;
+ - nethack-qt : Qt-based graphical version;
+ - nethack-lisp : Lisp window version.
+ .
+ This package provides the version required for playing NetHack via
+ Lisp, for instance under Emacs (which requires nethack-el).
Package: nethack-x11
Depends: ${shlibs:Depends}, ${misc:Depends}, nethack-common (= ${binary:Version}), xbase-clients (>= 3.3.3.1-5)
Architecture: any
Provides: nethack
-Description: Text-based/X11 overhead view D&D-style adventure game
- Nethack is a wonderfully silly, yet quite addicting, Dungeons and
- Dragons-style adventure game. You play the part of a fierce fighter,
- wizard, or any of many other classes, fighting your way down to
- retrieve the Amulet of Yendor (try saying THAT one backwards!) for
- your god. On the way, you might encounter a quantum mechanic or two,
- or perhaps a microscopic space fleet, or -- if you're REALLY lucky --
- the Ravenous Bugblatter Beast of Traal.
+Description: dungeon crawl game - X11 interface
+ NetHack is a wonderfully silly, yet quite addictive, Dungeons &
+ Dragons-style adventure game. You play a character from one of many
+ classes (such as wizard, ranger, or tourist), fighting your way down to
+ retrieve the Amulet of Yendor (try saying THAT one backwards!) for your
+ god. On the way, you might encounter a quantum mechanic or two, or
+ perhaps King Arthur, or - if you're REALLY lucky - the Ravenous
+ Bugblatter Beast of Traal.
+ .
+ You should install a front-end for NetHack if you
+ wish to play the game. Each of them includes the
+ original non-graphical version, and they can all be installed
+ at the same time:
+ - nethack-console: no graphics, just plain NetHack;
+ - nethack-x11 : original X11/Athena-based graphical version;
+ - nethack-qt : Qt-based graphical version;
+ - nethack-lisp : Lisp window version.
.
- This package contains the text and X11/Athena-based graphical versions
- of Nethack.
+ This package provides the text and X11/Athena-based graphical versions
+ of NetHack.
Package: nethack-qt
Depends: ${shlibs:Depends}, nethack-common (= ${binary:Version})
Architecture: any
Provides: nethack
-Description: Text-based/Qt overhead view D&D-style adventure game
- Nethack is a wonderfully silly, yet quite addicting, Dungeons and
- Dragons-style adventure game. You play the part of a fierce fighter,
- wizard, or any of many other classes, fighting your way down to
- retrieve the Amulet of Yendor (try saying THAT one backwards!) for
- your god. On the way, you might encounter a quantum mechanic or two,
- or perhaps a microscopic space fleet, or -- if you're REALLY lucky --
- the Ravenous Bugblatter Beast of Traal.
+Description: dungeon crawl game - Qt interface
+ NetHack is a wonderfully silly, yet quite addictive, Dungeons &
+ Dragons-style adventure game. You play a character from one of many
+ classes (such as wizard, ranger, or tourist), fighting your way down to
+ retrieve the Amulet of Yendor (try saying THAT one backwards!) for your
+ god. On the way, you might encounter a quantum mechanic or two, or
+ perhaps King Arthur, or - if you're REALLY lucky - the Ravenous
+ Bugblatter Beast of Traal.
.
- This package contains the text and Qt-based graphical versions
- of Nethack.
-
+ You should install a front-end for NetHack if you
+ wish to play the game. Each of them includes the
+ original non-graphical version, and they can all be installed
+ at the same time:
+ - nethack-console: no graphics, just plain NetHack;
+ - nethack-x11 : original X11/Athena-based graphical version;
+ - nethack-qt : Qt-based graphical version;
+ - nethack-lisp : Lisp window version.
+ .
+ This package provides the text and Qt-based graphical versions
+ of NetHack.
Template: nethack-common/recover-setgid
Type: boolean
Default: false
_Description: Use setgid bit with NetHack's recover utility?
The "recover" program is installed as part of the nethack-common package
and exists to help the administrator recover broken save files, etc.
.
Recover is traditionally installed with the "setgid" bit (group "games").
However, this package runs it automatically, as root, during the system
boot. As a consequence, allowing the utility to use the "games" group
privileges is only useful
to let players recover their save
files, should NetHack crash or their connection drop mid-game.
.
If you do not choose this option, recovers after a crash or a connection
drop can only be run as root or by a user who is member of the "games"
group.
Source: nethack
Section: games
Priority: optional
Maintainer: Joshua Kwan <joshk@triplehelix.org>
Standards-Version: 3.7.2
Build-Depends: flex, bison, groff-base, debhelper (>= 5.0.31), libx11-dev, libxt-dev, libxext-dev, libxmu-dev, xutils, bsdmainutils, libxaw7-dev | libxaw-dev, libncurses5-dev | libncurses-dev, libqt3-mt-dev (>= 3:3.3.4-7), dpatch, po-debconf
Package: nethack-common
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}, debianutils (>= 1.12)
Recommends: nethack-console | nethack-x11 | nethack-qt
Conflicts: suidmanager (<< 0.50), nethack-console (<< ${binary:Version}), nethack-x11 (<< ${binary:Version}), nethack-gnome (<< ${binary:Version}), nethack-qt (<< ${binary:Version}), nethack-lisp (<< ${binary:Version})
Replaces: nethack (<< 3.4.0)
Description: dungeon crawl game - common files
NetHack is a wonderfully silly, yet quite addictive, Dungeons &
Dragons-style adventure game. You play a character from one of many
classes (such as wizard, ranger, or tourist), fighting your way down to
retrieve the Amulet of Yendor (try saying THAT one backwards!) for your
god. On the way, you might encounter a quantum mechanic or two, or
perhaps King Arthur, or - if you're REALLY lucky - the Ravenous
Bugblatter Beast of Traal.
.
You should install a front-end for NetHack if you
wish to play the game. Each of them includes the
original non-graphical version, and they can all be installed
at the same time:
- nethack-console: no graphics, just plain NetHack;
- nethack-x11 : original X11/Athena-based graphical version;
- nethack-qt : Qt-based graphical version;
- nethack-lisp : Lisp window version.
.
The various graphical front-ends for NetHack all share a large
number of files in common. This package contains the graphics,
dungeon levels, and utilities common to all NetHack front-ends.
.
It also provides a few utilities such as recover, for retrieving auto-save files in case
of a power failure, and dgn_comp and lev_comp, two utilities for making
your own NetHack levels and dungeons. The "recover" may be run every time the system
boots, if there are any auto-save files available.
Package: nethack-console
Depends: ${shlibs:Depends}, nethack-common (= ${binary:Version})
Architecture: any
Provides: nethack
Description: dungeon crawl game - text-based interface
NetHack is a wonderfully silly, yet quite addictive, Dungeons &
Dragons-style adventure game. You play a character from one of many
classes (such as wizard, ranger, or tourist), fighting your way down to
retrieve the Amulet of Yendor (try saying THAT one backwards!) for your
god. On the way, you might encounter a quantum mechanic or two, or
perhaps King Arthur, or - if you're REALLY lucky - the Ravenous
Bugblatter Beast of Traal.
.
You should install a front-end for NetHack if you
wish to play the game. Each of them includes the
original non-graphical version, and they can all be installed
at the same time:
- nethack-console: no graphics, just plain NetHack;
- nethack-x11 : original X11/Athena-based graphical version;
- nethack-qt : Qt-based graphical version;
- nethack-lisp : Lisp window version.
.
This package provides the plain console version of NetHack.
Package: nethack-lisp
Depends: ${shlibs:Depends}, nethack-common (= ${binary:Version})
Suggests: nethack-el
Architecture: any
Provides: nethack
Description: dungeon crawl game - Lisp interface
NetHack is a wonderfully silly, yet quite addictive, Dungeons &
Dragons-style adventure game. You play a character from one of many
classes (such as wizard, ranger, or tourist), fighting your way down to
retrieve the Amulet of Yendor (try saying THAT one backwards!) for your
god. On the way, you might encounter a quantum mechanic or two, or
perhaps King Arthur, or - if you're REALLY lucky - the Ravenous
Bugblatter Beast of Traal.
.
You should install a front-end for NetHack if you
wish to play the game. Each of them includes the
original non-graphical version, and they can all be installed
at the same time:
- nethack-console: no graphics, just plain NetHack;
- nethack-x11 : original X11/Athena-based graphical version;
- nethack-qt : Qt-based graphical version;
- nethack-lisp : Lisp window version.
.
This package provides the version required for playing NetHack via
Lisp, for instance under Emacs (which requires nethack-el).
Package: nethack-x11
Depends: ${shlibs:Depends}, ${misc:Depends}, nethack-common (= ${binary:Version}), xbase-clients (>= 3.3.3.1-5)
Architecture: any
Provides: nethack
Description: dungeon crawl game - X11 interface
NetHack is a wonderfully silly, yet quite addictive, Dungeons &
Dragons-style adventure game. You play a character from one of many
classes (such as wizard, ranger, or tourist), fighting your way down to
retrieve the Amulet of Yendor (try saying THAT one backwards!) for your
god. On the way, you might encounter a quantum mechanic or two, or
perhaps King Arthur, or - if you're REALLY lucky - the Ravenous
Bugblatter Beast of Traal.
.
You should install a front-end for NetHack if you
wish to play the game. Each of them includes the
original non-graphical version, and they can all be installed
at the same time:
- nethack-console: no graphics, just plain NetHack;
- nethack-x11 : original X11/Athena-based graphical version;
- nethack-qt : Qt-based graphical version;
- nethack-lisp : Lisp window version.
.
This package provides the text and X11/Athena-based graphical versions
of NetHack.
Package: nethack-qt
Depends: ${shlibs:Depends}, nethack-common (= ${binary:Version})
Architecture: any
Provides: nethack
Description: dungeon crawl game - Qt interface
NetHack is a wonderfully silly, yet quite addictive, Dungeons &
Dragons-style adventure game. You play a character from one of many
classes (such as wizard, ranger, or tourist), fighting your way down to
retrieve the Amulet of Yendor (try saying THAT one backwards!) for your
god. On the way, you might encounter a quantum mechanic or two, or
perhaps King Arthur, or - if you're REALLY lucky - the Ravenous
Bugblatter Beast of Traal.
.
You should install a front-end for NetHack if you
wish to play the game. Each of them includes the
original non-graphical version, and they can all be installed
at the same time:
- nethack-console: no graphics, just plain NetHack;
- nethack-x11 : original X11/Athena-based graphical version;
- nethack-qt : Qt-based graphical version;
- nethack-lisp : Lisp window version.
.
This package provides the text and Qt-based graphical versions
of NetHack.
Reply to: