Suivez-nous sur X

|
|
|
0,
A,
B,
C,
D,
E,
F,
G,
H,
I,
J,
K,
L,
M,
N,
O,
P,
Q,
R,
S,
T,
U,
V,
W,
X,
Y,
Z,
ALL
|
|
0,
A,
B,
C,
D,
E,
F,
G,
H,
I,
J,
K,
L,
M,
N,
O,
P,
Q,
R,
S,
T,
U,
V,
W,
X,
Y,
Z
|
|
0,
A,
B,
C,
D,
E,
F,
G,
H,
I,
J,
K,
L,
M,
N,
O,
P,
Q,
R,
S,
T,
U,
V,
W,
X,
Y,
Z
|
|
A propos d'Obligement
|
|
David Brunet
|
|
|
|
Test d'ADoc 2 1.10
(Article écrit par Gilles Soulet et extrait d'AmigaDP - novembre 1992)
|
|
Présentation
ADoc est un utilitaire permettant de gérer des documentations sur n'importe quel sujet. Il est capable
de lancer automatiquement la recherche d'un mot désigné à la souris, et peut travailler sur plusieurs
fichiers à la fois.
Le gros intérêt d'ADoc est qu'il peut utiliser directement les fichiers Autodocs de Commodore, ainsi
que des fichiers compactés à l'aide de l'utilitaire PowerPacker.
ADoc 2 est une nouvelle version du programme, qui a été réécrit entièrement afin de supprimer
certaines limitations et de pouvoir ajouter plusieurs améliorations.
Lancement et utilisation
ADoc se lance depuis le CLI ou le Workbench. Depuis le CLI, on peut passer en paramètre le nom
d'un fichier de documentation. Le fichier par défaut est "amiga.doc". Le logiciel ouvre son
propre écran et demande éventuellement s'il faut mettre à jour le fichier d'index.
Puis, une fenêtre de sélection est ouverte sur l'écran (figure 1). Dans cette fenêtre se trouve la
liste des termes contenus dans le fichier de documentation. Cette liste peut être longue, aussi
la fenêtre dispose-t-elle d'un ascenseur.
Figure 1
Si l'on double-clique sur un terme, une nouvelle
fenêtre apparaît. Elle contient les informations sur le terme choisi. La figure 2 montre la fenêtre
obtenue lorsqu'on sélectionne le terme "NewScreen".
Figure 2
Tout en consultant la documentation sur
un terme, l'option "autre terme" du menu "projet" permet de consulter en même temps un nouveau
terme, ce qui très utile, d'autant plus que les fichiers Autodocs indiquent les liens qui
existent entre les termes. Ainsi, la figure 3 montre comment, tout en consultant la fonction
AllocMem(), l'utilisateur peut se renseigner sur les types de mémoires.
Figure 3
Il existe une option "cherche" qui permet de rechercher une chaîne de caractères dans l'ensemble de
la documentation. Après cette recherche, une liste complète des termes dont la documentation
comprend toute ou partie de la chaîne cherchée, est affichée dans une nouvelle fenêtre de
sélection.
Principe
ADoc travaille à partir de fichiers de documentation, qui associent un texte à un mot-clé, ou "terme".
A chaque fichier de documentation est associé un fichier d'index, qui permet d'accéder presque
instantanément aux termes recherchés. Seul le fichier d'index est chargé en mémoire lors de l'utilisation.
La consommation mémoire est ainsi limitée.
L'utilisateur peut créer lui-même ses propres fichiers de documentation, à l'aide d'un simple éditeur
de texte. Ces fichiers sont constitués d'une série de définitions, chaque définition ayant la
syntaxe suivante :
terme
première ligne de texte
seconde ligne de texte
etc.
n-ième ligne de texte
|
A chaque fois que l'on charge un fichier de documentation, ADoc propose de mettre à jour le fichier
d'index correspondant. Cette mise à jour est entièrement automatique, donc l'utilisateur n'a pas à
se soucier des fichiers d'index.
Conclusion
ADoc est un excellent outil. Son gros avantage est sa simplicité d'utilisation : toute la consultation
se fait avec la souris, et la mise à jour des fichiers d'index est totalement transparente.
L'option "cherche" est particulièrement utile pour travailler sur des termes traitant d'un même sujet.
Autre avantage très appréciable : les fichiers Autodocs ont été traduits en français ! Les
informations qu'ils proposent sont très utiles et bien détaillées. Malheureusement, elles sont encore
incomplètes (par exemple, pas de détail des structures Screen ou Window) et ne concernent que
le système 1.3. Rien ne vous empêche cependant de les compléter vous-même !
Nom : ADoc 2 1.10.
Auteur : Denis Gounelle.
Genre : gestionnaire de documentations.
Date : 1992.
Configuration minimale : Amiga OCS, 68000, 512 ko de mémoire, AmigaOS 1.3.
Licence : gratuiciel.
Téléchargement : DPAT 11.
NOTE : 7,5/10.
|
|