window-maker.txt

   1 AUTHOR: Daniel Baumann <daniel.baumann@panthera-systems.net>
   2
   3 DATE: 2004-12-04
   4
   5 LICENSE: GNU General Public License
   6
   7 SYNOPSIS: How to install Window Maker on LFS.
   8
   9 PRIMARY URI: http://archive.daniel-baumann.ch/linux-from-scratch/hints/window-maker/
  10
  11 DESCRIPTION:
  12 How to install Window Maker on your LFS-system.
  13
  14 PREREQUISITES:
  15 A complete LFS-system with an X Window System and libpng (see BLFS for instructions).
  16
  17 HINT:
  18 --------------------------------------------------------------------------------
  19
  20 Window Maker 0.91.0
  21 ===================
  22
  23 This hint is originally written by Corbin Bates <dracolinux@softhome.net>.
  24 Now updated and maintained by Daniel Baumann.
  25
  26
  27 1. Introduction to Window Maker
  28 ===============================
  29
  30 Window Maker is an X11 window manager designed to give additional integration
  31 support to the GNUstep Desktop Environment. In every way possible, it reproduces
  32 the elegant look and feel of the NeXTSTEP GUI. It is fast, feature rich, easy to
  33 configure, and easy to use. In addition, Window Maker works with GNOME and KDE,
  34 making it one of the most useful and universal window managers available.
  35
  36
  37 1.1. Package information
  38 ========================
  39
  40   * Download (HTTP): http://www.windowmaker.org/pub/source/release/WindowMaker-0.91.0.tar.bz2
  41
  42   * Download (FTP): ftp://ftp.windowmaker.org/pub/source/release/WindowMaker-0.91.0.tar.bz2
  43
  44   * MD5 Sum: be07953e905d1e42fe7a65ac2193a5f9
  45
  46   * Download size: 2.7 MB
  47
  48   * Estimated Disk space required: 64 MB
  49
  50   * Estimated build time: 0.59 SBU
  51
  52
  53 1.2. Additional downloads
  54 =========================
  55
  56 Optional:
  57
  58   * Window Maker extra package
  59
  60     This is the extra data package for Window Maker. It contains some icons and
  61     a few themes.
  62
  63     Download: http://www.windowmaker.org/pub/source/release/WindowMaker-extra-0.1.tar.gz
  64
  65
  66   * Clip-caption patch
  67
  68     Aesthetical change to the Window Maker clip. The workspace number is now in
  69     the lower right corner, the workspace name in the upper left. The workspace
  70     name will be truncated using an ellipsis if it is too long.
  71     Fixes inconsistent popup 'balloon'. The clip now uses the same balloon as
  72     other appicons/miniwindows/etc.
  73
  74     Download: http://www.linuxfromscratch.org/patches/downloads/WindowMaker/WindowMaker-0.91.0-clip_captions-1.patch
  75
  76
  77   * Workspace-number patch
  78
  79     Makes workspace numbering by the wmsetbg tool start at 1 instead of 0, just
  80     like it does for the rest of Window Maker.
  81
  82     Download: http://www.linuxfromscratch.org/patches/downloads/WindowMaker/WindowMaker-0.91.0-wmsetbg_workspace_number-1.patch
  83
  84
  85   * Optional preference-directory patch
  86
  87     Changes the preference directory from ~/GNUstep to ~/.GNUstep.
  88
  89     Note:       Set --datadir=~/.GNUstep/Library and
  90                 --with-iconsdir=~/.GNUstep/Library/Icons on installing other
  91                 GNUstep applications.
  92
  93     Download: http://www.linuxfromscratch.org/patches/downloads/WindowMaker/WindowMaker-0.91.0-preference_directory-1.patch
  94
  95
  96 1.3. Window Maker dependencies
  97 ==============================
  98
  99 Required:
 100
 101   * X Window System (see BLFS for instructions)
 102
 103   * libpng (see BLFS for instructions)
 104
 105
 106 Optional:
 107
 108   * libXPM
 109
 110     There is builtin support for XPM files, but it will not load images in some
 111     uncommon encodings.
 112
 113
 114   * libtiff
 115
 116   * libjpeg
 117
 118   * libgif or libungif
 119
 120   * libHermes
 121
 122     Faster pixel conversion in the wraster library.
 123
 124
 125 2. Installation of Window Maker
 126 ===============================
 127
 128 Install Window Maker by running the following commands:
 129
 130    __________________________________________________________________________
 131   |                                                                          |
 132   |  patch -Np1 -i ../WindowMaker-0.91.0-clip_captions-1.patch &&            |
 133   |  patch -Np1 -i ../WindowMaker-0.91.0-wmsetbg_workspace_number-1.patch && |
 134   |  patch -Np1 -i ../WindowMaker-0.91.0-preference_directory-1.patch &&     |
 135   |                                                                          |
 136   |  ./configure --prefix=/usr --sysconfdir=/etc &&                          |
 137   |  make &&                                                                 |
 138   |  make install &&                                                         |
 139   |  /sbin/ldconfig                                                          |
 140   |__________________________________________________________________________|
 141
 142
 143 If you want to strip the debugging symbols from the binaries and make them
 144 smaller, you can use 'make install-strip' instead of 'make install'.
 145
 146 If you have downloaded the extra package, install it with:
 147
 148    __________________________________________________________________________
 149   |                                                                          |
 150   |  ./configure --prefix=/usr                                               |
 151   |  make &&                                                                 |
 152   |  make install &&                                                         |
 153   |__________________________________________________________________________|
 154
 155
 156 3. Comannd explanations
 157 =======================
 158
 159 --sysconfdir=/etc/: This switch puts configuration files in /etc/ instead of
 160                     /usr/etc.
 161
 162
 163 4. Configuring Window Maker
 164 ===========================
 165
 166
 167 4.1. Config files
 168 =================
 169
 170 /etc/GNUstep/*, ~/GNUstep/* (or ~/.GNUstep/* with the preference-directory
 171 patch).
 172
 173
 174 4.2. Configuration information
 175 ==============================
 176
 177 Do not forget to backup your current xinitrc-file before proceeding:
 178
 179    __________________________________________________________________________
 180   |                                                                          |
 181   |  cat > ~/.xinitrc << "EOF"                                               |
 182   |  exec wmaker                                                             |
 183   |  EOF                                                                     |
 184   |__________________________________________________________________________|
 185
 186 This starts Window Maker automatically after XFree86 is up and running. If you
 187 like to set Window Maker as the default window manager for all users on your
 188 system, edit /etc/X11/xinit/xinitrc instead.
 189
 190 After you have sucessfully started Window Maker, you can configure all options
 191 with WPrefs.
 192
 193
 194 5. Contents
 195 ===========
 196
 197 The Window Maker package contains WPrefs, get-wings-flags, get-wraster-flags,
 198 get-wutil-flags, geticonset, getstyle, seticons, setstyle, wcopy, wdread,
 199 wdwrite, wkdemenu.pl, wm-oldmenu2new, wmagnify, wmaker, wmchlocale, wmsetbg,
 200 wmsetup, wpaste, wsetfont, wxcopy, wxpaste and libExtraWINGs.a, libWINGs.a,
 201 libWMaker.a, libWUtil.a, libwraster.a libraries.
 202
 203
 204 7. Description
 205 ==============
 206
 207   * WPrefs
 208
 209     WPrefs is the Window Maker Preferences Utility.
 210
 211
 212   * wmagnify
 213
 214     wmagnify is a screen magnifying glass.
 215
 216
 217   * wmaker
 218
 219     wmaker is the window manager itselfs.
 220
 221
 222 6. Other
 223 ========
 224
 225 Links:
 226
 227   * http://www.dockapps.org/
 228
 229   * http://www.bensinclair.com/dockapp/
 230
 231   * http://web.cs.mun.ca/~gstarkes/wmaker/
 232
 233   * http://www.lonelymachines.org/wm_themes.html
 234
 235   * http://www.jessanderson.org/wmthemes/
 236
 237 --------------------------------------------------------------------------------
 238
 239 ACKNOWLEDGEMENTS:
 240   * Corbin Bates <dracolinux@softhome.net> for the original hint.
 241   * Oliver Brakmann <obrakmann@gmx.net> for updating the Window Maker-Patches.
 242
 243 CHANGELOG:
 244 [2004-12-04]
 245   * Formal changes.
 246   * Minor text changes.
 247   * Added Command explanations.
 248   * Updated to Window Maker 0.91.0.
 249 [2004-07-10]
 250   * Typographic mistakes corrected.
 251 [2004-05-29]
 252   * Minor text changes.
 253   * Typographic mistakes corrected.
 254 [2004-05-23]
 255   * Initial revision.