OLD/gnome-install.txt

   1 TITLE:          Installing Gnome + Sawfish on LFS
   2 LFS VERSION:    2.4
   3 AUTHOR:         Mike Hildebrandt <mikehild@insight.org>
   4
   5 SYNOPSIS:
   6         Getting from a plain LFS + X installation to a working Gnome/Sawfish environment.
   7
   8 HINT:
   9 v1.1 - 11/06/00
  10 ================================================================================
  11 I. Introduction
  12
  13   1) What this is
  14
  15     As you likely already know, this document should hopefully make it less
  16   painless to get Gnome running on an LFS-based system.  I don't see why these
  17   instructions shouldn't work on other Linux distributions though - just that
  18   several of these packages may already be installed, or older versions may be
  19   installed which would need to be uninstalled first.
  20     I don't claim to have created a "Definitive Guide to Gnome Installations",
  21   nor do I claim to be an expert at Linux and/or Gnome (far from it, actually).
  22   Rather, this is a list of what I did to get Gnome to work on my LFS install.
  23   My hope is that these instructions work as smoothly for others as it did
  24   for me.  For the most part, the configuring and compiling itself isn't all
  25   that complicated, but it's the order you install them in that makes a big
  26   difference.  In the event you encounter problems feel free to post it to the
  27   lfs-apps@linuxfromscratch.com mailing list and there should be someone there
  28   that knows of a solution.
  29     Also, the window manager I decided to go with is Sawfish, mainly due to
  30   it's inclusion in Helixcode's distribution of Gnome.  I've made it clear
  31   which packages are only required by Sawfish and not Gnome so you're not
  32   installing unnecessary packages should you decide to install a different
  33   window manager instead.
  34
  35   2) What this isn't
  36
  37     At this point, I have chosen not to install any packages found only in
  38   the "Unstable" directory on the Gnome ftp site (such as bonobo, nautilus,
  39   etc), even though some of them could be quite useful or others can be used
  40   by the base packages.  My reasoning for this is that first of all, these
  41   packages are still in development and have not yet been deemed to be stable
  42   by the Gnome team and/or their developers.  Secondly, none of the base
  43   packages described below require them to function properly, that I've seen.
  44   When I have time, I am planning on looking into many of these new packages,
  45   and when I do I'll try to update this document accordingly.
  46
  47   3) Prerequesites
  48
  49     This file assumes that you have gone through the LFS Hint "X11Guide.txt"
  50   by Sergey Ostrovsky, located at archive.linuxfromscratch.org/lfs-hints.
  51   Although the purpose of that document is to get KDE2 up and running, it also
  52   describes in detail how to install XFree86 4.01 as well as several libs that
  53   are also needed by Gnome, so I decided not to duplicate their installation
  54   instructions here.
  55     In particular, you will need to install everything from X11Guide.txt,
  56   except for lcms, libmng, qt, and kde*, unless, of course, you are planning
  57   on installing KDE2 as well (lcms and libmng aren't KDE-specific, but none of
  58   the Gnome packages seemed to need them).
  59
  60 ================================================================================
  61 II. Packages to download
  62
  63   Following is a list of all the packages you need to download, as well as the
  64 address you should be able to download it from.  The values in brackets are
  65 the version numbers of the most current packages at the time of writing.  If
  66 you find a higher version available, it should be safe to download it instead,
  67 especially with the packages from the Gnome website.  The Gnome guys are nice
  68 enough to have the links on their website point to the most recent stable
  69 versions of the packages.
  70
  71 Gnome:
  72      ftp://prtr-13.ucsc.edu/pub/libgif          -  libungif (4.1.0b1)
  73      www.sleepycat.com                          -  db (3.1.14)
  74      ftp.gnu.org/pub/gnu/bc                     -  bc (1.05a)
  75      www.gnome.org/start/installing             -  audiofile (0.1.9)
  76                                            esound (0.2.20)
  77                                                    glib (1.2.8)
  78                                                    gtk+ (1.2.8)
  79                                                    imlib (1.9.8.1)
  80                                                    gtk-engines (0.10)
  81                                                    ORBit (0.5.4)
  82                                                    gnome-libs (1.2.3)
  83                                                    libgtop (1.0.9)
  84                                                    libxml (1.8.10)
  85                                                    libghttp (1.0.7)
  86                                                    libglade (0.14)
  87                                                    gdk-pixbuf (0.8.0)
  88                                                    control-center (1.2.2)
  89                                                    gnome-core (1.2.2.1)
  90                                                    gnome-applets (1.2.2)
  91 Sawfish:
  92      ftp.gnu.org/pub/gnu/gmp                            -  gmp (3.1)
  93      ftp.gnu.org/pub/gnu/gdbm                           -  gdbm (1.8.0)
  94      sourceforge.net/project/filelist.php?group id=580  -  librep (0.13)
  95      sourceforge.net/project/filelist.php?group id=581  -  rep-gtk (0.14)
  96      sourceforge.net/project/filelist.php?group id=32   -  sawfish (0.31.1)
  97
  98 ================================================================================
  99 III. Installing Gnome Packages
 100
 101   1) Setting up for install
 102
 103         export CONF="--prefix=/usr --enable-shared"
 104         useradd bin
 105         echo "games:x:9:" >> /etc/group                         /* Or if you've added groups
 106                                                                                                    yourself, change 9 to the
 107                                                                                                    next free number */
 108
 109   2) libungif - library for handling gif images
 110
 111     ./configure $CONF
 112     make
 113     make install
 114
 115   3) db - Berkeley DB database software
 116
 117     cd build_unix
 118     ../dist/configure $CONF --enable-compat185
 119     make
 120     make install
 121
 122   4) glib - Additional GTK C libraries
 123
 124     ./configure $CONF
 125     make
 126     make install
 127     ldconfig
 128
 129   5) gtk+ - Gimp Toolkit, library for creating GUIs
 130
 131     ./configure $CONF
 132     make
 133     make install
 134     ldconfig
 135
 136   6) imlib - Image loading & rendering library
 137
 138     ./configure $CONF
 139     make
 140     make install
 141
 142   7) ORBit - Not quite sure what this is, but everything else needs it...
 143
 144     ./configure $CONF
 145     make
 146     make install
 147
 148   8) audiofile - Processes audio from various file formats
 149
 150     ./configure $CONF
 151     make
 152     make install
 153
 154   9) esound - Enlightened Sound Daemon, allows simultaneous playback of
 155               multiple audio streams (ie. mixes two files in real time)
 156
 157     ./configure $CONF
 158     make
 159     make install
 160
 161   10) gnome-libs - Main libraries used by Gnome applications
 162
 163     ./configure $CONF --enable-prefer-db1
 164     make
 165     make install
 166
 167   11) gdk-pixbuf - Image loading & rendering library (similar to Imlib)
 168
 169     ./configure $CONF
 170     make
 171     make install
 172
 173   12) libxml - XML parser for Gnome
 174
 175     ./configure $CONF
 176     make
 177     make install
 178
 179   13) libghttp - Gnome http client library
 180
 181     ./configure $CONF
 182     make
 183     make install
 184
 185   14) bc - precision numeric processing language
 186     ./configure
 187     make
 188     make install
 189
 190   15) libtop - Provides info on running processes
 191
 192     ./configure $CONF
 193     make
 194     make install
 195
 196   16) libglade - Allows apps to load glade interface files
 197
 198     ./configure $CONF
 199     make
 200     make install
 201
 202   17) control-center - The primary means of configuring Gnome
 203
 204     ./configure $CONF
 205     make
 206     make install
 207
 208   18) gnome-core - The Gnome Panel plus other main parts of Gnome
 209
 210     ./configure $CONF
 211     make
 212     make install
 213
 214   19) gnome-applets - All the cool little programs that can run in the panel
 215
 216     ./configure $CONF
 217     make
 218     make install
 219
 220   20) gtk-engines - Basically just four extra GTK themes
 221
 222     ./configure $CONF
 223     make
 224     make install
 225
 226   21) mc - GNU Midnight Commander, file manager & desktop
 227
 228     ./configure $CONF
 229     make
 230     make install
 231
 232 ================================================================================
 233 IV. Installing Sawfish Packages
 234
 235   1) gmp - GNU MP, precision arithmetic library
 236
 237     ./configure $CONF
 238     make
 239     make install
 240
 241   2) gdbm - GNU dbm database routines
 242
 243     ./configure $CONF
 244     make
 245     make install
 246     ldconfig
 247
 248   3) librep - Lisp interpreter
 249
 250     ./configure $CONF
 251     make
 252     make install
 253
 254   4) rep-gtk - GTK+/Gnome/libglade bindings for Lisp
 255
 256     ./configure $CONF
 257     make
 258     make install
 259
 260   5) sawfish - The Sawfish window manager
 261
 262     ./configure $CONF
 263     make
 264     make install
 265
 266 ================================================================================
 267 V. Finishing Off
 268
 269   This part's quite simple, unless you or other applications have changed
 270 things around.  Edit the file /etc/X11/xinit/xinitrc, and go to the bottom
 271 of the file.  If Gnome was installed onto a fresh X installation, there
 272 should be lines that run xclock and three xterms.  Replace those lines with:
 273
 274         exec gnome-session
 275
 276 and save the file.  If all went correctly, running startx should bring you to
 277 the default Gnome desktop.
 278   Installing the packages listed under "Gnome Additional source downloads" on
 279 page where you downloaded the base and core packages should be as easy as a
 280 /configure && make && make install.  I haven't tried all of them yet, so I
 281 can't be too sure.  At the very least you'll probably want to install the
 282 users-guide, gnome-utils, gnome-games, gnome-audio, and gnome-media packages
 283 (or maybe not the last two if you don't have a sound card =).  I haven't tried
 284 the rest of the additional packages yet due to time constraints, but I'll be
 285 sure to update this document once I do.  I figured it wasn't worth holding on
 286 to this for another few weeks while I figured out the non-mandatory packages.
 287   If you're bored of the default appearance and want to change the look of
 288 Gnome/Sawfish, you can download additional themes from gtk.themes.org and
 289 sawfish.themes.org.  To install gtk themes, unpack the downloaded archive into
 290 /usr/share/themes.  To install sawfish themes, copy the downloaded archive into
 291 /usr/share/sawfish/themes (do not unpack!).
 292
 293 ===============================================================================
 294 VI. To Do
 295
 296   * Install rest of additional Gnome packages
 297   * Try out some of the stuff from the "Unstable" source tree and see if
 298     any of it's worth adding to this document yet (being careful not to follow
 299     Redhat's recent example... ;)
 300   * Finish reading "Lord of the Rings" (part of the reason this project has
 301     been delayed longer than I would have liked... =)
 302
 303 ===============================================================================
 304