ReadMe.txt

June 21, 2018 · View on GitHub

Welcome to StarGen.

StarGen is a a random solar system generator, derived from the work of a great number of people over the past three dozen years. (See Credits.txt for details.) It's called StarGen because there are already enough versions that call themselves starform to be confusing. StarGen's preferred output format its Web pages.

There are 4 differen distributions available. All of them contain:

ReadMe.txt                  The file you are reading
Credits.txt                 The history of the program
help						A folder/directory containing
    Manual.html             The user's manual
    Manual2-Building.html	Software Developer's Manual
    WinStarGenHelp.html		Windows help
ref							A folder containing
	*.gif and Key.html		Images etc used in generated HTML
	*.jpg					Images used in the Manual

To get more detailed documentation, feed the file Manual.html in the help folder or directory to a Web browser or Help viewer that reads HTML files.

The Macintosh binary version (StarGen.sit) contains:

stargen						Mac OS X command line version
StarGen PPC                 Classic Mac version compiled for PPC
StarGen 68K                 Classic Mac version for the original Mac

The Windows binary version (StarGen.zip) contains: WinStarGen.exe Clickable Windows version StarGen.exe DOS command-line version

The source distributions (StarGenSource.zip and StarGenSource.sit) contain:

C sources                       The source code for the 
    *.c and *.h                 	program itself
Makefile                        Make file for Unix/Mac OS X
Macintosh-specific sources:		Specific sources for 
    mac_prefix.h StarGen.r 			the Mac version
    StarGen.prj			
Windows project files:          Project files for
    StarGen.dsp StarGen.dsw 		Visual C on Windows
    Stargen.rc resource.h

To build a Unix or Mac OS X version of StarGen, cd to the directory containing the files listed above and type

make

You may need to edit the Makefile if you are using a version of Unix or the GNU development tools very different from the Mac OS X and GNU C and make that I used for development and testing.

To build the Macintosh-native version you will need a copy of Code Warrior from Metrowerks. The supplied StarGen.prj file was created with version 2.1 of Code Warrior and so should work with any version from the last 5 years.

To build on Windows you will nee Visual C or to use the GNU development tools from the command line.

To get more detailed documentation on building StarGen, feed the file Manual2-Building.html in the help folder or directory to a Web browser or Help viewer that reads HTML files.

JimB. aka Brons Jim Burrows Eldacur Technologies brons@eldacur.com http://www.eldacur.com/~brons/