Skip to content

Commit 6ad0a7e

Browse files
eserteeserte
committed
* regenerated html variants
1 parent 1263d6b commit 6ad0a7e

File tree

2 files changed

+129
-118
lines changed

2 files changed

+129
-118
lines changed

‎doc/README.english.html‎

Lines changed: 61 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ <h1 class="POD_TITLE">README.english</h1>
1616
<hr />
1717
<ul>
1818
<li><a class="POD_NAVLINK" href="#README">README</a>
19-
<li><a class="POD_NAVLINK" href="#PREBUILD_PACKAGES">PREBUILD PACKAGES</a>
19+
<li><a class="POD_NAVLINK" href="#PREBUILT_PACKAGES">PREBUILT PACKAGES</a>
2020
<li><a class="POD_NAVLINK" href="#INSTALLATION">INSTALLATION</a>
2121
<ul>
2222
<li><a class="POD_NAVLINK" href="#All_systems_except_W">All systems except Windows</a>
@@ -26,7 +26,7 @@ <h1 class="POD_TITLE">README.english</h1>
2626
<li><a class="POD_NAVLINK" href="#Linux_Solaris_other_">Linux, Solaris, other UNIX operating systems</a>
2727
<li><a class="POD_NAVLINK" href="#Mac_OS_X">Mac OS X</a>
2828
</ul>
29-
<li><a class="POD_NAVLINK" href="#Windows_95_98_2000_N">Windows 95/98/2000/NT/XP</a>
29+
<li><a class="POD_NAVLINK" href="#Windows_95_98_2000_N">Windows 95/98/2000/NT/XP/Vista/7/8</a>
3030
<ul>
3131
<li><a class="POD_NAVLINK" href="#Normal_installation">Normal installation</a>
3232
<li><a class="POD_NAVLINK" href="#Alternative_Windows_">Alternative Windows Installation (1)</a>
@@ -37,13 +37,12 @@ <h1 class="POD_TITLE">README.english</h1>
3737
</ul>
3838
<li><a class="POD_NAVLINK" href="#EXECUTION">EXECUTION</a>
3939
<ul>
40+
<li><a class="POD_NAVLINK" href="#Perl_Tk_version">Perl/Tk version</a>
4041
<li><a class="POD_NAVLINK" href="#WWW_version">WWW version</a>
41-
<li><a class="POD_NAVLINK" href="#Non_GUI_version">Non GUI version</a>
4242
</ul>
4343
<li><a class="POD_NAVLINK" href="#DEVELOPMENT">DEVELOPMENT</a>
4444
<ul>
4545
<li><a class="POD_NAVLINK" href="#git">git</a>
46-
<li><a class="POD_NAVLINK" href="#CVS">CVS</a>
4746
<li><a class="POD_NAVLINK" href="#Application_update">Application update</a>
4847
<li><a class="POD_NAVLINK" href="#Data_update">Data update</a>
4948
</ul>
@@ -56,11 +55,14 @@ <h2 class="POD_HEAD1"><a name="README">README</a></h2>
5655
<p class="POD_TEXT">
5756
BBBike - a route-finder for cyclists in Berlin and Brandenburg
5857
</p>
59-
<h2 class="POD_HEAD1"><a name="PREBUILD_PACKAGES">PREBUILD PACKAGES</a></h2>
58+
<h2 class="POD_HEAD1"><a name="PREBUILT_PACKAGES">PREBUILT PACKAGES</a></h2>
6059
<p class="POD_TEXT">
61-
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
62-
packages. But keep in mind that the versions there might not represent
63-
the newest state and maybe your operating system is not covered.
60+
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
61+
packages (Windows, einige Linux-Distributionen, MacOSX, FreeBSD).
62+
</p>
63+
<p class="POD_TEXT">
64+
The following installation steps are necessary only for installing
65+
BBBike from source.
6466
</p>
6567
<h2 class="POD_HEAD1"><a name="INSTALLATION">INSTALLATION</a></h2>
6668
<p></p>
@@ -70,7 +72,7 @@ <h4 class="POD_HEAD3"><a name="Download">Download</a></h4>
7072
<p class="POD_TEXT">
7173
You can find the newest source distribution file of BBBike in the directory
7274
<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
73-
<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> .
75+
<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> .
7476
</p>
7577
<h4 class="POD_HEAD3"><a name="FreeBSD">FreeBSD</a></h4>
7678
<p class="POD_TEXT">
@@ -88,30 +90,31 @@ <h4 class="POD_HEAD3"><a name="FreeBSD">FreeBSD</a></h4>
8890
</p>
8991
<h4 class="POD_HEAD3"><a name="Linux_Solaris_other_">Linux, Solaris, other UNIX operating systems</a></h4>
9092
<p class="POD_TEXT">
91-
First, you have to install perl5. Most operating systems have perl
93+
First, you have to install perl. Most operating systems have perl
9294
already bundled. You can check with
9395
</p>
9496
<pre class="POD_VERBATIM">
95-
perl -V
97+
perl -v
9698
</pre>
9799
<p class="POD_TEXT">
98100
whether and which version of perl is installed. Otherwise you can find
99-
perl5 at <a class="POD_LINK" href="http://www.perl.com">http://www.perl.com</a>. You need at least version 5.005.
101+
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
102+
5.005, but newer perl versions (5.6.x, 5.8.x, 5.10.x, 5.12.x, 5.14.x,
103+
5.16.x) work, too.
100104
</p>
101105
<p class="POD_TEXT">
102106
Next step is to extract the BBBike distribution:
103107
</p>
104108
<p></p>
105109
<pre class="POD_VERBATIM">
106-
zcat BBBike-3.17.tar.gz | tar xfv -
110+
zcat BBBike-3.18.tar.gz | tar xfv -
107111
</pre>
108112
<p class="POD_TEXT">
109113
If perl/Tk (the recommended version is 804.028 or 800.025) is not installed:
110-
change to the directory
111-
<code>BBBike-3.17</code> and type as super user:
114+
type as super user:
112115
</p>
113-
<p></p>
114116
<pre class="POD_VERBATIM">
117+
cd BBBike-3.18
115118
perl -I`pwd` -MCPAN -e shell
116119
force install Bundle::BBBike_small
117120
quit
@@ -137,9 +140,10 @@ <h4 class="POD_HEAD3"><a name="Linux_Solaris_other_">Linux, Solaris, other UNIX
137140
<pre class="POD_VERBATIM">
138141
perl bbbike
139142
</pre>
143+
<p></p>
140144
<p class="POD_TEXT">
141145
To compile some XS modules (this is optional and needs a C compiler)
142-
and install the panel entry for KDE, type:
146+
and install the panel entry for KDE/GNOME, type:
143147
</p>
144148
<p></p>
145149
<pre class="POD_VERBATIM">
@@ -181,7 +185,7 @@ <h4 class="POD_HEAD3"><a name="Mac_OS_X">Mac OS X</a></h4>
181185
The following instructions are from Wolfram Kroll:
182186
</p>
183187
<p class="POD_TEXT">
184-
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
188+
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
185189
<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
186190
</p>
187191
<ol class="POD_LIST">
@@ -223,14 +227,14 @@ <h4 class="POD_HEAD3"><a name="Mac_OS_X">Mac OS X</a></h4>
223227
Mac OS Classic is not supported.
224228
</p>
225229
<p></p>
226-
<h3 class="POD_HEAD2"><a name="Windows_95_98_2000_N">Windows 95/98/2000/NT/XP</a></h3>
230+
<h3 class="POD_HEAD2"><a name="Windows_95_98_2000_N">Windows 95/98/2000/NT/XP/Vista/7/8</a></h3>
227231
<h4 class="POD_HEAD3"><a name="Normal_installation">Normal installation</a></h4>
228232
<p class="POD_TEXT">
229233
BBBike and Perl need approx. 32 MB hard disk space.
230234
</p>
231235
<p class="POD_TEXT">
232236
Download the file
233-
<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
237+
<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
234238
program.
235239
</p>
236240
<h4 class="POD_HEAD3"><a name="Alternative_Windows_">Alternative Windows Installation (1)</a></h4>
@@ -244,32 +248,36 @@ <h4 class="POD_HEAD3"><a name="Alternative_Windows_">Alternative Windows Install
244248
Download the perl distribution from the ActiveState webpage:
245249
</p>
246250
<p class="POD_TEXT">
247-
<a class="POD_LINK" href="http://www.activestate.com/Products/ActivePerl/Download.html">http://www.activestate.com/Products/ActivePerl/Download.html</a>
251+
<a class="POD_LINK" href="http://www.activestate.com/activeperl/downloads">http://www.activestate.com/activeperl/downloads</a>
248252
</p>
249-
<p></p>
250-
<p></p>
251253
<p class="POD_TEXT">
252-
Usually, there are two files needed for the installation: the Windows
253-
Installer and the Perl distribution for Windows Intel. You have to
254-
execute both files. While installing Perl, you will have to reboot
255-
your computer.
254+
or alternatively use Strawberry Perl:
256255
</p>
257256
<p class="POD_TEXT">
258-
In current ActivePerl versions the Tk module is already included and
259-
does not need to be installed.
257+
<a class="POD_LINK" href="http://strawberryperl.com/">http://strawberryperl.com/</a>
260258
</p>
261259
<p></p>
260+
<p></p>
261+
<p class="POD_TEXT">
262+
The Tk module needs to be installed using the following commands in
263+
cmd.exe:
264+
</p>
265+
<pre class="POD_VERBATIM">
266+
perl -MCPAN -eshell
267+
force notest install Tk
268+
quit
269+
</pre>
270+
<p></p>
262271
<li class="POD_ITEM"><a name="_1"></a>
263272
<p class="POD_TEXT">
264273
Download
265-
<code>BBBike-3.17.tar.gz|http://heanet.dl.sourceforge.net/project/bbbike/BBBike/3.17/BBBike-3.17-Windows.exe</code>
266-
and extract this file with
267-
WinZip. The unpacked directory will not move in the later
268-
installation.
274+
<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>
275+
and extract this file. The unpacked directory may be moved to another
276+
position in the filesystem.
269277
</p>
270278
<li class="POD_ITEM"><a name="_2"></a>
271279
<p class="POD_TEXT">
272-
Open the explorer, change to the BBBike-3.17 directory and call
280+
Open the explorer, change to the BBBike-3.18 directory and call
273281
</p>
274282
<p></p>
275283
<pre class="POD_VERBATIM">
@@ -288,7 +296,7 @@ <h4 class="POD_HEAD3"><a name="Alternative_Windows_1">Alternative Windows Instal
288296
</p>
289297
<h4 class="POD_HEAD3"><a name="Alternative_Windows_2">Alternative Windows Installation (3)</a></h4>
290298
<p class="POD_TEXT">
291-
As an further alternative, you can download an older distribution with Tk
299+
For very old systems (Windows95, 98) you can download an older distribution with Tk
292300
included:
293301
</p>
294302
<p class="POD_TEXT">
@@ -311,6 +319,7 @@ <h4 class="POD_HEAD3"><a name="Windows_3_1">Windows 3.1</a></h4>
311319
</p>
312320
<p></p>
313321
<h2 class="POD_HEAD1"><a name="EXECUTION">EXECUTION</a></h2>
322+
<h3 class="POD_HEAD2"><a name="Perl_Tk_version">Perl/Tk version</a></h3>
314323
<p class="POD_TEXT">
315324
To execute BBBike on Unix, change to the bbbike directory and type
316325
</p>
@@ -319,26 +328,24 @@ <h2 class="POD_HEAD1"><a name="EXECUTION">EXECUTION</a></h2>
319328
perl bbbike
320329
</pre>
321330
<p class="POD_TEXT">
322-
in the shell. With a full KDE installation, there is an icon in the
331+
in the shell. With a full KDE/GNOME installation, there is an icon in the
323332
application menu item
324333
of the start menu. On Windows, there is a start menu entry for
325334
BBBike.
326335
</p>
327336
<p class="POD_TEXT">
328337
To switch the English language support, please set the LC_ALL,
329338
LC_MESSAGES, or LANG environment variables to &quot;en&quot; or something
330-
similar (for FreeBSD and Linux, this is &quot;en-GB.ISO8859-1&quot;). For Unix,
339+
similar (for FreeBSD and Linux, this is &quot;en_US.UTF-8&quot;). For Unix,
331340
this can be done with
332341
</p>
333342
<p></p>
334343
<pre class="POD_VERBATIM">
335-
env LC_ALL=en-GB.ISO8859-1 perl bbbike
344+
env LC_ALL=en_US.UTF-8 perl bbbike
336345
</pre>
337346
<p></p>
338347
<p class="POD_TEXT">
339-
BBBike is a memory and cpu hog. You need at least 16 MB RAM on i386
340-
platforms (Solaris needs at least 32 MB), but with 32/64 MB it will
341-
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
348+
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
342349
development machine runs with FreeBSD.
343350
</p>
344351
<h3 class="POD_HEAD2"><a name="WWW_version">WWW version</a></h3>
@@ -355,18 +362,16 @@ <h3 class="POD_HEAD2"><a name="WWW_version">WWW version</a></h3>
355362
<a class="POD_LINK" href="http://bbbike.de/cgi-bin/bbbike.cgi/info=1">http://bbbike.de/cgi-bin/bbbike.cgi/info=1</a>
356363
</p>
357364
<p></p>
358-
<h3 class="POD_HEAD2"><a name="Non_GUI_version">Non GUI version</a></h3>
359-
<p class="POD_TEXT">
360-
<code>cbbbike</code> and <code>cmdbbbike</code> are simpler command line versions of the program.
361-
</p>
362-
<h2 class="POD_HEAD1"><a name="DEVELOPMENT">DEVELOPMENT</a></h2>
363365
<p></p>
366+
<p></p>
367+
<p></p>
368+
<h2 class="POD_HEAD1"><a name="DEVELOPMENT">DEVELOPMENT</a></h2>
364369
<h3 class="POD_HEAD2"><a name="git">git</a></h3>
365370
<p class="POD_TEXT">
366371
The current BBBike development may be tracked via git.
367372
</p>
368373
<p class="POD_TEXT">
369-
To use the git repository from command line type the following:
374+
To fetch the git repository type the following in the command line:
370375
</p>
371376
<p></p>
372377
<pre class="POD_VERBATIM">
@@ -380,16 +385,12 @@ <h3 class="POD_HEAD2"><a name="git">git</a></h3>
380385
git pull
381386
</pre>
382387
<p class="POD_TEXT">
383-
The git repository is always up-to-date and also contains the current
388+
The git repository is frequently updated and also contains the current
384389
data.
385390
</p>
386391
<p></p>
387-
<h3 class="POD_HEAD2"><a name="CVS">CVS</a></h3>
388-
<p class="POD_TEXT">
389-
If git cannot be used, then there&#39;s still the possibility to access
390-
the old CVS repository (:pserver:anonymous@bbbike.cvs.sourceforge.net:/cvsroot/bbbike). Note that it&#39;s not guaranteed that
391-
updates occur in the same frequency as for the git repository.
392-
</p>
392+
<p></p>
393+
<p></p>
393394
<h3 class="POD_HEAD2"><a name="Application_update">Application update</a></h3>
394395
<p class="POD_TEXT">
395396
It is also possible to download a current snapshot using the URL
@@ -402,6 +403,11 @@ <h3 class="POD_HEAD2"><a name="Data_update">Data update</a></h3>
402403
extracted in the BBBike program directory (Windows: in
403404
<code>C:\Programme\BBBike\bbbike</code>).
404405
</p>
406+
<p class="POD_TEXT">
407+
The data may also be updated within the Perl/Tk application, using the
408+
menu item Settings &gt; Data update over internet.
409+
</p>
410+
<p></p>
405411
<h2 class="POD_HEAD1"><a name="DOCUMENTATION">DOCUMENTATION</a></h2>
406412
<p class="POD_TEXT">
407413
The <a class="POD_LINK" href="bbbike.html">documentation</a> can be accessed in pod format (<code>bbbike.pod</code>) or in
@@ -426,7 +432,7 @@ <h2 class="POD_HEAD1"><a name="LICENSE">LICENSE</a></h2>
426432
Consortium, <code>ext/BBBikeXS/sqrt.c</code> by Eyal Lebedinsky.
427433
</p>
428434
<p class="POD_TEXT">
429-
<code>BBBike-3.17-Windows.zip</code> contains a partial
435+
<code>BBBike-3.18-Windows.zip</code> contains a partial
430436
<code>Strawberry Perl</code> distribution, see
431437
<a class="POD_LINK" href="http://strawberryperl.com/">http://strawberryperl.com/</a>
432438
</p>

0 commit comments

Comments
 (0)