Skip to content

Commit

Permalink
* inc'd to version 3.18
Browse files Browse the repository at this point in the history 
* fixed some URLs in BBBikeVar.pm
* modernized README files (new version, fixed URLs, removed some
  obsolete or non-working sections, fixed some wordings...)
  • Loading branch information
@eserte
eserte committed Mar 16, 2013
1 parent b7c7a22 commit 1263d6b
Show file tree
Hide file tree
Showing 4 changed files with 208 additions and 178 deletions.
14 changes: 7 additions & 7 deletions BBBikeVar.pm
View file
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
#
# Author: Slaven Rezic
#
# Copyright (C) 2000-2010,2012 Slaven Rezic. All rights reserved.
# Copyright (C) 2000-2010,2012,2013 Slaven Rezic. All rights reserved.
# This package is free software; you can redistribute it and/or
# modify it under the same terms as Perl itself.
#
Expand All @@ -15,9 +15,9 @@

package BBBike;

$VERSION = '3.18-DEVEL'; # remove "-DEVEL" for releases
$STABLE_VERSION = '3.17';
$WINDOWS_VERSION = '3.17'; # Windows distribution
$VERSION = '3.18'; # remove "-DEVEL" for releases
$STABLE_VERSION = '3.18';
$WINDOWS_VERSION = '3.18'; # Windows distribution
$FREEBSD_VERSION = '3.17'; # (used on download page and bbbikevar.t)
$DEBIAN_I386_VERSION = '3.17-1'; # including revision
$DEBIAN_AMD64_VERSION = '3.17-1'; # including revision
Expand Down Expand Up @@ -59,9 +59,9 @@ $BBBIKE_MOBILE = 'http://m.bbbike.de';

# Distribution directory for scripts. Unfortunately there's no directory
# index available anymore at sourceforge...
$DISTDIR = 'http://heanet.dl.sourceforge.net/project/bbbike';
$DISTFILE_SOURCE = "$DISTDIR/BBBike/$STABLE_VERSION/BBBike-$STABLE_VERSION.tar.gz";
$DISTFILE_WINDOWS = "$DISTDIR/BBBike/$WINDOWS_VERSION/BBBike-$WINDOWS_VERSION-Windows.exe";
$DISTDIR = 'http://sourceforge.net/projects/bbbike/files';
$DISTFILE_SOURCE = "$DISTDIR/BBBike/$STABLE_VERSION/BBBike-$STABLE_VERSION.tar.gz/download";
$DISTFILE_WINDOWS = "$DISTDIR/BBBike/$WINDOWS_VERSION/BBBike-$WINDOWS_VERSION-Windows.exe/download";
# Distribution directory for humans (link to 'show files' at sourceforge, and restricted to BBBike)
$DISPLAY_DISTDIR = 'http://sourceforge.net/projects/bbbike/files/BBBike/';
$LATEST_RELEASE_DISTDIR = "http://sourceforge.net/projects/bbbike/files/BBBike/$STABLE_VERSION/";
Expand Down
110 changes: 56 additions & 54 deletions README
View file
Original file line number Diff line number Diff line change
Expand Up @@ -5,9 +5,11 @@ BBBike - ein Programm zum Suchen von Routen f
=head1 FERTIGE PAKETE

Wenn man sich die Arbeit erleichtern m�chte, dann kann man ein
fertiges Paket auf L<http://bbbike.sourceforge.net/downloads.de.html> finden. Die
Versionen dort sind allerdings unter Umst�nden nicht auf dem neuesten
Stand; auch sind nicht alle Betriebssysteme erh�ltlich.
fertiges Paket auf L<http://bbbike.sourceforge.net/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

Expand All @@ -19,7 +21,7 @@ Stand; auch sind nicht alle Betriebssysteme erh

Die aktuellste BBBike-Archivdatei findet man im Verzeichnis
L<http://sourceforge.net/projects/bbbike/files/BBBike/> . Die aktuelle Sourcedatei ist
L<http://heanet.dl.sourceforge.net/project/bbbike/BBBike/3.17/BBBike-3.17.tar.gz> .
L<http://sourceforge.net/projects/bbbike/files/BBBike/3.18/BBBike-3.18.tar.gz/download> .

=head3 FreeBSD

Expand All @@ -35,31 +37,31 @@ Ohne I<Port> kann BBBike wie bei L<anderen Unices|/Linux, Solaris, andere Unices

=head3 Linux, Solaris, andere Unices

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

perl -V
perl -v

kann �berpr�ft werden, ob und welche Version von perl installiert ist.
Ansonsten kann man Perl5 unter L<http://www.perl.com> finden. Es wird
mindestens die Version 5.005 ben�tigt.
Ansonsten kann man Perl unter L<http://www.perl.org/get.html> finden. Es wird
mindestens die Version 5.005 ben�tigt, alle neueren Perl-Versionen
(5.6.x, 5.8.x, 5.10.x, 5.12.x, 5.14.x, 5.16.x) funktionieren auch.

Danach kann BBBike ausgepackt werden:


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

Falls perl/Tk (eine m�glichst neue Version, z.B. 804.028 or 800.025) nicht
installiert ist: in das Verzeichnis C<BBBike-3.17>
wechseln und als Superuser

installiert ist: als Superuser folgendes eingeben:

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

eingeben, damit Perl/Tk �ber das
Internet geladen, compiliert und installiert wird. "force" wird
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
Expand All @@ -69,12 +71,14 @@ die Anweisungen in

befolgt werden, um das Modul Tk manuell zu installieren.

Danach kann mit
Danach kann das Programm mit


perl bbbike

das Programm gestartet werden. Mit
gestartet werden.

Optional kann mit


