Update 'play'

play.md

@@ -1,3 +1,29 @@
+`(desde v0.5.2)`
+# play(str)
+Reprodueix una seqüència musical. El format es el següent:
+
+* `c`,`d`,`e`,`f`,`g`,`a`,`b`: Son les notes do, re, mi, fa, sol, la i si.
+* `#` o `+`: darrer d'una nota la converteix en sostingut.
+* `-`: darrere d'una nota la converteix en bemol.
+* `r`: es un silenci
+* `oX`: on X es un nombre del 0 al 9, canvia la octava per a totes les notes que vinguen després.
+* `>` o `<`: puja o baixa una octava.
+* `lX`: on X es un nombre del 0 al 9, canvia la duració per a totes les notes que vinguen després.
+* `vX`: on X es un nombre del 0 al 9, canvia el volum per a totes les notes que vinguen després.
+* `tX`: on X es un nombre del 0 al 9, canvia el tempo de la cançò a partir de eixe moment.
+
+### Paràmetres
+
+`str`
+Una cadena que conté la seqüència de la cançò.
+
+### Exemple
+```
+play("cdefgab") -- toca do re mi fa sol la si
+play("o4cdefgabo5c") -- toca do re mi fa sol la si de la octava 4 i do de la octava 5
+play("cdefgab>c") -- com per defecte se comença en la octava 4, aquesta seqüencia es equivalent a l'anterior
+play("l1v5cv4cv3cv2cv1cv0c") -- toca un do fent un fade out
+```
+### Vore també
 * [sound(freq,len)](sound)
 * [nosound()](nosound)
-* [play(str)](play)