Calum:

 > 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...)

The SunOS Man Page Style Guide is here, for reference:

    http://infobot.sfbay/osmanpages/styleguide.html

This is referenced from our team's Man Page Process website, here:

http://jdswiki.ireland.sun.com/twiki/bin/view/JDS/ManPageProcess#Manpage_Style_Guide

Alfred:

> 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.

I agree.

> "complete" has been removed from the man page due to the lack of CD 
> playback.

Makes sense.

> "unique" could also be removed based on the guideline.

I don't have a problem with the term "unique", though all programs are
"unique" in their own way, I suppose, so it isn't really very
descriptive.

Brian

Reply via email to