[an error occurred while processing this directive]
Node:<a name="What%20to%20download">What to download</a>,
Next:<a rel=next href="faq4_5.html">Disk space</a>,
Previous:<a rel=previous href="faq4_3.html">DJGPP by WWW</a>,
Up:<a rel=up href="faq4.html">Getting DJGPP</a>
<br>

<h2>4.4 What Files to Download?</h2>

<p><em><strong>Q</strong>: What's the minimum set of <code>.zip</code> files I need to download?</em>

<br><p>
<p><strong>A</strong>:  This depends on what you are planning to use DJGPP for.

<p>The following table lists required and recommended files by category. 
An alternative method of choosing the files suitable for your needs is
to <a href="http://www.delorie.com/djgpp/zip-picker.html">use the DJGPP zip-picker feature</a> which will guide you through the
process.

<br><p>
<ul>
<li>To only run DJGPP-compiled programs, you MUST download all of
these<a rel=footnote href="faq25.html"><sup>10</sup></a>:

<dl>
<dt><code>v2/readme.1st</code>
<dd>This explains how to install DJGPP and get started with using it.

<br><dt><code>v2/faq230b.zip</code>
<dd>The latest edition of this FAQ list.  Use it whenever you have problems
installing and using DJGPP.

<br><dt><code>v2/frfaq21b.zip</code>
<dd>This FAQ list translated into French by <a href="mailto:deef@pobox.oleane.com">Francois Charton</a>.

<br><dt><code>v2misc/csdpmi4b.zip</code>
<dd>CWSDPMI, the DJGPP free DPMI server.  DJGPP programs require DPMI
services, which provide a way to run 32-bit protected-mode programs
under real-mode MS-DOS.  (If you can get DPMI services in your
environment, like if you run under Windows, QDPMI, or OS/2, you don't
need CWSDPMI, but I recommend downloading it nonetheless so you can try
it in case you have trouble with other DPMI servers.)

<br><dt><code>v2misc/pmode11b.zip</code>
<dd>This is an alternative DPMI server, PMODE/DJ.  Its memory footprint is
smaller than CWSDPMI and it can be bundled with DJGPP programs to make a
stand-alone executable that doesn't require a DPMI server to run. 
PMODE/DJ doesn't support virtual memory and its implementation of the
DPMI spec is a bit more restricted than that of CWSDPMI, but it is
faster, and therefore more appropriate for high-performance interrupt
handling.

<br><dt><code>v2/djtzn203.zip</code>
<dd>This archive includes the <dfn>timezone</dfn> files, which are used by
several library functions and programs that call those functions, to
translate file time stamps between different time zones.  You will need
this archive if you run DJGPP-compiled programs that set file times for
files downloaded from a distant place; one example is an archiving
program such as <code>unzip</code> or Tar.  Most people will only need a
single file from this distribution.  See <a href="faq22_20.html">zoneinfo files</a>, for a detailed explanation
of these files. 
</dl>

<li>For developing C programs (no C<tt>++</tt>), you MUST download all of the above,
plus the following:

<dl>
<dt><code>v2gnu/gcc2952b.zip</code>
<dd>The GNU C Compiler binaries and docs (including the docs for the C<tt>++</tt>
compiler).

<br><dt><code>v2gnu/bnu281b.zip</code>
<dd>The GNU Binutils, including <code>as</code>, the GNU assembler; <code>ld</code>, the
GNU linker; and their docs.  GCC calls these utilities during
compilation.

<br><dt><code>v2/djdev203.zip</code>
<dd>C header files and libraries, library reference, minimal development
environment (including assembly-level debuggers), DJGPP-specific
utilities and their documentation.  Required to compile/link C programs.

<br><dt><code>v2gnu/txi40b.zip</code>
<dd>Info, a stand-alone program to read GNU hypertext documentation files, and
an environment to produce such files.  Without <code>info</code>, you cannot
read the C library reference and the docs included with the ported GNU
software packages.  This package also includes the <code>install-info</code>
utility, which helps to install Info docs of optional utilities that you
download.  Several files required to format Texinfo docs for printing
are also included. 
</dl>

<li>For developing C<tt>++</tt> programs, you will need all of the above, plus the
following:

