| Next: podindex | Previous: README | [Index] |
BBBike - a route-finder for cyclists in Berlin and Brandenburg
You can find the newest distribution file of BBBike in the directory ftp://us.dl.sourceforge.net/pub/sourceforge/bbbike . The current source version is ftp://us.dl.sourceforge.net/pub/sourceforge/bbbike/BBBike-3.13.tar.gz .
For FreeBSD, since 3.0-RELEASE there is 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.
First, you have to install perl5. Most operating systems have perl already bundled. You can check with perl -V
whether and which version of perl is installed. 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.13.tar.gz | tar xfv -
If perl/Tk (the recommended version is 800.025) is not installed:
change to the directory
BBBike-3.13 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. If you have problems, especially with the internet connection, then you should follow the instructions in perldoc perlmodinstall
on how to install a perl module (in this case: the Tk module).
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.
If you choose to not use "perl install.pl", but you want to compile and install the XS modules for better performance, then you have to execute make ext
This requires the perl module Inline::C.
Download the file
ftp://us.dl.sourceforge.net/pub/sourceforge/bbbike/BBBike-3.13-Windows.zip and
extract this file
with WinZip. To start BBBike just click on the icon bbbike.bat in
the directory BBBike-3.13-Windows.
Optionally you can install BBBike in 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.
As an alternative, you can install BBBike just with the sources. Steps for Windows 95/98/2000/NT/XP users:
http://www.activestate.com/Products/ActivePerl/Download.html
Usually, there are two files needed for the installation: the Windows Installer and the Perl distribution for Windows Intel. You have to execute both files. While installing Perl, you will have to reboot your computer.
ppm
to start the Perl Package Manager. Inside ppm, type
install Tk
to download and install perl/Tk. To leave the ppm program, type
quit
BBBike-3.13.tar.gz|ftp://us.dl.sourceforge.net/pub/sourceforge/bbbike/BBBike-3.13.tar.gz
and extract this file with
WinZip. The unpacked directory will not move in the later
installation.
install.pl.
The installation program creates entries in the start menu and a desktop icon.
If you have Cygwin (http://www.cygwin.org/) installed, you can start a bash shell and follow the UNIX instructions.
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.
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.
Mac OS X comes already with perl 5.6.0. Now you just need XDarwin and Perl/Tk to get BBBike running. For instructions how to setup Perl/Tk on Mac OS X refer to the comp.lang.perl.tk newsgroup (see http://groups.google.com). I have never tried BBBike on Mac OS X and would be glad to here some success (and problem) reports.
Mac OS Classic is not supported.
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 a start menu entry for BBBike.
To switch the English language support, please set the LC_ALL, LC_MESSAGES, or LANG environment variables to "en" or something similar (for FreeBSD and Linux, this is "en-GB.ISO8859-1"). For Unix, this can be done with
env LC_ALL=en-GB.ISO8859-1 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, FreeBSD-4.6, FreeBSD-4.9, Linux Suse 6.4, Linux Suse 7.0, Linux Debian 3.0, Red Hat Linux 8.0, Windows 95, Windows 98, Windows NT 4.0, Windows 2000. The development machine runs with FreeBSD.
There is a simple cgi version at
More information for the CGI version at:
http://www.radzeit.de/cgi-bin/bbbike.cgi/info=1
cbbbike and cmdbbbike are simpler command line versions of the program.
The current BBBike development may be tracked via CVS. Look at
http://sourceforge.net/cvs/?group_id=19142 for instructions on how to use CVS. For direct access use
the repository on :pserver:anonymous@cvs.bbbike.sourceforge.net:/cvsroot/bbbike with user=anonymous and no password.
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).
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.
Some module und files from other authors are included in this
distribution: lib/your.pm by Michael G Schwern,
lib/Text/ScriptTemplate.pm by Taisuke Yamada, lib/enum.pm by
Zenin, ext/Strassen-Inline/heap.[ch] by Internet Software
Consortium, ext/BBBikeXS/sqrt.c by Eyal Lebedinsky.
BBBike-3.13-Windows.zip contains a partial SiePerl
distribution.
Slaven Rezic, E-Mail: slaven@rezic.de