=encoding iso-8859-1

=head1 README

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

=head1 FERTIGE PAKETE

Wenn man sich die Arbeit erleichtern m?chte, dann kann man ein fertiges Paket auf Lhttp://sourceforge.bbbike.de/downloads.de.html finden (Windows, einige Linux-Distributionen, MacOSX, FreeBSD).

Die n?chsten Installationsschritte werden nur f?r die BBBike-Installation aus den Quellen ben?tigt.

=head1 INSTALLATION AUS DEN QUELLDATEIEN

=head2 Alle Systeme au?er Windows

=head3 Download

Die aktuellste BBBike-Archivdatei findet man im Verzeichnis Lhttp://sourceforge.net/projects/bbbike/files/BBBike/ . Die aktuelle Sourcedatei ist Lhttp://sourceforge.net/projects/bbbike/files/BBBike/3.18/BBBike-3.18.tar.gz/download .

=head3 FreeBSD

F?r FreeBSD existiert ein I<Port> f?r BBBike in der Kategorie B. Besitzer ?lterer FreeBSD-Versionen k?nnen den I<Port> ?ber Lhttp://www.freebsd.org/cgi/ports.cgi?query=bbbike&stype=all finden. Die Installation ?ber das Ports-System erfolgt wie folgt:

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

Ohne I<Port> kann BBBike wie bei L<anderen Unices|/Linux, Solaris, andere Unices> installiert werden.

=head3 Linux, Solaris, andere Unices

Perl muss installiert sein. Das ist oft, besonders bei Linux, der Fall. Mit

perl -v

kann ?berpr?ft werden, ob und welche Version von perl installiert ist. Ansonsten kann man Perl unter Lhttp://www.perl.org/get.html finden. Es werden alle Perl-Versionen ab 5.8.9 unterst?tzt, ggfs. funktionieren auch ?ltere Versionen (bis 5.005).

Danach kann BBBike ausgepackt werden:

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

Falls perl/Tk (eine m?glichst neue Version, zurzeit 804.034) nicht installiert ist: als Superuser folgendes eingeben:

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

Damit wird Perl/Tk ?ber das Internet geladen, compiliert und installiert. "force" wird ben?tigt, da einige Module erwartete Fehler in der Test-Suite erzeugen und damit die Installation verhindern. Wenn weitere Probleme auftreten (insbesondere mit der Internet-Verbindung), dann sollten die Anweisungen in

perldoc perlmodinstall

befolgt werden, um das Modul Tk manuell zu installieren.

Danach kann das Programm mit

perl bbbike

gestartet werden.

Optional kann mit

perl install.pl

oder

./install.sh

eine Compilierung von einigen XS-Modulen durchgef?hrt werden sowie Eintr?ge f?r KDE/GNOME erzeugt werden. F?r das Compilieren ist ein C-Compiler (z.B. gcc), der mittlerweile nicht bei allen Linux-Versionen standardm??ig installiert wird, notwendig.

Statt dem oben erw?hnten Bundle::BBBike_small kann auch Bundle::BBBike verwendet werden. Damit werden wesentlich mehr Perl-Module installiert, die teilweise nur f?r die Entwicklung verwendet werden, teilweise aber zus?tzliche BBBike-Features erm?glichen.

Wenn "perl install.pl" nicht verwendet wird, aber trotzdem die XS-Module f?r bessere Performance installiert werden sollen, muss

make ext

ausgef?hrt werden. Dazu ist das Perl-Modul LInline::C notwendig.

=head3 Mac OS X