<dl>
<dt><code>v2gnu/gpp2952b.zip</code>
<dd>The GNU C<tt>++</tt> compiler, (the docs are part of the gccNNNb.zip package,
see above), the C<tt>++</tt> header files and standard C<tt>++</tt> class
libraries, including the STL, and their docs.

<br><dt><code>v2gnu/lgp2952b.zip</code>
<dd>Additional GNU C<tt>++</tt> class libraries.  This library is now deprecated
and no longer maintained.  I suggest not to use it.

<br><dt><code>v2gnu/objc2952b.zip</code>
<dd>If you want to develop Objective-C programs, you will need this file,
which includes the Objective-C compiler and header files.  More
information about Objective-C is available <a href="http://www.virtualschool.edu/lang/objectivec/">from Brad Cox's home page</a>.  Many Objective-C related
links can be found at
&lt;<code>http://www.sente.ch/cetus/oo_objective_c.html</code>&gt;. 
</dl>

<li>For developing Fortran programs, you will need the C development tools
(no need to download C<tt>++</tt> compilers and libraries), plus the
following:

<dl>
<dt><code>v2gnu/g772952b.zip</code>
<dd>The GNU f77 compiler and libraries. 
</dl>

<li>The following are some optional packages which you might want:

<ul>
<li>Debugging:

<dl>
<dt><code>v2gnu/gdb418b.zip</code>
<dd>GDB, the GNU Debugger and its docs.  (Note that the <code>djdev</code>
distribution includes two simpler, assembly-level debuggers,
<code>edebug</code> and <code>fsdb.</code>  The latter presents a user interface
similar to that of Turbo Debugger.) 
</dl>

<li>Additional development tools (consider getting at least the Make
distribution):

<dl>
<dt><code>v2gnu/mak3781b.zip</code>
<dd>GNU Make program with its docs.  (Make is a program that can
automatically compile/link a program given the description of
dependencies between the various source and object files, on a special
file called <code>Makefile</code>.)  You should install Make 3.75 or later if
you use DJGPP v2.01 (previous ports of Make have subtle
incompatibilities with v2.01 tools).  The DJGPP port of Make supports
Unix-style shells (as well as DOS <code>COMMAND.COM</code> and its
<code>4DOS</code>/<code>NDOS</code> replacements) and can be used to run Unix
Makefiles if you install a Unix-style shell (e.g., <code>bash</code>) and
auxiliary utilities.  It also supports long filenames on Windows 9X and
MS-DOS pathnames with drive letters.

<br><dt><code>v2apps/rhide14b.zip</code>
<dd>The <small>RHIDE</small> integrated development environment for DJGPP (similar to
Borland IDE), written by <a href="mailto:robert.hoehne@gmx.net">Robert Hoehne</a>. 
The latest version features an integrated debugger, based on GDB code; a
stand-alone version of GDB with a Turbo Vision interface (but not all
GDB features can be used); and support for user interface in languages
other than English (using a port of GNU <code>gettext</code> library).  Latest
developments and beta versions of <small>RHIDE</small> are available <a href="http://www.tu-chemnitz.de/~sho/rho/rhide.html">from <small>RHIDE</small> home page</a>.  Binaries
of an improved beta version is available <a href="http://www.lanet.lv/~pavenis/rhide.html">from Andris Pavenis's home page</a>; this version uses TVision
v1.0.9, <small>SETEdit</small> v0.4.39, and its debugging engine is based on
GDB 4.18 and DJGPP debug support from a pretest version of v2.03.

<br><dt><code>v2/djlsr203.zip</code>
<dd>The sources of the DJGPP C library and utilities written specifically
for DJGPP.  If you can afford the disk space (it requires about 10MB), I
recommend installing or at least downloading it, so you can easily fix
possible library bugs.  Note that beginning with DJGPP v2.02, the
sources for the time-zone-related programs and files are available
separately, in the <code>djtzs203.zip</code> archive.

<br><dt><code>v2gnu/bsh203b.zip</code>
<dd>Bash (<code>Bourne-Again SHell</code>), the GNU shell, and its docs.  If you
mostly work in Unix environment, you will feel right at home using
<code>bash</code> as your interactive shell.  It is also great as a batch
shell for running Unix-born shell scripts and Makefiles when these are
too complex to convert them to MSDOS.  If you install <code>bash</code>, you
should also install auxiliary utilities (Fileutils, Textutils, Sh-utils,
Grep, Diffutils, Findutils, Sed and Gawk) as these are usually invoked
from many shell scripts and Makefiles.

