    Cette version de l'extracteur de prototypes est un "shareware".
    Ce n'est pas une version complte. Solucorp fournis ce programme
    uniquement pour valuation. L'usager a 30 jours pour l'valuer.
    Lorsque l'usager s'enregistre en payant 25$ US ou 30$ canadien,
    il reoit une version complte de l'extracteur ainsi que plusieurs
    utilitaires.

    L'usager recevra une version DOS, une version UNIX,XENIX
    (pour ordinateurs 386/486) and une version SUN SPARC.
    L'usager recevra aussi un numro d'enregistrement lui permettant
    de commander n'importe quel rvision future de ce produit pour
    la modique somme de 10$ (10$ pour chaque rvision).

    Ce qui suit est une prsentation des utilitaires. Le fichier exemple.zip
    fournit une description plus complte de l'utilisation de ces programmes.
    Solucorp se rserve le droit de modifier la composition de cet ensemble
    de programme sans pravis.


    -Dircmd: Un "file find" amlior.
    -Make: Un make amlior.
    -Makedep: Un constructeur de dpendances pour makefile.
    -Naloc: Un localisateur de dclarations de fonctions.
    -Naperm: Un formatteur d'indexs.
    -Nadoc: Un formatteur de documentation.
    -Nulfct: Elimine certains appels de fonctions dans un source.

Dircmd: Un "file find" amlior.

    Dircmd permet de localiser des fichiers et rpertoires  partir
    de critres de slection complexes (date,multiples wildcards,
    exclusion, comparaison de rpertoires, etc...). De plus,
    il permet d'assembler des commandes  partir du nom des fichiers
    trouvs.

    La commande suivante efface tous les fichiers .obj associs aux
    fichiers .c sur un disque.

    dircmd -s -e *.c del %p%\%b.obj

    Cette commande dtruit chaque fichier apparaissant et dans le
    rpertoire "travail" et le rpertoire "archive" et qui ont la mme
    date de rvision et la mme dimension. La destruction se fait
    dans le rpertoire "travail".

    dircmd -c+=\archive -e \travail\*.* del %s

    Dircmd est essentiel pour la gestion de larges disques dures et
    de rseaux.

Make: Un make amlior.

    Le make de Solucorp introduit plusieurs extensions. Il permet
    la construction de makefile portable entre DOS et UNIX. Voici
    une liste d'extensions par rapport aux make standard.
    Voir le fichier makefile dans exemple.zip.

   -Elimine la limitation de DOS pour les lignes de commande.

    DOS limite une ligne de commande  126 caractres. Make rsout ce
    problme de faon quasi invisible.

   -Elimine la limite de 640k de DOS.

    Make peut soit s'liminer temporairement de la mmoire ou
    dclencher un "window DesqView" spar, librant pratiquement
    toute la mmoire disponible.

   -Traitement conditionnel.

    Make supporte un ensemble complet de directive fonctionnant comme
    le prprocesseur du compilateur C.

   -Projet distribu.

    Make peut oprer de faon transparente avec des sources, des
    fichiers objets et des librairies disposs dans des rpertoires
    diffrents. La disposition exacte est indpendant des rgles inscrite
    dans les makefile. C'est ce qui permet d'obtenir des makefile
    "transportables".

   -Syntaxe de dfinition de macro.

    Make supporte la dfinition de macro  partir de wildcards.
    Il supporte l'exclusion.

   -Rvision dynamique du contenu d'une macro.

    Un fois une macro dfinie, on peut l'utiliser comme telle, ou
    avec modifications.

   -Gestion automatique des dpendances entre un sources et les
    fichiers d'inclusion qu'il rfrence. Voir l'utilitaire makedep.

   -Option touch slectif.

    Un "touch" peut tre appliqu sur toutes les cibles qui ne sont
    plus  date, seulement si elles sont rendues dsuettes par une
    dpendance spcifique.

   -Option de dverminage permettant d'inspecter l'arbre de dcision
    du make.

Makedep: Un constructeur de dpendances pour makefile.

    Makedep lit une srie de fichier source et produit un fichier
    "parallle" qui sera utilis par make. Ce fichier indique la
    dpendances entre un fichier sources et des fichiers d'inclusion.
    Vous n'avez plus  rviser le fichier makefile  chaque fois
    qu'un fichier d'inclusion est ajout  un source.

    Voir le fichier makefile.dep dans exemple.zip.

Naloc: Un localisateur de dclarations de fonctions.

    Naloc localise le source contenant la dclaration d'une fonction
    n'importe o dans un projet  plusieurs sources, et plusieurs
    rpertoires. Se rattache facilement  un diteur programmable.

