README

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


INSTALLATION


General

BBBike is a perl script (it's already over 300 kBytes of code, so I don't think it should be called ``script'' anymore...) and needs perl5.004 or perl5.005. Additionaly the perl/Tk extension have to be installed (at least Tk-402.002 or a newer Tk-800.xxx version). The exact installation procedure is described separately for each operating system below.

You can find the newest distribution file of BBBike at http://www.onlineoffice.de/distfiles/bbbike/


FreeBSD

For FreeBSD, there is since 3.0-RELEASE a port for BBBike in the category german. For older versions of FreeBSD, you can download bbbike-fbsdport.tar.gz from http://www.onlineoffice.de/distfiles/bbbike/ and then type:

        tar xfvz bbbike-fbsdport.tar.gz
        cd BBBike
        make -f Makefile-2.2.7 all install clean

This port will compile perl5, fetch all needed perl modules and the BBBike distribution from the internet, compile and install the whole thing.

If you are using KDE, you have to change the latter line:

        make -f Makefile-2.2.7 HAVE_KDE=1 all install clean

So you got an entry for BBBike in the KDE panel (menu Applications). There are further comments for the compiling in the port's Makefile.

Without a port description, 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.

Next step is to extract the BBBike distribution:

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

If perl/Tk is not installed: change to the directory BBBike-3.01 and type:

        perl -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

Steps for Windows 95/98/2000/NT users:


Alternative Windows-Installation

As an 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.

Continue like described above (download BBBike etc.).


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/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

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 under Solaris-2.5, FreeBSD-2.2.8, Linux Red Hat 5.1, Windows 95 and Windows NT 4.0. The development machine runs under FreeBSD.


WWW version

There is a simple cgi version at

        http://www.bbbike.de


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).


AUTHOR

Slaven Rezic, E-Mail: eserte@cs.tu-berlin.de