  															      Le 16/11/2007
                             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.1
                                     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







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

							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-retours 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. (peu importe la version, enfin je recommande la v0.16 ou v0.20)

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 lancer un programme: [croix] (pour toutes les autres fonctions classique de Lowser consultez le fichier d'aide dans l'archive du 
Luaplayer).

Pour diter un programme: [carr]



Vous voil dans l'diteur (pour ceux qui connaissent Luaprog, il y a suppression des images d'arrire-plan pour conomiser la RAM):
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".

*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 est la colonne du curseur.

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



	Pour le DEPLACEMENT:

*Utilisez le PAD ANALOGIQUE pour un dfilement rapide, ou les TOUCHES DIRECTIONNELLES pour un dplacement prcis.

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

*De mme il est possible de sauter  la page d'aprs/avant en appuyant sur: [CARRE] puis [DROITE]/[GAUCHE].

*Pour vous rendre directement  une ligne: tapez [R] et simultanment [HAUT], ensuite entrez le numro de la ligne  l'aide du clavier.
	Remarque: pour annuler mettez le chiffre 0 puis appuyez sur [R]




	Pour entrer du texte:

*Taper 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 enfoncez la touche [R].

*Pour entrer des chiffres: taper la 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-taper la touche [START].

*Il existe un raccourci pour supprimer un caractre: touche [TRIANGLE]

*De mme pour l'ajout de ligne: touche [CROIX]




	Les quelques fonctions utiles:

*La copie de texte: appuyez sur la touche [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 effctue, tapez  nouveau sur [ROND] pour copierle tout en mmoire)
	Remarque 1: si la slection est trop importante il est possible (mme si je ne l'ai jamais expriment) que cela sature la RAM
	et donc vous risquez de perdre tout votre travail: sauvegardez rgulirement.
	Remarque 2: durant la phase de slection, il est toujours possible de sauter de page en utilisant la touche [carre] et les touches
	directionnelles.

*La suppression de texte: de mme que pour la copie, commencez par appuyer sur la touche [ROND], effectuez votre slection. Puis pressez la
touche [TRIANGLE] pour supprimer la slection. (attention ce n'est pas rversible!)

*Pour la mise en fome du texte il est possible de dcaler  gauche/droite votre texte. Pour cela appuyer sur [ROND], slectionnez les lignes
 dcaler, puis appuyez sur les touches [L]/[R]. Une fois le processus fini, r-appuyer sur [ROND].

*La recherche de texte: appuyer sur [R] et simultanment sur [GAUCHE]. 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 [select].
	Remarque 1: Il est possible de coller du texte copier par la mthode vu ci-dessus, en appuyant directement sur la touche [start]
	Remarque 2: pour alterner la recherche avec ou sans respect de la casse appuyez sur [HAUT] ou [BAS]




	Les rubriques "Fichier" et "Options":

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

*"Ouvrir": vous permet d'ouvrir un fichier en format texte (sauf les images qui sont affiches directement).
Pour vous dplacer utiliser [HAUT]/[BAS] ou le pad analogique.
Pour ouvrir un rpertoire/ fichier, placez le selectionneur dessus et appuyez sur [CROIX] ou [R] (au choix).
Pour remonter d'un rpertoire: - allez sur le repertoire nomm ".." et appuy dessus
			       - ou appuyez sur [TRIANGLE].
/!\ Attention pour si vous appuyez sur [cARRE] ceci effacera le fichier selectionn /!\
Pour quitter le menu "Ouvrir" appuyez sur [L]

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

/!\ Attention pour si vous appuyez sur [cARRE] ceci effacera le fichier selectionn /!\
Pour creer un nouveau dossier: allez totu en bas de la liste, (le curseur se place sur un espace vide), entrer le nom de votre dossier, et
appuyer sur [SELECT]

*"Quitter": vous permet de revenir au shell du Luaplayer.

*"Colorisation": vous permet d'activer la coloration syntaxique. (ceci facilite la lecture mais ralenti ENORMEMENT le programme)

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





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

						       	Les bugs connus:

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

*problme d'affichage de la zone slectionne lors de scrolling horizontal du texte.

*problme dans la coloration syntaxique, lors de scrolling horizontal, et pour les commentaires multilignes.


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





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

						       	   A faire:

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

*Corriger les bugs ;-)

*Creer diffrents algorythmes de tri dans les menu "Ouvrir"/"Fermer", et afficher la taille es fichiers

*Recreer un algorythme de coloration syntaxique.

*Demander l'enregistrement du document actif lors de l'ouverture d'un fichier.

*Demander confirmation lors de la suppression d'un fichier (dans les menus "ouvrir"/"enregistrer").

*Creer une rubrique "Nouveau" (bien que ce soit facilement contournable).

*Creer une aide lors de l'utilisation du programme.

*Ractualiser la liste des menu "Ouvrir"/"Fermer" s'il y a des changements.

*Crer un diteur d'image (pour sprite et background)

*Nettoyer le code (ben oui quoi... j'apprends).

*Lecture de musique lors de l'ditin de musique...? (a peut tre fun pour programmer, mais je ne sais pas si c'est facilement ralisable)


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 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 (dont 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.

(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"