Skip to content

Commit

Permalink
* regenerated html variants
Browse files Browse the repository at this point in the history
  • Loading branch information
eserte committed Mar 16, 2013
1 parent 1263d6b commit 6ad0a7e
Show file tree
Hide file tree
Showing 2 changed files with 129 additions and 118 deletions.
116 changes: 61 additions & 55 deletions doc/README.english.html
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ <h1 class="POD_TITLE">README.english</h1>
<hr />
<ul>
<li><a class="POD_NAVLINK" href="#README">README</a>
<li><a class="POD_NAVLINK" href="#PREBUILD_PACKAGES">PREBUILD PACKAGES</a>
<li><a class="POD_NAVLINK" href="#PREBUILT_PACKAGES">PREBUILT PACKAGES</a>
<li><a class="POD_NAVLINK" href="#INSTALLATION">INSTALLATION</a>
<ul>
<li><a class="POD_NAVLINK" href="#All_systems_except_W">All systems except Windows</a>
Expand All @@ -26,7 +26,7 @@ <h1 class="POD_TITLE">README.english</h1>
<li><a class="POD_NAVLINK" href="#Linux_Solaris_other_">Linux, Solaris, other UNIX operating systems</a>
<li><a class="POD_NAVLINK" href="#Mac_OS_X">Mac OS X</a>
</ul>
<li><a class="POD_NAVLINK" href="#Windows_95_98_2000_N">Windows 95/98/2000/NT/XP</a>
<li><a class="POD_NAVLINK" href="#Windows_95_98_2000_N">Windows 95/98/2000/NT/XP/Vista/7/8</a>
<ul>
<li><a class="POD_NAVLINK" href="#Normal_installation">Normal installation</a>
<li><a class="POD_NAVLINK" href="#Alternative_Windows_">Alternative Windows Installation (1)</a>
Expand All @@ -37,13 +37,12 @@ <h1 class="POD_TITLE">README.english</h1>
</ul>
<li><a class="POD_NAVLINK" href="#EXECUTION">EXECUTION</a>
<ul>
<li><a class="POD_NAVLINK" href="#Perl_Tk_version">Perl/Tk version</a>
<li><a class="POD_NAVLINK" href="#WWW_version">WWW version</a>
<li><a class="POD_NAVLINK" href="#Non_GUI_version">Non GUI version</a>
</ul>
<li><a class="POD_NAVLINK" href="#DEVELOPMENT">DEVELOPMENT</a>
<ul>
<li><a class="POD_NAVLINK" href="#git">git</a>
<li><a class="POD_NAVLINK" href="#CVS">CVS</a>
<li><a class="POD_NAVLINK" href="#Application_update">Application update</a>
<li><a class="POD_NAVLINK" href="#Data_update">Data update</a>
</ul>
Expand All @@ -56,11 +55,14 @@ <h2 class="POD_HEAD1"><a name="README">README</a></h2>
<p class="POD_TEXT">
BBBike - a route-finder for cyclists in Berlin and Brandenburg
</p>
<h2 class="POD_HEAD1"><a name="PREBUILD_PACKAGES">PREBUILD PACKAGES</a></h2>
<h2 class="POD_HEAD1"><a name="PREBUILT_PACKAGES">PREBUILT PACKAGES</a></h2>
<p class="POD_TEXT">
You can check on <a class="POD_LINK" href="http://bbbike.sourceforge.net/downloads.en.html">http://bbbike.sourceforge.net/downloads.en.html</a> 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 <a class="POD_LINK" href="http://bbbike.sourceforge.net/downloads.en.html">http://bbbike.sourceforge.net/downloads.en.html</a> for prebuilt BBBike
packages (Windows, einige Linux-Distributionen, MacOSX, FreeBSD).
</p>
<p class="POD_TEXT">
The following installation steps are necessary only for installing
BBBike from source.
</p>
<h2 class="POD_HEAD1"><a name="INSTALLATION">INSTALLATION</a></h2>
<p></p>
Expand All @@ -70,7 +72,7 @@ <h4 class="POD_HEAD3"><a name="Download">Download</a></h4>
<p class="POD_TEXT">
You can find the newest source distribution file of BBBike in the directory
<a class="POD_LINK" href="http://sourceforge.net/projects/bbbike/files/BBBike/">http://sourceforge.net/projects/bbbike/files/BBBike/</a> . The current source version is
<a class="POD_LINK" href="http://heanet.dl.sourceforge.net/project/bbbike/BBBike/3.17/BBBike-3.17.tar.gz">http://heanet.dl.sourceforge.net/project/bbbike/BBBike/3.17/BBBike-3.17.tar.gz</a> .
<a class="POD_LINK" href="http://sourceforge.net/projects/bbbike/files/BBBike/3.18/BBBike-3.18.tar.gz/download">http://sourceforge.net/projects/bbbike/files/BBBike/3.18/BBBike-3.18.tar.gz/download</a> .
</p>
<h4 class="POD_HEAD3"><a name="FreeBSD">FreeBSD</a></h4>
<p class="POD_TEXT">
Expand All @@ -88,30 +90,31 @@ <h4 class="POD_HEAD3"><a name="FreeBSD">FreeBSD</a></h4>
</p>
<h4 class="POD_HEAD3"><a name="Linux_Solaris_other_">Linux, Solaris, other UNIX operating systems</a></h4>
<p class="POD_TEXT">
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
</p>
<pre class="POD_VERBATIM">
perl -V
perl -v
</pre>
<p class="POD_TEXT">
whether and which version of perl is installed. Otherwise you can find
perl5 at <a class="POD_LINK" href="http://www.perl.com">http://www.perl.com</a>. You need at least version 5.005.
perl at <a class="POD_LINK" href="http://www.perl.org/get.html">http://www.perl.org/get.html</a>. 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.
</p>
<p class="POD_TEXT">
Next step is to extract the BBBike distribution:
</p>
<p></p>
<pre class="POD_VERBATIM">
zcat BBBike-3.17.tar.gz | tar xfv -
zcat BBBike-3.18.tar.gz | tar xfv -
</pre>
<p class="POD_TEXT">
If perl/Tk (the recommended version is 804.028 or 800.025) is not installed:
change to the directory
<code>BBBike-3.17</code> and type as super user:
type as super user:
</p>
<p></p>
<pre class="POD_VERBATIM">
cd BBBike-3.18
perl -I`pwd` -MCPAN -e shell
force install Bundle::BBBike_small
quit
Expand All @@ -137,9 +140,10 @@ <h4 class="POD_HEAD3"><a name="Linux_Solaris_other_">Linux, Solaris, other UNIX
<pre class="POD_VERBATIM">
perl bbbike
</pre>
<p></p>
<p class="POD_TEXT">
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:
</p>
<p></p>
<pre class="POD_VERBATIM">
Expand Down Expand Up @@ -181,7 +185,7 @@ <h4 class="POD_HEAD3"><a name="Mac_OS_X">Mac OS X</a></h4>
The following instructions are from Wolfram Kroll:
</p>
<p class="POD_TEXT">
Get <a class="POD_LINK" href="http://heanet.dl.sourceforge.net/project/bbbike/BBBike/3.17/BBBike-3.17.tar.gz">http://heanet.dl.sourceforge.net/project/bbbike/BBBike/3.17/BBBike-3.17.tar.gz</a> and (from
Get <a class="POD_LINK" href="http://sourceforge.net/projects/bbbike/files/BBBike/3.18/BBBike-3.18.tar.gz/download">http://sourceforge.net/projects/bbbike/files/BBBike/3.18/BBBike-3.18.tar.gz/download</a> and (from
<a class="POD_LINK" href="http://www.cpan.org">http://www.cpan.org</a>) perl-5.8.4-stable.tar.gz, Tk-804.027.tar.gz
</p>
<ol class="POD_LIST">
Expand Down Expand Up @@ -223,14 +227,14 @@ <h4 class="POD_HEAD3"><a name="Mac_OS_X">Mac OS X</a></h4>
Mac OS Classic is not supported.
</p>
<p></p>
<h3 class="POD_HEAD2"><a name="Windows_95_98_2000_N">Windows 95/98/2000/NT/XP</a></h3>
<h3 class="POD_HEAD2"><a name="Windows_95_98_2000_N">Windows 95/98/2000/NT/XP/Vista/7/8</a></h3>
<h4 class="POD_HEAD3"><a name="Normal_installation">Normal installation</a></h4>
<p class="POD_TEXT">
BBBike and Perl need approx. 32 MB hard disk space.
</p>
<p class="POD_TEXT">
Download the file
<a class="POD_LINK" href="http://heanet.dl.sourceforge.net/project/bbbike/BBBike/3.17/BBBike-3.17-Windows.exe">http://heanet.dl.sourceforge.net/project/bbbike/BBBike/3.17/BBBike-3.17-Windows.exe</a> and just start it for the installation
<a class="POD_LINK" href="http://sourceforge.net/projects/bbbike/files/BBBike/3.18/BBBike-3.18-Windows.exe/download">http://sourceforge.net/projects/bbbike/files/BBBike/3.18/BBBike-3.18-Windows.exe/download</a> and just start it for the installation
program.
</p>
<h4 class="POD_HEAD3"><a name="Alternative_Windows_">Alternative Windows Installation (1)</a></h4>
Expand All @@ -244,32 +248,36 @@ <h4 class="POD_HEAD3"><a name="Alternative_Windows_">Alternative Windows Install
Download the perl distribution from the ActiveState webpage:
</p>
<p class="POD_TEXT">
<a class="POD_LINK" href="http://www.activestate.com/Products/ActivePerl/Download.html">http://www.activestate.com/Products/ActivePerl/Download.html</a>
<a class="POD_LINK" href="http://www.activestate.com/activeperl/downloads">http://www.activestate.com/activeperl/downloads</a>
</p>
<p></p>
<p></p>
<p class="POD_TEXT">
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:
</p>
<p class="POD_TEXT">
In current ActivePerl versions the Tk module is already included and
does not need to be installed.
<a class="POD_LINK" href="http://strawberryperl.com/">http://strawberryperl.com/</a>
</p>
<p></p>
<p></p>
<p class="POD_TEXT">
The Tk module needs to be installed using the following commands in
cmd.exe:
</p>
<pre class="POD_VERBATIM">
perl -MCPAN -eshell
force notest install Tk
quit
</pre>
<p></p>
<li class="POD_ITEM"><a name="_1"></a>
<p class="POD_TEXT">
Download
<code>BBBike-3.17.tar.gz|http://heanet.dl.sourceforge.net/project/bbbike/BBBike/3.17/BBBike-3.17-Windows.exe</code>
and extract this file with
WinZip. The unpacked directory will not move in the later
installation.
<a class="POD_LINK" href="http://sourceforge.net/projects/bbbike/files/BBBike/3.18/BBBike-3.18-Windows.exe/download">BBBike-3.18.tar.gz</a>
and extract this file. The unpacked directory may be moved to another
position in the filesystem.
</p>
<li class="POD_ITEM"><a name="_2"></a>
<p class="POD_TEXT">
Open the explorer, change to the BBBike-3.17 directory and call
Open the explorer, change to the BBBike-3.18 directory and call
</p>
<p></p>
<pre class="POD_VERBATIM">
Expand All @@ -288,7 +296,7 @@ <h4 class="POD_HEAD3"><a name="Alternative_Windows_1">Alternative Windows Instal
</p>
<h4 class="POD_HEAD3"><a name="Alternative_Windows_2">Alternative Windows Installation (3)</a></h4>
<p class="POD_TEXT">
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:
</p>
<p class="POD_TEXT">
Expand All @@ -311,6 +319,7 @@ <h4 class="POD_HEAD3"><a name="Windows_3_1">Windows 3.1</a></h4>
</p>
<p></p>
<h2 class="POD_HEAD1"><a name="EXECUTION">EXECUTION</a></h2>
<h3 class="POD_HEAD2"><a name="Perl_Tk_version">Perl/Tk version</a></h3>
<p class="POD_TEXT">
To execute BBBike on Unix, change to the bbbike directory and type
</p>
Expand All @@ -319,26 +328,24 @@ <h2 class="POD_HEAD1"><a name="EXECUTION">EXECUTION</a></h2>
perl bbbike
</pre>
<p class="POD_TEXT">
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.
</p>
<p class="POD_TEXT">
To switch the English language support, please set the LC_ALL,
LC_MESSAGES, or LANG environment variables to &quot;en&quot; or something
similar (for FreeBSD and Linux, this is &quot;en-GB.ISO8859-1&quot;). For Unix,
similar (for FreeBSD and Linux, this is &quot;en_US.UTF-8&quot;). For Unix,
this can be done with
</p>
<p></p>
<pre class="POD_VERBATIM">
env LC_ALL=en-GB.ISO8859-1 perl bbbike
env LC_ALL=en_US.UTF-8 perl bbbike
</pre>
<p></p>
<p class="POD_TEXT">
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.
</p>
<h3 class="POD_HEAD2"><a name="WWW_version">WWW version</a></h3>
Expand All @@ -355,18 +362,16 @@ <h3 class="POD_HEAD2"><a name="WWW_version">WWW version</a></h3>
<a class="POD_LINK" href="http://bbbike.de/cgi-bin/bbbike.cgi/info=1">http://bbbike.de/cgi-bin/bbbike.cgi/info=1</a>
</p>
<p></p>
<h3 class="POD_HEAD2"><a name="Non_GUI_version">Non GUI version</a></h3>
<p class="POD_TEXT">
<code>cbbbike</code> and <code>cmdbbbike</code> are simpler command line versions of the program.
</p>
<h2 class="POD_HEAD1"><a name="DEVELOPMENT">DEVELOPMENT</a></h2>
<p></p>
<p></p>
<p></p>
<h2 class="POD_HEAD1"><a name="DEVELOPMENT">DEVELOPMENT</a></h2>
<h3 class="POD_HEAD2"><a name="git">git</a></h3>
<p class="POD_TEXT">
The current BBBike development may be tracked via git.
</p>
<p class="POD_TEXT">
To use the git repository from command line type the following:
To fetch the git repository type the following in the command line:
</p>
<p></p>
<pre class="POD_VERBATIM">
Expand All @@ -380,16 +385,12 @@ <h3 class="POD_HEAD2"><a name="git">git</a></h3>
git pull
</pre>
<p class="POD_TEXT">
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.
</p>
<p></p>
<h3 class="POD_HEAD2"><a name="CVS">CVS</a></h3>
<p class="POD_TEXT">
If git cannot be used, then there&#39;s still the possibility to access
the old CVS repository (:pserver:[email protected]:/cvsroot/bbbike). Note that it&#39;s not guaranteed that
updates occur in the same frequency as for the git repository.
</p>
<p></p>
<p></p>
<h3 class="POD_HEAD2"><a name="Application_update">Application update</a></h3>
<p class="POD_TEXT">
It is also possible to download a current snapshot using the URL
Expand All @@ -402,6 +403,11 @@ <h3 class="POD_HEAD2"><a name="Data_update">Data update</a></h3>
extracted in the BBBike program directory (Windows: in
<code>C:\Programme\BBBike\bbbike</code>).
</p>
<p class="POD_TEXT">
The data may also be updated within the Perl/Tk application, using the
menu item Settings &gt; Data update over internet.
</p>
<p></p>
<h2 class="POD_HEAD1"><a name="DOCUMENTATION">DOCUMENTATION</a></h2>
<p class="POD_TEXT">
The <a class="POD_LINK" href="bbbike.html">documentation</a> can be accessed in pod format (<code>bbbike.pod</code>) or in
Expand All @@ -426,7 +432,7 @@ <h2 class="POD_HEAD1"><a name="LICENSE">LICENSE</a></h2>
Consortium, <code>ext/BBBikeXS/sqrt.c</code> by Eyal Lebedinsky.
</p>
<p class="POD_TEXT">
<code>BBBike-3.17-Windows.zip</code> contains a partial
<code>BBBike-3.18-Windows.zip</code> contains a partial
<code>Strawberry Perl</code> distribution, see
<a class="POD_LINK" href="http://strawberryperl.com/">http://strawberryperl.com/</a>
</p>
Expand Down
Loading

0 comments on commit 6ad0a7e

Please sign in to comment.