Mac OS X enth?lt bereits 5.8.x. Um BBBike zum Laufen zu bringen werden noch XDarwin und Perl/Tk ben?tigt. Eine Anleitung zum Aufsetzen von Perl/Tk auf Mac OS X bekommt man in der comp.lang.perl.tk Newsgroup (siehe Lhttp://groups.google.com).

Folgende Anleitung habe ich von Wolfram Kroll erhalten:

Lhttp://sourceforge.net/projects/bbbike/files/BBBike/3.18/BBBike-3.18.tar.gz/download und (von Lhttp://www.cpan.org) perl-5.8.4-stable.tar.gz, Tk-804.027.tar.gz besorgt.

=over

=item 1. Perl auf dynamische Libs konfiguriert:

sh Configure -des -Duseshrplib

make

make test

sudo make install

--> /usr/local/ ist der default (das orginale perl bleibt erhalten)

=item 2. Tk: das ist kein Aqua-Tk, sondern f?r X11, na meinetwegen...

make

in einem X11-Fenster: # make test

sudo make install

=item 3. bbbike unter X11

l?uft!

=back

Um compilieren zu k?nnen, sind die Entwicklertools notwendig. Diese werden "Xcode" genannt und befinden sich entweder auf einer gleichnamigen CD (bei ?lteren Macs) oder im Applications-Ordner unter C<Installers/Xcode Tools/Developer.mpkg> (bei neueren Macs).

Es wird auch eine X11- bzw. Darwin-Umgebung ben?tigt (X11SDK-Paket).

Mac OS Classic wird nicht unterst?tzt.

=head2 Windows 95/98/2000/NT/XP/Vista/7/8

=head3 Normale Installation

BBBike und Perl ben?tigen ca. 32 MB an Festplattenspeicher.

Einfach die Datei Lhttp://sourceforge.net/projects/bbbike/files/BBBike/3.18/BBBike-3.18-Windows.exe/download laden und starten. Damit wird das Installationsprogramm gestartet.

=head3 Alternative Windows Installation (1)

Alternativ kann BBBike auch nur mit den Sourcen installiert werden. Arbeitsschritte f?r Windows-95/98/2000/NT/XP-Benutzer:

=over 4

=item *

Aus dem WWW die perl-Distribution downloaden. Perl kann von der ActiveState Webpage geladen werden:

Lhttp://www.activestate.com/activeperl/downloads

oder es kann alternativ Strawberry Perl verwendet werden:

Lhttp://strawberryperl.com/

Das Tk-Modul muss separat installiert werden. Das wird in der Eingabeaufforderung mit den folgenden Kommandos getan:

perl -MCPAN -eshell
force notest install Tk
quit

=item *

L<BBBike-3.18.tar.gz|http://sourceforge.net/projects/bbbike/files/BBBike/3.18/BBBike-3.18-Windows.exe/download> downloaden und auspacken. Das ausgepackte Verzeichnis kann an eine gew?nschte Position verschoben werden.

=item *

In der Eingabeaufforderung oder im Explorer zum Verzeichnis BBBike-3.18 wechseln und

install.pl

aufrufen. Das Installationsskript erstellt Eintr?ge f?r BBBike im Startmen? und erzeugt ein Icon auf dem Desktop.

=back

=head3 Alternative Windows Installation (2)

Wenn Cygwin (Lhttp://www.cygwin.org/) installiert ist, k?nnen aus einer cygwin-Shell heraus die Anweisungen wie bei einer L<UNIX-Installation|/Linux, Solaris, andere Unices> befolgt werden.

=head3 Alternative Windows Installation (3)

F?r sehr alte Systeme (Windows95, 98) kann als weitere Alternative eine ?ltere perl-Distribution, die bereits Tk enth?lt, geladen werden:

Lhttp://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 C<install.bat>. Das Programm in der Eingabeaufforderungen aufrufen und die Anweisungen befolgen.

Mit dieser alten Version (5.004_02) von Perl ben?tigt man auch eine relativ alte Version von BBBike (?lter als 3.00).

=head3 Windows 3.1

Windows 3.1 wird nicht mehr unterst?tzt. ?ltere Versionen von BBBike (z.B. 2.x) haben noch eine Anleitung, wie man BBBike unter Windows 3.1 nutzen kann.

=head1 AUSF?HREN

=head2 Perl/Tk-Version

Unter Unix wird BBBike ausgef?hrt, indem man ins bbbike-Verzeichnis wechselt und

perl bbbike

eintippt. Wenn eine KDE/GNOME-Installation durchgef?hrt wurde, findet man das Icon im Startmen? unter dem Punkt "Anwendungen". Bei Windows befindet sich das BBBike-Icon ebenfalls im Startmen?.

Einige Versionen von BBBike wurden unter folgenden Plattformen getestet: Linux (Debian jessie, Debian wheezy, Debian squeeze, Debian etch, Ubuntu 12.04, CentOS, Suse 7.0 und 6.4, Red Hat 8.0), FreeBSD (Version 10.0, 9.2, 9.1, 9.0, 8.0, 6.1, 4.9, 4.6, 3.5), Windows (Windows 8, Windows 7, Vista, XP, 2000, NT 4.0, 98, 95), MacOSX (10.4, 10.5 ...), Solaris (Version 8 und 2.5). Die Entwicklungsarbeit wird auf einem Debian/jessie- sowie einem FreeBSD-Rechner vorgenommen.

=head2 WWW-Version

Im WWW existiert unter der Adresse

Lhttp://www.bbbike.de

eine einfache, stark text-orientierte, aber dennoch leistungsf?hige Version von bbbike. Weitere Informationen zu der CGI-Version gibt es unter

Lhttp://bbbike.de/cgi-bin/bbbike.cgi/info=1

=head1 ENTWICKLUNG

=head2 git

Der aktuelle Entwicklungsstand von BBBike kann mit git verfolgt werden.

Dazu muss in der Kommandozeile folgendes eingegeben werden:

git clone https://github.com/eserte/bbbike.git

Alle weiteren Male nur folgendes verwenden:

cd bbbike
git pull

Das L<git-Repository|http://github.com/eserte/bbbike> wird fast t?glich aktualisiert und enth?lt auch die aktuellen Daten.

=head2 Programm-Aktualisierung

Der aktuelle Programm -und Daten-Stand kann auch von der Adresse Lhttp://www.bbbike.de/cgi-bin/bbbike-snapshot.cgi downgeloadet werden.

=head2 Daten-Aktualisierung

Um nur die Daten zu aktualisieren, kann man sich die aktuellen Daten als ZIP-Datei von Lhttp://www.bbbike.de/cgi-bin/bbbike-data.cgi holen. Die ZIP-Datei muss im BBBike-Programmverzeichnis (bei Windows unter C<C:\Programme\BBBike\bbbike>) ausgepackt werden.

Die Daten k?nnen auch aus der Perl/Tk-Applikation heraus aktualisiert werden: per Men?punkt Einstellungen > Daten-Update ?ber das Internet.

=head1 DOKUMENTATION

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

=head1 LIZENZ

Die wichtigsten Teilst?cke der Anwendung (C, C<cgi/bbbike.cgi>, C<Strassen.pm> und C<Strassen/Inline.pm>) und die Daten im C-Verzeichnis sind unter der L<GPL|http://www.opensource.org/licenses/gpl-license.html> ver?ffentlicht. Die restlichen Module k?nnen entweder unter der L<Artistic License|http://www.opensource.org/licenses/artistic-license.html> oder GPL ver?ffentlicht werden. Die genauen Lizenzbestimmungen stehen in den Quelldateien selbst.

Einige Module und Dateien von anderen Autoren sind in dieser Distribution enthalten: C<lib/your.pm> von Michael G Schwern, C<lib/Text/ScriptTemplate.pm> von Taisuke Yamada, C<lib/enum.pm> von Zenin, C<ext/Strassen-Inline/heap.[ch]> der Internet Software Consortium, C<ext/BBBikeXS/sqrt.c> von Eyal Lebedinsky.

C<BBBike-3.18-Windows.zip> enth?lt einen Teil der C<Strawberry Perl>-Distribution, siehe Lhttp://strawberryperl.com/

=head1 AUTOR

Slaven Rezic, E-Mail: L<[email protected]|mailto:[email protected]>

=cut