Naperm: Un formatteur d'index.

    Ce programme produit trois fichier: Un sommaire, un index permutt
    et un historique des rvisions d'une librairie. Voir le fichier
    document.exm dans exemple.zip.

Nadoc: Un formatteur de documentation.

    Nadoc produit un document complet sur un systme (librairie)
     partir d'un squelette. Vous n'inscrivez que les sections et
    sous-sections accompagnes d'une courte description, et 
    identifiez les fonctions qui font partie de ces sections.
    Nadoc produit automatiquement un document  partir de la documentation
    extraite des sources. Il cre la table des matires. Il produit
    un rapport mentionnant les fonctions qui n'existent plus et
    les fonctions qui n'ont pas t classifies.

    Un outils essentiel pour produire du code rutilisable, rutilis !
    Voir document.exm dans exemple.zip.

Nulfct: Elimine certains appels de fonctions dans un source.

    Nulfct limine tous les appels fait  une fonction dans une
    srie de source. Il produit un fichier temporaire qui sera
    compil, laissant l'original inchang. Il peut faire le traitement
    en parallle pour plusieurs fonctions. Les fonctions limins de
    cette faon sont gnralement utilis pour le dverminage.


--------------------------------------------------------------------

    Nouvelles options et corrections de proto. Extraits du manuel
    protof.man.

--------------------------------------------------------------------

1       Introduction et avertissements 

  L'extracteur de prototypes automatise et agrmente une 
  partie du travail d'un programmeur en langage ANSI C et C++ 
  2.0. Il supporte aussi la syntaxe de dclaration de 
  fonctions K&R. 

  Une version existe pour MSDOS (PCDOS) version 3 et plus, 
  pour SCO XENIX version 2.3 (UNIX systme V.3.2) et pour SUN 
  SPARC (Sunos). 

  Ce manuel s'applique intgralement dans les trois 
  environnements. Toutefois, le sparateur / a t choisi pour 
  la spcification de fichiers dans le manuel. La version 
  MSDOS du logiciel reconnat le sparateur \ et non pas /. 

3.3     Mot-cls ajouts pour automatiser l'opration de
        l'extracteur 

  Le langage C++ ne permet pas d'extraire les prototypes d'une 
  faon compltement automatique. Pour sa part le langage C 
  possde un concept rudimentaire de controle de l'accs. 

  Sept mot-cls sont interprts par l'extracteur pour 
  compltement controler la gnration des prototypes  partir 
  du source. 

      export      C et C++
      _export     C et C++
      PRIVATE     C++
      PUBLIC      C++
      PROTECTED   C++
      STATIC      C++
      VIRTUAL     C++

3.4.3   -b : Mise  jour d'un fichier C++  partir d'un
        fichier .pm 

  Normalement, proto regroupe tous les prototypes des 
  fonctions membres d'une classe C++ dans un seul fichier 
  (voir -m0+,-m1+ et -c+). Ce fichier porte gnralement 
  l'extension ".pm". A partir de ce fichier, les prototypes 
  des fonctions membres sont distribus dans les fichiers qui 
  contiennent les dclarations des classes. L'option -b active 
  cette distribution. 

  La syntaxe de l'option est: 

      -bfichier__rviser+fichier_pm=fichier_rsultat
      -bfichier__rviser+fichier_pm
      -bfichier__rviser
      -b

  Si fichier_rsultat n'est pas spcifi, fichier__rviser 
  sera pris comme source et destination. Si fichier_pm n'est 
  pas spcifi, X.pm sera choisi (X est le nom du rpertoire 
  courant). L'option -b sans arguments sera quivalente  
  -bX.hpp+X.pm o -bX.h+X.pm o X est le nom du rpertoire 
  courant. X.h sera utilis si X.hpp n'existe pas. 

  L'option -b peut tre utilis plusieurs fois (pour rviser 
  plusieurs fichier d'inclusion) sur la ligne de commande. Son 
  action ne sera dclenche qu'aprs l'extraction du dernier 
  prototype. 

3.4.6   -D : Dfinition de symbole sur la ligne de commande 

  L'option -D permet de dfinir des symboles du prprocesseur 
  directement sur la ligne de commande. 

  L'option "-Dsymxxx" est quivalente  la ligne "#define 
  symxxx". 

  L'option "-Dsymxxx=yyy" est quivalente  "#define symxxx 
  yyy". 

3.4.15  -o : Nom alternatif pour l'option -m 

  L'option -m compose le nom des fichiers resultats  partir 
  du nom du rpertoire courant. L'option -o permet de 
  spcifier un autre nom 

