[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

[RFR] templates://icecast2/{templates}



Please find, for review, the debconf templates and packages descriptions for the icecast2 source package.

This review will last from Friday, August 19, 2011 to Monday, August 29, 2011.

Please send reviews as unified diffs (diff -u) against the original
files. Comments about your proposed changes will be appreciated.

Your review should be sent as an answer to this mail.

When appropriate, I will send intermediate requests for review, with
"[RFRn]" (n>=2) as a subject tag.

When we will reach a consensus, I send a "Last Chance For
Comments" mail with "[LCFC]" as a subject tag.

Finally, the reviewed templates will be sent to the package maintainer
as a bug report, and a mail will be sent to this list with "[BTS]" as
a subject tag.

Rationale:
--- icecast2.old/debian/templates	2011-08-14 09:24:23.655249057 +0200
+++ icecast2/debian/templates	2011-08-19 07:09:45.603862196 +0200
@@ -1,37 +1,39 @@
 Template: icecast2/icecast-setup
 Type: boolean
 Default: false
-_Description: Setup Icecast2 - Enable Live HTTP Streaming?
- This option allows enable icecast2 on this server
- and configure passwords for icecast-server.
+_Description: Enable live HTTP streaming for IceCast2?

OMG. No German person among maintainers and, still, the synopsis Has
Kapitals Everywhere..:-)

OK, drop "Setup Icecast2" as debconf will already mention this..:-)

+ If you choose this option, IceCast2 will be enabled on this server
+ and passwords will be configured.
  .
- If you have already manually tweaked icecast2 configuration
- it may not work as expected.
+ You should not use this option if you have already manually tweaked
+ the configuration of Icecast2.

Let's be more directive and use common wording in such situations.
 
 Template: icecast2/hostname
 Type: string
 Default: localhost
-_Description: Icecast2 Hostname:
- Specify a fully qualified domain name.
- Icecast2 uses this as prefix to all streams.
+_Description: Icecast2 hostname:
+ Please specify the fully qualified domain name that should be used
+ as prefix to all streams.

Apart from the ungermanization....use a wording that's quite common
for debconf templates.

 
 Template: icecast2/sourcepassword
 Type: string
 Default: hackme
-_Description: Icecast2 Source Password:
- Specify a password to send A/V sources to icecast
+_Description: Icecast2 source password:
+ Please specify the password that should be used to send audio and
+ video sources to Icecast2.

Ditto...and unjargonize "A/V"
 
 Template: icecast2/relaypassword
 Type: string
 Default: hackme
-_Description: Icecast2 Relay Password:
- Specify the default password for stream relay access.
+_Description: Icecast2 relay password:
+ Please specify the password that should be used for stream relay access.

Ditto

 
 Template: icecast2/adminpassword
 Type: string
 Default: hackme
-_Description: Icecast2 Admin Password:
- Specify the admin password. 
- You can access icecast2's admin interface via
- http://localhost:8000/ - and both monitor connection as
- well as block users.
+_Description: Icecast2 administration password:
+ Please specify the password that should be used for IceCast2
+ administration.
+ .
+ The administration web interface, at http://localhost:8000, can be
+ used to monitor connections or to block users from streaming.

Only for that, by the way? I wonder if we really need to specify what
the admin interface can be used for. This is an admin interface, period..:)

--- icecast2.old/debian/control	2011-08-14 09:24:23.655249057 +0200
+++ icecast2/debian/control	2011-08-19 07:11:26.682568073 +0200
@@ -33,9 +33,9 @@
 Suggests: ices2
 Description: streaming media server
  Icecast is a streaming media server which currently supports Ogg
- streaming including the Vorbis and Theora codecs. Icecast can also
- handle other streams like MP3/AAC/NSV. It can be used to create an
- Internet radio station or a privately running jukebox and many things
- in between. It is very versatile in that new formats can be added
- relatively easily and supports open standards for communication and
+ streaming including the Vorbis and Theora codecs. It can also
+ handle other streams such as MP3/AAC/NSV. It can be used, for
+ instance, to create an "Internet radio station" or a privately
+ running jukebox. New formats support can be added
+ relatively easily. Open standards are used for communication and
  interaction.


s/Icecast/It

put "Internet radio station" in quotes and drop the "many things in
between"

Make the mention of new formats simpler.



-- 


Template: icecast2/icecast-setup
Type: boolean
Default: false
_Description: Enable live HTTP streaming for IceCast2?
 If you choose this option, IceCast2 will be enabled on this server
 and passwords will be configured.
 .
 You should not use this option if you have already manually tweaked
 the configuration of Icecast2.

Template: icecast2/hostname
Type: string
Default: localhost
_Description: Icecast2 hostname:
 Please specify the fully qualified domain name that should be used
 as prefix to all streams.

Template: icecast2/sourcepassword
Type: string
Default: hackme
_Description: Icecast2 source password:
 Please specify the password that should be used to send audio and
 video sources to Icecast2.

Template: icecast2/relaypassword
Type: string
Default: hackme
_Description: Icecast2 relay password:
 Please specify the password that should be used for stream relay access.

