From c2d31bb2b700269d283a9e28aeb4ca515d1ce1d2 Mon Sep 17 00:00:00 2001 From: Arvid Norberg Date: Sat, 2 Dec 2006 14:10:09 +0000 Subject: [PATCH] documentation updates on building on ubuntu and suse --- docs/acquasition.jpg | Bin 0 -> 8698 bytes docs/building.html | 17 +++++++--- docs/building.rst | 16 +++++++-- docs/projects.html | 7 ++++ docs/projects.rst | 7 ++++ docs/suse_build_notes.html | 60 +++++++++++++++++++++++++++++++++ docs/suse_build_notes.rst | 31 +++++++++++++++++ docs/ubuntu_6_build_notes.html | 55 ++++++++++++++++++++++++++++++ docs/ubuntu_6_build_notes.rst | 29 ++++++++++++++++ 9 files changed, 215 insertions(+), 7 deletions(-) create mode 100644 docs/acquasition.jpg create mode 100644 docs/suse_build_notes.html create mode 100644 docs/suse_build_notes.rst create mode 100644 docs/ubuntu_6_build_notes.html create mode 100644 docs/ubuntu_6_build_notes.rst diff --git a/docs/acquasition.jpg b/docs/acquasition.jpg new file mode 100644 index 0000000000000000000000000000000000000000..51acc44d67eca67104e4ec955c2ea57c33117a84 GIT binary patch literal 8698 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 ju75xG literal 0 HcmV?d00001 diff --git a/docs/building.html b/docs/building.html index 83eec016e..cc1182614 100644 --- a/docs/building.html +++ b/docs/building.html @@ -22,7 +22,8 @@

Table of contents

    -
  • downloading and building
      +
    • downloading and building
        +
      • Contributed build tutorials
      • building with BBv2
      • building with autotools
      • building with other build systems
        • @@ -39,8 +40,16 @@ You'll find instructions on how to do this #libtorrent IRC channel on irc.freenode.net.

        -

        If you want to build the cvs version on Ubuntu (and possibly other Linux -distros), see this document.

        +
        +

        Contributed build tutorials

        + +

        These tutorials may work on similar linux distros as well.

        +

        building with BBv2

        The primary reason to use boost-build is that it will automatically build the @@ -337,7 +346,7 @@ with the following option:

        The above option make use of -DNDEBUG, which is used throughout libtorrent.

        -

        Step 3: Building libtorrent

        +

        Step 3: Building libtorrent

        Once the configure script is run successfully, you just type make and libtorrent, the examples and the tests will be built.

        When libtorrent is built it may be a good idea to run the tests, you do this diff --git a/docs/building.rst b/docs/building.rst index f1e0005b3..fa2fde018 100644 --- a/docs/building.rst +++ b/docs/building.rst @@ -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`` IRC channel on ``irc.freenode.net``. -If you want to build the cvs version on Ubuntu (and possibly other Linux -distros), see this__ document. +Contributed build tutorials +--------------------------- -__ 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 ------------------ diff --git a/docs/projects.html b/docs/projects.html index 547d59b8d..a16cc4a2a 100644 --- a/docs/projects.html +++ b/docs/projects.html @@ -57,6 +57,13 @@ and Johan Ström.

        bitrocket_thumb.png +

        Acquasition

        +

        Acquasition is a multi-network peer-to-peer +client for Mac.

        + +acquasition.jpg + +

        Instant Media

        IM is a client for downloading Internet TV.

        diff --git a/docs/projects.rst b/docs/projects.rst index b3147dfe6..37f43ac3f 100644 --- a/docs/projects.rst +++ b/docs/projects.rst @@ -37,6 +37,12 @@ project listed here, let me_ know. | | | | 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 | | | | | IM_ is a client for downloading Internet TV. | | @@ -107,6 +113,7 @@ project listed here, let me_ know. .. _qBittorrent: http://www.qbittorrent.org/ .. _btg: http://developer.berlios.de/projects/btg/ .. _BitRocket: http://www.bitrocket.org/ +.. _Acquasition: http://www.acquisitionx.com .. _IM: http://www.im.com/ .. _MooPolice: http://www.moopolice.de .. _BitsCast: http://www.bitscast.com/software/ diff --git a/docs/suse_build_notes.html b/docs/suse_build_notes.html new file mode 100644 index 000000000..d7c47f93f --- /dev/null +++ b/docs/suse_build_notes.html @@ -0,0 +1,60 @@ + + + + + + + + + + + +
        + + +++ + + + +
        Author:Torsten Bergander
        +
        +

        building libtorrent on SuSE 10.1 (i586)

        +
          +
        1. +
          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.

          +
          +
          +
          2. +
        2. +
          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.

          +
          +
          +
          3. +
        +
        +
        + + diff --git a/docs/suse_build_notes.rst b/docs/suse_build_notes.rst new file mode 100644 index 000000000..f38217327 --- /dev/null +++ b/docs/suse_build_notes.rst @@ -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. + diff --git a/docs/ubuntu_6_build_notes.html b/docs/ubuntu_6_build_notes.html new file mode 100644 index 000000000..ab1701468 --- /dev/null +++ b/docs/ubuntu_6_build_notes.html @@ -0,0 +1,55 @@ + + + + + + + + + + + +
        + + +++ + + + +
        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. +

        2. Get release tar ball (0.11 at time of writing), unpack, change into:

          +
          +libtorrent-0.11 dir
+
          +
          3. +

        3. Build and install:

          +
          +export BOOST_BUILD_PATH=/usr/share/boost-build/tools
+./configure
+make
+sudo make install
+
          +
          4. +
        +
        +
        + + diff --git a/docs/ubuntu_6_build_notes.rst b/docs/ubuntu_6_build_notes.rst new file mode 100644 index 000000000..60860b01d --- /dev/null +++ b/docs/ubuntu_6_build_notes.rst @@ -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 + +