               ____
            . /    \  Jeeves4k. (c)2001 by bliss
          .:: \__/ /__  ________  ______  ______
          _____/   __ \/ __  __ \/   __ \/_  __/
          \    / /   _/\  __/_\ /  /  __/_\  \
           \____/ \__________/ /__/ \________/ 4k.

  Hi!

 [intro]

  You're reading the readme.txt for Jeeves4k, my attempt at a
  skeleton for win32 4k intro development in 100% assembler.

  To build the .asm the following tools/libraries are required:

    - gnu make -- FIXME: by ...
      	A win32 version of gnu make. I used a version 3.77 included
      	with mingw32, presumably any port will do (I use some long
      	file names so a DOS port may not work).
      FIXME: url.

    - nasm -- The Netwide Assembler
      	I used the windows version of nasm 0.98.
      FIXME: url.

    - alink -- by Anthony A.J. Williams <anthony_w@geocities.com>
    	This is used to link the object file produced by nasm.
        the win32.lib available at the site is also required.
      URL: http://www.geocities.com/SiliconValley/Network/4311/al_al.zip
      URL: http://www.geocities.com/SiliconValley/Network/4311/win32lib.zip

    - win32n.inc v0.6 -- by Tamas Kaproncai <tomcat@szif.hu>
      URL: http://rs1.szif.hu/~tomcat/win32/win32n.zip

    - apack -- by Joergen Ibsen / Jibz
        Used to compress the final target.
      URL: http://members.nbci.com/jibz/apack/apack099.zip

    - tar -- FIXME: by ...
      Only for `make dist', i think i'm using a cygwin port.

  When you've installed all those tools, edit the Makefile to
  make sure the filenames and paths of some tools are correct
  and type make (or gmake on some installations).

  The Makefile also supports the following targets:

     release	- build release version (i.e. apack the binary)
     clean	- remove intermediate files (using clean.bat).
     dist	- package the distribution (using dist.bat)

  For more information on the internals of the intro itself
  please read the source (jeeves.asm).


 [acknowledgments]

  Besides the abovementioned tools there's some other resources
  which have been helpful:

    - PE header
        While toying with the PE header i've used an excellent
        doc on the PE header written by B. Luevelsmeyer
	<bernd.luevelsmeyer@iplan.heitec.net>. Also there's
        a bit of info in hugi #21 as well.
      FIXME: URL: pe1.zip
      FIXME: URL: hugi #21

    - win32 asm
        Besides win32n.inc there's also some useful links on
        win32 asm coding at Tamas Kaproncai's site.
      URL: http://rs1.szif.hu/~tomcat/win32/

    - opengl/directx in asm
 	Some info on writing opengl and directx code in asm.
      URL: http://www1.eurosoft.od.ua


 [credits]

  tharsis:  all audio code, sound effects and music.
  warp:     all visual code, system code, graphics and design.

  well, that's the intention anyway, it's not an intro just yet ;-)


 [thank you!]

  I'd like to thank the following people for keeping the
  open source demoscene alive:

  smoke, avoozl, cavey, zarq, jylam, xef4, violator, burp,
  rigel, and the other people in #demoscene on openprojects
  irc (http://openprojects.nu).


 [bye]

  Bliss homepage is at <www.demonic.demon.nl>
  Don't hesitate to mail me for any reason,

  -- Warp <warp-tmt@dds.nl>.


 [license]

    Jeeves4k, Copyright (C) 2001 Bliss

    This program is free software; you can redistribute it and/or
    modify it under the terms of the GNU General Public License as
    published by the Free Software Foundation; either version 2 of
    the License, or (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; see the file copying.txt; if not, write to
    the Free Software Foundation, Inc.,
    59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

