PREVIOUS_FORMAT/icewm.txt

   1 01234567890123456789012345678901234567890123456789012345678901234567890123456789
   2 TITLE:          IceWM
   3 LFS-VERSION:    3.3
   4 AUTHOR:         Vassili Dzuba <vassili.dzuba@wanadoo.fr>
   5
   6 SYNOPSIS:
   7         How to install the window manager IceWM on your LFS
   8
   9 HINT:
  10
  11 CONTENT
  12 =======
  13   1) REQUIREMENTS
  14   2) BUILDING THE REQUIRED LIBRARIES
  15   3) GETTING IceWM
  16   4) BUILDING IceWM
  17   5) CONFIGURING IceWM
  18
  19 REQUIREMENTS
  20 ============
  21
  22 As IceWM is a window manager, it requires of course X11.
  23 One will assume that X has been installed according to the
  24 BLFS book.
  25
  26 To build XIceW, you will need the following libraries
  27
  28 - libXpm (required)
  29 - Imlib (optional, for wider image support)
  30 - zlib (required by gnome-libs)
  31 - libpng (required by gnome-libs)
  32 - libjpeg (required by gnome-libs)
  33 - libtiff (required by gnome-libs)
  34 - libungif  (required by gnome-libs)
  35 - DB (required by gnome-libs)
  36 - gtk+ 1.2.xx (required by gnome-libs)
  37 - gnome-libs (optional, for gnome menu support)
  38 - sgml2html (optional, to rebuild HTML documentation)
  39 - XFreeType (optional, for antialiasing)
  40
  41 IceWM is released under the LGPL.
  42
  43 BUILDING THE REQUIRED LIBRARIES
  44 ===============================
  45
  46 libXpm
  47 ------
  48   XPM is a format for storing/retrieving X Pixmaps
  49   from/to files
  50
  51   current version : 3.4k
  52   where to get it : http://koala.inria.fr/ftp/pub/xpm/
  53                     ftp://ftp.x.org/contrib/libraries
  54   how to build it :
  55
  56        tar xzvf xpm-3.4k.tar.gz /usr/src
  57        cd /usr/src/xpm-3.4k
  58        xmkmf -a
  59        make
  60        make install
  61
  62   note : by default, Xpm is installed in the X11 tree
  63
  64 Imlib
  65 -----
  66   The imlib package contains image libraries. These are useful
  67   for loading, rendering and dithering a wide variety of image data formats.
  68
  69   see BLFS book
  70
  71 zlib
  72 ----
  73   see BLFS book
  74
  75 libpng
  76 ------
  77   see BLFS book
  78
  79 libjpeg
  80 ------
  81   see BLFS book
  82
  83 libtiff
  84 -------
  85   see BLFS book
  86
  87 libungif
  88 --------
  89   see BLFS book
  90
  91 DB
  92 --
  93   see BLFS book
  94
  95 ORBIT
  96 -----
  97   Instructions to build ORBIT are not yet available in the BLFS
  98
  99   current version : 0.5.17
 100   where to get it : ftp://ftp.gnome.org/pub/GNOME/stable/sources/ORBit/
 101   how to build it :ftp://ftp.gnome.org/pub/GNOME/stable/sources/ORBit/ORBit-0.5.17.tar.bz2
 102
 103         tar xjvf ORBit-0.5.17.tar.bz2 /usr/src
 104         cd /usr/src/ORBit-0.5.17
 105         ./configure --prefix=/usr
 106         make
 107         make install
 108
 109 gnome-libs
 110 ----------
 111   Instructions to build gnome-libs are not yet available in the BLFS
 112
 113   current version : 1.4.1.7
 114   where to get it : ftp://ftp.gnome.org/pub/GNOME/sources/gnome-libs
 115   how to build it :
 116
 117         tar xjvf gnome-libs-1.4.1.7.tar.bz2 /usr/src
 118         cd gnome-libs-1.4.1.7
 119         ./configure --prefix=/usr
 120         make
 121         make install
 122
 123 sgml2html
 124 ---------
 125   sgml2html is necessary only if you want to update the documentation
 126   of IceWM. The original format of the docmentation uses linuxdoc
 127   (a SGML DTD previously used by the  Linux Documentation project,
 128   now replaced by DocBook XML)
 129
 130   At the moment, i don't know where to get a .tar.gz distribution
 131   of linuxdoc-tools, that contains sgml2html.
 132   It seems to be  available as a RPM from Red Hat site, and a .deb
 133   from Debian site.
 134
 135
 136 XFreeType
 137 ---------
 138   ...TO BE COMPLETED...
 139
 140
 141 GETTING IceWM
 142 =============
 143
 144   IceWM home page is : http://icewm.sourceforge.net/
 145   The current version is 1.2.0
 146
 147
 148 BUILDING IceWM
 149 ==============
 150
 151   tar xjvf icewm-1.2.0 /usr/src
 152   cd /usr/src/icewm-1.2.0
 153
 154   # if you dare to use experimental features :
 155
 156   ./configure --with-imlib --enable-i18n --enable-antialiasing
 157
 158   # otherwise
 159
 160   ./configure --with-imlib
 161
 162   #
 163
 164   make
 165   make install
 166   make install-docs
 167
 168
 169   Notes :
 170   - by default, icewm is installed into /usr/local/bin
 171   - by default, the configuration files are installed
 172     in /usr/local/lib/X11/icewm
 173   - by default, the documentation is installed in
 174     /usr/local/doc/icewm-1.2.0
 175
 176
 177 CONFIGURING IceWM
 178 =================
 179
 180   To use IceWM as your window manager, you may call it from your .xinitrc
 181   file.
 182
 183   The default configuration of IceWM is fully usable. If you want to
 184   customize it anyway, you should create a directory ~/.icewm in your
 185   home directory and copy the files you want to modify from
 186   the global configuration directory /usr/local/X11/icewm.
 187
 188   For instance, if you want to modify the menus, you should copy the file
 189   /usr/local/X11/icewm/menu into ~/.icewm
 190
 191   Note that if a program is not installed, IceWm will not display it in the
 192   menu. The syntax for an entry in the menu is :
 193     prog "<title>" <icon> <program>
 194
 195   For instance, the (very simple) menu definition for my LFS box is :
 196
 197     prog xterm xterm xterm
 198     separator
 199     menu Applications folder {
 200         prog Emacs - emacs
 201         prog Mozilla - /usr/local/mozilla/bin/mozilla
 202         prog Sylpheed - sylpheed
 203     }
 204     menu Utilities folder {
 205         prog top top xterm -e top
 206     }
 207     menu "Window Managers" folder {
 208         restart twm - twm
 209         restart sawfish - sawfish
 210         restart icewm - icewm
 211         restart wmaker - /opt/wm/bin/wmaker
 212         restart enlightenment - /usr/enlightenment/bin/enlightenment
 213         restart blackbox - blackbox
 214         restart AmiWM - amiwm
 215         restart AfterStep - afterstep
 216     }
 217
 218   If you want to change some defaults, you may copy in ~/.icewm the file
 219   /usr/local/lib/X11/icewm/preferences.
 220   For instance, i changed only an entry in this file, to change the default
 221   theme :
 222
 223      Theme="Infadel2/Ergonomic.theme"
 224