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

Justin B Rye jbr at edlug.org.uk
Fri Aug 19 08:22:11 UTC 2011 

Christian PERRIER wrote:
> --- 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: Enable live HTTP streaming for IceCast2?
> 
> OMG. No German person among maintainers and, still, the synopsis Has
> Kapitals Everywhere..:-)

You've still got "IceCast2" a couple of times where upstream just say
"Icecast2".  Otherwise it all looks good.

>  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.
> 
> Ditto...and unjargonize "A/V"

I don't understand this one.  The password sends sources to Icecast2?
Shouldn't it be something more like:

    Please specify the password that should be used to control access to
    Icecast2's media sources.
  
>  Template: icecast2/relaypassword
>  Type: string
>  Default: hackme
> +_Description: Icecast2 relay password:
> + Please specify the password that should be used for stream relay access.
> 
> Ditto

Ditto.  Maybe:

    Please specify the password that should be used to control access to
    Icecast2's stream relays.

(whatever that means).
 
> --- 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. 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.

This still has a couple of problems.
 * It launches itself straight into technical details of supported
   codecs before explaining what it's for.  Move the "can be used to
   create" part earlier.  This also means that all the stuff about
   media formats is together in one place.
 * "New formats support can be added relatively easily" is a feature
   of the sourcecode, not of this binary package.
 * What "open standards" is it talking about?  If it means "compatible
   with most media players" it should say that.
 
> s/Icecast/It
> 
> put "Internet radio station" in quotes and drop the "many things in
> between"

Saying that it can only handle things between radio station and
jukebox is false anyway, now that it can function as an "Internet TV
station" too.

How about:

 Description: streaming media server
  Icecast is a versatile multimedia streaming server which can create
  (for instance) a private jukebox or "Internet radio station". It
  supports Ogg streaming using the Vorbis and Theora codecs, as well as
  other formats such as MP3, AAC, or NSV, and is compatible with most
  media players.

-- 
JBR	with qualifications in linguistics, experience as a Debian
	sysadmin, and probably no clue about this particular package
-------------- next part --------------
diff -ru old/control new/control
--- old/control	2011-08-14 09:29:40.865960651 +0100
+++ new/control	2011-08-19 09:18:21.641960965 +0100
@@ -32,10 +32,8 @@
 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. 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
- interaction.
+ Icecast is a versatile multimedia streaming server which can create
+ (for instance) a private jukebox or "Internet radio station". It
+ supports Ogg streaming using the Vorbis and Theora codecs, as well as
+ other formats such as MP3, AAC, or NSV, and is compatible with most
+ media players.
diff -ru old/templates new/templates
--- old/templates	2011-08-14 09:29:42.721960556 +0100
+++ new/templates	2011-08-19 09:19:46.241960576 +0100
@@ -1,37 +1,40 @@
 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 control access to
+ Icecast2's media sources.
 
 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 to control access to
+ Icecast2's stream relays.
 
 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.
-------------- next part --------------
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 control access to
 Icecast2's media sources.

Template: icecast2/relaypassword
Type: string
Default: hackme
_Description: Icecast2 relay password:
 Please specify the password that should be used to control access to
 Icecast2's stream relays.

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.
-------------- next part --------------
Source: icecast2
Section: sound
Priority: optional
Maintainer: Debian Multimedia Maintainers <pkg-multimedia-maintainers at lists.alioth.debian.org>
Uploaders: Guillaume Pellerin <yomguy at altern.org>,
 Romain Beauxis <toots at rastageeks.org>,
 Jonas Smedegaard <dr at 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 versatile multimedia streaming server which can create
 (for instance) a private jukebox or "Internet radio station". It
 supports Ogg streaming using the Vorbis and Theora codecs, as well as
 other formats such as MP3, AAC, or NSV, and is compatible with most
 media players.

More information about the pkg-multimedia-maintainers mailing list