  															      Le 07/04/2008
                             l
                              ll
                               lll
                               lll
                               lll                          aaaaaaa  a
                               lll        uu     uu        aa    aaaa
                              lll         uu     uu       a       aaa
                              lll         uu     uu                aa
                             lll          uu     uu          aaaa  aa
                            lll            uu    uuu       aaa  aaaaa
                           lll             uuu    uuu     aa      aaa
                            llllllllll      uuuuuuuuu     aa      aaa
                              llllllllll       uuu  uuu    aaa  aa aa
                                     ll               uu     aaa    aa
                                     l                               a



                                   ssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssssss
                                 ssss        t                t
                                sss         tt               tt       ii
                                sss         tttttt  aaa      tttttt           oooo      n  nnnn
                                 sss        tt         a     tt              oo  oo      nnn  nn
                                   sss      tt          a    tt       ii    oo    oo     nn    nn
                                     sss    tt      aaaaa    tt       ii    oo    oo     nn    nn	V 1.3
                                     sss    tt     aa   a    tt       ii    oo    oo     nn    nn
                                   ssss     tt     aa   a    tt       ii     oo  oo      nn    nn
sssssssssssssssssssssssssssssssssssss        ttt    aaaa a    ttt      iii    oooo       n      nnn	par Samy (alias Gogy)
													traduit et test par IMIX







********************************************************************************************************************************************

							Avant propos:

********************************************************************************************************************************************

Premirement je tiens, avant toute chose,  prciser le point suivant:
Cet add-on a t ralis  partir de Luaprog (v0.2) dvelopp par Novservant (SERVANT Jrmy) avec l'aide de Sabbator.
Un gand merci pour son accord de rexploitation de ses sources (un certain nombre de fonctions dcrites ci-aprs sont le 
rsultat de son travail).


Deuximement: cet add-on a t ralis avec deux objectifs:
-apprendre le Lua,
-pouvoir crer entirement sur PSP, sans avoir  passer par le PC.




********************************************************************************************************************************************

						Mais qu'est ce donc est-ce?

********************************************************************************************************************************************

Lua station est un diteur de texte spcialement conu pour la programmation en Lua sur PSP (lui mme tant dvelopp en Lua).
De plus il a t rattach au Luaplayer afin de permettre un dveloppement en continu sur PSP (ce qui vite tout les allez-r
etours entre les diffrents homebrews... pas mal pour gagner du temps et conomiser la batterie).
Note: ce rattachement a ncessit la modification du programme Lowser crer par Joachim Bengtsson <joachimb@gmail.com> 
(aka Nevyn)

Ci joint vous trouverez la documentation des principales fonctions Lua et du Luaplayer dans le repertoire "Documentation". 
Idal pour transporter partout la documentation avec soi (il suffit d'ouvrir le documment qui vous interesse).




********************************************************************************************************************************************

						       Les garanties:

********************************************************************************************************************************************

Eh bien justement il n'y a aucune garantie: en aucun je ne peux tre responsable des ventuels dommages pouvant arriver  un quelconque 
systme PSP utilisant ce programme ou un de ses drivs. (Et puis mme s'il n'utilise pas ce programme ou ses drivs ;-) )
A utiliser  vos risques et prils!!!!




********************************************************************************************************************************************

						       L'installation:

********************************************************************************************************************************************

Cela ncessite l'installation pralable du Luaplayer sur la PSP. 

#####	ATTENTION CHANGEMENT	#####
 Du fait de l'utilisation d'une police autre que celle incluse dans l'interpreteur, votre Luaplayer doit pouvoir supporter 
les differentes polices. A l'heure actuelle: les version officielles, et les mods tels que HM (recommends pour les PSP SLIM,
en attendant une version officielle).



