
Unofficial HeroesDen version of FreeGLUT - Readme (source code)
--------------------------------------------------------------------------------


Steps for building libraries and demonstation applications:


1)	Install Borland C++ Compiler v5.5.1 with command line tools. Perhaps, to
	avoid any technical difficulties in the future it is preferably to choose
	installation path without spaces and non-latin characters. The default path
	is a good choice:

		C:\Borland\BCC55\

	In 2000 Inprise Corporation released free version of this awesome compiler.
	Official webpage "www.borland.com/bcppbuilder/freecompiler/" contained
	installation file is not available anymore. One of the places where the
	compiler can be downloaded is the Internet Archive:

		https://archive.org/details/freecommandLinetools

	Also Inprise Corporation released free version of Turbo Debugger v5.5. It
	may be useful for big projects. Early it was available on
	"www.borland.com/bcppbuilder/turbodebugger/" webpage but not anymore. Saved
	copies of the debugger can downloaded from web-archives of abandonware:

		https://vetusware.com/download/Turbo Debugger 5.5/
		http://old-dos.ru/files/file_1403.html


2)	Create "bcc32.cfg" file in the "bin" directory of installed tools which
	will set up compiler's options. Add path to the "include" directory with
	header files (-I switch) and path to the "lib" directory with libraries
	(-L switch):

		-I"C:\Borland\BCC55\include"
		-L"C:\Borland\BCC55\lib"

	Create "ilink32.cfg" file in the "bin" directory which will set up linker's
	options. Add path to the library directory (same -L switch):

		-L"C:\Borland\BCC55\lib"

	A lot of useful information about these compiler, linker and debugger was
	contained in VIDE Reference Manual by Bruce E. Wampler. His official
	website "www.objectcentral.com" is for sale now and there is no any files.
	Copy of the manual can be found on:

		http://www.picallw.com/zip/vide/bcc32.html


3)	Download and extract archive with FreeGLUT source code. With text editor
	open "build.bat" batch script and change path to the compiler's "bin"
	directory ($BIN variable) and set up targets ($BUILD_* variables). By
	default all targets are switched on. To disable a target change the value
	of associated variable to 0.

		SET $BIN=C:\Borland\BCC55\bin

		SET $BUILD_LIB_DEBUG=1
		SET $BUILD_LIB_RELEASE=1

		SET $BUILD_DLL_DEBUG=1
		SET $BUILD_DLL_RELEASE=1

		SET $BUILD_DEMO_LIB_DEBUG=1
		SET $BUILD_DEMO_LIB_RELEASE=1

		SET $BUILD_DEMO_DLL_DEBUG=1
		SET $BUILD_DEMO_DLL_RELEASE=1


4)	Run Command Prompt (cmd.exe), go to the folder with extracted source code,
	run "build.bat". After building you can get binaries from following
	directories:

		exe\ - demonstation applications.
		lib\ - libraries for static linkage.
		dll\ - dynamic-link libraries.

5)	To remove intermediate files of compiling process run "clean.bat".

6)	To remove built targets and intermediate files of compiling process run
	"distclean.bat".


--------------------------------------------------------------------------------

Unofficial FreeGLUT builds on https://www.heroesden.link/.

Email address for any questions, complaints or suggestions:
mailbox@heroesden.link.

