home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 300-399 / ff346.lzh / Az / AZ_Francais / Manuel / Preliminaires < prev    next >
Text File  |  1990-04-15  |  6KB  |  148 lines
  1.  
  2. /*==========================================================================
  3.  * \__________/ Copyright 1988-90 Jean-Michel Forgeas & The Software Winery.
  4.  *  \°   °   /  All Rights Reserved. This program may not be distributed
  5.  *   \ °   °/   without the permission of the author:
  6.  *    \  ° /         Jean-Michel Forgeas
  7.  *     \ °/          4 rue du Général Leclerc
  8.  *      ||           95210 Saint-Gratien   FRANCE
  9.  *      ||      Contact The Software Winery at :
  10.  *      ||           BBS     : +33 (1) 39 55 84 59  (V23 Videotex)
  11.  *      ||           MAIL    : c/o Alain DIDIERJEAN 69 rue Dunois
  12.  *      ||                     75646 Paris cedex 13 FRANCE
  13.  *    «====»         INTERNET: rouaix@inria.inria.fr or groult@ibp.fr
  14.  *==========================================================================
  15.  */
  16.  
  17.  
  18.  ==========================================================================
  19. ||                                                                        ||
  20. ||      AZ : Préliminaires                                                ||
  21. ||                              -version courante : 1.50 (06-Fev-90)-     ||
  22.  =========================================================================
  23.  
  24.  
  25. 1-  CARACTERISTIQUES DU MANUEL :
  26.  
  27. Le Manuel d'AZ est prévu pour être consulté à partir d'AZ lui-même, d'où
  28. son organisation particulière.
  29.  
  30.  
  31.     1.1-  Le Manuel est un répertoire :
  32.     plutôt qu'un fichier, c'est un ensemble de 5 fichiers réunis dans
  33.     le répertoire "Manuel" : ils sont plus rapidement chargés, et plus
  34.     maniables.
  35.  
  36.  
  37.     1.2-  La Répartition des Informations :
  38.     entre les fichiers peut vous surprendre, nous avons retenus les
  39.     critères suivants :
  40.  
  41.         1.2.1-  séparer les informations en fonction de la fréquence
  42.         prévisible de leur utilisation; par exemple, il fallait éviter
  43.         d'avoir à charger l'historique en même temps que le mode d'emploi.
  44.  
  45.         1.2.2-  séparer les informations susceptibles d'être affichées
  46.         simultanément; puisque AZ est multi-fenêtres, on peut trouver
  47.         confortable de travailler avec le "Mode d'Emploi" dans une fenètre
  48.         et son "Sommaire" dans une autre.
  49.  
  50.         1.2.3-  séparer les informations à cycle de maintenance trop
  51.         dissemblables, pour limiter le nombre de fichiers modifiés à
  52.         chaque nouvelle version.
  53.  
  54.  
  55.     1.3-  La Redondance des Informations :
  56.     doit éviter le principal écueil de ce type d'organisation d'une
  57.     documentation : balader l'utilisateur d'un fichier à l'autre.
  58.  
  59.  
  60.     1.4-  L'indexation :
  61.     le fichier "Mode d'Emploi" est indexé et les index utilisés dans
  62.     "Sommaire". L'unité d'indéxage est la LIGNE.
  63.     Avantage : on retrouve instantanément une information dont on connait
  64.     l'index grâce à Go To Line #. Inconvénient : il est déconseillé
  65.     d'éditer son "Mode d'Emploi".
  66.  
  67.  
  68.     1.5-  La Maintenance :
  69.     la conception modulaire de la documentation doit permettre de suivre
  70.     le rythme infernal imposé par l'ardeur au clavier de Jean-Michel
  71.     FORGEAS : j'ai compté 25 upgrades entre Aout 88 et Décembre 89. La
  72.     dernière livraison de la documentation sera proposée sous deux
  73.     formes : intégrale pour les nouveaux utilisateurs et sous forme
  74.     patches à appliquer aux fichiers de la version précédente et d'un
  75.     script automatisant l'opération. Le logiciel de patch, du domaine
  76.     public, sera disponible avec AZ.
  77.  
  78.  
  79. 2-  CONTENU DU MANUEL
  80.  
  81. "Manuel" : contient les fichiers suivants :
  82.  
  83.  
  84.     2.1-  "Préliminaires"
  85.     présente la documentation.
  86.  
  87.  
  88.     2.2-  "Générique"
  89.     présente l'auteur de AZ, ses collaborateurs, la Software Winery. Il
  90.     précise les conditions de distribution d'AZ, les possibilités de
  91.     contact.
  92.  
  93.  
  94.     2.3-  "Historique"
  95.     permet à l'utilisateur averti de se tenir à jour de l'évolution d'AZ
  96.     en lisant quelques lignes.
  97.  
  98.  
  99.     2.4-  "Mode d'Emploi"
  100.     est le gros morceau. Il contient les caractéristiques détaillées d'AZ,
  101.     renseigne sur ses possibilités.
  102.  
  103.  
  104.     2.5-  "Sommaire"
  105.     détaille méthodiquement le contenu de "Mode d'Emploi" en renvoyant
  106.     à des numéros de ligne.
  107.  
  108.  
  109.  
  110. 3-  FICHIERS DISTRIBUES
  111.  
  112.      AZ_English (dir)
  113.           Manual (dir)
  114.             .info                          Credits
  115.             Credits.info                   FR.man
  116.             FR.man.info                    History
  117.             History.info                   Manual
  118.             Manual.info                    ReadMeFirst
  119.             ReadMeFirst.info               Summary
  120.             Summary.info
  121.           AZ_Short (dir)
  122.             .info                          AZ
  123.             AZ.info
  124.        .info                          AZ
  125.        AZ.info                        AZ_Short.info
  126.        Manual.info
  127.      AZ_Francais (dir)
  128.           Manuel (dir)
  129.             .info                          FR.man
  130.             FR.man.info                    Generique
  131.             Generique.info                 Historique
  132.             Historique.info                Mode d'Emploi
  133.             Mode d'Emploi.info             Preliminaires
  134.             Preliminaires.info             Sommaire
  135.             Sommaire.info
  136.           AZ_Court (dir)
  137.             .info                          AZ
  138.             AZ.info
  139.        .info                          AZ
  140.        AZ.info                        AZ_Court.info
  141.        Manuel.info
  142.   .info                          AZ_English.info
  143.   AZ_Francais.info               isup.library
  144.   isup.library.info
  145.  
  146. ** Noter que les noms de fichiers français ont perdus leurs accents :
  147. ZOO les digère mal, et les restitue plus mal encore.
  148.