Universite Paris Sud Orsay
Lundi 14 Avril 2003

---------------------
| PixArchi : README |
---------------------
|    version 1.1    |
|    readme file    |
|      19/05/00     |
---------------------

1. Introduction
2. Systeme et materiel requis
3. Installation 
4. Arborescence
5. Bugs connus
6. Credits

----------------------------------------------------------------------------------------------

1.Introduction

    PixArchi a ete developpe dans le cadre du TER d'architecture de 2nd semestre de 
  maitrise d'informatique 1999-2000 dirige par Nathalie Drach-Temam.
  Ce logiciel a pour but d'aider les etudiants de DEUG a comprendre les architectures 
  d'ordinateurs de type RISC en leur permettant d'en visualiser simultanement les
  differentes parties.
    PixArchi a ete developpe en JAVA (notamment avec le package javax.swing) 
  et avec le modele de programmation MVC (Model View Controler).


2.Systeme et materiel requis

	PixArchi a ete developpe avec le Java Developement Kit 1.2.2 de SUN MicroSystems.
	Il s'execute sur toutes plate-formes supportant le JAVA precite
	(teste sous Windows, Linux, MacOSX, HP-UX, et solaris).
	Il est necessaire de posseder une version de JAVA 1.2 et recommande de l'utiliser 
	avec la version 1.2.2 (de SUN MicroSystems).

3.Installation

	LINUX, MacOSX et UNIX:
	Pour installer PixArchi, vous devez decompresser l'archive dans un repertoire 
	de votre choix et, depuis ce repertoire, executer la commande
		
		make all

	Puis pour lancer le logiciel il faut lancer le script "PixArchi".

	WINDOWS:
 	Pour installer PixArchi, vous devez decompresser l'archive dans un repertoire 
	de votre choix et lancer le script "Go.bat" a la PREMIERE UTILISATION pour compiler 
	les sources.
	Puis pour lancer le logiciel il faut lencer le script "PixArchi.bat".

4. Arborescence

	Voici l'arborescence de PixArchi:
	
+-PixArchi/
|   .
|   +-PixArchi : script d'execution
|   |
|   +-Go : script de compilation
|   |
|   +-GoLexCup : script de compilation des fichiers de JLex et JCup
|   |
|   +-GoCompil : script de compilation des fichiers .java
|   |
|   +-GoDoc : script de construction du javadoc (utilise le script packages)
|   |
|   +-GoClean : script de nettoyage des .class et autres fichiers inutiles
|   |
|   +-Images/
|   |   .
|   |   +-anim/ : les images de l'animation
|   |   |   .
|   |   |   +-640-480/
|   |   |   |
|   |   |   +-800-600/
|   |   |   |
|   |   |   +-1024-768/
|   |   |
|   |   +-icons/ + : les icons
|   |   |   .
|   |   |   +-/normal
|   |   |   |
|   |   |   +-/mini
|   |   |
|   |   +-intro/ : le logo
|   |   |
|   |   +-archi/ : le schema d'architecture
|   |   |
|   |   +-divers/ : pour le tutorial
|   |
|   +-Docs/ : documentation javadoc et aide ainsi que manuel de reference de l'architecture 
|   |   .
|   |   +-javadoc/ : documentation pour les developpeurs
|   |   |
|   |   +-Aide/ : Aide de PixArchi
|   |   |
|   |   +-LexCupManuals/ : les manuels de JLEX et JCUP
|   |
|   +-exemples/ : fichiers assembleurs exemples
|   |
|   +-src/
|   |   .
|   |   +-Packages : un fichier contenant les noms des packages poue le javadoc
|   |   |
|   |   +-PixArchi.java : la classe principale (main)
|   |   |
|   |   +-Interface/ : les interfaces (views)
|   |   |   .
|   |   |   +-IArchi/
|   |   |   |
|   |   |   +-IEdit/
|   |   |   |
|   |   |   +-ICmd/
|   |   |   |
|   |   |   +-IRam/
|   |   |   |
|   |   |   +-IReg/
|   |   |   |
|   |   |   +-UI/
|   |   |
|   |   +-Controlers/ : les controleurs (controlers)
|   |   |
|   |   +-Models/ : les modeles (models)
|   |   |
|   |   +-Utilitaires/ : constantes et choses pratiques
|   |
|   +-bin/ + : le repertoire contenant les sources compilees (.class) 
|   |
|   +-Extra/
|   |   .
|   |   +-LexCup/
|   |   |   .
|   |   |   +-JLex/ : les fichiers de l'analyseur lexical
|   |   |   |
|   |   |   +-java_cup/ + :les fichiers de l'analyseur syntaxique 		
|   |   |   |   .
|   |   |   |   +-/runtime



5. Bugs connus

	Il semblerait que sous LINUX avec le window manager FVWM, JAVA ait un comportement de redimmensionnement 
des fenetres un peu anarchique, et qu'il faut finir le redimmensionnement "a la main"


6.Credits  

  Developeurs :
  - Version 1.0
    Paul Ladeveze
    Frederik Sackx
  
    Merci a Marc-Antoine Heritier, Emmanuel Devreux et Armand ladeveze pour les tests.	
    Merci beaucoup aux gens qui ont developpe JLex et JCup c.a.d. 

    * Elliot BERK
      Dept of ComputerScience, princeton University
      http://www.cs.princeton.edu/~appel/modern/java/JLex	
    * Frank Flannery
      Dept of ComputerScience, princeton University	
    * scott E. HUDSON
      Graphics Visualization and Usability Center
      Georgia Institute of Technology

    N'hesitez pas a envoyer vos commentaires, demandes ou recommandations aux auteurs :
    Paul Ladevze   jazzman@worldonline.fr
    Frederik Sackx  lalouche@worldonline.fr
  
  - Version 1.1
    Yves Lhuillier
    yves@fr.fm

---------------------------------------------------------------------------------------------------------------------------
