documentation updates on building on ubuntu and suse

This commit is contained in:
Arvid Norberg 2006-12-02 14:10:09 +00:00
parent 4f68ca55dc
commit c2d31bb2b7
9 changed files with 215 additions and 7 deletions

BIN
docs/acquasition.jpg Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.5 KiB

View File

@ -22,7 +22,8 @@
<div class="contents topic" id="table-of-contents"> <div class="contents topic" id="table-of-contents">
<p class="topic-title first"><a name="table-of-contents">Table of contents</a></p> <p class="topic-title first"><a name="table-of-contents">Table of contents</a></p>
<ul class="simple"> <ul class="simple">
<li><a class="reference" href="#downloading-and-building" id="id7" name="id7">downloading and building</a><ul> <li><a class="reference" href="#downloading-and-building" id="id6" name="id6">downloading and building</a><ul>
<li><a class="reference" href="#contributed-build-tutorials" id="id7" name="id7">Contributed build tutorials</a></li>
<li><a class="reference" href="#building-with-bbv2" id="id8" name="id8">building with BBv2</a></li> <li><a class="reference" href="#building-with-bbv2" id="id8" name="id8">building with BBv2</a></li>
<li><a class="reference" href="#building-with-autotools" id="id9" name="id9">building with autotools</a></li> <li><a class="reference" href="#building-with-autotools" id="id9" name="id9">building with autotools</a></li>
<li><a class="reference" href="#building-with-other-build-systems" id="id10" name="id10">building with other build systems</a></li> <li><a class="reference" href="#building-with-other-build-systems" id="id10" name="id10">building with other build systems</a></li>
@ -39,8 +40,16 @@ You'll find instructions on how to do this <a class="reference" href="http://sou
(BBv2) and autotools (for unix-like systems). If you still can't build after (BBv2) and autotools (for unix-like systems). If you still can't build after
following these instructions, you can usually get help in the <tt class="docutils literal"><span class="pre">#libtorrent</span></tt> following these instructions, you can usually get help in the <tt class="docutils literal"><span class="pre">#libtorrent</span></tt>
IRC channel on <tt class="docutils literal"><span class="pre">irc.freenode.net</span></tt>.</p> IRC channel on <tt class="docutils literal"><span class="pre">irc.freenode.net</span></tt>.</p>
<p>If you want to build the cvs version on Ubuntu (and possibly other Linux <div class="section">
distros), see <a class="reference" href="ubuntu_build_notes.html">this</a> document.</p> <h2><a id="contributed-build-tutorials" name="contributed-build-tutorials">Contributed build tutorials</a></h2>
<ul class="simple">
<li>libtorrent cvs, <a class="reference" href="ubuntu_build_notes.html">ubuntu</a></li>
<li><a class="reference" href="ubuntu_6_build_notes.html">ubuntu 6.10</a></li>
<li><a class="reference" href="suse_build_notes.html">suse</a></li>
<li><a class="reference" href="vs2005_build_notes.html">visual studio 2005</a></li>
</ul>
<p>These tutorials may work on similar linux distros as well.</p>
</div>
<div class="section"> <div class="section">
<h2><a id="building-with-bbv2" name="building-with-bbv2">building with BBv2</a></h2> <h2><a id="building-with-bbv2" name="building-with-bbv2">building with BBv2</a></h2>
<p>The primary reason to use boost-build is that it will automatically build the <p>The primary reason to use boost-build is that it will automatically build the
@ -337,7 +346,7 @@ with the following option:</p>
<p>The above option make use of -DNDEBUG, which is used throughout libtorrent.</p> <p>The above option make use of -DNDEBUG, which is used throughout libtorrent.</p>
</div> </div>
<div class="section"> <div class="section">
<h3><a id="id6" name="id6">Step 3: Building libtorrent</a></h3> <h3><a id="id5" name="id5">Step 3: Building libtorrent</a></h3>
<p>Once the configure script is run successfully, you just type <tt class="docutils literal"><span class="pre">make</span></tt> and <p>Once the configure script is run successfully, you just type <tt class="docutils literal"><span class="pre">make</span></tt> and
libtorrent, the examples and the tests will be built.</p> libtorrent, the examples and the tests will be built.</p>
<p>When libtorrent is built it may be a good idea to run the tests, you do this <p>When libtorrent is built it may be a good idea to run the tests, you do this

View File

