# dosbox/cfg - "Build" settings for package

#---------------------------------------------------------------------

[technotes]

1. General points:

      a. For  basic instructions,  execute the command  "intro" at the
         "dosbox" command-line level.

      b. To make a Linux directory accessible  to a  "dosbox" session,
         execute a command similar to the following:

         mount c /tmp/dir

         Substitute the appropriate  Linux  directory path for  "/tmp/
         dir". This command will map C: (under "dosbox") to the speci-
         fied Linux directory. To map additional directories, use sim-
         ilar commands with different drive letters.

      c. To  switch a  "dosbox" session into (or  out  of)  fullscreen
         mode, press Alt-Enter.  Note:  The "dosbox" session must have
         "focus" at the time.

      d. If  "dosbox" detects  that  you're running a  mouse-based DOS
         program on its  emulated system,  it'll take  control  of the
         mouse.  You won't  be able  to use  the mouse (or Alt-Tab) to
         leave  the "dosbox" window until "dosbox" releases the mouse.
         To make "dosbox" release the mouse,  press Control-F10 (where
         F10 is the "F10" key).

      e. To give control of the mouse back to "dosbox", press Control-
         F10 again  (or run a  mouse-based DOS program  under "dosbox"
         and click in the "dosbox" window).

      f. Control-C doesn't work under "dosbox".

#---------------------------------------------------------------------

2. Warning:  The "dosbox" ".conf"-file format may change  from release
to release.  Therefore, you may need to  update  old ".conf" files be-
fore you can use them with new releases.

#---------------------------------------------------------------------

3. According to one "dosbox" user,  if you're  trying to run  a badly-
"pixelated" game, and your system supports OpenGL, it may be benefici-
al to  specify  the following settings in  the game's "dosbox" ".conf"
file:

      fulldouble=false
      fullresolution=1024x768
      output=opengl
      scaler=none

However, as of late 2008, this hadn't been tested.

#---------------------------------------------------------------------

[buildtimes]

00.03 hours (or 001.93 minutes) - HP EliteBook 8560w 32GB RAM
00.03 hours (or 002.00 minutes) - ThinkPad E540 i7 4x2 16GB RAM
00.05 hours (or 003.23 minutes) - Dell Inspiron 6400 2.0 GHz Intel Duo
                                  7200 2GB RAM
00.20 hours (or 011.98 minutes) - Compaq 1.7 GHz Intel Pentium 4 512MB
                                  RAM

#---------------------------------------------------------------------

[settings]
build    = default
defer    = glibc64
exepack  = yes
ldbefore = -lX11 -lc
license  = See "license*.txt" in installed tree
licfile  = COPYING
tmpsize  = 85M

setpaths = xorg

#---------------------------------------------------------------------

[depends]
actools
alsa
gawk
grep
libpng
sdl
slang
xorg                            # plus OpenGL
zlib

#---------------------------------------------------------------------

[configure]
MANBASE=$PKGDIR_PROD/man
mkdir -p $MANBASE

bash ./configure \
    --prefix=$PKGDIR_PROD          \
    --build=$LACARCHBUILD          \
    --host=$LACARCHHOST            \
    --disable-debug                \
    --disable-dependency-tracking  \
    --mandir=$MANBASE

#---------------------------------------------------------------------

# Original URLs. These URLs were valid at one point, but may have died
# since then. If you download newer versions of tarballs [etc.], don't
# delete  the  original versions,  as you may not  be able  to replace
# them.

[urls]
url_debian  = Not checked yet
url_home    = http://dosbox.sourceforge.net/
url_lfs     = n/a

url_tarball = http://downloads.sourceforge.net/\
dosbox/dosbox-0.74-3.tar.gz

#---------------------------------------------------------------------

[history]
180903 Updated from 0.74 to 0.74.2
211017 Updated to 0.74.3