<br><dt><code>v2gnu/bsn125b.zip</code>
<dd>Bison, a Yacc-like parser generator, and its docs.  You will need it if
you intend to build a compiler or a parser for some language.

<br><dt><code>v2gnu/acnf213b.zip</code>
<dd>Gnu Autoconf, a tool for producing shell scripts that automatically
configure software source code packages to adapt to target platforms.

<br><dt><code>v2gnu/dif272b.zip</code>
<dd>GNU Diffutils (diff, cmp, diff3, sdiff), and their docs.  If you need to
submit patches or changes to DJGPP or GNU sources, you will need the GNU
<code>diff</code> program from this package.  <code>diff</code> is also required by
almost all configuration-management packages, such as <small>RCS</small> and
<small>CVS</small>.

<br><dt><code>v2gnu/emacs.README</code>
<dt><code>v2gnu/em2005*.zip</code>
<dd>GNU Emacs, the most powerful, customizable, extensible programmer's
editor known today.  The DJGPP port supports mouse, menu bar, pop-up
menus, color syntax highlighting, reading Info documentation and
compilation from within the editor, long filenames on Windows 9X, and
much more.  Emacs can and should be used as an integrated development
environment (another alternative is <small>RHIDE</small>, see above).  Please
read the file <code>emacs.README</code> before you begin downloading the rest.

<br><dt><code>v2gnu/fil316b.zip</code>
<dd>GNU Fileutils, including <code>ls</code>, <code>rm</code>, <code>cp</code>, <code>mv</code>, and
others.  Highlights of the latest port: <code>ls</code> supports colorization
of files (like on Linux), <code>ln -s</code> knows about DJGPP-style
"symlinks" (see <a href="faq22_5.html">symlink feature of DJGPP</a>, elsewhere in this document), <code>install
-s</code> will strip executables on the fly, and all the utilities support
long filenames on Windows 9X and numbered backups (even on plain DOS). 
This package is a must if you want to run Unix shell scripts, as they
use some of these utilities <em>a lot</em>.

<br><dt><code>v2gnu/find41b.zip</code>
<dd>GNU Findutils, including <code>find</code>, <code>xargs</code>, and <code>locate</code>. 
These programs are used to process a group of files which share some
common attributes, like the file name pattern, read/write permissions,
file time-stamps, etc.  Since DOS has its own, incompatible program
called <code>find.exe</code>, you will need either to make sure DJGPP's
<code>bin</code> subdirectory is before the <code>C:\DOS</code> directory (for
DOS and Windows 3.X) and <code>C:\WINDOWS\COMMAND</code> directory
(for Windows 9X) on your <code>PATH</code>, or to rename the DOS <code>find</code>
program to some other name.  If you don't, you might see the following
message when you try to run <code>find</code>:

<pre> FIND: Parameter format not correct
</pre>

<br><dt><code>v2gnu/flx254b.zip</code>
<dd>Flex, a Lex-like lexical analyzer generator, and its docs.  Required to
build compilers or programs which break streams of characters into
lexical tokens.  Used a lot in conjunction with Bison, a parser
generator.

<br><dt><code>v2gnu/gwk304b.zip</code>
<dd>GNU Awk, an interpreter for a powerful text-processing language with
many built-in functions.  Gawk is also invoked by many shell scripts, so
if you use Bash or need to run shell scripts, you should download Gawk.

<br><dt><code>v2gnu/grep24b.zip</code>
<dd>GNU Grep package and its docs.  The programs of this package are used to
search for strings or regular expressions within files.  You will also
need this if you use Emacs (which has commands that invoke Grep) or if
you want to run Unix shells and Makefiles.

<br><dt><code>v2gnu/idu32db.zip</code>
<dd>GNU Id-utils and their docs.  These utilities are used to quickly search
for tokens in all the files that comprise a directory tree (e.g., a
large project).  They are similar to <code>Grep</code>, but much faster, and
their notion of a token is sensitive to the source language of the
scanned file, so they are more appropriate e.g. for searching variable
names in C source files.

<br><dt><code>v2gnu/pat254b.zip</code>
<dd>GNU Patch program and docs.  Required to apply patches to sources given
a source-level patch-file generated by <code>diff</code>.

