<<< DISK$DATA:[NOTES$LIBRARY]PROGRAMMATHEQUE.NOTE;1 >>> -< Suivi des programmes DECUS >- ================================================================================ Note 106.0 BROWSER : Documentation en ligne. No replies DECUSF::DIAKONOFF_N "Responsable programmathèque" 166 lines 28-AUG-1991 11:34 -------------------------------------------------------------------------------- Subj: Browser - Carol DECUS France 91 soumis par Jean-Noël ALBERT BROWSER ======= Présentation ------------ BROWSER est un logiciel permettant d'organiser une documentation en ligne, plus particulièrement pour des terminaux de type ASCII standard. BROWSER est constitué: o d'un interface utilisateur basé sur SMG permettant de naviguer dans la documentation; o d'un utilitaire de visualisation des textes; o d'une table d'organisation de la documentation, en terme de documents et d'arbres de groupements (un ensemble logique de documents). BROWSER permet également d'accéder à tout utilitaire maison de visualisation de fichier, via un `Spawn' de cet utilitaire maison. Historique ---------- BROWSER a été écrit pour les besoins de l'expérience DELPHI, l'une des 4 expériences LEP du CERN. Il a été proposé aux Carols de DECUS France lors du symposium de Juin 1991. Distribution ------------ La présente distribution correspond à la version 2.0. Elle ne comprend que les binaires et la documentation. La raison de ces restrictions est double: 1/ la présente distribution est déjà un peu volumineuse (1600 blocs VMS) pour passer facilement sur le réseau et tenir sur DECUSF; 2/ cette distribution, quoi que tardive, est la manière la plus simple de fournir quelque chose que fonctionne directement, vu l'état un peu `embrouillé' des fichiers sources. Les binaires se présentent sous la forme d'une librairie permettant de reconstruire l'exécutable pour les différentes versions de VMS 5.x, bien qu'il n'ait été testé que pour VMS 5.4. La documentation est fournie aux formats ASCII, PostScript et Bookreader. Des procédures permettant de construire l'exécutable et de définir les symboles et noms logiques recquis sont fournies. Je dois m'attaquer à mettre sur pieds une distribution convenable, avec sources, procédures de commandes, ... Installation ------------ Pour sauver de la place sur les disques de DECUSF, la distribution est sous la forme d'un backup VMS compressé par le COMPRESS, adapté par Alain Fauconnet, copié de DECUSF. Voici ce qu'il faut faire pour installer BROWSER. a - Vous assurez que vous disposez de COMPRESS, que vous trouverez dans DECUSF::VAXF91A: (et sur la bande Decus France 1991). b - Recopier sur votre site les fichiers BROWSER.BCK_Z et BROWSER.ALIRE. c - Décomprimer le fichier de distribution grâce la séquence suivante: $ COMPRESS == "$ my-disk:[my-compress-directory]COMPRESS" $ COMPRESS -di -r 32256 browser.bck La première ligne crée un symbole DCL pointant sur l'utilitaire COMPRESS. Vous remplacez `my-disk:[my-compress-directory]' par le nom du disque et du directory où se trouve COMPRESS. La seconde décomprime le fichier BCK_Z et crée un fichier BCK utilisable par Backup: - d : pour Décompresse - i : parce que le fichier a été comprimer avec `i' (image) - r 32256 : parce que le fichier BCK est un backup sur disque. d - Extraire les fichiers du save-set: $ BACKUP browser.bck/save [] e - Construire l'exécutable: $ @ BROWSER_INSTALL f - Définir les symboles et noms logiques nécessaire: $ @ BROWSER_SETUP g - Faire un premier test par: $ BROWSER /TABLE=BROWSER_TEMPLATE En principe, cela marche... Post-Installation ----------------- Une fois BROWSER installé (voir Installation), vous pouvez: o imprimer la documentation PostScript (il y a 28 pages); o créer une table (BROWSER.TABLE) pour votre documentation à partir de l'exemple BROWSER_TEMPLATE.TABLE; o copier BROWSER.TABLE, BROWSER.HLP et BROWSER.EXE dans des directories apropriés; o éditer le fichier BROWSER_SETUP pour adapter symboles et noms logiques. o si vous utilisez le BookReader, créer un fichier LIBRARY.DECW$BOOKSHELF contenant: BOOK\my-disk:[my-doc-directory]BROWSER\BROWSER User's Guide et redéfinir le nom logique DECW$BOOK, par exemple: $ DEFINE DECW$BOOK SYS$COMMON:[DECW$BOOK],my-disk:[my-doc-directory] o commencer à collecter vos documents. Quelques remarques ------------------ o La documentation est en anglais. o BROWSER, en standard, ne nécessite aucun privilége. Si vous souhaitez utiliser vos propres `viewers', vous devez vérifier si ceux-ci nécessitent des privilèges. Pour créer un sous-process, l'utilisateur devra pour le moins disposer de TMPMBX, qui est un privilège assez standard. Avertissements et copyright --------------------------- Conformément aux usages de Decus, ce produit est mis gratuitement à la disposition des utilisateurs de DECUS. Il est toutefois propriété de l'expérience DELPHI et de l'auteur. L'auteur, l'expérience DELPHI, le CNRS et le CERN ne s'engagent en aucune façon concernant l'utilisation de ce logiciel. Jean-Noël Albert Genève 1991 VXDEOP::ALBERT ALBERT@VXDEOP.CERN.CH PostScript est une marque déposée Adobe Bookreader est un copyright de DEC