perl install.pl
Expand All @@ -84,13 +88,13 @@ oder

./install.sh

kann optional eine Compilierung von einigen XS-Modulen durchgef�hrt
werden sowie Eintr�ge f�r KDE erzeugt werden. F�r das Compilieren
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 Bundle::BBBike_small kann auch Bundle::BBBike verwendet werden.
Damit werden wesentlich mehr Module installiert, die teilweise nur f�r
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.

Expand All @@ -110,7 +114,7 @@ von Perl/Tk auf Mac OS X bekommt man in der comp.lang.perl.tk Newsgroup

Folgende Anleitung habe ich von Wolfram Kroll erhalten:

L<http://heanet.dl.sourceforge.net/project/bbbike/BBBike/3.17/BBBike-3.17.tar.gz> und (von
L<http://sourceforge.net/projects/bbbike/files/BBBike/3.18/BBBike-3.18.tar.gz/download> und (von
L<http://www.cpan.org>) perl-5.8.4-stable.tar.gz, Tk-804.027.tar.gz
besorgt.

Expand Down Expand Up @@ -152,14 +156,14 @@ Es wird auch eine X11- bzw. Darwin-Umgebung ben
Mac OS Classic wird nicht unterst�tzt.


=head2 Windows 95/98/2000/NT/XP
=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 L<http://heanet.dl.sourceforge.net/project/bbbike/BBBike/3.17/BBBike-3.17-Windows.exe> laden und starten.
Einfach die Datei L<http://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)
Expand All @@ -174,28 +178,31 @@ Arbeitsschritte f
Aus dem WWW die perl-Distribution downloaden. Perl kann
von der ActiveState Webpage geladen werden:

L<http://www.activestate.com/Products/ActivePerl/Download.html>
L<http://www.activestate.com/activeperl/downloads>

oder es kann alternativ Strawberry Perl verwendet werden:

L<http://strawberryperl.com/>



In der Regel werden zwei Dateien zum Installieren ben�tigt, den
Windows Installer und die eigentliche Perl-Distribution f�r Windows
Intel. Beide Dateien m�ssen nacheinander ausgef�hrt werden. Die
Installation ist normalerweise mit einigen Reboots verbunden.
Das Tk-Modul muss separat installiert werden. Das wird in der
Eingabeaufforderung mit den folgenden Kommandos getan:

In den aktuellen Versionen von ActivePerl ist das Tk-Modul bereits
enthalten und muss nicht separat installiert werden.
perl -MCPAN -eshell
force notest install Tk
quit


=item *

L<BBBike-3.17.tar.gz|http://heanet.dl.sourceforge.net/project/bbbike/BBBike/3.17/BBBike-3.17-Windows.exe>
downloaden und mit WinZip auspacken. Das
ausgepackte Verzeichnis wird sp�ter nicht mehr verschoben.
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.17
In der Eingabeaufforderung oder im Explorer zum Verzeichnis BBBike-3.18
wechseln und


Expand All @@ -215,8 +222,8 @@ befolgt werden.

=head3 Alternative Windows Installation (3)

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

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

Expand All @@ -237,21 +244,21 @@ 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-Installation durchgef�hrt wurde, findet man
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�.

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. Einige Versionen von BBBike wurden unter folgenden
Plattformen getestet: Solaris (Version 8 und 2.5), FreeBSD (Version 6.1, 4.9, 4.6, 3.5), Linux (Suse 7.0 und 6.4, Debian 3.0, Ubuntu, Red Hat 8.0), Windows (2000, NT 4.0, 98, 95), MacOSX 10.4. Die
Einige Versionen von BBBike wurden unter folgenden
Plattformen getestet: Linux (Debian wheezy, Debian squeeze, Debian etch, Ubuntu 12.04, CentOS, Suse 7.0 und 6.4, Red Hat 8.0), FreeBSD (Version 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 FreeBSD-Rechner vorgenommen.

=head2 WWW-Version
Expand All @@ -260,26 +267,23 @@ Im WWW existiert unter der Adresse

L<http://www.bbbike.de>

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

L<http://bbbike.de/cgi-bin/bbbike.cgi/info=1>


=head2 Nicht-GUI-Version

Mit C<cbbbike> und C<cmdbbbike> existieren einfache Kommandozeilen-Versionen des
Programms.

=head1 ENTWICKLUNG

=head1 ENTWICKLUNG

=head2 git

Der aktuelle Entwicklungsstand von BBBike kann �ber git
Der aktuelle Entwicklungsstand von BBBike kann mit git
verfolgt werden.

Von der Kommandozeile muss folgendes eingegeben werden:
Dazu muss in der Kommandozeile folgendes eingegeben werden:


git clone git://github.com/eserte/bbbike.git
Expand All @@ -294,12 +298,7 @@ Daten.



=head2 CVS

Falls git nicht verwendet werden kann, gibt es noch immer die
M�glichkeit auf das alte CVS-Repository unter :pserver:[email protected]:/cvsroot/bbbike zuzugreifen.
Es ist allerdings nicht garantiert, dass Updates in der gleichen
Frequenz wie auf dem git-Repository passieren.

=head2
Programm-Aktualisierung
Expand All @@ -315,6 +314,9 @@ als ZIP-Datei von L<http://www.bbbike.de/cgi-bin/bbbike-data.cgi> holen. Die ZIP
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
Expand All @@ -341,7 +343,7 @@ 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.17-Windows.zip> enth�lt einen Teil der
C<BBBike-3.18-Windows.zip> enth�lt einen Teil der
C<Strawberry Perl>-Distribution, siehe
L<http://strawberryperl.com/>

Expand Down
Loading

0 comments on commit 1263d6b

Please sign in to comment.