Template: icecast2/adminpassword
Type: string
Default: hackme
_Description: Icecast2 administration password:
 Please specify the password that should be used for IceCast2
 administration.
 .
 The administration web interface, at http://localhost:8000, can be
 used to monitor connections or to block users from streaming.
--- icecast2.old/debian/templates	2011-08-14 09:24:23.655249057 +0200
+++ icecast2/debian/templates	2011-08-19 07:13:48.966377017 +0200
@@ -1,37 +1,39 @@
 Template: icecast2/icecast-setup
 Type: boolean
 Default: false
-_Description: Setup Icecast2 - Enable Live HTTP Streaming?
- This option allows enable icecast2 on this server
- and configure passwords for icecast-server.
+_Description: Enable live HTTP streaming for IceCast2?
+ If you choose this option, IceCast2 will be enabled on this server
+ and passwords will be configured.
  .
- If you have already manually tweaked icecast2 configuration
- it may not work as expected.
+ You should not use this option if you have already manually tweaked
+ the configuration of Icecast2.
 
 Template: icecast2/hostname
 Type: string
 Default: localhost
-_Description: Icecast2 Hostname:
- Specify a fully qualified domain name.
- Icecast2 uses this as prefix to all streams.
+_Description: Icecast2 hostname:
+ Please specify the fully qualified domain name that should be used
+ as prefix to all streams.
 
 Template: icecast2/sourcepassword
 Type: string
 Default: hackme
-_Description: Icecast2 Source Password:
- Specify a password to send A/V sources to icecast
+_Description: Icecast2 source password:
+ Please specify the password that should be used to send audio and
+ video sources to Icecast2.
 
 Template: icecast2/relaypassword
 Type: string
 Default: hackme
-_Description: Icecast2 Relay Password:
- Specify the default password for stream relay access.
+_Description: Icecast2 relay password:
+ Please specify the password that should be used for stream relay access.
 
 Template: icecast2/adminpassword
 Type: string
 Default: hackme
-_Description: Icecast2 Admin Password:
- Specify the admin password. 
- You can access icecast2's admin interface via
- http://localhost:8000/ - and both monitor connection as
- well as block users.
+_Description: Icecast2 administration password:
+ Please specify the password that should be used for IceCast2
+ administration.
+ .
+ The administration web interface, at http://localhost:8000, can be
+ used to monitor connections or to block users from streaming.
--- icecast2.old/debian/control	2011-08-14 09:24:23.655249057 +0200
+++ icecast2/debian/control	2011-08-19 07:11:26.682568073 +0200
@@ -33,9 +33,9 @@
 Suggests: ices2
 Description: streaming media server
  Icecast is a streaming media server which currently supports Ogg
- streaming including the Vorbis and Theora codecs. Icecast can also
- handle other streams like MP3/AAC/NSV. It can be used to create an
- Internet radio station or a privately running jukebox and many things
- in between. It is very versatile in that new formats can be added
- relatively easily and supports open standards for communication and
+ streaming including the Vorbis and Theora codecs. It can also
+ handle other streams such as MP3/AAC/NSV. It can be used, for
+ instance, to create an "Internet radio station" or a privately
+ running jukebox. New formats support can be added
+ relatively easily. Open standards are used for communication and
  interaction.
Source: icecast2
Section: sound
Priority: optional
Maintainer: Debian Multimedia Maintainers <pkg-multimedia-maintainers@lists.alioth.debian.org>
Uploaders: Guillaume Pellerin <yomguy@altern.org>,
 Romain Beauxis <toots@rastageeks.org>,
 Jonas Smedegaard <dr@jones.dk>
Build-Depends: cdbs (>= 0.4.39),
 autotools-dev,
 devscripts (>= 2.10.7),
 libtool,
 automake1.10,
 autoconf,
 cdbs (>= 0.4.85~),
 debhelper (>= 7.0.1),
 dh-buildinfo,
 libogg-dev (>> 1.0.0),
 libvorbis-dev (>> 1.0.0),
 libxslt1-dev | libxslt-dev,
 libxml2-dev,
 libcurl4-gnutls-dev,
 libtheora-dev (>= 0.0.0.alpha7),
 libspeex-dev,
 po-debconf
Vcs-Git: git://git.debian.org/pkg-multimedia/icecast2.git
Vcs-Browser: http://git.debian.org/?p=pkg-multimedia/icecast2.git
Standards-Version: 3.9.2
Homepage: http://www.icecast.org/

Package: icecast2
Architecture: any
Depends: adduser, ${shlibs:Depends}, ${misc:Depends}
Suggests: ices2
Description: streaming media server
 Icecast is a streaming media server which currently supports Ogg
 streaming including the Vorbis and Theora codecs. It can also
 handle other streams such as MP3/AAC/NSV. It can be used, for
 instance, to create an "Internet radio station" or a privately
 running jukebox. New formats support can be added
 relatively easily. Open standards are used for communication and
 interaction.

Attachment: signature.asc
Description: Digital signature


Reply to: