README

  BBBike - ein Programm zum Suchen von Routen für Radfahrer in Berlin


INSTALLATION


Allgemein

BBBike ist ein perl-Skript (obwohl bei 300 kB Code nicht mehr von ``Skript'' gesprochen werden kann...) und benötigt perl5.004 oder perl5.005. Zusätzlich muss noch perl/Tk installiert werden (mindestens Version Tk-402.002 oder eine neuere Tk-800.xxx-Version). Die genauen Installationsanweisungen findet man passend zum Betriebssystem weiter unten.

Die aktuellste BBBike-Archivdatei findet man unter http://www.onlineoffice.de/distfiles/bbbike/


FreeBSD

Für FreeBSD existiert seit 3.0-RELEASE ein Port für BBBike in der Kategorie german. Besitzer älterer FreeBSD-Versionen können sich bbbike-fbsdport.tar.gz von http://www.onlineoffice.de/distfiles/bbbike/ herunterladen und dann eingeben:

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

Damit wird perl5, alle benötigten perl-Module und BBBike vom Internet geladen, compiliert und installiert.

Wenn KDE verwendet werden soll, muss die letzte Zeile zu

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

geändert werden, damit ein Eintrag im KDE-Panel erzeugt wird (Menü Applications). Weitere Kommentare befinden sich im Makefile des Ports.

Ohne port kann BBBike wie bei anderen Unices installiert werden.


Linux, Solaris, andere Unices

Perl5 muss installiert sein. Das ist oft, besonders bei Linux, der Fall. Ansonsten kann man Perl5 unter http://www.perl.com finden.

Danach kann BBBike ausgepackt werden:

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

Falls perl/Tk nicht installiert ist: in das Verzeichnis BBBike-3.01 wechseln und

        perl -MCPAN -e "install Bundle::BBBike_small"

eingeben, damit Perl/Tk über das Internet geladen, compiliert und installiert wird. Danach kann mit

        perl bbbike

das Programm gestartet werden. Mit

        perl install.pl

kann optional eine Compilierung von einigen XS-Modulen durchgeführt werden sowie Einträge für KDE erzeugt werden.

Statt Bundle::BBBike_small kann auch Bundle::BBBike verwendet werden. Damit werden wesentlich mehr Module installiert, die teilweise nur für die Entwicklung verwendet werden, teilweise aber auch die Arbeit mit BBBike erleichtern.


Windows 95/98/2000/NT

Arbeitsschritte für Windows-95/98/2000/NT-Benutzer:


Alternative Windows-Installation

Alternativ kann eine ältere perl-Distribution, die allerdings Tk bereits enthält, geladen werden:

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

Die geladene Datei muss mit WinZip oder gunzip+tar ausgepackt werden. Im ausgepackten Verzeichnis befindet sich das Installationsprogramm install.bat. Das Programm in der Eingabeaufforderungen aufrufen und die Anweisungen befolgen.

Dann weiter wie oben beschrieben (BBBike downloaden usw.).


Windows 3.1

Windows-3.1-Benutzer haben zwei Alternativen: Verwenden des Kommandozeilen-Interfaces mit einer perl5-Version für Windows 3.1 (z.B. http://www.perl.com/CPAN/ports/win16/perl5.00402-bindist01-dos-djgpp.zip).

Wenn das Tk-Interface verwendet werden soll, muss zuerst Win32s installiert sein (die Datei heißt PW1118.EXE, mit http://ftpsearch.ntnu.no/ftpsearch/ danach suchen) und danach die perl5-Distribution für Windows95 (siehe oben) installiert werden.

Für weitere Hinweise bitte an den Autor wenden.


AUSFÜHREN

BBBike ist sehr speicher- und CPU-intensiv. Mindestens 16 MB RAM sind auf i386-Plattformen notwendig (bei Solaris mindestens 32 MB), besser das doppelte davon. Getestete Plattformen sind Solaris-2.5, FreeBSD-2.2.8, Linux Red Hat 5.1, Windows 95 und Windows NT 4.0, wobei die Entwicklungsarbeit unter FreeBSD vorgenommen wird und insbesondere unter Windows nicht alle Features funktionieren.


WWW-Version

Im WWW existiert unter der Adresse

        http://www.bbbike.de

eine einfache, stark text-orientierte Version von bbbike.


Kommandozeilen-Version

Mit cbbbike existiert eine einfache Kommandozeilen-Version des Programms.


DOKUMENTATION

Die Dokumentation liegt im POD-Format (plain old documentation) in der Datei bbbike.pod, sowie als HTML (bbbike.html) vor. Die POD-Datei kann entweder mit tkpod, perldoc oder aus bbbike (bei installiertem Tk::Pod) heraus gelesen werden.


AUTOR

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