readme.txt

Ouvrir un terminal et se placer dans le répertoire project
Les commandes sont considérées comme scripts, il suffit de cliquer dessus sous linux.
Les principales commandes sont les suivantes :
	- build : 	compiler le compilateur
	- clean : 	supprimer les fichiers de compilation et ne garder que la source et l'exécutable
	- clean-all : 	clean + suppression de l'exécutable
	- release : 	générer un tar.gz avec horodateur pour une soumission à l'automate
			attention "release" supprime source/lsd10, il faut faire un "build" après si on veut utiliser le compilateur
	- source/lsd10 : utiliser le compilateur lsd10 (analyse du fichier code.t si présent) pour autant qu'un build ait été effectué
 
Fichiers :
	- ast.html : 	affichage de l'arbre du dernier appel de source/lsd10 pour du debug
	- ast.xml : 	affichage de l'arbre du dernier appel de source/lsd10 pour du debug, 
					sans feuille de style, on peut étendre ou collapse les noeuds
	- lsd10.pm :	fichier à ouvrir avec la p-machine, p-code du dernier appel de source/lsd10 
	- astLSD10.dot : fichier nécessaire à la génération d'une image
	- lsd10_ImgXXX.jpg : image de l'arbre syntaxique de l'appel de source/lsd10 au moment XXX
	- symbolsTable.html :  affichage des données de la table des symboles
 
Pour ne pas générer les fichiers, ouvrir source/common.h et ajuster les différentes valeurs 
 
Exemple d'affichage sur le terminal
 
steph@astate:~/dev/compiler/project$ ./build
steph(1000) on astate [running linux-gnu]
Compile lsd10 code
 
 
Removing possible previous compiled files ...
Cleaning executable file ...
 
 
Compiling Yacc file ...
 
 
Compiling Lex file ...
 
 
Compiling C files ...
 
 
Done
 
 
steph@astate:~/dev/compiler/project$ source/lsd10
;  
;
;	LSD010 Compiler [SSHD09]
;
;
;  Creating Symbols Table
;  Using Test file...true
;  Calling yyparse()
;  End of yyparse execution
;
;  Filling Table of symbol...
;	Printing AST into ast.html file ... (console.c, col 147);  ...OK HTML printed
;	Printing AST into ast.xml file ... (console.c, col 169);  ...OK XML printed
;	Generating AST Graph from ast.xml into astLSD10.dot file ... (digraphHelper.c, col 104);  ...OK Graph printed
; Generating image from dot file : dot -Tjpg -olsd10_Img20104237153.jpg astLSD10.dot
;  Checking types...
;  ...OK Types check done
;
;  Generating p-code...
;  Open p-code file...OK
;	Message : 'ssp 2 (0 & 1) + memory used for variables (2 temporary locations for modulo algorithm)' On pcode.c, Line 165
ssp 0
mst 0
cup 0 @func_main_1
ujp @prg_end_0
;	Message : 'pcodeGenValue Functions (400) (parsed code, line 1)' On pcode.c, Line 231
;GEN_VALUE 400
;	Message : 'pcodeGenValue Function (401) (parsed code, line 1)' On pcode.c, Line 231
;GEN_VALUE 401
;NODE_TYPE_FUNCTION main loc 1
define @func_main_1
ssp 9
ujp @body_main_1
define @body_main_1
;	Message : 'pcodeGenValue Structural node (-2) (parsed code, line 8)' On pcode.c, Line 231
;GEN_VALUE -2
;	Message : 'pcodeGenValue Type declarations (405) (parsed code, line 3)' On pcode.c, Line 231
;GEN_VALUE 405
;	Message : 'pcodeGenValue Type declaration (406) (parsed code, line 3)' On pcode.c, Line 231
;GEN_VALUE 406
;	Message : 'pcodeGenValue Type declarations (405) (parsed code, line 3)' On pcode.c, Line 231
;GEN_VALUE 405
;	Message : 'pcodeGenValue Type declaration (406) (parsed code, line 3)' On pcode.c, Line 231
;GEN_VALUE 406
;	Message : 'pcodeGenValue function body (407) (parsed code, line 8)' On pcode.c, Line 231
;GEN_VALUE 407
;	Message : 'pcodeGenValue NODE_TYPE_LEXICAL_FOR_STMT (415) (parsed code, line 7)' On pcode.c, Line 231
;GEN_VALUE 415
;	Message : 'pcodeGenValue function body (407) (parsed code, line 8)' On pcode.c, Line 231
;GEN_VALUE 407
retf
;NODE_TYPE_FUNCTION main END
;	Message : 'end of program' On pcode.c, Line 189
define @prg_end_0
stp
;		[0x8da9008] id='           main', location= 0, type 300 isFunction 403 next= 0x8dadea8 ast_parent=0x8dade10 pcode_mem_place 1
;		[0x8dadea8] id='              j', location= 0, type 302 isFunction 406 next= 0x8daded0 ast_parent=0x8daddb0 pcode_mem_place 1
;		[0x8daded0] id='              i', location= 0, type 302 isFunction 406 next= 0x8dadef8 ast_parent=0x8daddb0 pcode_mem_place 2
;		S->next is NULL'         (null)', location=-1, type  -1 isFunction 414 next=     (nil) ast_parent=     (nil)
;  ...OK P-code generated
;
;
;	Warning : 'Print table of symbole not requested (use DEB_I level minimum to print it)' On lsd10.y, Line 628
;	-------------------------------------------------------------
;  Cleaning memory...
;  ...OK Memory cleaned
;
;
;  Parsing started at Fri Apr 23 07:15:03 2010
;	631 lines 9983 chars parsed in 0 seconds
;	Verbose set on "P-code generation" level
;  That's All Folks!
OK
steph@astate:~/dev/compiler/project$