Attention cette tape est particulirement difficile ;-)
il faut extraire le dossier "Lowser" de l'archive vers le dossier "application" de votre Luaplayer. (peu importe le dossier 
GAME/GAME150/GAME3XX). Une fentre va apparatre demandant la confirmation de l'crasement des fichiers dj prsents, il 
suffit de cliquer sur "oui" ou sur "tous" (c'est moins fatiguant :-p)

Et voil c'est fait!




********************************************************************************************************************************************

						       L'utilisation:

********************************************************************************************************************************************

Lancez le Luaplayer, vous vous retrouvez dans le shell classique.
Pour executer un programme: [CROIX] (pour toutes les autres fonctions classique de Lowser consultez le fichier d'aide dans 
l'archive du Luaplayer).



Quelques petites modifications ont ete ajoutees  Lowser:
-indications des touches courantes, (navigation, excution, dition),
-indication de l'tat de la ram,
-possibilite de dfilement rapide des composant d'un dossier en restant appuy sur [haut]/[bas].

A propos de la ram:
L'diteur une fois qu'il a t lanc, conserve certaines donnes en ram, (ceci afin d'acclrer l'dition d'autres programmes). 
Cependant, il est possible que la mmoire ram se sature petit a petit, pour cela deux messages d'alertes apparaissent 
successivement dans Lowser:
-lorsqu'il reste mois de 8Mo, il vous est propos de faire un garbage-collector pour supprimer certains composants inutiliss, 
pour cela appuyez sur [SELECT]; dplacez vers le curseur de navigation pour ractualiser l'etat de la ram. Si cela est 
insuffisant passez  l'tape suivante:
-lorsque'il reste moins de 4Mo, il vous est propos de redmarrer Lowser, pour cela maintenez [START] enfonc jusqu' ce 
qu'un message d'erreur apparaisse, Lowser se relancera alors, et la mmoire aura t vide.




Pour diter un programme: [CARRE]



Vous voil dans l'diteur:
Le programme dit n'est autre que celui que vous aviez selectionn auparavant dans le shell.



	L'interface:

*En haut a gauche se situe les rubriques "Fichier", "Options" et "Aide".

*En Haut au milieu se trouve l'heure de la PSP.

*Un peu plus  droite se trouve l'tat de la batterie (en rouge si la PSP est en chargement).

*Et puis tout  droite il y a la ligne et la colonne du curseur.

*En bas se trouve le chemin d'accs du fichier dit.


	Remarque: une innovation de LuaStation 1.3 est le choix des raccourcis. Dans ce qui va suivre, les raccourcis qui 
	seront cits correspondent aux raccourcis d'origine. (il sont marqus par un #). Une section ultrieure explique 
	comment changer les raccourcis.




	Pour le DEPLACEMENT:

*Utilisez le PAD ANALOGIQUE pour un dfilement rapide, ou les TOUCHES DIRECTIONNELLES pour un dplacement prcis (Le maintien 
d'une touche directionnelle passera en dfilement rapide).

*Afin de faciliter la navigation, il vous est possible de sauter tout  la fin/dbut du document en appuyant sur: 
#[L]+[CARRE] puis [BAS]/[HAUT].

*De mme il est possible de sauter  la page d'aprs/avant en appuyant sur: #[L]+[CARRE] puis [DROITE]/[GAUCHE].
	Remarque: pour sauter successivement plusieurs page sans avoir a rappuyer la combinaison de touche, maintenez appuy #[L] 
	et [GAUCHE]/[DROITE], il suffit simplement de rappuyer sur la touche #[CARRE].

*Pour vous rendre directement  une ligne: tapez #[R]+[CARRE], ensuite entrez le numro de la ligne  l'aide du clavier.
	Remarque: pour annuler, mettez le chiffre 0 puis appuyez sur [R] ou bien appuyez directement sur [START].




	Pour entrer du texte:

*Pressez la touche [START], le clavier s'ouvre alors. Celui-ci utilise la mthode du clavier de DANZEFF (PAD + [CARRE]/[ROND]
/[TRIANGLE]/[CROIX]).
	Remarque: il est possible que l'affichage du texte change  ce moment si le curseur est trop bas: ceci est dans le 
	but d'assurer une meilleure lisibilit du code lors de l'entre  du texte.

*Pour entrer des caractres majuscules: maintenez enfonce la touche [R].

*Pour entrer des chiffres: pressez la touche [L] (le signe  ct du "4" est la tabulation, le signe  ct du "5" est le
retour  la ligne).

*Pour accder aux caractres de ponctuations et spciaux appuyer sur [R] dans lorsque vous tes dans l'interface des chiffres.

*Pour fermer le clavier re-appuyez sur la touche [START].

*Il existe un raccourci pour supprimer un caractre: touche [TRIANGLE] (agit comme backspace)

*De mme pour l'ajout de ligne: touche [CROIX] (agit comme enter)




	Les quelques fonctions utiles:

*La copie de texte: appuyez sur la touche #[L]+[ROND], le mode slection s'active alors. Deplacez le curseur afin d'largir 
vorte slection, celle-ci est alors surligne en rouge. Une fois la selection dsire effectue, tapez  nouveau sur 
#[L]+[ROND] pour copier le tout en mmoire.
	Remarque: durant la phase de slection, il est toujours possible de sauter de page en utilisant les touches 
	#[R]+[CARRE] et les touches directionnelles.

*La suppression de texte: de mme que pour la copie, commencez par appuyer sur la touche #[L]+[ROND], effectuez votre 
slection. Puis pressez la touche [TRIANGLE] pour supprimer la slection. (attention ce n'est pas rversible! Seule la 
rouverture du fichier peut permettre de revenir  la dernire sauvegarde sans prendre les derniers changements en compte).


*Pour la mise en fome du texte il est possible de dcaler  gauche/droite votre texte. Pour cela appuyer sur #[R]+[GAUCHE] ou 
[DROITE], ceci dcalera la ligne repectivement vers la gauche ou vers la droite.
Vous pouvez galement indenter toute un selection, pour cela basculez en mode selection (#[L]+[ROND]) et effectuez la 
manoeuvre dcrite ci-dessus.


*La recherche de texte: appuyer sur #[R]+[CROIX]. Ensuite entrez votre texte  l'aide du clavier. Puis taper sur la touche 
[DROITE]/[GAUCHE] pour rechercher votre texte vers la fin/dbut du document. Pour arrter la recherche appuyez sur [START].
	Remarque 1: Il est possible de coller du texte copi par la mthode vu ci-dessus, en appuyant directement sur la 
	touche [SELECT]
	Remarque 2: pour alterner la recherche avec ou sans respect de la casse appuyez sur [HAUT] ou [BAS]




	Les rubriques "Fichier", "Options" et "Aide":

*Pour y accder appuyez sur [L]+[R] lorsqu'aucun clavier n'est activ. Un menu droulant apparat alors, deplacez vous en 
utilisant les touches directionelles.

---FICHIERS---

*"Nouveau": permet de creer un nouveau document. L'entte contient la dte de cration, ainsi qu'un emplacement pour mettre 
votre nom.
	Remarque 1: avant de creer votre document, une fenetre s'ouvre, vous demandant si vous dsirez ou non enregistrer le 
	document en cours.
	Remarque 2: Pour annuler appuyez sur [L].

*"Ouvrir": vous permet d'ouvrir un fichier en format texte (sauf les images qui sont affiches directement) ou en hexadecimal.
Pour vous dplacer utilisez [HAUT]/[BAS] ou le pad analogique.
Pour ouvrir un rpertoire/fichier, placez le selectionneur dessus et appuyez sur [CROIX] ou [R] ou [DROITE](au choix).
Pour remonter d'un rpertoire: allez sur le repertoire nomm ".." et appuy sur [CROIX], ou appuyez sur [GAUCHE] (peu importe 
la position du selectionneur).
Pour ouvrir un fichier en mode texte, appuyez simplement sur [CROIX] lorsque le curseur est positionn dessus. Si c'est une 
image, un aperu vous sera affich (pour le quitter appuyez sur [CROIX] ou sur [ROND] ou sur [START].

Pour ouvrir n'importe quel fichier en mode hexadecimal, appuyez sur [TRIANGLE] lorsque le curseur est positionn dessus.
Pour quitter le menu "Ouvrir" appuyez sur [L]
	Remarque 1: avant d'ouvrir un autre document, une fenetre s'ouvre, vous demandant si vous dsirez ou non enregistrer 
	le document en cours.
	Remarque 2: Pour annuler appuyez sur [L].

*"Enregistrer": vous permet d'enregistrer un fichier au format ASCII avec l'extension dsire (si le fichier a t ouvert en 
format texte), ou en format hexadecimal.
	Remarque: le nom par defaut est celui du dernier fichier ouvert.
La navigation se fait de mme que dans le menu "ouvrir".
Pour modifier le nom, fates apparatre le clavier en appuyant sur [START] et dplacer le curseur avec [GAUCHE]/[DROITE]. 
Effectuez l'enregistrement en appuyant sur [R].

Pour supprimer un fichier, placez le curseur dessus, puis appuyez sur [SELECT]+[TRIANGLE], une fenetre s'ouvre vous demandant 
la confirmation. (l'ancien raccourcis a t supprim suite  des effacements involontaires).

Pour creer un nouveau dossier: entrez le nom de votre dossier, et appuyez sur [ROND]


*"Quitter": vous permet de revenir au shell du Luaplayer.
	Remarque 1: avant de quitter l'diteur, une fenetre s'ouvre, vous demandant si vous dsirez ou non enregistrer le 
	document en cours.
	Remarque 2: Pour annuler appuyez sur [L].

	
---OPTIONS---	
		
*"Coloration synt.": vous permet d'activer la coloration syntaxique. Ceci facilite la lecture mais ralenti lgrement le 
programme (l'algorythme a t modifier, si bien que la coloration est plus rapide qu'avant)
	Remarque: il se peut que vous rencontriez deux bugs (non corrigs pour ne pas trop ralentir l'diteur):
	-si vous avez un commentaire de type --[[ ]] sur une seule ligne, la totalit de la ligne sera colore en vert! Pour 
	remdier  ce dsagrment je  vous conseille de sauter  la ligne aprs tout ]].
	-la coloration ne prend pas en compte les caracters d'echappement au sein d'une citation si bien que la coloration 
	de la	syntaxe: "  \" " s'effectuera de manire anormale. Pour remedier  ce dsagrment, je vous conseille 
	d'alterner les caracteres de citation de la maniere suivante: '  \" ' ou "   \' "

*"Num. de lignes": vous affiche sur le ct gauche le numro des lignes actives.

*"Barre de scrolling": cre une barre de dplacement sur la gauche, indiquant la position de la page au sein du document 
(ainsi que son importancequantitative).
	Remarque: afin de ne pas trop rduire l'espace de lecture, la barre de scrolling et les numeros de lignes ne peuvent 
	tre affichs en mme temps.

*"Auto-completion": Ceci est un mode de saisie vous permettant d'acclrer concidrablement l'entre d'expressions 
rcurrentes. A la base, la majorit des fonction du Lua ainsi que celles spcifiques aux LuaPlayer son intgres. Pour 
intgres les votres voir dans la rubrique AIDE ci dessous.

Comment cela fonctionne:
lorsque vous entrez des caractres le programme cherche une correspondance dans la base de donnes. Le rsultat s'affiche 
sous forme d'une petite fenetre, o il vous est possible de naviguer en utilisant [HAUT] ou [BAS]. Si l'entre correspond  
l'expression dsire, appuyez sur [SELECT] pour l'insrer dans votre texte.
	Remarque 1: merci aux membres d'XtreamLua pour cette proposition d'amlioration.
	Remarque 2: ne fonctionne pas en mme temps que l'aide automatique
	
*"Aide automatique": Ce mode vous permet d'accder directement aux descriptions de la fonction (si celle ci est rpertorie) 
sur laquelle est positionn le curseur. Une fentre apparat au bas de l'cran, elle comprend le nom de la fonction avec ses
arguments, les donnes retournes habituellement, ainsi que la description de la fonction. Pour faire dfiler le texte 
utilisez [HAUT] ou [BAS]. Si le dbut de l'entre que vous avez saisie correspond a plusieurs fonctions, celles-ci seront 
affiches  la suite. (Ceci permet de retrouver le nom d'une fonction dont vous n'tes plus trs sr par exemple, ou bien de 
vous assurer de son fonctionnement,...)

*"Rglages": ce menu vous permet de paramtrer l'interface de l'diteur:
-des paramtres de couleur (Rouge Vert Bleu) sont modifiables en utilisant [GAUCHE]/[DROITE],
	Remarque: vous pouvez modifiez la couleur de l'diteur en gnral ainsi que celle du texte.
-l'arrire plan: toute une slection d'image est proposes, ou bien aucune image (modifiables en utilisant [GAUCHE]/[DROITE]),
	Remarque: vous pouvez mettre vos propres images, il suffit de les placer dans le repertoire img\bg\
-pour visualiser l'effet produit appuyez sur [SELECT],
	Remarque: la couleur du texte est automatiquement mise  jour.
-pour annuler et retourner  l'ancienne apparence appuyez sur [L],
-pour adopter la nouvelle configuration appuyez sur [CROIX].


---AIDE---

*"Aide gnrale": explications rapides pour expliquer le foncitonnementde l'diteur.

*"Crdits": les remerciements.

*"Init. auto-comp.": permet l'initialisation de l'auto-completion: le programme parcourera le script dit a la recherche de 
fonctions  inclure pour acclerer votre saisie de texte.
	Remarque: si votre programme fait appel  des scripts prsents dans le mme repertoire que le script dit, 
	LuaStation les parcourera galement.



	
La modification des raccourcis:
	LuaStation 1.3 permet de choisir les raccourcis qui vous semblent les plus adequats pour accder aux fonctions 
d'ditions.
Pour cela lorsqu'aucun clavier n'est activ, appuyez sur [SELECT]. Un menu intitul "raccourcis" apparat.
Placez le curseur (ligne surligne en bleu) sur la ligne du raccourcis  modifier. Appuyez sur [SELECT], la ligne est alors 
surligne en rouge. Entrez la combinaison de touche de votre choix:
[R]/[L] + [HAUT]/[BAS]/[DROITE]/[GAUCHE]/[TRIANGLE]/[CARRE]/[CROIX]/[ROND]
	Remarque: Si le raccourcis venait  tre le mme que celui d'une autre fonction, il y aura alors intervertion des 
	deux.
Pour quitter ce menu appuyez sur [R]/[L].

	
	
********************************************************************************************************************************************

						       	Les bugs connus:

********************************************************************************************************************************************

*Les deux bugs signals au dessus concernant la coloration.

Si vous rencontrez d'autres bug n'hsitez pas  me le faire savoir: voir ci-aprs





********************************************************************************************************************************************

						       	   A faire:

********************************************************************************************************************************************

*Ameliorer l'diteur d'image (pour sprite et background) et l'incorporer  LuaStation

*Finir la traduction de la description des fonctions,

*Rajouter les descriptions manquantes de certaines fonctions.

N'hsitez pas  me faire part de vos suggestion: voir ci-aprs




********************************************************************************************************************************************

						       	   Remerciements:

********************************************************************************************************************************************

*Tout d'abord  Sony pour cette merveilleuse console... mme si c'est dommage qu'il n'accepte pas plus que a la communaut 
de dveloppeur.

*A Imix pour son aide: traduction en un veritable anglais, et tests  la pelle! Un grand merci.

*A tout ceux qui ont particip d'une quelconque manire au hack de la PSP. Un formidable travail qui profite bnfiquement  
tant de monde..

*A tout ceux qui ont contribu au dveloppement de Luaplayer (spcialement Shine).

*A Novservant et Sabbator pour avoir crer Luaprog.

*A tout ceux qui ont fait des tutos sur la programmation sur PSP sur XtreamLua, PSPGen, PlayerAdvance et Luaplayer.

(dsol pour tout ceux que je n'ai pas cit :-( je ne connais pas vos noms).

********************************************************************************************************************************************

						       	   Me contacter:

********************************************************************************************************************************************

Si vous constatez des bugs non signals prcdemments, ou si vous avez des suggestions, ou encore si vous avez des comentaires  faire 
contactez moi  "reivax_vet@hotmail.com"