home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1997 March / Simtel-MSDOS-Mar1997-CD2.iso / disc2 / djgpp / v2 / lisezmoi.1er < prev    next >
Encoding:
Text File  |  1996-10-27  |  12.0 KB  |  318 lines
  1. Ficher README.1ST de DJGPP Version 2.01
  2.  
  3. [Avertissement: DJ Delorie, l'auteur de la version originale de ce document
  4. (et de DJGPP), n'est nullement responsable des erreurs de traduction, ou du
  5. retard dans la mise a jour de ce document. Si cette version francaise vous
  6. pose probleme, envoyez vos remarques/critiques a Francois Charton 
  7. <deef@pobox.oleane.com>] 
  8.  
  9.  
  10. DJGPP v2.01 est un ensemble d'applicatifs gratuits permettant de developper 
  11. des programmes C/C++ en mode protege 32 bits sous MS-DOS.
  12.  
  13. L'etat d'avancement du projet et diverses informations (documentation en 
  14. ligne, FAQ, archives de la messagerie) sont disponibles sur le site web 
  15. de djgpp, a l'adresse http://www.delorie.com/. Commentaires sur DJGPP et 
  16. questions sur son utilisation et ses fonctionnalites peuvent etre envoyes
  17. au newsgroup comp.os.msdos.djgpp ou a la liste de diffusion 
  18. <djgpp@delorie.com>, (pour vous y abonner, envoyez un message a
  19. <listserv@delorie.com>). Des informations sur les dernieres
  20. versions des applicatifs de DJGPP sont disponibles sur le site web.
  21.  
  22. Dans chaque fichier zippe, le numero de version est dans le fichier
  23. manifest/*.ver, et le contenu dans manifest/*.mft.
  24.  
  25. Un autre manuel, plus complet (et plus long), de presentation de DJGPP 
  26. a ete ecrit par An <avly@remus.rutgers.edu> et est disponible par ftp 
  27. anonyme a x2ftp.oulu.fi dans le repertoire /pub/msdos/programming/djgpp2, 
  28. son nom est djtut-bm.zip. Vous pouvez aussi le consulter en ligne a 
  29. l'adresse Web suivante:
  30.  
  31.         http://remus.rutgers.edu/~avly/djgpp.html
  32.  
  33.  
  34.  
  35. LES PROGRAMMES
  36. **************
  37.  
  38. Les fichiers dont le nom finit par 'b' contiennent les programmes et leur
  39. documentation. Au moment ou ce document a ete ecrit, les applicatifs 
  40. disponibles etaient:
  41.  
  42. FAQ     Un petit fichier indiquant les documents que vous devriez lire
  43.         (en particulier la "vraie" FAQ).
  44.  
  45. v2/
  46. unzip386 Decompacteur (comme PKUNZIP) librement accessible
  47. djdev201 Executables et kit de developpement de DJGPP V2
  48. djlsr201 Sources des librairies de DJGPP V2
  49. djtst201 Programmes de test
  50. djcrx201 Compilateur croise, pour produire des programmes DOS depuis un 
  51.          autre systeme
  52. faq202b  La FAQ complete sous divers formats (Info, ASCII, HTML...)
  53. faq202s  Sources en Texinfo de la FAQ, et outils pour la traduire
  54.          dans differents formats.
  55. frfaq020 Traduction francaise de la FAQ v2.02
  56.  
  57. v2gnu/
  58. bnu27b   GNU binutils 2.7 pour DJGPP V2
  59. bnu27s   Sources de GNU binutils 2.7 
  60. bsn124b  GNU bison 1.24 pour DJGPP V2
  61. bsn124s  Sources de GNU bison 1.24 
  62. dif271b  GNU diffutils 2.7.1 pour DJGPP V2
  63. dif271s  Sources de GNU diffutils 2.7.1 
  64. find41b  GNU findutils 4.1 pour DJGPP V2
  65. find41s  Sources de GNU findutils 4.1 
  66. flx252b  GNU Flex 2.5.2 pour DJGPP V2
  67. flx252s  Sources de GNU Flex 2.5.2
  68. gcc2721b GNU GCC 2.7.2.1 pour DJGPP V2
  69. gcc2721s Sources de GNU GCC 2.7.2.1
  70. gdb416b  GNU Debugger 4.16 pour DJGPP V2
  71. gdb416s  Sources de GNU Debugger 4.16
  72. gpp2721b GNU G++ 2.7.2.1 pour DJGPP V2 (sans les librairies)
  73. grep20b  GNU grep 2.0 pour DJGPP V2
  74. grep20s  Sources de GNU grep 2.0
  75. gzp124b  GNU gzip 1.2.4 pour DJGPP V2
  76. gzp124s  Sources de GNU gzip 1.2.4
  77. lgp271b  GNU libg++ 2.7.1 pour DJGPP V2
  78. lgp271s  Sources de GNU libg++ 2.7.1
  79. mak375b  GNU Make 3.75 pour DJGPP V2
  80. mak375s  Sources de GNU Make 3.75
  81. obc2721b GNU ObjC 2.7.2.1 pour DJGPP V2
  82. pat21b   GNU patch 2.1 pour DJGPP V2
  83. pat21s   Sources de GNU patch 2.1
  84. sed118b  GNU sed 1.18 pour DJGPP V2
  85. sed118s  Sources de GNU sed 1.18
  86. txi390b  GNU texinfo 3.9 pour DJGPP V2
  87. txi390s  Sources de GNU texinfo 3.9 
  88.  
  89. v2tk/
  90. bcc2grx  Convertisseur graphique Borland/GRX pour DJGPP V2
  91. grx20    GRX 2.0 Librairie Graphique pour DJGPP V2
  92. pdc22    Librairie "curses" domaine public
  93.  
  94. v2misc/
  95. csdpmi3b CWSDPMI, executables et documentation du serveur DPMI gratuit 
  96.                   de Charles Sandmann
  97. csdpmi3s Sources de CWSDPMI
  98. wmemu2b  Emulateur 387 de WM, executables pour DJGPP V2
  99. wmemu2s  Emulateur 387 de WM, sources pour DJGPP V2
  100.  
  101.  
  102. PREMIERS PAS
  103. ************         
  104.  
  105. Les informations donnees ici sont le minimum qu'un utilisateur novice doit
  106. connaitre pour demarrer DJGPP. Pour avoir davantage de details, veuillez 
  107. lire la documentation et la FAQ de DJGPP. Il est souhaitable que tout nouvel
  108. utilisateur lise la FAQ dans son integralite.
  109.  
  110.  
  111. Que telecharger
  112. ---------------
  113.  
  114. En general, ne telechargez que les executables; peu de gens ont besoin 
  115. des sources.
  116.  
  117. Pour compiler des programmes C, vous devrez avoir djdev201.zip, gcc2721b.zip,
  118. et bnu27b.zip. Pour le C++, il vous faudra egalement gpp2721b.zip et 
  119. lgp271b.zip. Pour pouvoir lire les manuels en ligne, telechargez txi370b.zip
  120. et executez "info". Si aucun serveur DPMI n'est installe sur votre machine,
  121. vous devrez avoir csdpmi3b.zip. (Windows, QDPMI, 386Max, NWDOS, OS/2, Win/NT 
  122. et DOSEmu sous Linux contiennent un serveur DPMI. Vous n'avez donc pas 
  123. besoin de CWSDPMI dans ces environnements). Pour plus d'informations, 
  124. telechargez faq202b.zip (ou en francais frfaq020.zip), et lisez le chapitre 4 
  125. de la FAQ.
  126.  
  127. Installation
  128. ------------
  129.  
  130. 1. Creez un repertoire pour DJGPP, par exemple C:\DJGPP. Si vous avez
  131.    deja installe la version 1.x , il vaut mieux effacer le contenu du
  132.    sous repertoire 'bin/', ou le recopier dans un autre repertoire (qui
  133.    ne soit pas sur votre PATH), et detruire tout le reste de cette version.
  134.    (Certains des problemes rencontres par les utilisateurs de DJGPP v2 viennent 
  135.    du melange des deux versions v1.x et v2). Le seul programme de la version 
  136.    1.x que vous devriez conserver est 'go32.exe'.
  137.  
  138. 2. Decompactez les fichiers zip a partir de ce repertoire, en veillant a 
  139.    preserver l'arborescence des sous repertoires. Par exemple :
  140.  
  141.         pkunzip -d gcc2721b
  142.    ou
  143.         unzip386 gcc2721b
  144.  
  145.  
  146. 3. Apres avoir decompacte tous les fichiers zippes, faites pointer la 
  147.    variable d'environnement DJGPP sur le fichier DJGPP.ENV, dans le 
  148.    repertoire de base de DJGPP, et ajoutez le sous repertoire BIN a votre PATH. 
  149.    Par exemple, si votre installation de DJGPP s'est faite a partir 
  150.    de C:\DJGPP, vous ajouterez au fichier AUTOEXEC.BAT les deux lignes :
  151.  
  152.         set DJGPP=C:\DJGPP\DJGPP.ENV
  153.         set PATH=C:\DJGPP\BIN;%PATH%
  154.  
  155.  
  156. 4. Executez le programme go32-v2.exe sans arguments
  157.  
  158.         go32-v2
  159.  
  160.    Il doit alors vous annoncer combien de memoire et d'espace 
  161.    d'echange DPMI DJGPP disposera sur votre systeme, par exemple :
  162.  
  163.         DPMI memory available: 8020 Kb
  164.         DPMI swap space available: 240 Kb
  165.  
  166.    (Ces nombres dependent de la taille de la RAM de votre systeme, de 
  167.    l'espace disque disponible, et du serveur DPMI.) Si go32-v2 annonce 
  168.    moins de 4 MOctets de memoire DPMI, lisez le paragraphe 3.8 de la FAQ.
  169.    (Meme si vous disposez de davantage de memoire, lisez le si vous voulez 
  170.    optimiser les performances de DJGPP sur votre systeme).
  171.  
  172. Compilation
  173. -----------
  174.  
  175. GCC est un compilateur en ligne de commande, que vous appelez depuis le DOS.
  176. Pour compiler et relier un programme C constitue d'un seul fichier, vous
  177. taperez une commande comme :
  178.  
  179.         gcc monfich.c -o monfich.exe -lm
  180.  
  181. L'option -lm relie la librairie lib/libm.a (fonctions trigonometriques) si
  182. vous en avez besoin. (Lors de la reliure, l'ordre des operations est 
  183. important, aussi, tapez toujours '-lm' a la fin de la ligne de commande.)
  184.  
  185. Pour compiler un fichier C ou C++ en fichier objet, tapez :
  186.  
  187.         gcc -c -Wall monfich.c   (programme C)
  188.   ou
  189.         gcc -c -Wall monfich.cc (programme C++)
  190.  
  191. Ceci cree le fichier objet monfich.o. L'option '-Wall' active toutes sortes
  192. de messages d'avertissement, qui peuvent etre d'une grande utilite aux
  193. utilisateurs novices de GCC. (D'autre extensions de fichiers C++, comme .cpp,
  194. sont egalement acceptees, pour plus d'information, lire la section 8.4 de la 
  195. FAQ).
  196.  
  197. Pour relier plusieurs fichiers objets C en un programme executable, tapez:
  198.  
  199.         gcc -o monprog.exe monmain.o monsub1.o monsub2.o -lm
  200.  
  201. Ceci cree 'monprog.exe' qui peut etre execute a l'invite du DOS.
  202.  
  203. Pour relier un programme C++, utilisez gxx au lieu de gcc:
  204.  
  205.         gxx -o monprog.exe monmain.o monsub1.o monsub2.o -lm
  206.  
  207. Il utilisera automatiquement les librairies C++, ce vous epargne de les faire 
  208. figurer sur la ligne de commande.
  209.  
  210. Vous pouvez egalement combiner compilation et reliure :
  211.  
  212.         gcc -Wall -o monprog.exe monmain.c monsub1.c monsub2.c -lm
  213.  
  214. Les innombrables options de GCC sont decrites dans sa documentation en ligne. 
  215. Pour y avoir acces, installez l'applicatif Texinfo (texi390b.zip, 
  216. voir le paragraphe "documentation en ligne" ci dessous) et tapez :
  217.  
  218.         info gcc invoking
  219.  
  220.  
  221. Environnement de developpement (EDI)
  222. ------------------------------------
  223.  
  224. DJGPP n'a pas actuellement d'environnement de developpement integre.
  225. Vous pouvez utiliser comme EDI n'importe quel editeur capable de lancer des 
  226. programmes DOS et d'en recevoir le resultat. De nombreux utilisateurs de 
  227. DJGPP utilisent un portage pour DOS de GNU Emacs (disponible au memes endroits
  228. que DJGPP) qui peut etre compile par DJGPP. Emacs est un editeur tres puissant 
  229. (il dispose par exemple d'un lecteur Info integre, ce qui vous permet de lire 
  230. la documentation DJGPP sans quitter l'editeur), mais de nombreux autres  
  231. editeurs gratuits peuvent servir d'EDI. La seule chose que ces editeurs 
  232. (y compris Emacs) ne puissent faire est d'utiliser un debogueur lors d'une
  233. session plein-ecran.
  234.  
  235. Un EDI specifique a DJGPP, appele RHIDE, est en phase de beta test, et devrait
  236. etre disponible prochainement.
  237.  
  238.  
  239. Debogage
  240. --------
  241.  
  242. Pour deboguer un programme, vous devez d'abord le compiler en utilisant 
  243. l'option -g :
  244.  
  245.         gcc -c -Wall -g monmain.c
  246.         gcc -c -Wall -g monsub1.c
  247.         gcc -c -Wall -g monsub2.c
  248.  
  249. puis le relier avec l'option '-g', mais en donnant au relieur le nom du
  250. programme sans l'extension .exe :
  251.  
  252.         gcc -g -o monprog monmain.o monsub1.o monsub2.o -lm
  253.  
  254. (remarquer que l'on tape '-o monprog' et non '-o monprog.exe'). Ceci creera
  255. un fichier COFF appele 'monprog', ainsi que l'executable 'monprog.exe'; les
  256. debogueurs doivent avoir acces au fichier COFF.
  257.  
  258. Puis executez votre programme avec le debogueur :
  259.  
  260.         fsdb monprog
  261. ou
  262.         gdb monprog
  263.  
  264. (Vous devez telecharger gdb416b.zip si vous voulez deboguer avec GBD.)
  265. FSDB a une aide en ligne; appuyez sur F1 pour la lire. GDB a une 
  266. documentation au format Info (voir ci dessous) qui peut etre lue au moyen
  267. d'Info.exe.
  268.  
  269.  
  270. Documentation en ligne
  271. ----------------------
  272.  
  273. Le plupart des documentations sont ecrites dans un format hypertexte
  274. special utilise par le projet GNU. Chaque applicatif contient sa propre
  275. documentation sous la forme de fichiers ayant l'extension .iNN, et qui se
  276. decompactent dans le sous repertoire info/ de votre repertoire principal 
  277. DJGPP. Pour consulter ces documentations, telechargez et decompactez le 
  278. fichier txi390b.zip, et executez info.exe. Si vous ne savez pas comment
  279. utiliser Info, tapez '?'.
  280.  
  281.  
  282. Compatibilite avec la version 1.x
  283. ---------------------------------
  284.  
  285. Les programmes compiles avec DJGPP V1.x peuvent etre utilises pour des
  286. applicatifs qui n'ont pas ete portes sous DJGPP v2.0. Les 
  287. programmes version 1 ne peuvent executer des programmes de la version 2.0
  288. (mais les programmes v2 *peuvent* executer des programmes v1), n'essayez pas,
  289. par exemple, d'utiliser Make v1.x avec le compilateur v2.0.
  290.  
  291.  
  292. --- COPYRIGHT ---
  293.  
  294. DJGPP V2 Copyright (C) 1995, DJ Delorie. Certaines parties de libc.a 
  295. sont Copyright (C) Regents of the University of California at Berkeley.
  296.  
  297.  
  298. Les programmes GNU (gcc,make,libg++,etc...) sont Copyright Free Software
  299. Foundation.
  300.  
  301. Le copyright de la version 2 de DJGPP vous autorise a l'utiliser pour 
  302. produire des applications commerciales. Cependant, si vous utilisez du
  303. code ou des librairies qui n'appartiennent pas a djgpp (par exemple la
  304. librairies libg++ de gnu), alors vous devez vous conformer aux dispositions 
  305. de leur copyright. Lisez le chapitre 19 de la FAQ pour davantage de 
  306. details.
  307.  
  308. Amusez vous bien!
  309.  
  310.  
  311. DJ Delorie
  312. dj@delorie.com
  313. http://www.delorie.com/
  314.  
  315.  
  316. [traduction : Francois Charton deef@pobox.oleane.com]
  317.  
  318.