Next:
podindex
Previous:
README
 [Index]

README.english



README

  BBBike - a route-finder for cyclists in Berlin and Brandenburg

INSTALLATION

General

You can find the newest distribution file of BBBike in the directory http://prdownloads.sourceforge.net/bbbike . The current source version is http://prdownloads.sourceforge.net/bbbike/BBBike-3.11.tar.gz .

FreeBSD

For FreeBSD, there is since 3.0-RELEASE a port for BBBike in the category german. For older versions of FreeBSD, you can find the port at http://www.freebsd.org/cgi/ports.cgi?query=bbbike&stype=all. If you don't have the BBBike port, you can install BBBike like in other UNIX's.

Linux, Solaris, other UNIX operating systems

First, you have to install perl5. Most operating systems have perl already bundled. Otherwise you can find perl5 at http://www.perl.com. You need at least version 5.005.

Next step is to extract the BBBike distribution:

	zcat BBBike-3.11.tar.gz | tar xfv -

If perl/Tk (the recommended version is 800.024) is not installed: change to the directory BBBike-3.11 and type as super user:

	perl -I`pwd` -MCPAN -e "install Bundle::BBBike_small"

Perl/Tk will be fetched over the internet, get compiled and installed. After that, you can start the program with

	perl bbbike

To compile some XS modules (this is optional) and install the panel entry for KDE, type:

	perl install.pl

You can also use Bundle::BBBike instead of Bundle::BBBike_small. This will install more Perl modules, some of them only useable for the development, but some of them enabling more features of BBBike.

Windows 95/98/2000/NT BBBike and Perl need approx. 32 MB hard disk space.

Download the file http://prdownloads.sourceforge.net/bbbike/BBBike-3.09-Windows.zip and extract this file with WinZip. To start BBBike just click on the icon bbbike.bat in the directory BBBike-3.09-Windows.

Optional you can install BBBike to C:\BBBike with setup.bat. This will also create an entry in the start menu. After the installation with setup.bat you can delete the old extracted directory.

Alternative Windows Installation (1)

As an alternative, you can install BBBike just with the sources. Steps for Windows 95/98/2000/NT users:

Alternative Windows Installation (2)

If you have Cygwin (http://www.cygwin.org/) installed, you can start a bash shell and follow the UNIX instructions.

Alternative Windows Installation (3)

As an further alternative, you can download an older distribution with Tk included:

http://www.perl.com/CPAN/ports/win32/Standard/x86/perl5.00402-bindist04-bc.tar.gz

You have to extract this file with WinZip or gunzip+tar. In the extracted directory, there will be the installation program install.bat. Call this program in the MSDOS prompt and follow the instructions.

If you're using this old version of perl (5.004_02), you also need an old version of BBBike, at least older than version 3.00.

Windows 3.1

Users of Windows 3.1 have to alternatives: using the command line interface with a version of perl5 for Windows 3.1 (e.g. http://www.perl.com/CPAN/ports/win16/LMOLNAR/perl5.00402-bindist01-dos-djgpp.zip).

If you want to use the Tk interface, you have to install Win32s (the file is called PW1118.EXE) and then install the perl5 distribution for Windows95 (see above).

For more information please send a mail to the author.

EXECUTION

To execute BBBike on Unix, change to the bbbike directory and type

	perl bbbike

in the shell. With a full KDE installation, there is an icon in the application menu item of the start menu. On Windows, there is also an start menu entry for BBBike.

To switch the English language support, please set the LANG environment variable to "en". For Unix, this could be done with

	env LANG=en perl bbbike

BBBike is a memory and cpu hog. You need at least 16 MB RAM on i386 platforms (Solaris needs at least 32 MB), but with 32/64 MB it will work better. Some versions of BBBike are tested with: Solaris-2.5, Solaris 8, FreeBSD-3.5, Linux Suse 6.4, Linux Suse 7.0, Windows 95, Windows 98, Windows NT 4.0, Windows 2000. The development machine runs with FreeBSD.

WWW version

There is a simple cgi version at

http://www.bbbike.de

More information for the CGI version at:

http://www.bbbike.de/info=1

Command line version

Cbbbike is a simple command line version of the program.

DOCUMENTATION

The documentation can be accessed in pod format (bbbike.pod) or in html format (bbbike.html). You can read the pod version with tkpod, perldoc or from bbbike (if Tk::Pod is installed).

LICENSE

The most important parts of the application (bbbike, cgi/bbbike.cgi, Strassen.pm and Strassen/Inline.pm) and the data in the subdirectory data are released unter the GPL. The other files can be redristibuted either under the Artistic License or the GPL. Please refer to the source files.

AUTHOR

Slaven Rezic, E-Mail: slaven.rezic@berlin.de


[Top]