1	Introduction	* 
2	Prsentation du logiciel	*
2.1	La barre d'informations	*
2.2	La barre d'outils	*
2.3	Le menu principal	*
3	Les modes d'utilisation	*
4	Les modes d'dition	*
4.1	Le mode 'Edit-Mode'	*
4.2	Le mode 'Block-Mode'	*
4.2.1	Acitvation	*
4.2.2	Dsactivation	*
5	Les fonctions d'dition	*
5.1	Le Copier/Couper/Coller	*
5.2	La recherche et remplacement de texte	*
5.3	La slection de blocs	*
5.4	Le dplacement vers un ligne	*
5.5	Effacement d'un mot	*
5.6	Indention simple d'un bloc	*
6	Fonctions interactives	*
7	Fonctions diverses	*
8	Les fonctions accessibles au clavier	*
 
 
 
Overedit V1.16
Vendredi 12 Mars 1999
 
1. Introduction
Overedit est un outil (pour machine ATARI,  base de 68030) permettant au programmeur C utilisant PURE C, d'avoir un environnement agrable et amliorant la lisibilit d'un programme.
 
2. Prsentation du logiciel
Overedit se prsente comme tout logiciel GEM. 
Une barre d'informations affich en bas dans l'cran permet de connatre les diffrentes tches en cours d'excution.
Un barre d'outils permet d'accder aux fonctions les plus utilises.
1. La barre d'informations
La barre d'informations est utilis pour informer l'utilisateur des diffrentes tches en cours, et d'utiliser le mode interactif de Overedit.
Elle aussi utiliser pour afficher une ligne d'aide sur les entres du menu principal.
2. La barre d'outils
La barre d'outils, permet d'accder au fonctions les plus utiliss de Overedit. Ces fonctions sont entres autres :
- Cration d'un nouveau fichier
- Chargement d'un fichier
- Sauvegarde d'un fichier
- Choix de fontes (en fonctionnement diteur de texte)
- Compilation, dition des liens (fonctionnement diteur de sources C)
3. Le menu principal
1. Le menu Fichier
Les entres de ce menu concerne les oprations pouvant tre faites sur les fichiers :
- Nouveau (Nouveau fichier)
- Charger (Chargement d'un fichier))
- Sauver (Sauvegarde d'un fichier
- Sauver sous ... (Sauvegarde sous un autre nom)
- Insrer (Insertion d'un fichier)
- Imprimer (Impression d'un fichier)
- History (Historique des fichiers ouverts)
- Quitter (Quitter le programme)


2. 
Le menu Edition
Ce menu concerne l'dition de texte. Les fonctions sont :
- Undo (Dfaire)
- Copier./Couper/Coller (Fonction classiques)
- Tout slectionner (Slectionner tout le texte)
- Rechercher/Remplacer (fonction de recherche et de remplace de patterns)
- Aller  la ligne (Atteindre un ligne)

3. Le menu Fentre
Ce menu permet d'accder facilement au fentre ouvertes. On y trouve :
- Suivante (Changement circulaire de fentre)
- Slection (Slection d'une fentre particulire)
- Fontifier (Fontification de la fentre courante en fonctionnement diteur de sources C)

4. Le menu Commandes C
Ce menu est disponible uniquement en fonctionnement diteur de sources C. Il permet la compilation des sources C, l'dition de projet, l'dition des options des outils de compilations, le paramtrage de l'diteur de source C. On y trouve :
- Project (Chargement d'un projet pour dition)
- Compile (Compilation d'un source C ; en appuyant sur la touche CTRL, on choisit le fichier  compiler)
- Assemble (Assemblage d'un source assembleur ; en appuyant sur la touche CTRL, on choisit le fichier  assembler)
- Link (Edition des liens)
- Makedepend (Edition des dpendances)
- Make All (Edition des dpendances, compilation et link)
- Options (Edition des options des outils de compilation)
- Editor (Paramtrage de l'diteur de compilation)


5. Le menu Options
- Choix d'une fonte  (Choisir la fonte gnrale utilis par Overedit.)
- Paramteres  (Ce menu permet de rgler les options globaux de Overedit. C'est en passant par ce menu, que l'on choisit le mode de fonctionnement de Overedit, le choix de la tabulation, du curseur etc ...)

 
 
3. Les modes d'utilisation
Overedit peut tre utilis comme un simple diteur de texte ou comme un diteur de source C.
Dans le premier mode, certaines fonctions de Overedit sont indisponibles.
Le passage d'un mode  l'autre, par un simple clique dans la fentre de paramtrage.
4. Les modes d'dition 
Overedit possde deux modes d'dition, l'dition normale, 'Edit-mode' et l'dition de blocs 'Block-Mode'.
Ces deux modes sont disponibles dans les deux modes d'utilisation de Overedit.
1. Le mode 'Edit-Mode'
C'est le mode par dfaut d'Overedit. Il permet la saisie et l'dition normale de texte.
2. Le mode 'Block-Mode'
Le mode d'dition 'Block-Mode', permet de slectionner des blocs de faons intuitives, simple et rapide.
En effet, ce mode utilise toutes les faons de dplacer le curseur pour slectionner un bloc.
1. Acitvation
Pour activer le mode 'Block-Mode', il suffit d'utiliser la combinaison de touches CTRL+ESPACE.
Ensuite, dplacer le curseur comme vous le voulez pour slectionner un bloc :
* Clique souris 
* Fonction 'Goto-Line' 
* Dplacement du curseur au clavier 
* Fonction 'Find-Parent'
 
1. Dsactivation
Pour dsactiver le mode 'Block-Mode', vous pouvez utiliser la combinaison de touches CTRL+ESPACE., ou la touche ESCAPE. Cette dsactivation provoque le retour en mode 'Edit-Mode'. Certaines fonctions appeles en mode 'Block-Mode', le dsactive automatiquement.
 
1. Les fonctions d'dition
Dans Overedit, ont retrouve les fonctions d'dition classiques, et des fonctions d'dition spciale. 
 
1. Le Copier/Couper/Coller
2. La recherche et remplacement de texte
Ces deux fonctions sont regroupes dans un mme formulaires, accessible depuis le menu 'Edition'.
La recherche de chanes dans le texte est aussi accessible depuis la fonctions interactives 'Inter-Find'.
3. La slection de blocs
La slection de blocs peut s'effectuer  la souris ou au clavier (Block-Mode).
Tout le texte peut tre slectionn depuis le menu 'Edition'.
4. Le dplacement vers un ligne
Cette fonction permet de positionner le curseur sur un ligne du texte. Elle est accessible depuis le menu 'Edition', ou depuis la fonction interactive 'Goto-Line'.
 
5. Effacement d'un mot
En utilisant la combinaison de touches ALT+BACKSPACE, il est possible d'effacer le mot prcdent.
Si le curseur est plac  la fin d'un mot le, tout le mot sera effac. Si le curseur est plac dans un mot, seule la partie avant le curseur sera efface.
 
En utilisant la combinaison de touches ALT+DEL, il est possible d'effacer le mot suivant.
Si le curseur est plac au dbut d'un mot le, tout le mot sera effac. Si le curseur est plac dans un mot, seule la partie aprs le curseur sera efface.
 
6. Indention simple d'un bloc
Cette fonction permet seulement de dplacer un bloc vers la droite (ajout de tabulations TAB) ou vers la gauche (retrait de tabulations SHIFT+TAB).
Elle n'est fonctionnelle que si un bloc est slectionn.
 
2. Le project Manager
Le Project manager permet de crer ou de modifier un projet. Son utilisation est simple et intuitive.
Pour faire appel au projet manager, cliquer sur le menu Commandes C/Projet (ou nom du projet).
A gauche de cette fentre, se trouve une barre de commandes verticale. A droite ce trouve la liste des fichiers (sources C ou S, .O ou .LIB) faisant partie du projet. Dans cette partie sont indiqus le nom, le type,  la date et la taille de chaque fichier du projet. Le nom de la cible, se trouve en bas de la fentre.
Les commandes servent respectivement  :
- Ajouter un fichier au projet 
- Enlever un fichier du projet
- Editer un fichier source
- Mettre  jour la date d'un fichier
- Charger un projet
- Sauvegarder un projet
Les projets sauvegards par OVEREDIT, sont de type PJT. Il est possible de charger des projets de type PRJ de PureC (sauf projet contenant des options ou de dpendances).

Pour crer un projet, il suffit d'ouvrir la fentre du Project Manager, d'insrer les fichiers faisant partie du projet, de mettre  jour la cible, et sauvegarder le projet.
3. Fonctions interactives
Les fonctions interactives de Overedit permettent d'utiliser la barre d'informations comme seule interface avec l'utilisateur. Ainsi, les formulaires encombrants ne sont pas affichs.
 
Ces fonctions ne sont accessibles que si la barre d'informations est affiche.
 
 
1. Recherche Interactive (Inter-Find)
La recherche interactive, est ralis en temps rel. Le mode interactif est donc utilis au mieux.
L'accs  cette fonction ce fait en utilisant la combinaison de touches ALT+S.
Une fois la fonction active, un prompt (Rechercher :) est affich dans la barre d'informations. Vous n'avez plus qu' tapez de la chane que vous voulez trouver. La recherche se fait au fur et  mesure que vous tapez.
Il est possible de complter le mot recherch appuyant sur ALT+W.
 
En appuyant de nouveau sur ALT+S, vous passer  la prochaine occurrence de la chane recherche.
 
En appuyant de nouveau sur ALT+D, vous passer  l'occurrence prcdente de la chane recherche.
 
2. Atteindre une ligne (Goto-Line)
La fonction interactive 'Goto-Line' permet de positionner le curseur sur une ligne du texte.
Elle est active en utilisant la combinaison de touches ALT+G. Une fois active, un prompt (Aller  la ligne:) est affich dans la barre d'informations. Il suffit ensuite de tapez le numro de ligne  atteindre, puis de valider avec la touche RETURN.
 
3. Recherche d'un rfrence
Cette fonction n'est utilisable qu'en mode dition de source C. Elle n'est effective que si un fichier TAGS  t crer pour le projet en cours,  partir du menu 'Commandes C'.
La recherche de rfrences consiste  trouver dans une fichier, une dclaration de variables, une fonction ou une dfinition (#define).
 
Elle est active en utilisant la combinaison de touches ALT+T. Une fois active, un prompt (Rechercher un TAG:) est affich dans la barre d'informations. Il suffit ensuite de tapez le nom de la rfrence  atteindre, puis de valider avec la touche RETURN.
ALT+N, permet de passer  l'occurrence suivante.
 
4. Fonctions diverses
Overedit possde des fonctions facilitant le dplacement dans un source C. 
1. Atteindre une fonction
On peut en cliquant sur le bouton droit de la souris (en plaant le curseur de celle-ci sur la fentre), afficher dans un popup, la liste des fonctions contenu dans le source courant. Ensuite, on accde  une d'entre elles juste en cliquant sur le nom de la fonction.
On peut atteindre un fonction n'appartenant pas au fichier courant en utilisant la fonction 'Find-tag' (ALT-T ou F3). Pour cela, il faut avoir crer les 'TAGS' (F1). Un TAG, est une rfrence sur une fonction, ou une dfinition. La cration du fichier TAGS ce fait  partir d'un rpertoire. Overedit cherchera alors dans ce rpertoire et tous ses sous-rpertoires des fichier .c ou .h, afin de crer la liste des rfrences. Il peut y avoir un fichier TAGS par projet.
1. Obtenir des informations concernant une fonction
On peut aussi afficher des informations sur un fonctions en plaant la souris sur le nom de cette fonction tout en appuyant sur les touche CTRL+ALT.
 
2. En vrac
Drag & Drop sous MAGIC et MINT
Tirez des fichiers depuis le bureau vers OVEREDIT
Slection d'une ligne  la souris
Double-cliquez sur la fin de la ligne ou sur un espace.
 
Recherche de caractres parents ou enfants (Place le curseur sur le caractre parent ou enfant: 
(, ), [, ], {, ou } ).
	Se placer sur le caractre pour les " fermant " et devant le caractre pour les " ouvrant " puis appuyer sur CTRL+<.
Effacer la fin d'un ligne
Appuyer sur CTRL+K
	
5. Les fonctions accessibles au clavier
F1		: Cration du fichier TAGS (SHFT_L+SHFT_G pour arrter)
F3		: Recherche d'un tag
F4		: Fontifier un source
F5		: Fontifier tous les sources en gnral
F6		: Refontifier le buffer
F10		: Agrandissement/Rduction d'une fentre
 
CTRL+CUR_RIGHT		: Dbut du mot suivant
CTRL+CUR_LEFT		: Dbut du mot prcdent
SHIFT+CTRL+CUR_RIGHT	: Fin du mot suivant
SHIFT+CTRL+CUR_LEFT	: Fin du mot prcdent

SHIFT+CUR_RIGHT		: Fin de la ligne courante
SHIFT+CUR_LEFT		: Dbut de la ligne courante
 
 
 
 
1. Compilation
Pour compiler un programme, rglez d'abord les options de compilations dans le menu Commandes C / Options . Une fois ces options dfinies, il suffira de lancer la compilation dans le menu Commandes C / compile. Les options sont sauvegardes automatiquement.
 
2. BUGS
Quelques petits problmes avec WinX.
Gestion de centaines fontes incorrect 
 
  
Marc.Beaudoin@dorotech.fr