@ -21,10 +21,20 @@ The build systems supported "out of the box" in libtorrent are boost-build v2
following these instructions, you can usually get help in the ``#libtorrent`` following these instructions, you can usually get help in the ``#libtorrent``
IRC channel on ``irc.freenode.net``. IRC channel on ``irc.freenode.net``.
If you want to build the cvs version on Ubuntu (and possibly other Linux Contributed build tutorials
distros), see this__ document. ---------------------------
__ ubuntu_build_notes.html * libtorrent cvs, ubuntu_
* `ubuntu 6.10`_
* suse_
* `visual studio 2005`_
These tutorials may work on similar linux distros as well.
.. _ubuntu: ubuntu_build_notes.html
.. _`ubuntu 6.10`: ubuntu_6_build_notes.html
.. _suse: suse_build_notes.html
.. _`visual studio 2005`: vs2005_build_notes.html
building with BBv2 building with BBv2
------------------ ------------------

View File

@ -57,6 +57,13 @@ and Johan Ström.</p>
<td><img alt="bitrocket_thumb.png" class="first last" src="bitrocket_thumb.png" /> <td><img alt="bitrocket_thumb.png" class="first last" src="bitrocket_thumb.png" />
</td> </td>
</tr> </tr>
<tr><td><p class="first"><strong>Acquasition</strong></p>
<p class="last"><a class="reference" href="http://www.acquisitionx.com">Acquasition</a> is a multi-network peer-to-peer
client for Mac.</p>
</td>
<td><img alt="acquasition.jpg" class="first last" src="acquasition.jpg" />
</td>
</tr>
<tr><td><p class="first"><strong>Instant Media</strong></p> <tr><td><p class="first"><strong>Instant Media</strong></p>
<p class="last"><a class="reference" href="http://www.im.com/">IM</a> is a client for downloading Internet TV.</p> <p class="last"><a class="reference" href="http://www.im.com/">IM</a> is a client for downloading Internet TV.</p>
</td> </td>

View File

@ -37,6 +37,12 @@ project listed here, let me_ know.
| | | | | |
| BitRocket_ is a MacOS X bittorrent client. | | | BitRocket_ is a MacOS X bittorrent client. | |
+-------------------------------------------------------------------------------+-------------------------------------+ +-------------------------------------------------------------------------------+-------------------------------------+
| **Acquasition** | .. image:: acquasition.jpg |
| | |
| Acquasition_ is a multi-network peer-to-peer | |
| client for Mac. | |
| | |
+-------------------------------------------------------------------------------+-------------------------------------+
| **Instant Media** | .. image:: im_thumb.jpg | | **Instant Media** | .. image:: im_thumb.jpg |
| | | | | |
| IM_ is a client for downloading Internet TV. | | | IM_ is a client for downloading Internet TV. | |
@ -107,6 +113,7 @@ project listed here, let me_ know.
.. _qBittorrent: http://www.qbittorrent.org/ .. _qBittorrent: http://www.qbittorrent.org/
.. _btg: http://developer.berlios.de/projects/btg/ .. _btg: http://developer.berlios.de/projects/btg/
.. _BitRocket: http://www.bitrocket.org/ .. _BitRocket: http://www.bitrocket.org/
.. _Acquasition: http://www.acquisitionx.com
.. _IM: http://www.im.com/ .. _IM: http://www.im.com/
.. _MooPolice: http://www.moopolice.de .. _MooPolice: http://www.moopolice.de
.. _BitsCast: http://www.bitscast.com/software/ .. _BitsCast: http://www.bitscast.com/software/

View File

@ -0,0 +1,60 @@
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="generator" content="Docutils 0.5: http://docutils.sourceforge.net/" />
<title></title>
<meta name="author" content="Torsten Bergander" />
<link rel="stylesheet" href="style.css" type="text/css" />
</head>
<body>
<div class="document">
<table class="docinfo" frame="void" rules="none">
<col class="docinfo-name" />
<col class="docinfo-content" />
<tbody valign="top">
<tr><th class="docinfo-name">Author:</th>
<td>Torsten Bergander</td></tr>
</tbody>
</table>
<div class="section">
<h1><a id="building-libtorrent-on-suse-10-1-i586" name="building-libtorrent-on-suse-10-1-i586">building libtorrent on SuSE 10.1 (i586)</a></h1>
<ol class="arabic" start="0">
<li><dl class="first docutils">
<dt>Prerequisites</dt>
<dd><p class="first">Install packages <tt class="docutils literal"><span class="pre">boost</span></tt> and <tt class="docutils literal"><span class="pre">boost-devel</span></tt> from packman:
<a class="reference" href="http://packman.links2linux.org/package/boost/10887">http://packman.links2linux.org/package/boost/10887</a></p>
<p class="last">There are standard packages delivered with the distribution. They give
some headaches when building new stuff, so the above mentioned ones fix
these problems.
All other potential prerequisites are available via yast in the standard
distribution.</p>
</dd>
</dl>
</li>
<li><dl class="first docutils">
<dt>Building and installing the lib</dt>
<dd><p class="first">Get the libtorrent-011 release tarbal, unpack and change into its
directory. Then:</p>
<pre class="literal-block">
./configure --with-boost-date-time=boost_date_time
--with-boost-filesystem=boost_filesystem
--with-boost-thread=boost_thread-mt --with-boost-regex=boost_regex
--with-boost-program-options=boost_program_options --disable-debug
make
sudo make install
</pre>
<p class="last">If you don't give the --with-boost parameters configure does not find
the main in the libs and fails. Also, when later installing e.g. btg,
you have to make sure to use the same parameters there, otherwise it is
bound to fail.</p>
</dd>
</dl>
</li>
</ol>
</div>
</div>
</body>
</html>

