From:	"Damian Yerrick" <web DOT poison AT pineight DOT 8m DOT com>
Newsgroups:	comp.os.msdos.djgpp
Subject:	Read Me Third: The Short DJGPP FAQ List
Date:	Mon, 4 Oct 1999 10:36:46 -0500
Organization:	Rose-Hulman Institute of Technology
Lines:	203
Message-ID:	<7tahmc$ics$1@solomon.cs.rose-hulman.edu>
NNTP-Posting-Host:	yerricde.laptop.rose-hulman.edu
X-Trace:	solomon.cs.rose-hulman.edu 939051532 18844 137.112.101.169 (4 Oct 1999 15:38:52 GMT)
X-Complaints-To:	news AT cs DOT rose-hulman DOT edu
NNTP-Posting-Date:	4 Oct 1999 15:38:52 GMT
X-Priority:	3
X-MSMail-Priority:	Normal
X-Newsreader:	Microsoft Outlook Express 5.00.2314.1300
X-MimeOLE:	Produced By Microsoft MimeOLE V5.00.2314.1300
To:	djgpp AT delorie DOT com
DJ-Gateway:	from newsgroup comp.os.msdos.djgpp
Reply-To:	djgpp AT delorie DOT com

  Read Me First: readme.1st @ http://www.delorie.com/djgpp/
  Read Me Second: DJ Delorie's Weekly Mini-FAQ post for DJGPP
> Read Me Third: The Short DJGPP FAQ List
  Read Me Fourth: The DJGPP FAQ @ http://www.delorie.com/djgpp/v2faq/

This is not DJ Delorie's mini-FAQ list. This is a second list that answers
the
most frequently asked DJGPP-related questions on comp.os.msdos.djgpp
and other NGs in the c.o.m.* hierarchy.


Read Me Third: The Short DJGPP FAQ List
Most Frequently Asked Questions in comp.os.msdos.djgpp
By Damian Yerrick

Because many people do not have time to browse through the whole DJGPP FAQ
list, I created this extremely condensed version based on the most common
questions on c.o.m.d.
Read the original at http://www.delorie.com/djgpp/v2faq/
Read the latest short FAQ at
http://www.rose-hulman.edu/~yerricde/minifaq.txt


To be included in this list, a question must be related to DJGPP and
discussed in at least five separate threads in comp.os.msdos.djgpp and/or
comp.os.msdos.programmer. If a question is also answered in the full FAQ,
these five questions must have come within five weeks.


 1. Why DJGPP?
 2. Location of Info-ZIP
 3. I know C++. How do I enter my code into DJGPP?
 4. C++: linker "cannot open -lstdcx"
 5. Long file names
 6. How do I do (graphics)? How do I do (sound)? What is "spilled"?
 7. What is DPMI?
 8. How do I make a GUI?
 9. Help!


Q: I'm looking for a DOS compiler. Why DJGPP?

A: Watcom C++ was a payware C/C++ compiler that made 32-bit DOS binaries.
You
can recognize a program built with Watcom because it will generally come
with
the DOS extender DOS4GW.EXE. According to Sascha Bendinger
<digana AT t-online DOT de>, it has been shelved by Powersoft and is no longer
developed.

DJGPP, on the other hand, is a free C/C++ compiler that makes 32-bit DOS
binaries. DJGPP programs often come with a DOS extender called CWSDPMI, but
a
compatible extender is built into Windows 3.1 and later. Because DJGPP is a
port of the popular Linux compiler gcc, programs developed with DJGPP will
be
more portable (Davin McCall <DavMac AT iname DOT com>). And it fully supports long
filenames under Windows 95 and 98 (note: not NT).

"Well, for me it is one factor - price. I cannot spend the hundreds (or
thousands) I'll need to pay in my local currency for Watcom. Along with
that,
I sincerely believe DJGPP's "after sales support" (if you can term it that
for a free compiler) is 100% better, it is regularly updated, has
diversified
widely (GCC on which it is based is widely used on almost all Unix
implementations) it has a good track record (i. e. Quake was coded in it)
it produced fast code, is very stable, well debugged, etc - I have used it
extensively for a hobbist programmer and I have NEVER had ANY trouble that
could be attributed to a buggy compiler, preproccessor, assembler or
whatever.
Plus, tips and techniques for doing almost anything, from sound programming
to
high resolution hi color programming is widely and very importantly FREELY
available - which I am quite sure does not apply to Watcom in most
instances."
(Stefan Viljoen <rylan AT intekom DOT com>)


