From 6ad0a7e39b310dd01733181fea599367d32882df Mon Sep 17 00:00:00 2001
From: Slaven Rezic
BBBike - a route-finder for cyclists in Berlin and Brandenburg
-You can check on http://bbbike.sourceforge.net/downloads.en.html for prebuild BBBike
-packages. But keep in mind that the versions there might not represent
-the newest state and maybe your operating system is not covered.
+You can check on http://bbbike.sourceforge.net/downloads.en.html for prebuilt BBBike
+packages (Windows, einige Linux-Distributionen, MacOSX, FreeBSD).
+
+The following installation steps are necessary only for installing
+BBBike from source.
You can find the newest source distribution file of BBBike in the directory
http://sourceforge.net/projects/bbbike/files/BBBike/ . The current source version is
-http://heanet.dl.sourceforge.net/project/bbbike/BBBike/3.17/BBBike-3.17.tar.gz .
+http://sourceforge.net/projects/bbbike/files/BBBike/3.18/BBBike-3.18.tar.gz/download .
@@ -88,30 +90,31 @@ README.english
-README.english
README.english
README
PREBUILD PACKAGES
+PREBUILT PACKAGES
INSTALLATION
@@ -70,7 +72,7 @@ Download
FreeBSD
FreeBSD
-First, you have to install perl5. Most operating systems have perl +First, you have to install perl. Most operating systems have perl already bundled. You can check with
- perl -V + 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. +perl at http://www.perl.org/get.html. You need at least version +5.005, but newer perl versions (5.6.x, 5.8.x, 5.10.x, 5.12.x, 5.14.x, +5.16.x) work, too.
Next step is to extract the BBBike distribution:
- zcat BBBike-3.17.tar.gz | tar xfv - + zcat BBBike-3.18.tar.gz | tar xfv -
If perl/Tk (the recommended version is 804.028 or 800.025) is not installed:
-change to the directory
-BBBike-3.17
and type as super user:
+type as super user:
+ cd BBBike-3.18 perl -I`pwd` -MCPAN -e shell force install Bundle::BBBike_small quit @@ -137,9 +140,10 @@Linux, Solaris, other UNIX
perl bbbike+To compile some XS modules (this is optional and needs a C compiler) -and install the panel entry for KDE, type: +and install the panel entry for KDE/GNOME, type:
@@ -181,7 +185,7 @@Mac OS X
The following instructions are from Wolfram Kroll:-Get http://heanet.dl.sourceforge.net/project/bbbike/BBBike/3.17/BBBike-3.17.tar.gz and (from +Get http://sourceforge.net/projects/bbbike/files/BBBike/3.18/BBBike-3.18.tar.gz/download and (from http://www.cpan.org) perl-5.8.4-stable.tar.gz, Tk-804.027.tar.gz
@@ -223,14 +227,14 @@
Mac OS X
Mac OS Classic is not supported. -Windows 95/98/2000/NT/XP
+Windows 95/98/2000/NT/XP/Vista/7/8
Normal installation
BBBike and Perl need approx. 32 MB hard disk space.
Download the file -http://heanet.dl.sourceforge.net/project/bbbike/BBBike/3.17/BBBike-3.17-Windows.exe and just start it for the installation +http://sourceforge.net/projects/bbbike/files/BBBike/3.18/BBBike-3.18-Windows.exe/download and just start it for the installation program.
Alternative Windows Installation (1)
@@ -244,32 +248,36 @@Alternative Windows Install Download the perl distribution from the ActiveState webpage:
-http://www.activestate.com/Products/ActivePerl/Download.html +http://www.activestate.com/activeperl/downloads
- --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. +or alternatively use Strawberry Perl:
-In current ActivePerl versions the Tk module is already included and -does not need to be installed. +http://strawberryperl.com/
+ ++The Tk module needs to be installed using the following commands in +cmd.exe: +
++ perl -MCPAN -eshell + force notest install Tk + quit ++Download -
BBBike-3.17.tar.gz|http://heanet.dl.sourceforge.net/project/bbbike/BBBike/3.17/BBBike-3.17-Windows.exe
-and extract this file with -WinZip. The unpacked directory will not move in the later -installation. +BBBike-3.18.tar.gz +and extract this file. The unpacked directory may be moved to another +position in the filesystem.-Open the explorer, change to the BBBike-3.17 directory and call +Open the explorer, change to the BBBike-3.18 directory and call
@@ -288,7 +296,7 @@Alternative Windows Instal
Alternative Windows Installation (3)
-As an further alternative, you can download an older distribution with Tk +For very old systems (Windows95, 98) you can download an older distribution with Tk included:
@@ -311,6 +319,7 @@
Windows 3.1
EXECUTION
+Perl/Tk version
To execute BBBike on Unix, change to the bbbike directory and type
@@ -319,7 +328,7 @@EXECUTION
perl bbbike-in the shell. With a full KDE installation, there is an icon in the +in the shell. With a full KDE/GNOME installation, there is an icon in the application menu item of the start menu. On Windows, there is a start menu entry for BBBike. @@ -327,18 +336,16 @@
EXECUTION
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, +similar (for FreeBSD and Linux, this is "en_US.UTF-8"). For Unix, this can be done with
- env LC_ALL=en-GB.ISO8859-1 perl bbbike + env LC_ALL=en_US.UTF-8 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 (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. The +Some versions of BBBike are tested with: 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). The development machine runs with FreeBSD.
WWW version
@@ -355,18 +362,16 @@WWW version
http://bbbike.de/cgi-bin/bbbike.cgi/info=1 -Non GUI version
--
-cbbbike
andcmdbbbike
are simpler command line versions of the program. -DEVELOPMENT
+ + +DEVELOPMENT
git
The current BBBike development may be tracked via git.
-To use the git repository from command line type the following: +To fetch the git repository type the following in the command line:
@@ -380,16 +385,12 @@git
git pull-The git repository is always up-to-date and also contains the current +The git repository is frequently updated and also contains the current data.
-CVS
--If git cannot be used, then there's still the possibility to access -the old CVS repository (:pserver:anonymous@bbbike.cvs.sourceforge.net:/cvsroot/bbbike). Note that it's not guaranteed that -updates occur in the same frequency as for the git repository. -
+ +Application update
It is also possible to download a current snapshot using the URL @@ -402,6 +403,11 @@
Data update
extracted in the BBBike program directory (Windows: inC:\Programme\BBBike\bbbike
). ++The data may also be updated within the Perl/Tk application, using the +menu item Settings > Data update over internet. +
+DOCUMENTATION
The documentation can be accessed in pod format (
bbbike.pod
) or in @@ -426,7 +432,7 @@LICENSE
Consortium,ext/BBBikeXS/sqrt.c
by Eyal Lebedinsky.-
diff --git a/doc/README.html b/doc/README.html index a46538ef40..337fa9c8b9 100644 --- a/doc/README.html +++ b/doc/README.html @@ -26,7 +26,7 @@BBBike-3.17-Windows.zip
contains a partial +BBBike-3.18-Windows.zip
contains a partialStrawberry Perl
distribution, see http://strawberryperl.com/README
- Linux, Solaris, andere Unices
- Mac OS X -
- Windows 95/98/2000/NT/XP +
- Windows 95/98/2000/NT/XP/Vista/7/8
- Normale Installation
- Alternative Windows Installation (1) @@ -37,13 +37,12 @@
README
- AUSFÜHREN
- ENTWICKLUNG @@ -59,9 +58,12 @@
README
FERTIGE PAKETE
Wenn man sich die Arbeit erleichtern möchte, dann kann man ein -fertiges Paket auf 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 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.
INSTALLATION
@@ -71,7 +73,7 @@Download
Die aktuellste BBBike-Archivdatei findet man im Verzeichnis http://sourceforge.net/projects/bbbike/files/BBBike/ . Die aktuelle Sourcedatei ist -http://heanet.dl.sourceforge.net/project/bbbike/BBBike/3.17/BBBike-3.17.tar.gz . +http://sourceforge.net/projects/bbbike/files/BBBike/3.18/BBBike-3.18.tar.gz/download .
FreeBSD
@@ -89,38 +91,38 @@
FreeBSD
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 -vkann überprüft werden, ob und welche Version von perl installiert ist. -Ansonsten kann man Perl5 unter http://www.perl.com finden. Es wird -mindestens die Version 5.005 benötigt. +Ansonsten kann man Perl unter 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
-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 @@ -133,14 +135,17 @@
Linux, Solaris, andere Unic 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
@@ -154,14 +159,14 @@Linux, Solaris, andere Unic ./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.
@@ -186,7 +191,7 @@Mac OS X
Folgende Anleitung habe ich von Wolfram Kroll erhalten:-http://heanet.dl.sourceforge.net/project/bbbike/BBBike/3.17/BBBike-3.17.tar.gz und (von +http://sourceforge.net/projects/bbbike/files/BBBike/3.18/BBBike-3.18.tar.gz/download und (von http://www.cpan.org) perl-5.8.4-stable.tar.gz, Tk-804.027.tar.gz besorgt.
@@ -229,14 +234,14 @@Mac OS X
Mac OS Classic wird nicht unterstützt. -Windows 95/98/2000/NT/XP
+Windows 95/98/2000/NT/XP/Vista/7/8
Normale Installation
BBBike und Perl benötigen ca. 32 MB an Festplattenspeicher.
-Einfach die Datei http://heanet.dl.sourceforge.net/project/bbbike/BBBike/3.17/BBBike-3.17-Windows.exe laden und starten. +Einfach die Datei http://sourceforge.net/projects/bbbike/files/BBBike/3.18/BBBike-3.18-Windows.exe/download laden und starten. Damit wird das Installationsprogramm gestartet.
Alternative Windows Installation (1)
@@ -251,30 +256,35 @@Alternative Windows Install von der ActiveState Webpage geladen werden:
-http://www.activestate.com/Products/ActivePerl/Download.html +http://www.activestate.com/activeperl/downloads
- --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. +oder es kann alternativ Strawberry Perl verwendet werden:
-In den aktuellen Versionen von ActivePerl ist das Tk-Modul bereits -enthalten und muss nicht separat installiert werden. +http://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 +-BBBike-3.17.tar.gz -downloaden und mit WinZip auspacken. Das -ausgepackte Verzeichnis wird später nicht mehr verschoben. +BBBike-3.18.tar.gz +downloaden und auspacken. Das +ausgepackte Verzeichnis kann an eine gewünschte Position verschoben werden.
-In der Eingabeaufforderung oder im Explorer zum Verzeichnis BBBike-3.17 +In der Eingabeaufforderung oder im Explorer zum Verzeichnis BBBike-3.18 wechseln und
@@ -295,8 +305,8 @@Alternative Windows Instal
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:
http://www.perl.com/CPAN/ports/win32/Standard/x86/perl5.00402-bindist04-bc.tar.gz @@ -319,6 +329,7 @@
Windows 3.1
AUSFÜHREN
+Perl/Tk-Version
Unter Unix wird BBBike ausgeführt, indem man ins bbbike-Verzeichnis wechselt und @@ -328,16 +339,14 @@
AUSFÜHREN
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.
WWW-Version
@@ -348,27 +357,24 @@WWW-Version
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
http://bbbike.de/cgi-bin/bbbike.cgi/info=1
-Nicht-GUI-Version
--Mit
-cbbbike
undcmdbbbike
existieren einfache Kommandozeilen-Versionen des -Programms. -ENTWICKLUNG
+ + +ENTWICKLUNG
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:
@@ -387,13 +393,8 @@git
-CVS
--Falls git nicht verwendet werden kann, gibt es noch immer die -Möglichkeit auf das alte CVS-Repository unter :pserver:anonymous@bbbike.cvs.sourceforge.net:/cvsroot/bbbike zuzugreifen. -Es ist allerdings nicht garantiert, dass Updates in der gleichen -Frequenz wie auf dem git-Repository passieren. -
+ +Programm-Aktualisierung
Der aktuelle Programm -und Daten-Stand kann auch von der Adresse @@ -406,6 +407,10 @@
Daten-AktualisierungC:\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. +
DOKUMENTATION
Die Dokumentation liegt im POD-Format (plain old @@ -433,7 +438,7 @@
LIZENZ
Consortium,ext/BBBikeXS/sqrt.c
von Eyal Lebedinsky.-
BBBike-3.17-Windows.zip
enthält einen Teil der +BBBike-3.18-Windows.zip
enthält einen Teil derStrawberry Perl
-Distribution, siehe http://strawberryperl.com/