31
docs/suse_build_notes.rst Normal file
View File

@ -0,0 +1,31 @@
:Author: Torsten Bergander
building libtorrent on SuSE 10.1 (i586)
=======================================
0. Prerequisites
Install packages ``boost`` and ``boost-devel`` from packman:
http://packman.links2linux.org/package/boost/10887
There are standard packages delivered with the distribution. They give
some headaches when building new stuff, so the above mentioned ones fix
these problems.
All other potential prerequisites are available via yast in the standard
distribution.
1. Building and installing the lib
Get the libtorrent-011 release tarbal, unpack and change into its
directory. Then::
./configure --with-boost-date-time=boost_date_time
--with-boost-filesystem=boost_filesystem
--with-boost-thread=boost_thread-mt --with-boost-regex=boost_regex
--with-boost-program-options=boost_program_options --disable-debug
make
sudo make install
If you don't give the --with-boost parameters configure does not find
the main in the libs and fails. Also, when later installing e.g. btg,
you have to make sure to use the same parameters there, otherwise it is
bound to fail.

View File

@ -0,0 +1,55 @@
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="generator" content="Docutils 0.5: http://docutils.sourceforge.net/" />
<title></title>
<meta name="author" content="Torsten Bergander" />
<link rel="stylesheet" href="style.css" type="text/css" />
</head>
<body>
<div class="document">
<table class="docinfo" frame="void" rules="none">
<col class="docinfo-name" />
<col class="docinfo-content" />
<tbody valign="top">
<tr><th class="docinfo-name">Author:</th>
<td>Torsten Bergander</td></tr>
</tbody>
</table>
<div class="section">
<h1><a id="building-libtorrent-0-11-on-ubuntu-edy-eft-6-10" name="building-libtorrent-0-11-on-ubuntu-edy-eft-6-10">building libtorrent-0.11 on ubuntu Edy Eft 6.10</a></h1>
<ol class="arabic">
<li><p class="first">Install prerequisites (maybe cann be stripped down but it works):</p>
<pre class="literal-block">
sudo apt-get install bjam boost-build libboost-date-time-dev
libboost-date-time1.33.1 libboost-filesystem-dev
libboost-filesystem1.33.1 libboost-graph-dev libboost-graph1.33.1
libboost-iostreams-dev libboost-iostreams1.33.1
libboost-program-options-dev libboost-program-options1.33.1
libboost-regex-dev libboost-regex1.33.1 libboost-serialization-dev
libboost-signals-dev libboost-signals1.33.1 libboost-test-dev
libboost-test1.33.1 libboost-thread-dev libboost-thread1.33.1
libboost-wave-dev libboost-dev
</pre>
</li>
<li><p class="first">Get release tar ball (0.11 at time of writing), unpack, change into:</p>
<pre class="literal-block">
libtorrent-0.11 dir
</pre>
</li>
<li><p class="first">Build and install:</p>
<pre class="literal-block">
export BOOST_BUILD_PATH=/usr/share/boost-build/tools
./configure
make
sudo make install
</pre>
</li>
</ol>
</div>
</div>
</body>
</html>

View File

@ -0,0 +1,29 @@
:Author: Torsten Bergander
building libtorrent-0.11 on ubuntu Edy Eft 6.10
===============================================
1. Install prerequisites (maybe cann be stripped down but it works)::
sudo apt-get install bjam boost-build libboost-date-time-dev
libboost-date-time1.33.1 libboost-filesystem-dev
libboost-filesystem1.33.1 libboost-graph-dev libboost-graph1.33.1
libboost-iostreams-dev libboost-iostreams1.33.1
libboost-program-options-dev libboost-program-options1.33.1
libboost-regex-dev libboost-regex1.33.1 libboost-serialization-dev
libboost-signals-dev libboost-signals1.33.1 libboost-test-dev
libboost-test1.33.1 libboost-thread-dev libboost-thread1.33.1
libboost-wave-dev libboost-dev
2. Get release tar ball (0.11 at time of writing), unpack, change into::
libtorrent-0.11 dir
3. Build and install::
export BOOST_BUILD_PATH=/usr/share/boost-build/tools
./configure
make
sudo make install