Q: WinZip wants to put each zipfile's contents into a new folder. How do I
unzip everything into C:\DJGPP?

A: Get unzip32 from the DJGPP Zip Picker, at http://www.delorie.com/djgpp/
Then install everything as directed in the README.


Q: How do I enter my code into DJGPP?

A: You can use any text editor and then use gcc from the command line, or
you
can use RHIDE, Robert Hoehne's Integrated Development Environment. If you
downloaded it from the DJGPP web site, and you installed DJGPP to c:\djgpp,
RHIDE should be at
c:\djgpp\bin\rhide.exe


Q: When I try to compile and link a C++ program in RHIDE, I get
  Error: C:/djgpp/bin/ld.exe: cannot open -lstdcx: No such file or directory
    (ENOENT)

A: RHIDE 1.4 was released when long file names were turned off.
See section 8.7 of the full FAQ list for a full explanation. The quick fix
for this problem is to add this line to c:\djgpp\share\rhide\rhide.env

  RHIDE_TYPED_LIBS_DJGPP.cc=stdcxx


Q: It still doesn't work. Now I get
  Error: C:/djgpp/bin/ld.exe: cannot open -lstdcxx: No such file or
directory
    (ENOENT)
Q: Why can't I use long file names under NT or plain DOS?

A: MS-DOS by itself does not support long file names such as
l i b s t d c x x . a
and neither does Windows NT's DOS emulator. You probably used WinZip
under Windows to unzip DJGPP (giving libstd~1.a according to plain DOS).
Ever wonder why I call it SinZip? Try reinstalling DJGPP using unzip32,
as described above. See also section 22.18 of the full FAQ list.


Q: How do I do (graphics)?
Q: How do I do (sound)?
Q: How do I do (mouse)?

A: The Allegro library by Shawn Hargreaves et al. handles the
keyboard, mouse, joystick, graphics, waves, and MIDI. It works on
Win32, Linux, DJGPP, and even the dreaded Watcom C++. Get it at
http://www.talula.demon.co.uk/allegro/
But make sure you get version 3.12 or later; otherwise, gcc 2.95 or later
will
give you

 src/cpu.c:64: Invalid `asm' statement:
 src/cpu.c:64: fixed or forbidden register 0 (ax) was spilled for class AREG

And note that Allegro, when built for DOS, will not be able to use SVGA
resolutions (anything over 320x200) under Windows NT because NT prohibits
the
sort of direct access required for SVGA. However, if you build with
Micro$oft
Visual C++, you'll get a Win32 program that uses DirectX.


Q: What is DPMI?
Q: When I try to run my program on my other computer, it gives me
Cannot load DPMI: get csdpmi*b.zip

A: DPMI, or the DOS Protected Mode Interface, is a method of
communication between 32-bit DJGPP programs and 16-bit PC DOS (MS-DOS,
DR DOS, FreeDOS). To run DJGPP programs in DOS mode (booting straight into
DOS as opposed to a DOS emulation box in Windows 9x), you'll need to get a
DPMI manager such as CWSDPMI. Download it from the DJGPP Zip Picker; then
unzip cwsdpmi.exe into a folder on your PATH.


Q: How do I give my DJGPP program a GUI?

A: Use Turbo Vision for a text-mode GUI. I don't have the URL,
but you can find it on
http://www.dogpile.com/
Use Allegro and its add-ons for an all points addressable (read [S]VGA) GUI.
http://www.talula.demon.co.uk/allegro/


Q: My program doesn't work. Can someone on c.o.m.d help?

A: The general consensus is that we'll help if you provide these five
things:

1. Version number of DJGPP, gcc, binutils, and any add-ons
   (Allegro, RSXNTDJ, etc.) you are using.
2. Your operating system (DOS? Sin95? 98? NT?)
3. The smallest source code fragment that produces the error.
4. The command line you are using to make the program.
5. Any error messages you get, and the output from symify.exe if there is a
   list of traceback EIPs.

Otherwise, we're not psychics. :-)


If you have any questions or comments, post them at comp.os.msdos.djgpp *or*
mail them to djgpp AT delorie DOT com; if they're the most frequently asked, they
may become part of this short FAQ list.

Damian Yerrick
http://pineight.webjump.com/


Looking for a book? Try Barnes & Noble.
http://bn.bfast.com/booklink/click?sourceid=9831085&categoryid=homepage
Hate spam?
http://www.mindspring.com/~lindellj/spam/


--
Damian Yerrick
CM 398, Rose-Hulman Institute of Technology
5500 Wabash Ave
Terre Haute, IN 47803
http://come.to/yerrick

- Raw text -