<br><dt><code>v2gnu/perl552b.zip</code>
<dd>Perl, a powerful scripting and text-processing language implemented as
an interpreter.  Many sophisticated scripts, like
<code>texi2html</code><a rel=footnote href="faq25.html"><sup>11</sup></a>, use Perl.  In particular, the GNU Automake package is
implemented as a Perl script.

<br><dt><code>v2gnu/sed302b.zip</code>
<dd>GNU Sed (a batch editor) program and its docs.  Many ported packages
require it during the build process on MSDOS.

<br><dt><code>v2gnu/shl112b.zip</code>
<dd>GNU Sh-utils.  A must if you use the port of <code>bash</code> or want to run
Unix Makefiles, but some utilities (such as <code>env</code> or <code>test</code>)
can also be very useful on their own right.

<br><dt><code>v2gnu/txt20b.zip</code>
<dd>GNU Textutils.  Includes many useful programs, such as <code>sort</code>,
<code>wc</code>, <code>cat</code>, <code>join</code>, <code>paste</code>, <code>od</code>, and
<code>uniq</code>.  Unix shell scripts and Makefiles call some of these
<em>a lot</em>, so you should install this package if you run them. 
</dl>

<li>Developing text-mode and graphics GUI applications:

<dl>
<dt><code>v2tk/grx23.zip</code>
<dd>A graphics library for DJGPP.  Note that it is still in development, so
some advanced features might not work.  GRX is quite portable to other
operating systems: it is known to work with several DOS compilers,
including Borland and Watcom; on Linux with svgalib and X11, and on
several Unix platforms with X11R5 or later version of X-Windows.  Also,
GRX is the only library that supports printing out graphics images
(check out the <code>addons/print</code> directory in the GRX distribution). 
A significant drawback of GRX is that its docs is <em>very</em> outdated
and incomplete.

<a href="mailto:hsc@techfak.uni-kiel.de">Hartmut Schirmer</a> is the current
maintainer of GRX.  GRX is distributed under the GNU Library License
(a.k.a. LGPL).  Latest versions of GRX, including fixes to known
problems and plans for future developments can be found on the <a href="http://www.gnu.de/software/GRX/">GRX home page</a>.

<br><dt><code>v2tk/bcc2grx.zip</code>
<dd><a name="BCC2GRX"></a>
The interface library to convert Borland graphics calls into calls to
GRX library functions.

<br><dt><code>v2tk/allegro/alleg312.zip</code>
<dd>A recursive acronym for <dfn>Allegro Low LEvel Game ROutines</dfn>, Allegro
is a powerful game-writing and graphics library.  It is also an
alternative to GRX (see above), even if you don't need to develop a
game.  It is somewhat less portable than GRX to other operating systems,
but its documentation is significantly better and up-to-date.  Unlike
GRX, Allegro is <em>not</em> under LGPL, it is free.  A port of Allegro to
Win32 and to Linux is in the works (initial versions are available).

<p>By popular demand, Allegro now has its mailing list.  To post a message
to the list, send email to <a href="mailto:allegro@canvaslink.com">allegro@canvaslink.com</a>.  To
subscribe to the Allegro list, send a message to
<a href="mailto:listserv@canvaslink.com">listserv@canvaslink.com</a> with the text <code>subscribe allegro
{your full name}</code>.  Another related resource is the <a href="http://www.talula.demon.co.uk/allegro/">Allegro home page</a>.

<br><dt><code>v2tk/pdc22.zip</code>
<dd>A public-domain Curses library, for programming text-mode user-interfaces
which are portable to Unix or ported from Unix.

<p>Version 2.3 of PDCurses was released.  It is available <a href="ftp://ftp.lightlink.com/pub/hessling/PDCurses/">via FTP</a>. 
</dl>

</ul>

<p>Note that all of the packages have source distributions
(<code>*s.zip</code>) which you can download in case you discover a bug, or
want to know more about how the tools work.  The companion <code>*d.zip</code>
files hold the documentation for the package converted into HTML, DVI
and PostScript formats.

<p>For description of additional files not mentioned here, get the file
<code>00_index.txt</code>; it contains a full list of the distribution files and a
short description of every file. 
</ul>

<p><hr>
[an error occurred while processing this directive]