doc/texi/Building.linux.texi

   1 @input texinfo @c -*- Texinfo -*-
   2 @c %**start of header
   3 @setfilename Building.linux.info
   4 @include base/article.texi
   5 @include building/command.texi
   6 @paragraphindent none
   7
   8 @set BG.platform linux
   9 @c %**end of header
  10
  11 @majorheading Guide to Building @value{HB.title} on @value{OS.@value{BG.platform}}
  12 @contents
  13 @include building/chapter.introduction.texi
  14
  15 @c %**-------------------------------------------------------------------------
  16 @anchor{prerequisites}
  17 @chapter Prerequisites
  18 The following are the recommended specifications for building on @value{OS.linux}; but is not necessarily the only configuration that is possible:
  19
  20 @itemize @bullet
  21 @item Intel 32-bit or 64-bit kernel
  22 @item Ubuntu 8.04, gcc 4.3.0, yasm 0.7.1
  23 @item Ubuntu 8.10, gcc 4.3.2, yasm 0.7.1
  24 @item Ubuntu 9.04, gcc 4.3.3, yasm 0.7.1
  25 @item Ubuntu 9.10, gcc 4.4.1, yasm 0.8.0
  26 @item Fedora 9, gcc 4.3.0, yasm 0.7.1
  27 @item Fedora 10, gcc 4.3.2, yasm 0.7.1
  28 @item Fedora 11, gcc 4.4.0, yasm 0.7.2
  29 @item Fedora 12, gcc 4.4.2, yasm 0.7.2
  30 @item gcc 4.0.0 or higher is reported to work
  31 @end itemize
  32
  33 @include building/prerequisites.bundled.texi
  34
  35 @include building/prerequisites.common.texi
  36
  37 The @b{GTK UI} introduces some significant extra build requirements. If you intend to disable building the GUI with @command{configure --disable-gtk} you will not need many of these packages installed:
  38
  39 Ubuntu 8.04 - 9.10 packages:
  40 @itemize @bullet
  41 @item subversion (cli/gui)
  42 @item yasm (cli/gui)
  43 @item build-essential (cli/gui)
  44 @item autoconf (cli/gui)
  45 @item libtool (cli/gui)
  46 @item zlib1g-dev (cli/gui)
  47 @item libbz2-dev (cli/gui)
  48 @item intltool (gui)
  49 @item libglib2.0-dev (gui)
  50 @item libdbus-glib-1-dev (gui)
  51 @item libgtk2.0-dev (gui)
  52 @item libhal-dev (gui)
  53 @item libhal-storage-dev (gui)
  54 @item libwebkit-dev (gui)
  55 @item libnotify-dev (gui)
  56 @item libgstreamer0.10-dev (gui)
  57 @item libgstreamer-plugins-base0.10-dev (gui)
  58 @end itemize
  59
  60 Ubuntu 8.04, substitute libwebkitgtk-dev for libwebkit-dev
  61
  62 To install these packages:
  63 @example
  64 sudo apt-get install subversion yasm build-essential \
  65 autoconf libtool zlib1g-dev libbz2-dev intltool libglib2.0-dev \
  66 libdbus-glib-1-dev libgtk2.0-dev libhal-dev libhal-storage-dev \
  67 libwebkit-dev libnotify-dev libgstreamer0.10-dev \
  68 libgstreamer-plugins-base0.10-dev
  69 @end example
  70
  71 Fedora 9 - 12 package groups:
  72 @itemize @bullet
  73 @item Development Tools
  74 @item Development Libraries
  75 @item X Software Development (gui)
  76 @item GNOME Software Development (gui)
  77 @end itemize
  78
  79 To install these package groups:
  80 @example
  81 sudo yum groupinstall "Development Tools" "Development Libraries" \
  82 "X Software Development" "GNOME Software Development"
  83 @end example
  84
  85 Additional Fedora packages:
  86 @itemize @bullet
  87 @item yasm (cli/gui)
  88 @item zlib-devel (cli/gui)
  89 @item bzip2-devel (cli/gui)
  90 @item dbus-glib-devel (gui)
  91 @item hal-devel (gui)
  92 @item webkitgtk-devel (gui)
  93 @item libnotify-devel (gui)
  94 @item gstreamer-devel (gui)
  95 @item gstreamer-plugins-base-devel (gui)
  96 @end itemize
  97
  98 Fedora 9 & 10, substitute WebKit-gtk-devel for webkitgtk-devel
  99
 100 To install these packages:
 101 @example
 102 sudo yum install yasm zlib-devel bzip2-devel \
 103 dbus-glib-devel hal-devel webkitgtk-devel libnotify-devel\
 104 gstreamer-devel gstreamer-plugins-base-devel
 105 @end example
 106
 107 @c %**-------------------------------------------------------------------------
 108 @include building/chapter.quickstart.texi
 109
 110 @anchor{overview}
 111 @chapter Overview
 112 @value{OS.linux} builds are performed from a @b{terminal}. There is no support for building from any IDEs.
 113
 114 @c %**-------------------------------------------------------------------------
 115 @include building/chapter.via.terminal.texi
 116 @include building/chapter.troubleshooting.texi
 117 @include building/appendix.repo.texi