Calum Benson wrote: > On 18 Aug 2008, at 11:06, Alfred Peng wrote: >> NAME >> songbird - The desktop media player mashed-up with the Web. >> >> DESCRIPTION >> Songbird is a complete desktop media player or "jukebox" >> with a uniquely open approach to Internet digital media net- >> work services. > > IMHO, there's rather too much marketing-speak in here than is fitting > for a manpage. "Mashed-up" sounds too informal and imprecise, and a > manpage shouldn't be trying to persuade me that any particular > features are "unique" or "complete". > > I just want a manpage to tell me what the application does, in the > simplest and clearest way possible. (I'm sure Sun must have a manpage > style guide somewhere...) Hi Calum,
I feel that "mashup" is a good word to describe that Songbird isn't only about playing media: http://en.wikipedia.org/wiki/Mashup_(web_application_hybrid), and it's used in many press releases to talk about Songbird. "complete" has been removed from the man page due to the lack of CD playback. "unique" could also be removed based on the guideline. Best Regards, -Alfred
