[MPlayer-DOCS] CVS: main/DOCS/man/en mplayer.1,1.1148,1.1149

[Diego Biurrun]

On Tue, Nov 15, 2005 at 05:07:55PM +0100, Paul TT wrote:
> On Sun,  6 Nov 2005 15:21:20 +0100 (CET)
> syncmail at mplayerhq.hu (Reimar Döffinger CVS) wrote:
> 
> > Modified Files:
> > 	mplayer.1 
> > Log Message:
> > "describe" cdda://n-m syntax
> > 
> > --- mplayer.1	5 Nov 2005 11:40:05 -0000	1.1148
> > +++ mplayer.1	6 Nov 2005 14:21:17 -0000	1.1149
> > @@ -104,7 +104,7 @@
> >  .in
> >  .B mplayer
> >  'in +\n[.k]u
> > -.I [cdda|cddb]://track[:speed][/device]
> > +.I [cdda|cddb]://track[-endtrack][:speed][/device]
> 
> only an opinion:
> since dvd syntax is explained like this:
> .I dvd://[title | [start_title]\-end_title ]
> 
> maybe cdda|cddb would be:
> 
> +.I [cdda|cddb]://[track | [start_track]\-endtrack][:speed][/device]
> 
> or maybe _better_, leave cdda|cddb as you wrote now and modify DVD
> syntax explanation according to this...
> so:
> .I dvd://title[\-end_title]

Yes, it should be consistent.  Which variant to use is a good question.

  dvd://start_title[-end_title]

is more compact, which is an advantage, while

  dvd://[title | [start_title]-end_title]

makes it a little bit more clear that if you provide just one number, it
will play just that track and not start at that track and keep playing.

In any case, this part of the command line syntax needs to be properly
documented.  I don't think many people can figure it out correctly from
the terse syntax description.

Diego