Hi David

The words "random" and "randomize" are ok. The main thing is to provide 
a better command help. The command help is clear, but a little confuse 
for all of us that don't know caml language and expression languages.

I think you can improve the help adding an extra fiel for each command 
help, named "Example" or "Examples" of how to use in a real world the 
command.

For instante, the help command:

* mode : string (default "randomize")
     Play the files in the playlist either in the order ("normal" mode), or
shuffle the playlist each time it is loaded, and play it in this order for a
whole round ("randomize" mode), or pick a random file in the playlist each time
("random" mode).


Can be more helpful if you added a real world example, like this:

-----------------------------------------------
example  1: You want to shufle all the songs without repeated each round 
from the playlist, use "randomizer"
myplaylist = 
playlist(mode="randomize",reload=1,reload_mode="rounds","/opt/Musica/Tangos")

example 2: If you want to pick one by one the songs in a random mode. 
Note: In this mode you can get a repeated song, because the random 
algorith pick files one by one each time they will be played.
myplaylist = 
playlist(mode="random",reload=1,reload_mode="rounds","/opt/Musica/Tangos")

example 3: You want to play in order ......
-----------------------------------------------

If you can add the extra field for examples for each command, then the 
requests for help in the mail list will be lowered.

Thanks


El 03/12/2010 02:36 p.m., David Baelde escribió:
> Okay so here's a poll:
>
> 1. Do you think the name "randomize" is confusing?
> 2. If so do you think "shuffle" would be clear, or do you have another
> proposition?
>
> Cheers,
>
> David
>
>


------------------------------------------------------------------------------
Increase Visibility of Your 3D Game App & Earn a Chance To Win $500!
Tap into the largest installed PC base & get more eyes on your game by
optimizing for Intel(R) Graphics Technology. Get started today with the
Intel(R) Software Partner Program. Five $500 cash prizes are up for grabs.
http://p.sf.net/sfu/intelisp-dev2dev
_______________________________________________
Savonet-users mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/savonet-users

Reply via email to