Alfred:

> Here comes the manpage for Songbird.
> 
> songbird.1 is in sgml format. songbird.1.txt is the plain text version 
> of the manpage for review. Most of the content comes from "songbird -h".

      songbird - The desktop media player mashed-up with the Web.

I would just say "Desktop media player mashed-up with the web".
Starting the sentence with "The" makes it sound like the only media
player with these features.

      Songbird is a complete desktop  media  player  or  "jukebox"
      with a uniquely open approach to Internet digital media net-
      work services.

Does it support CD playback?  If not, then it probably isn't a
"complete" player.  Might be better to be a bit more clear about
what features it has.  The DESCRIPTION doesn't really tell me what
this program does aside from being a media jukebox.

It seems that the arguments refer to profiles.  Might be nice if
the DESCRIPTION defined what a profile does or means.

It isn't really clear to me what the "-no-remote" option does.

      -UILocale locale        Start with  the  UI  Locale  listed:
                              locale.

      -contentLocale locale   Start  with   the   content   Locale
                              listed: locale.

I would say "Will use the specified locale with the UI" or "Will
use the specified locale with the content".

      -height value           Set the height of startup window  to
                              value.

I would say "Specify the height value of the startup window".  I
think that is just a bit more clear.

Since Songbird uses GStreamer, I'd think that referring to the fact that
it uses GStreamer in the DESCRIPTION would be nice.  I'd also include
gst-std-options(5) in the SEE ALSO section since I assume it supports
the standard GStreamer library options documented here.  No?



Reply via email to