Update surf.save

surf.save.md

@@ -1,14 +1,24 @@
-# surf.save(filename)
-Guarda la surface de destí actual en un arxiu especificat (en format GIF).
+# surf.save(surface, filename, palette)
+Guarda (en format GIF) la surface especificada en un arxiu especificat, opcionalment amb la paleta especificada.
 
 ### Paràmetres
 
+`surface`
+La surface que volem guardar.
+
 `filename`
-Nom de l'arxiu on es guardarà. Si no s'especifica ruta, si no recorde mal, ho guarda al directori actual del sistema (normalment on està l'executable). 
+Nom de l'arxiu on es guardarà. Si no s'especifica ruta ho guarda al directori actual del sistema (normalment on està l'executable). 
+
+`palette`
+La paleta que volem que tinga el GIF. Si no s'especifica guarda el GIF sense paleta (alguns visors/editors s'atraganten amb gifs sense paleta).
 
 ### Exemple
 ```
--- TODO
+local s = surf.new(128,64)    -- crea una nova surface de 128x64 pixels
+surf.target(s)  -- la fica com a destinació
+surf.cls(0)  -- la esborra amb color 0
+draw.circf(64,32,32,1)    -- pinta un circle de 32 pixels de radio al centre
+surf.save(s, "circle.gif") -- guarda la surface com un gif sense paleta
 ```
 
 ### Vore també