INSTALL

Installing Formosa BBS Community Edition (FBCE)
	__________________________________________________________________

	Table of Contents
	Preface
	1. General Installation Considerations
	2. Source Installation on Unix systems

		Ubuntu/Linux Pre-install packages
		Linux installation notes
		Non-Linux OS installation notes

	3. Binary Installation on Unix systems

		Gentoo/Linux installation notes
		Debian GNU/Linux installation notes
		Ubuntu/Linux installation notes
		CentOS installation notes
		FreeBSD installation notes
		Mac OS X installation notes
		Solaris installation notes

	4. Problems?

		Read the FAQ
		Bug reports

	5. Runtime Configuration

		The configuration file
		How to change configuration settings

	6. Installation FAQ
	__________________________________________________________________

Preface

	These installation instructions were generated from the HTML version
	of the FBCE Manual so formatting and linking have been altered.
	See the	online and updated version at: <URL><TBD>
	__________________________________________________________________

Chapter 1. General Installation Considerations

	Source getting:
	http://github.com/pigfoot/formosa/tree/master
	Binary getting:
	__________________________________________________________________

Chapter 2. Source Installation on Unix systems

	The initial FBCE setup and configuration process is controlled by the
	use of the command line options of the configure script. You could get
	a list of all available options along with short explanations running
	./configure --help. Our manual documents the different options
	separately. You will find the core options in the appendix, while the
	different extension specific options are descibed on the reference
	pages.

	When FBCE is configured, you are ready to build the module and/or
	executables. The command make should take care of this. If it fails
	and you can't figure out why, see the Problems section.

	Prerequisite software for compiling:

		* GNU Compiler Collection: version 3.4.6+
		(http://gcc.gnu.org/)
		* Perl: version 5.8+
		(http://www.perl.org/)
		* GNU Make: version 3.8+
		(http://www.gnu.org/software/make/)
		* GNU M4: version 1.4+
		(http://www.gnu.org/software/m4/)
		* GNU Autoconf: version 2.59+
		(http://www.gnu.org/software/autoconf/)
		* GNU Automake: version 1.10+
		(http://www.gnu.org/software/automake/)

	Supported platforms:

		* Gentoo/Linux 2.6+
		* Debian GNU/Linux 2.6+
		* Ubuntu/Linux 2.6+
		* CentOS 5+
		* FreeBSD 7+
		* Mac OS X
		* Solaris 10+

Ubuntu/Linux Pre-install packages

1.	apt-get install make
2.	apt-get install m4
3.	apt-get install automake
4.	apt-get install autoconf
5.	apt-get install perl
6.	apt-get install git-core
7.	apt-get install gcc
8.	apt-get install libc6-dev
9.	apt-get install ncurses-dev

Linux installation notes

1.	git clone git://github.com/pigfoot/formosa.git
2.	cd formosa
3.	./autogen.sh
4.	./configure --prefix=$homebbs --enable-feature=
5.	make
6.	make install

Non-Linux OS installation notes

1.	git clone git://github.com/pigfoot/formosa.git
2.	cd formosa
3.	./autogen.sh
4.	./configure --prefix=$homebbs --enable-feature=
5.	gmake
6.	gmake install

	__________________________________________________________________

Chapter 3. Binary Installation on Unix systems

Gentoo/Linux installation notes

1.	gunzip fbce-gentoo-x86-x_x_x.tar.gz
2.	tar -xvf fbce-gentoo-x86-x_x_x.tar
	__________________________________________________________________

Chapter 4. Problems?

Read the FAQ

	Some problems are more common than others. The most common ones are
	listed in the FBCE FAQ, part of this manual.
	__________________________________________________________________

Bug reports

	* Use bug-tracking system
	If you think you have found a bug in FBCE, please report it. The FBCE
	developers probably don't know about it, and unless you report it,
	chances are it won't be fixed. You can report bugs using the
	bug-tracking system at <URL><TBD>. The bug system is also suitable
	to submit feature requests.

	* Use mailing-list
	Please mailto:formosabbs@googlegroups.com?subject=[FBCE BUG]

	* Use BBS
	Please telnet://bbs.CDPA.cc FormosaBBS board.
	__________________________________________________________________

Chapter 5. Runtime Configuration

The configuration file
	__________________________________________________________________

How to change configuration settings
	__________________________________________________________________

Chapter 6. Installation FAQ