<<< DUA0:[NOTES$LIBRARY]PROGRAMMATHEQUE.NOTE;1 >>> -< Suivi des programmes DECUS >- ================================================================================ Note 33.0 De la doc please. 12 replies DECUSF::VIBERT_JF "Dr J-F Vibert, Vice-President" 20 lines 11-OCT-1989 23:58 -------------------------------------------------------------------------------- Je ne desire pas ici amener une polemique Unix/VMS hors de propos. C'est donc sincerement sans souci polemique que je fais la remarque suivante: Pourquoi les programmes qui sont dans le directory VMS n'ont pas de README.1ST ou de .DOC? Il est difficile de savoir a quoi ils correspondent, et comment les installer sans regarder dans le code. Il serait souhaitable je crois qu'il y ait avec chaque prg genereusement offert sur DECUSF, un fichier indiquant les grdes lignes d'installation et d'usage. Le serveur du SIG Graphique exige cette discipline, et ca me semble une bonne chose. Si le fichier est package dans un shar ou un saveset, la doc sera dedans bien sur. Dans le directory UNIX, il n'y a que des .SHAR, et tous ont un README, un makefile et souvent un manuel pour man (l'equivalent de help). C'est assez agreable, et ca me semble un exemple a suivre, si vous voulez que vos produits soient vraiment utilises par les collegues. Un des reproches principaux des soft public domain concerne le non suivi, mais si en plus on a des pb des l'install, ca facilite pas les choses. ================================================================================ Note 33.1 De la doc please. 1 of 12 DECUSF::DIAKONOFF_N "Responsable programmathèque" 10 lines 12-OCT-1989 18:27 -< Lire les NOTES d'abord. >- -------------------------------------------------------------------------------- Effectivement pour un NON_VMS, il faut qu'il apprenne à faire un type du fichier qu'il vient de récupérer. Pour les VMSiens, je ne pense pas quie celà soit un problème. En règle général les informations sont les notes, alors celui qui veut un produit dans VMS DOIT lire la note concernée. Pourquoi prendre quelque chose qui ne lui servira à rien si ce n'est qu'à encombrer un peu plus les disques. Les AAA*.* sont par contre dans les fichiers de la programmathèque. ================================================================================ Note 33.2 De la doc please. 2 of 12 DECUSF::VIBERT_JF "Dr J-F Vibert, Vice-President" 24 lines 12-OCT-1989 22:49 -< J'utilise UNIX et vms >- -------------------------------------------------------------------------------- Nicolas, certes la NOTE sert de doc (obligatoirement succinte), mais il faut penser a extraire cette note, et a l'importer en meme temps que le produit desire. Quand a faire une type pour la doc, je veux bien, mais des que c'est un peu gros, si c'est pas bien commente, ca peut devenir vite pas evident. Je voulais simplement dire que ce serai commode d'avoir un fichier x.doc avec le produit x.com ou x.exe, et qui pourrait effectivement simplement etre le texte de la note. Je pense qu'il s'agit du travail de celui qui prend la peine de mettre le produit et d'ecrire la note de faite un extract/noheader dans x.doc et de le mettre avec. Ca vaut aussi bien pour VMS que pour Unix, bien sur. Si pour Unix il y a de la doc, c'est tout simplement que generalement il s'agit de produits qui sont des travaux d'etudiants qui doivent faire un travail propre pour etre notés correctement, ou des universitaires (desoeuvres bien sur), et que ne sont mis dans le DP que les mieux faits (il y a un filtre du gestionnaire de UNIX.SRC sur Bitnet/EARN qui ne met sur le reseau que ce qui a une doc, un manuel, un makefile et les sources). Ca n'a evidemment rien a voir avec l'OS (d'où la non polémique), et je pense que les etudiants de JPP ou de NB produisent d'aussi bon produits que ceux des Universités du Texas, bien qu'ils soient sous VMS (je n'ai pas dit : les pauvres!). ================================================================================ Note 33.3 De la doc please. 3 of 12 DECUSF::MILLOT_P "Pascal Millot - LASH/ENTPE, Lyon" 11 lines 14-OCT-1989 21:46 -< Autres suggestions: >- -------------------------------------------------------------------------------- Deux petits trucs qui pourraient aussi ameliorer l'utilisation de la directory VMS: - Faire en sorte que la date de creation du fichier dans la directory VMS soit la date d'insertion -ce qui ne semble pas etre le cas actuellement dans la majorite des cas. L'avantage est de pouvoir rapidement savoir les fichiers qui ont ete inseres recemment ($ dir/sin=xxx VMS). - Creer une sous-directory par package, et non pas tout mettre en vrac dans la meme directory VMS. ================================================================================ Note 33.4 De la doc please. 4 of 12 DECUSF::MANET_P "Philippe - SECMAI" 6 lines 16-OCT-1989 18:47 -------------------------------------------------------------------------------- - Pour le $ dir/sin=xxx VMS, on peut ajouter /mod, la date de modif est en principe correcte (cad = a celle de l'insertion). - On peut aussi mettre les packages constitues de plusieurs fichiers dans une archive VMS_SHARE. ================================================================================ Note 33.5 De la doc please. 5 of 12 DECUSF::KERMA_G "THOMSON-CSF/Lab. Central de Rech." 6 lines 23-NOV-1989 12:05 -< la DOC n'est pas un LUXE ... >- -------------------------------------------------------------------------------- Quel que soit le produit fourni, la DOCUMENTATION est insdispensable. Je remarque que les UNIXiens sont meilleurs que les VMSiens sur ce point particulier. Les différents produits que nous avons diffusés par DECUS sont TOUS DOCUMENTES (cf. serveur graphique LOAD, FIP et DESSIN ...) ce qui peut laisser penser que certains VMSiens savent faire l'effort ... ================================================================================ Note 33.6 De la doc please. 6 of 12 DECUSF::VIBERT_JF "Dr J-F Vibert, Vice-President" 5 lines 24-NOV-1989 01:26 -< Documentez >- -------------------------------------------------------------------------------- J'appuie tout a fait la demande de Gerard: DE LA DOC. Jamais je ne permet a un etudiant de me rendre un projet sans une doc et un manuel utilisateur. Vous qui etes des professionnels parmi les plus competents, n'oubliez pas la DOC. Ca vaut aussi bien pour VMS que pour Unix, cette remarque est OS independante. ================================================================================ Note 33.7 De la doc please. 7 of 12 DECUSF::DIAKONOFF_N "Responsable programmathèque" 28 lines 13-DEC-1989 19:10 -< OK, Voir dans VMS:AAA_LIRE. >- -------------------------------------------------------------------------------- Vous trouverez dans la directory VMS: le fichier AAA_LIRE. qui décrit le contenu des différents fichiers existants celà en fonction des renseignements glanés ici et là dans Notes. Cependant j'ai quelques incertitudes et beaucoup de manques (je n'ai pas eu le courage de relire toutes les notes pour savoir qui a mis quoi dans VMS: et je vous demande de bien vouloir m'indiquez par MAIL les corrections a effectuer. Merci d'avance. En particulier : ACP*.* par ??? DECODE_PC... FOUCHET_F DECW$... AF et BO EPSON PHARIPOU_Y EXEMPLES.ADA THONON_D MEMORY.MAR BO MFTU.COM AF MODATTR.* BORDET_JP PSFONTS JFV PSI DANA_M, PETIOT_JC et AF RESET_TAPE_MAR BO SHAR.C JFV SHOWLOCK.SHAR_1 ??? UTEXAS.* KERMA_G VERB.SHAR_1 Que fait ce programme ? XADRIVER.MAR BO ================================================================================ Note 33.8 De la doc please. 8 of 12 DECUSF::VIBERT_JF "Dr J-F Vibert, Vice-President" 27 lines 14-DEC-1989 00:07 -< PSFIG et SHAR.C >- -------------------------------------------------------------------------------- Quand je mets des fichiers dans ULTRIX, il y a toujours une doc, mais dans VMS, ca ne semblait pas etre la coutume... Donc BRAVO Nicolas, ce que tu fais est tres important, car comme tu l'a constate toi meme, c'est galere que d'aller rechercher dans les notes ce que font les programmes. Voici pour ce que j'ai mis: PSFONTS: Fichier de macros TeX comprenant plusieurs fichiers, donc a couper en petits morceaux (c'est explique un peu dedans), et qui permet d'utiliser les fontes built-in des imprimantes PostScript, au lieu des fontes CMR utilisees en standard par TeX. Il doit etre utilise avec un programme DVI2PS qui est capable de comprendre ses sorties. J'ai egalement mis le source de ce DVI2PS, qui est different de celui se trouvant sur la bande TeX DECUS. SHAR.C: Pour SHell ARchiver. C'est un archiveur/desarchiveur habituellement utilise sous UNIX pour transferer plusieurs fichiers ASCII sous forme d'un seul gros fichier. Les sources des outils UNIX sont toujours distribues sur les reseaux (EARN, BITNET, etc...) sous forme de fichiers SHAR. Sous Unix, il n'y a pas besoins de desarchiveur (le fichier s'auto-desarchive lorsqu'il est lu par la shell), mais sous VMS, DCL ne sait pas faire, alors Jean-Noel Albert et moi avons modifie SHAR.C venant d'Unix pour qu'il fonctionne sous VMS (et sous Ultrix bien sur, puisque c'est le meme code, vive le C pour la portabilite). Grace a lui, vous pouvez donc recuperer des fichier shar venant du monde Unix. ================================================================================ Note 33.9 De la doc please. 9 of 12 DECUSF::VIBERT_JF "Dr J-F Vibert, Vice-President" 10 lines 14-DEC-1989 00:30 -< une precision... >- -------------------------------------------------------------------------------- Precision: le DVI2PS.SHAR se trouve dans Ultrix, ainsi que le mode d'emploi concernant PSFONTS (PSFONTS.NOTES). Nicolas, ce que tu as fait dans VMS, c'ets parfait, il faut maintanant le faire dans ULTRIX. Ne crains pas de lire les .SHAR, c'est du texte tres lisible, avec le README generalement au debut. J'ai enleve ASKVAL.SHAR, car je vais mettre la nouvelle version, tres tres enhanced (edition, recall contextuel, multilingue, help en ligne, etc...) des que PSICOPY remarche. ================================================================================ Note 33.10 De la doc please. 10 of 12 DECUSF::VIBERT_JF "Dr J-F Vibert, Vice-President" 23 lines 15-DEC-1989 01:16 -< ASKVAL V2 >- -------------------------------------------------------------------------------- Ca y est , j'ai retransfere la nouvelle version d'askval, dans ULTRIX: Il s'agit d'un jeu de fonctions C permettant de se passer de scanf et de ses causes de migraines. Ce sont de fonctions qui "ask des values". elles permettent de mettre le prompt, et une reponse par defaut. Ca existait deja dans V1. L'apport de V2: edition de ligne comme tcsh ou dcl, rappel contextuel (si on demande un entier, ca rapelle le dernier entier entre) de l'historique, aide en ligne, verification de domaine, choix de la langue, de la sortie du prompt (stder ou stdout), verification qu'on entre bien des chiffres, ou des caracteres, etc... Ca marche sous Ultrix, bien sur, mais aussi sous VMS et sous MS/DOS (MSC et Turbo C). Il y a une doc TeX, nroff pour man et texte formate. et un exemple d'utilisation. Ca devrait interesser tous les Cistes. C'est shar, mais shar existe aussi sous VMS. PS: les 3 fichiers que j'ai egalement mis dans VMS (SYMPO_J[1-3]), sont les fichiers PostScript contenant la V1 du programme du Symposium 90. Il est probable qu'il y aura qq chgts, mais ca donne une 1ere idee du planning. Il y a qqs erruers 90 ================================================================================ Note 33.11 De la doc please. 11 of 12 DECUSF::DIAKONOFF_N "Responsable programmathèque" 11 lines 26-FEB-1990 22:25 -< Mise à Jour de VMS: >- -------------------------------------------------------------------------------- J'ai remis d'aplomb le fichier AAA_LIRE [il commence à faire 30 blocks], et j'ai quelques troubles : D'où vient le fichier ANSIFONT.PS ? Où trouver la note qui parle de CLUSTER.TXT ? Que celui qui a pris (sans le rendre) le fichier WDOG.SHAR_1_OF_1 le remette à sa place. Merci pour toutes les précisions. ================================================================================ Note 33.12 De la doc please. 12 of 12 DECUSF::VIBERT_JF "Dr J-F Vibert, Vice-President" 4 lines 26-FEB-1990 23:57 -< fonte iso-latin-1 >- -------------------------------------------------------------------------------- Le fichier ANSIFONT.PS est un fichier PostScript permettant de remapper les fontes DEC/ISOLATIN_1 au lieu des fontes ADOBE, afin d'avoir les accents. Il a ete obligemment mis par qq suite a une question que j'avais pose.