home *** CD-ROM | disk | FTP | other *** search
/ Sams Teach Yourself C in 21 Days (6th Edition) / STYC216E.ISO / mac / DJGPP / v2 / lisezmoi.1er < prev    next >
Text File  |  1998-05-07  |  16KB  |  398 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/. Tous commentaires sur DJGPP 
  16. et questions sur son utilisation et ses fonctionnalites peuvent etre 
  17. envoyes 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 archive .zip, 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), d'introduction a DJGPP 
  26. a ete ecrit par An <avly@remus.rutgers.edu> et peut etre telecharge par ftp 
  27. anonyme a x2ftp.oulu.fi. Il se trouve dans le repertoire 
  28. /pub/msdos/programming/djgpp2, et son nom est djtut-bm.zip. Vous pouvez 
  29. egalement le consulter en ligne a 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. faq210b  La FAQ complete sous divers formats (Info, ASCII, HTML...)
  53. faq210s  Sources en Texinfo de la FAQ, et outils pour la traduire
  54.          dans differents formats.
  55. frfaq21b Traduction francaise de la FAQ v2.10, version texte (Info, ASCII)
  56. frfaq21s Traduction francaise de la FAQ v2.10, source Texinfo
  57.  
  58. v2apps/                                                             
  59. rhide14b Environnement de developpement integre pour DJGPP v2
  60. rhide14s Sources de RHIDE
  61.  
  62. v2gnu/
  63. bnu281b  GNU binutils 2.8.1 pour DJGPP V2
  64. bnu281s  Sources de GNU binutils 2.8.1 
  65. bsh1147b GNU bash 1.14.7 pour DJGPP V2
  66. bsh1147s Sources de GNU bash 1.14.7
  67. bsn125b  GNU bison 1.25 pour DJGPP V2
  68. bsn125s  Sources de GNU bison 1.25 
  69. dif271b  GNU diffutils 2.7.1 pour DJGPP V2
  70. dif271s  Sources de GNU diffutils 2.7.1 
  71. em1934b  GNU emacs 19.34: Executables pour DJGPP v2
  72. em1934l? GNU emacs 19.34: Sources Elisp (3 fichiers)
  73. em1934r? GNU emacs 19.34: Environnement d'execution (3 fichiers)
  74. em1934s? GNU emacs 19.34: Sources (3 fichiers)
  75. fil316b  GNU fileutils 3.16 pour DJGPP v2
  76. fil316s  Sources de GNU fileutils 3.16
  77. find41b  GNU findutils 4.1 pour DJGPP V2
  78. find41s  Sources de GNU findutils 4.1 
  79. flx254b  GNU Flex 2.5.4 pour DJGPP V2
  80. flx254s  Sources de GNU Flex 2.5.4
  81. g770519b GNU Fortran77 0.5.19 pour DJGPP V2
  82. g770519s Sources de GNU Fortran77 0.5.19
  83. gcc280b  GNU GCC 2.8.0 pour DJGPP V2
  84. gcc280s  Sources de GNU GCC 2.8.0
  85. gdb416b  GNU Debugger 4.16 pour DJGPP V2
  86. gdb416s  Sources de GNU Debugger 4.16
  87. gdbm173b GDBM 1.7.3, executables pour DJGPP V2
  88. gdbm173s Sources de GDBM 1.7.3
  89. gpc20b   GNU Pascal 2.0, executables pour DJGPP V2
  90. gpc20s   Sources de GNU Pascal 2.0
  91. gpp280b  GNU G++ 2.8.0 pour DJGPP V2 (sans les librairies)
  92. gpt112b  GNU Pascal avec extensions Turbo Pascal
  93. grep21b  GNU grep 2.1 pour DJGPP V2
  94. grep21s  Sources de GNU grep 2.1
  95. gwk303b  GNU awk 3.03 pour DJGPP V2
  96. gwk303s  Sources de GNU awk 3.03
  97. gzp124b  GNU gzip 1.2.4 pour DJGPP V2
  98. gzp124s  Sources de GNU gzip 1.2.4
  99. isp3120b GNU ispell 3.1.20 pour DJGPP V2
  100. isp3120s Sources de GNU ispell 3.1.20
  101. lgpp280b GNU libg++ 2.8.0 pour DJGPP V2
  102. lgpp280s Sources de GNU libg++ 2.8.0
  103. lss332b  GNU less 3.22, executables pour DJGPP v2
  104. lss332s  Sources de GNU less 3.22
  105. mak3761b GNU Make 3.76.1 pour DJGPP V2
  106. mak3761s Sources de GNU Make 3.76.1
  107. objc280b GNU ObjC 2.8.0 pour DJGPP V2
  108. pat25b   GNU patch 2.5 pour DJGPP V2
  109. pat25s   Sources de GNU patch 2.5
  110. rcs5713b GNU rcs 5.7p113 pour DJGPP v2
  111. rcs5713s Sources de GNU rcs 5.7p113
  112. sed118b  GNU sed 1.18 pour DJGPP V2
  113. sed118s  Sources de GNU sed 1.18
  114. shl112b  GNU sh-utils 1.12 pour DJGPP V2
  115. shl112s  Sources de GNU sh-utils 1.12
  116. txi390b  GNU texinfo 3.9 pour DJGPP V2
  117. txi390s  Sources de GNU texinfo 3.9 
  118. txt119b  GNU textutils 1.19 pour DJGPP V2
  119. txt119s  Sources de GNU textutils 1.19
  120.  
  121. v2tk/
  122. allegro  Sources d'Allegro 3.0 - librairies de programmation de jeux
  123. bccgrx20 Convertisseur graphique Borland/GRX pour DJGPP V2
  124. bcsio20  Communications sur le port serie, par Bill Currie
  125. djgpptsr Exemples d'ecriture de programmes residents sous DJGPP
  126. gccsjis  Patch pour GCC, pour compiler les sources de JIS (beta)
  127. grx20    GRX 2.0 Librairie Graphique pour DJGPP V2
  128. jkthpack Threads pour DOS, par JK
  129. jptui37d JPTUI, Interface utilisateur texte
  130. libkb100 Interface clavier bas niveau portable
  131. lmb051b  JIS librairie multi-octets (beta)
  132. lmb051s  Source de JIS, librairie multi-octets (beta)
  133. lw03b    JIS caracteres grand formats (beta)
  134. lw03s    Source de JIS caracteres grands formats (beta)
  135. mkkbd3   Exemples de gestionnaire clavier
  136. mttws121 Systeme de fenetrage, par Malcolm Taylor
  137. pdc22    Librairie "curses" domaine public
  138. rsxdj131 RSX pour DJGPP
  139. sw21_dj1 Systeme de fenetrage SWORD, executables pour DJGPP V1
  140. sw21_dj2 Systeme de fenetrage SWORD, executables pour DJGPP V2
  141. sw21_doc Systeme de fenetrage SWORD, documentation
  142. sw21_p1  Systeme de fenetrage SWORD, Partie 1
  143. sw21_p2  Systeme de fenetrage SWORD, Partie 2
  144. sw21_tc  Systeme de fenetrage SWORD, Executables pour Turbo C
  145.  
  146. v2misc/
  147. csdpmi4b CWSDPMI, executables et documentation du serveur DPMI gratuit 
  148.                   de Charles Sandmann
  149. csdpmi4s Sources de CWSDPMI
  150. infng100 Conversion d'INFO vers Norton Guides
  151. mlp107b  Compresseur de fichiers executables ML
  152. mlp107s  Sources de ML
  153. pmode12b PMODE, amorce pour djgpp V2
  154. pmode12s Source de PMODE
  155. wmemu2b  Emulateur 387 de WM, executables pour DJGPP V2
  156. wmemu2s  Emulateur 387 de WM, sources pour DJGPP V2
  157.  
  158.  
  159. PREMIERS PAS
  160. ************         
  161.  
  162. Les informations donnees ici sont le minimum qu'un utilisateur novice doit
  163. connaitre pour demarrer DJGPP. Pour avoir davantage de details, veuillez 
  164. lire la documentation et la FAQ de DJGPP. Il est souhaitable que tout nouvel
  165. utilisateur lise la FAQ en entier.
  166.  
  167.  
  168. Que telecharger
  169. ---------------
  170.  
  171. En general, ne telechargez que les executables; peu de gens ont besoin 
  172. des sources.
  173.  
  174. Pour compiler des programmes C, vous devez avoir djdev201.zip, gcc280b.zip,
  175. et bnu281b.zip. Pour le C++, il vous faudra egalement gpp280b.zip et 
  176. lgpp280b.zip. Pour lire les manuels, telechargez txi390b.zip et executez 
  177. "info". Si aucun serveur DPMI n'est installe sur votre machine, vous devez 
  178. avoir csdpmi4b.zip. (Windows, QDPMI, 386Max, NWDOS, OpenDOS, OS/2, Win/NT 
  179. et DOSEmu sous Linux contiennent un serveur DPMI. Vous n'avez donc pas 
  180. besoin de CWSDPMI dans ces environnements). Pour plus d'informations, 
  181. telechargez faq210b.zip (ou en francais frfaq21b.zip), et lisez le chapitre 4 
  182. de la FAQ.
  183.  
  184. Installation
  185. ------------
  186.  
  187. 1. Creez un repertoire pour DJGPP, par exemple C:\DJGPP. Si vous avez
  188.    deja installe la version 1.x , il vaut mieux effacer le contenu du
  189.    sous repertoire 'bin/', ou le recopier dans un autre repertoire (qui
  190.    ne soit pas sur votre PATH), et detruire tout le reste de cette version.
  191.    (Certains des problemes rencontres par les utilisateurs de DJGPP v2 viennent 
  192.    du melange des deux versions v1.x et v2). Le seul programme de la version 
  193.    1.x que vous devriez conserver est 'go32.exe'.
  194.  
  195. 2. Decompactez les fichiers zip a partir de ce repertoire, en veillant a 
  196.    preserver l'arborescence des sous repertoires. Par exemple :
  197.  
  198.         pkunzip -d gcc280b
  199.    ou
  200.         unzip386 gcc280b
  201.  
  202.  
  203. 3. Apres avoir decompacte tous les fichiers zippes, faites pointer la 
  204.    variable d'environnement DJGPP sur le fichier DJGPP.ENV, dans le 
  205.    repertoire de base de DJGPP, et ajoutez le sous repertoire BIN a votre PATH. 
  206.    Par exemple, si votre installation de DJGPP s'est faite a partir 
  207.    de C:\DJGPP, vous ajouterez au fichier AUTOEXEC.BAT les deux lignes :
  208.  
  209.         set DJGPP=C:\DJGPP\DJGPP.ENV
  210.         set PATH=C:\DJGPP\BIN;%PATH%
  211.  
  212.  
  213. 4. Executez le programme go32-v2.exe sans arguments
  214.  
  215.         go32-v2
  216.  
  217.    Il doit alors vous annoncer combien de memoire et d'espace 
  218.    d'echange DPMI DJGPP disposera sur votre systeme, par exemple :
  219.  
  220.         DPMI memory available: 8020 Kb
  221.         DPMI swap space available: 39413 Kb
  222.  
  223.    (Ces nombres dependent de la taille de la RAM de votre systeme, de 
  224.    l'espace disque disponible, et du serveur DPMI.) Si go32-v2 annonce 
  225.    moins de 4 MOctets de memoire DPMI, lisez le paragraphe 3.8 de la FAQ.
  226.    (Meme si vous disposez de davantage de memoire, lisez le si vous voulez 
  227.    optimiser les performances de DJGPP sur votre systeme).
  228.  
  229. Compilation
  230. -----------
  231.  
  232. GCC est un compilateur en ligne de commande, que vous appelez depuis le DOS.
  233. Pour compiler et relier un programme C constitue d'un seul fichier, vous
  234. taperez une commande comme :
  235.  
  236.         gcc monfich.c -o monfich.exe -lm
  237.  
  238. L'option -lm relie la librairie lib/libm.a (fonctions trigonometriques) si
  239. vous en avez besoin. (Lors de la reliure, l'ordre des operations est 
  240. important, aussi, tapez toujours '-lm' a la fin de la ligne de commande.)
  241.  
  242. Pour compiler un fichier C ou C++ en fichier objet, tapez :
  243.  
  244.         gcc -c -Wall monfich.c   (programme C)
  245.   ou
  246.         gcc -c -Wall monfich.cc (programme C++)
  247.  
  248. Ceci cree le fichier objet monfich.o. L'option '-Wall' active toutes sortes
  249. de messages d'avertissement, qui peuvent etre d'une grande utilite aux
  250. utilisateurs novices de GCC. (D'autre extensions de fichiers C++, comme .cpp,
  251. sont egalement acceptees, pour plus d'information, lire la section 8.4 de la 
  252. FAQ).
  253.  
  254. Pour relier plusieurs fichiers objets C en un programme executable, tapez:
  255.  
  256.         gcc -o monprog.exe monmain.o monsub1.o monsub2.o -lm
  257.  
  258. Ceci cree 'monprog.exe' qui peut etre execute a l'invite du DOS.
  259.  
  260. Pour relier un programme C++, utilisez gxx au lieu de gcc:
  261.  
  262.         gxx -o monprog.exe monmain.o monsub1.o monsub2.o -lm
  263.  
  264. Il utilisera automatiquement les librairies C++, ce vous epargne de les faire 
  265. figurer sur la ligne de commande.
  266.  
  267. Vous pouvez egalement combiner compilation et reliure :
  268.  
  269.         gcc -Wall -o monprog.exe monmain.c monsub1.c monsub2.c -lm
  270.  
  271. Les innombrables options de GCC sont decrites dans sa documentation en ligne. 
  272. Pour y avoir acces, installez l'applicatif Texinfo (texi390b.zip, 
  273. voir le paragraphe "documentation en ligne" ci dessous) et tapez :
  274.  
  275.         info gcc invoking
  276.  
  277.  
  278. Environnement de developpement (EDI)
  279. ------------------------------------
  280.  
  281. DJGPP n'a pas actuellement d'environnement de developpement integre.
  282. Vous pouvez utiliser comme EDI n'importe quel editeur capable de lancer des 
  283. programmes DOS et d'en recevoir le resultat. De nombreux utilisateurs de 
  284. DJGPP utilisent un portage pour DOS de GNU Emacs (disponible au meme endroit
  285. que DJGPP) qui peut etre compile par DJGPP. Emacs est un editeur tres puissant 
  286. (il dispose par exemple d'un lecteur Info integre, ce qui vous permet de lire 
  287. la documentation DJGPP sans quitter l'editeur), mais de nombreux autres  
  288. editeurs gratuits peuvent servir d'EDI. La seule chose que ces editeurs 
  289. (y compris Emacs) ne puissent faire est d'utiliser un debogueur lors d'une
  290. session plein-ecran.
  291.  
  292. Un EDI specifique a DJGPP, appele RHIDE, peut etre utilise. Il presente une
  293. interface similaire a celle de Turbo C, et permet l'indentation automatique, 
  294. la mise en evidence de la syntaxe, l'appel automatique du compilateur DJGPP, 
  295. la creation automatique de fichiers Makefile, et un acces simple a la 
  296. documentation en ligne de DJGPP. RHIDE permet aussi le debogage, en utilisant
  297. les fonctionnalites du debogueur GNU (gdb). RHIDE etant tres recent, des 
  298. corrections et revisions lui sont regulierement apportees. Consultez
  299. http:/www.tu-chemnitz.de/~sho/rho/rhide.html pour les dernieres versions.
  300.  
  301.  
  302.  
  303. Debogage
  304. --------
  305.  
  306. Pour deboguer un programme, vous devez d'abord le compiler en utilisant 
  307. l'option -g :
  308.  
  309.         gcc -c -Wall -g monmain.c
  310.         gcc -c -Wall -g monsub1.c
  311.         gcc -c -Wall -g monsub2.c
  312.  
  313. puis le relier avec l'option '-g':
  314.  
  315.         gcc -g -o monprog.exe monmain.o monsub1.o monsub2.o 
  316.  
  317. (Depuis la version 2.01 de DJGPP, il n'est plus necessaire de produire un
  318. fichier COFF brut en ne mettant pas le suffixe '.exe' au nom de fichier pour
  319. pouvoir deboguer un programme. Les nouvelles versions du debogueur savent 
  320. lire l'executable comme le fichier COFF. Si vous ne comprenez pas ce
  321. paragraphe, ce n'est pas grave).
  322.  
  323. Puis executez votre programme avec le debogueur :
  324.  
  325.         fsdb monprog.exe
  326. ou
  327.         gdb monprog.exe
  328. ou
  329.         edebug32 monprog.exe
  330.  
  331. (Vous devez telecharger gdb416b.zip si vous voulez deboguer avec GBD.)
  332. FSDB a une aide en ligne; appuyez sur F1 pour la lire. GDB a une 
  333. documentation au format Info (voir ci dessous) qui peut etre lue au moyen
  334. d'Info.exe. Edebug32 est un debogueur rarement utilise; tapez '-h' pour
  335. lire l'aide.
  336.  
  337.  
  338. Documentation en ligne
  339. ----------------------
  340.  
  341. Le plupart des documentations sont ecrites dans un format hypertexte
  342. special utilise par le projet GNU. Chaque applicatif contient sa propre
  343. documentation sous la forme de fichiers ayant l'extension .iNN, et qui se
  344. decompactent dans le sous repertoire info/ de votre repertoire principal 
  345. DJGPP. Pour consulter ces documentations, telechargez et decompactez le 
  346. fichier txi390b.zip, et executez info.exe. Si vous ne savez pas comment
  347. utiliser Info, tapez '?'.
  348.  
  349.             
  350. Compatibilite avec la version 2.0
  351. ---------------------------------
  352.  
  353. Si vous passez de la version 2.00 de DJGPP a la version 2.01, vous devriez
  354. reinstaller en totalite les applicatifs que vous utilisez. Comme la version
  355. 2.01 utilise une methode entirement nouvelle de gestion des longues lignes
  356. de commande (et des noms de fichiers longs sous Win95), melanger des 
  357. programmes v2.00 et v2.01 peut faire apparaitre des erreurs subtiles , 
  358. difficiles a deboguer. Lisez le paragraphe 16.6 de la FAQ pour plus 
  359. d'informations.
  360.  
  361.  
  362. Compatibilite avec la version 1.x
  363. ---------------------------------
  364.  
  365. Les programmes compiles avec DJGPP V1.x peuvent etre utilises pour des
  366. applicatifs qui n'ont pas ete portes sous DJGPP v2.0. Les 
  367. programmes version 1 ne peuvent executer des programmes de la version 2.0
  368. (mais les programmes v2 *peuvent* executer des programmes v1), n'essayez pas,
  369. par exemple, d'utiliser Make v1.x avec le compilateur v2.0.
  370.  
  371.  
  372. --- COPYRIGHT ---
  373.  
  374. DJGPP V2 Copyright (C) 1995, DJ Delorie. Certaines parties de libc.a 
  375. sont Copyright (C) Regents of the University of California at Berkeley.
  376.  
  377.  
  378. Les programmes GNU (gcc,make,libg++,etc...) sont Copyright Free Software
  379. Foundation.
  380.  
  381. Le copyright de la version 2 de DJGPP vous autorise a l'utiliser pour 
  382. produire des applications commerciales. Cependant, si vous utilisez du
  383. code ou des librairies qui n'appartiennent pas a djgpp (par exemple la
  384. librairies libg++ de gnu), alors vous devez vous conformer aux dispositions 
  385. de leur copyright. Lisez le chapitre 19 de la FAQ pour davantage de 
  386. details.
  387.  
  388. Amusez vous bien!
  389.  
  390.  
  391. DJ Delorie
  392. dj@delorie.com
  393. http://www.delorie.com/
  394.  
  395.  
  396. [traduction : Francois Charton deef@pobox.oleane.com]
  397.  
  398.