----------------------------------------------------------------
        X-GALAXY project    version 1.00        Install Manual  
                Copyright(C)1992-2001   G-HAL & ubora           
----------------------------------------------------------------

== Requires

	OS, Library, and so on...
		 UNIX like OS.
		 X11, XFree86, or Compatible Window System.
		Only X11/Xt was need.
		 If use the ScreenSaver function,
		Need X server extension: MIT-SCREEN-SAVER, and libXext.
	Machine-Architecter
		 Required the machine, that can run UNIX like OS.
	CPU
		 Fast, Fast, Fast.
		 If you use X-GALAXY with full power,
		The load average exceeds 1.0, maybe.
	FPU
		 Unnecessary, perhaps.
	Memory
		 Need a few mega bytes, probably.
		If use swap, it'll be endurance test of disk.
	Graphic-Accelerater
		 Supported by X window system, and fast.
		The function of 3D acceleration is un-necessary.
	Sound
		 Un-necessary.
	Mouse
		 Use 3 button mouse.
	
	Tested Environment
		FreeBSD 3.5			XFree86 3.3.6
		FreeBSD 4.1.1			XFree86 3.3.6
		SunOS 5.6 sun4u sparc SUNW Ultra-5_10	X11R6
		Linux kernel-2.0.38(rt-linux 1.3 patched)XFree86 4.0
	
	Tested Environment (OLD)
		FreeBSD 3.2			XFree86 3.3.5
		FreeBSD 2.2.8			XFree86 3.3.5
		FreeBSD 2.2.8			XFree86 3.3.3
		NetBSD-pc98(NetBSD 1.4.1 based)	XFree86 3.3.5
		OpenBSD 2.5 i386		XFree86 3.3.2
		Linux kernel-2.0.36(rt-linux 1.2 patched)XFree86 3.3.3.1



== How to Install

  1)  Expand source archive to some directory.
	> lha x xglx*.lzh
     or
	> tar -zxf xgalaxy-*.tar.gz

  2)  Examine X server with xdpyinfo,
     Support MIT-SCREEN-SAVER extensions or not.
      If X server don't support MIT-SCREEN-SAVER,
     You can't use ScreenSaver function.
     Edit the file "src/xgalaxy.h",
     and change "#define USE_SAVER" to "#undef USE_SAVER".

  3)  Examine X server with xdpyinfo,
     Support MIT-SHM extensions or not.
      If X server don't support MIT-SHM,
     edit the file "src/xgalaxy.h",
     and change "#define USE_XSHM" to "#undef USE_XSHM".
      If you set no use SHM when you build kernel,
     Change undef, too.

  4)  Select language.
     In src/ directory, Make symbolic link to "msg.h"
     from "msg_jp.h" or "msg_eng.h", which your favorite one.

  5)  Build "Makefile".
      Run xmkmf,
	> xmkmf -a
     And builded automaticaly.

  6)  Build all source.
      Run
	> make
     Or
	> gmake

  7)  Install to your favorite directory, or do nothing.
      If you have root permission, run and automaticaly installed
	> make install
     And other way, manual install
	> install -c -s ./src/xgalaxy /usr/X11R6/bin/
     Somebody use
	> cp ./src/xgalaxy ~/bin/
      There are many ways, and I can't describe all.

  8)  Setting X resource.
     If install automaticaly with root permission, reboot X.
     Otherwise, use xrdb and do manual reload.
	> xrdb -merge XGalaxy.ad
     If you want, edit this file, before reload.

  9)  Install manuals, if you want.
     Automaticaly install with
	> make install.man
     Otherwise, manual install use install command
	> install -c -m 0444 ./xgalaxy.man /usr/X11R6/man/man1/xgalaxy.1
	> install -c -m 0444 ./xgalaxy.jman /usr/X11R6/man/ja/man1/xgalaxy.1
     Somebody use cp
	> cp ./xgalaxy.jman ~/man/man1/xgalaxy.1
      There are many ways, and I can't describe all.

  Z)  If you have any question, come to www.fenix.ne.jp and ask,
     And then, somebody will reply, probably, maybe, perhaps...



				--- G-HAL ---
				/// Sun,07 Jan,2001 ///