Next: podindex | Previous: README |  | [Index]

# README.english

- README
- INSTALLATION
  - Download
  - FreeBSD
  - Linux, Solaris, other UNIX operating systems
  - Windows 95/98/2000/NT/XP BBBike and Perl need approx. 32 MB hard disk space.
  - Alternative Windows Installation (1)
  - Alternative Windows Installation (2)
  - Alternative Windows Installation (3)
  - Windows 3.1
  - Mac OS X
- EXECUTION
  - WWW version
  - Command line version
- DEVELOPMENT
- DOCUMENTATION
- LICENSE
- AUTHOR

## README

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

## INSTALLATION

### Download

You can find the newest distribution file of BBBike in the directory http://sourceforge.net/project/showfiles.php?group_id=19142&package_id=14052 . The current source version is http://heanet.dl.sourceforge.net/sourceforge/bbbike/BBBike-3.15.tar.gz .

### FreeBSD

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. To install the application via the ports system type:

    	cd /usr/ports/german/BBBike
    	make all install

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. 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.15.tar.gz | tar xfv -

If perl/Tk (the recommended version is 800.025 or 804.027) is not installed: change to the directory `BBBike-3.15` and type as super user:

    	perl -I`pwd` -MCPAN -e shell
    	force install Bundle::BBBike_small
    	quit

Perl/Tk will be fetched over the internet, get compiled and installed. "force" is needed because some modules (especially Tk) have expected test failures and therefore would not be 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 manually (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 needs a C compiler) 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.

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

Download the file http://heanet.dl.sourceforge.net/sourceforge/bbbike/BBBike-3.14-Windows.exe and extract this file with WinZip. To start BBBike just click on the icon `bbbike.bat` in the directory BBBike-3.14-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.

### Alternative Windows Installation (1)

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

- Download the perl distribution from the ActiveState webpage:

  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.

- After the perl installation you have to open the MSDOS prompt and type

      	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

- Download `BBBike-3.14.tar.gz|http://heanet.dl.sourceforge.net/sourceforge/bbbike/BBBike-3.14-Windows.exe` and extract this file with WinZip. The unpacked directory will not move in the later installation.

- Open the explorer, change to the BBBike-3.15 directory and call

      	install.pl.

  The installation program creates entries in the start menu and a desktop icon.

### Alternative Windows Installation (2)

If you have Cygwin (http://www.cygwin.org/) installed, you can start a cygwin 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

Windows 3.1 is not supported anymore. Older BBBike versions (for example 2.x) have instructions on how to use BBBike under Windows 3.1.

### Mac OS X

Mac OS X comes already with perl 5.6.0 oder 5.8.x. 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).

The following instructions are from Wolfram Kroll:

Get http://heanet.dl.sourceforge.net/sourceforge/bbbike/BBBike-3.15.tar.gz and (from http://www.cpan.org) perl-5.8.4-stable.tar.gz, Tk-804.027.tar.gz

1. Perl configured to use dynamic libraries:

        # sh Configure -des -Duseshrplib
        # make
        # make test
        # sudo make install

   --> /usr/local/ is the default (the original Perl is preserved)

2. Tk: that is not a Aqua-Tk, but rather is for X11, but...

        # make

   in an X11 window: # make test

        sudo make install

3. bbbike under X11

   runs!

To compile bbbike under X11 the "Xcode" development tools are needed. These can be found either on a CD-ROM of the same name (for older Macs) or in the Applications folder under `Installers/Xcode Tools/Developer.mpkg` (for newer Macs).

An X11 environment or Darwin environment is also required (package X11SDK).

Mac OS Classic is not supported.

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

### WWW version

There is a simple cgi version at

http://www.bbbike.de

More information for the CGI version at:

http://www.radzeit.de/cgi-bin/bbbike.cgi/info=1

### Command line version

`cbbbike` and `cmdbbbike` are simpler command line versions of the program.

## DEVELOPMENT

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.

To use the CVS repository from command line type the following:

        # login is necessary only once, leave the password empty
        cvs -d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/bbbike login
        cvs -d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/bbbike co bbbike

        # to update the next time
        cd bbbike
        cvs -q update -d

The CVS repository is always up-to-date and also contains the current data.

To update only the data part of BBBike, just download the current data as a ZIP file from http://www.radzeit.de/cgi-bin/bbbike-data.cgi. The ZIP file has to be extracted in the BBBike program directory (Windows: in `C:\Programme\BBBike\bbbike`).

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

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.14-Windows.zip` contains a partial `SiePerl` distribution.

## AUTHOR

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

[Top] Generated by Marek::Pod::HTML 0.49 on Sun Dec 11 20:36:44 2005