The X Window User HOWTO
by Ray Brigleb, rayola@mindless.com
v1.3, 22 January 1999

This document contains information on configuring the X Window envi- ronment for the Linux user, as well as for the beginning system admin- istrator attempting to sort through the many configuration options and details of X Window. A basic knowledge of software configuration and installation is assumed, as is the presence of X on the users system.


Table of Contents

1. Introduction
1.1 Other Sources Of Information
1.2 Versions Of This Document
1.3 Feedback And Corrections
1.4 Acknowledgments
1.5 Copyright

The X Window System is an advanced, network transparent, windowing, graphical environment, developed at the Massachusetts Institute of Technology, and first released in 1984. This document assumes that you have installed X and it is functional. We intend to learn how to use X productively, not so much how to compile the programs; most Linux distributions come with X as an option during installation, compiled and ready to go.

1.1 Other Sources Of Information

If you are just starting out, you may find the XFree86 HOWTO and XFree86 Video Timings HOWTOs to be more helpful, and you should be able to find that in the same place you found this. At the end of the document you will also find a Bibliography And Resources section, to find even more information. Oh, and don't forget to read the man pages.

1.2 Versions Of This Document

New versions of this HOWTO may be periodically posted to comp.os.linux.help comp.os.linux.help. They will also be uploaded to various Linux WWW and FTP sites, including Linux Documentation Project metalab.unc.edu/LDP web site. The latest version can (almost) always be found at www.croftj.net/~ray/howto.[§]

Changes in version 1.1 include more coverage of rxvt, expanded coverage of X Resources, more trivial history of X, corrected references to SunSite to point to MetaLab, and instructions on using Type 1 fonts with X.

Changes in version 1.2 include much-requested coverage of using TrueType fonts in X, more details about setting up xdm, and a few more added resources. There is also a correction to my discussion of screen blanking features (thanks to Heinrich Langos for the correction!).

Changes in this version (1.3) include some fixes, info for corrupted font paths in some recent distributions, and lots more info about basic X security. I've also added some tips about KDE and an e-mail address update.

1.3 Feedback And Corrections

If you have questions or comments about this document, please feel free to email Ray Brigleb at ray@croftj.net or rayola@mindless.com. I readily welcome any suggestions or criticisms. If you find any mistakes with this document, please let me know so I can correct them in the next revision. If you have information you would like to see in future revisions, or you would like to contribute to a future revision, drop me a line. I'm also looking for more resources to add to the sections and bibliography. While we're at it, I'm also looking for a job in the Portland, Oregon area...

1.4 Acknowledgments

A special thanks to the HOWTO coordinator Tim Bynum for help and suggestions, and the XFree86 Group for the man pages and help files that come with XFree86. I really need to thank all of those who have written documentation and descriptions of their offerings in the past, I have just gleaned a selection of the most relevant items from their material for this document. Also, thanks are due to Matt Chapman, author of the Window Managers Guide website, and Scott Scriven, for the FVWM2 Themes tips and tricks I stole from some of his hacks. Thanks are also due to Joe Croft for the Internet service, invaluable to the ongoing development of this HOWTO, and Claire Galper, for moral support and miscellaneous tips. Last but not least, thanks to the whole GNU/Linux community, for everything, and Mr. Stallman, for this text editor (and philosophy).

1.5 Copyright

Copyright (c) 1998, 1999 by Ray Brigleb.

Unless otherwise stated, Linux HOWTO documents are copyrighted by their respective authors. Linux HOWTO documents may be reproduced and distributed in whole or in part, in any medium physical or electronic, as long as this copyright notice is retained on all copies. Commercial redistribution is allowed and encouraged; however, the author would like to be notified of any such distributions.

All translations, derivative works, or aggregate works incorporating any Linux HOWTO documents must be covered under this copyright notice. That is, you may not produce a derivative work from a HOWTO and impose additional restrictions on its distribution. Exceptions to these rules may be granted under certain conditions; please contact the Linux HOWTO coordinator for more information.

In short, we wish to promote dissemination of this information through as many channels as possible. However, we do wish to retain copyright on the HOWTO documents, and would very much like to be notified of any plans to redistribute the HOWTOs, this one in particular!

Many of the terms mentioned in this document are trade names. Unless otherwise stated, all trademarks are property of their respective owners.


2. Getting Started
2.1 The X Window System: History and Architecture
2.2 Anatomy of Your Desktop
2.3 Invoking X Window
2.4 The X Display Manager

 

2.1 The X Window System: History and Architecture

The X Window System was developed in the Laboratory for Computer Science at the Massachusetts Institute of Technology, as part of project Athena in cooperation with DEC, and first released in 1984. The project lead of the main development was Robert Scheifler, and the origins of X owe much debt to the ``W'' Windowing package, developed by Paul Asente at Stanford. In September of 1987, MIT issued the first release of the X11 that we know and use today. As of X11R2, control passed from MIT to the X Consortium, formed in January of 1988.

Many of the ideas that went into X Window also came from research at Xerox Corporation's Palo Alto Research Center (PARC), where they were working on computers like the Parc and the Star in the late seventies. None of these computers made it to market, but when Xerox demonstrated a window system custom built to run Smalltalk 80, people were hooked. These series of three computers demonstrated the WIMP (Windows, Icons, Menus, Pointer) interface so well that it spawned a revolution in computing almost overnight. Within a few years many computer users got a taste of a windowing system of some kind, and you might say they never looked back.

X Window is currently developed and distributed by the X Consortium, however, a liberal license permits the existence of free and low-cost implementations. The version of X used on Linux is XFree86. XFree86 is a collection of X servers for UNIX-like OSs on Intel x86 platforms. The work is derived from X386, and much of it is contributed back into X11R6 thereafter. We can think of XFree86, for all intents and purposes, to be X Window for Linux, unless you have purchased another X server.

X Window is built upon a great many toolkits, or libraries. It is built upon the X Toolkit Intrinsics and the Athena Widgets. Many programs use XView or Motif tools. More still are part of a newer, unified windowing and communication system, like GNOME or KDE. If you find many of your programs not compiling, or are getting strange and inexplicable errors, you may wish to make sure that you have installed X correctly, because most of these libraries (with the exception of Motif) are free and most likely preinstalled with X on your system.

And remember, it's called X Window, not X Windows!

2.2 Anatomy of Your Desktop

There are a few basic principles and terms you should familiarize yourself with to make using X much more straightforward. These terms will appear over and over again in the manual pages and help files, which it is suggested that you consult whenever necessary.

The screen is your whole ``desktop'', and the words may be used interchangeably. Technically it means the primary video display you view X with, and you can have more than one screen, in fact you can have more than one computer running off a single X server. This is beyond the scope of this humble document, but you should be aware of the distinction.

The root window is the background of your screen. It is referred to a window in name alone, it does not behave like any other window, but rather you run your applications on the root window, or put a picture on it, or just a solid color.

The window manager is the main interface between the X Window system and the user. Without the window manager, the system would be rather difficult to use, and would certainly not be a very productive tool. The window manager provides such functionality as window borders, menus, icons, virtual desktops, button bars, tool bars, and allows the user to customize it at will, often adding to its functionality in the process.

The pointer is the arrow or indicator of any given shape which represents the location your mouse (or other pointing device) corresponds to on the screen. The pointer often changes to give you contextual feedback as to what will happen when you use the mouse at that point on the screen.

The window is a frame in which any given application resides which is ``managed'' by the window manager. This includes pretty much anything except the so-called root window. Even windows which do not appear to have frames, titles, or normal borders of any kind are being managed by your window manger. The active window is the window you are currently using, the window that will receive text when you type, and is traditionally denoted by the fact that your mouse cursor is pointing at it, though this is not always the case. The active window is said to have ``focus,'' the rest of the windows on your display being ``unfocused.''

Menus and icons behave in X similar to the way they behave in other windowing systems, and the same general principles apply. Windows with text only are called terminal emulators, an example would be xterm, and these basically emulate a console text-only display, but let you multiplex and use more than one at a time, and have many other advantages available due to their being used in X. We shall discuss many of these later on.

2.3 Invoking X Window

Starting X can be done in several ways. On your system it may be set up to start automatically, and you will not need to read this section. Most Linux systems, however, presently start at the command line upon login, and you have to decipher this for yourself.

The most basic way to start X is with xinit. This will put you at a blank desktop, by default, and with no window manager loaded. If no client program is specified on the command line, xinit will look for the .xinitrc file to run as a shell script, to start up client programs. If this file does not exist, xinit will use the following command as a default:

        xterm -geometry +1+1 -n login -display :0

As you see, this is not very helpful. The most common way to start X is with the command startx. This is the most civilized fashion to start the windowing system, but requires that you log in from a text shell, and start the windowing system yourself. For many Linux users this is the most common way to start X, it is also the most flexible. You can issue a commands such as the following:

        startx -- -bpp 8    #start x in 256 color mode
        startx -- -bpp 32   #start x in true color mode

The double dashes pass arguments directly to xinit, and this way you can start up X in the resolution your work will require, and still have it use the configuration files we will cover later in this document.

2.4 The X Display Manager

The program xdm provides similar services to getty and login, which allow users to log into a system and start their basic shell. If you start X with xdm, however, users need only to type in their username and password at a friendly prompt, and they are dropped directly into the graphical environment. This is simple and easy to use, and is seen frequently in college campuses, cyber cafes, business environments, anywhere you have users not necessarily familiar with Unix to any great extent.

xdm can be configured with configuration files located in /usr/X11R6/lib/X11/xdm on your Linux system. The file xdm-config is for configuring how the login screen appears to users, and Xsetup_0 is used to tell xdm what programs should be launched when X is started. Some of the configuration a normal user would put in their .xinitrc file should go in here, if xdm is to be normally used.

Here is a sample Xsetup_0 file to look at, which might help to configure your system. The xfstt program is the TrueType font server, and is discussed later in this document. Also, notice that we're using a shell script here, and it's trying to call xv to set the background to a nice picture (instead of the boring black and white background pattern), and if that call fails, xsetroot is called, to at least try to set the background to a nice blue color.

        #!/bin/sh
        xconsole -geometry 480x100-0-0 -daemon -notify -verbose -fn \
        '-schumacher-clean-medium-r-*-*-10-*-*-*-*-*-*-*' -exitOnFail
        /usr/X11R6/bin/xfstt &
        /usr/X11R6/bin/xv -quit -root                               \
        /usr/local/share/WindowMaker/Backgrounds/InDreams.jpg       \
        || xsetroot -solid darkblue
        xset fp+ unix/:7100

3. Choosing a Window Manager
3.1 FVWM And Its Ancestors
3.2 The Wide World of Window Systems
3.3 The X Graphical Interfaces
3.4 The X Desktop Environments
3.5 The Flashy Window Managers

This is a discussion of the window managers available to the X Window user, with a comparison of some finer ones to choose from. In order to prevent this document from becoming overwhelmingly large (and proportionally difficult to maintain, as well) I am limiting the discussion to the more popular and well known window managers out there. I believe these are most representative for our purposes, and once you grasp the basic concepts of a few, you more or less will have the hang of them all.

Your choice of window manager can dramatically influence how pleasant your computing experience will be. You spend much of your time dealing with windows when you're in X, and you don't want something that's too obtrusive, one that will get in your way. Some window managers are extremely customizable, to the point that you can pretty much feel like it's a new operating system. If you don't like icons, get rid of them! If you miss that toolbar, you can build a better one, and it can be a pretty painless and rewarding process besides.

3.1 FVWM And Its Ancestors

The most common window managers nowadays have their roots in Robert Nation's FVWM window manager. These include FVWM, FVWM2, FVWM95, and many more. FVWM itself is derived partly from TWM, which comes with an X Window installation, but which we will not cover here. The syntax and usage of TWM is similar to FVWM, but it actually uses more memory, and feels clumsy and awkward to most users.

FVWM is the original and old standby favorite Linux window manager. Now that the 2.0 of versions of FVWM have become stable and in more general usage, this newer version is preferred, for the syntax is much more direct and simplified, and much more flexible as well. However, many people still have the original FVWM on their systems, as it has been a long time favorite and standard, and most of the examples in this text are equally applicable to this older version. And if the older one is working fine for you, there may be no need to upgrade, since it may break your configuration files to some degree, for some of the syntax has indeed changed, and is not altogether backward compatible. Such is the nature of progress.

Nobody seems quite sure what F in FVWM stands for (not even the author, from what I can tell!), but the VWM would seem to (correctly) indicate Virtual Window Manager, and indeed the FVWM series are virtual window managers, and that is one of their strengths. You can bind keys to any function, including the switching between the virtual desktops, and do this with ease.

FVWM2 is the new standard, including many improvements and features not found in the previous version. Unlike many newer window managers, it works just fine on 8-bit, 256 color displays, which I am using at the moment, and still can be improved with little icons and gradients, to look as much like the Win98 interface as you may or may not want. This version is also much more extensible in general, and allows the use of themes and dynamic menus. Technically, FVWM2 is still in beta, but it works just great, and I have not yet had a single problem with it.

Resources:
The official FVWM and FVWM2 site is fvwm.math.uh.edu/. Versions could be available at ftp.hpc.uh.edu/pub/fvwm/.

3.2 The Wide World of Window Systems

For users more familiar with other window environments on other operating systems, there are plenty of window managers to emulate the desktop you're accustomed to.

The icewm window manager is aimed at a more consistent look and feel, and can emulate many other windowing system standards, hot key bindings, and such. The OS/2 emulations are particularly nice. AmiWM www.lysator.liu.se/~marcus/amiwm.html is an Amiga Workbench type window manager, mlvwm www2u.bioglobe.ne.jp/~y-miyata/mlvwm.html[§] is a MacOS emulator. A nice addition to these window managers is dfm, a desktop and file manager that pleasantly resembles the OS/2 Workplace Shell.

Resources:
The Window Managers website can be found at www.PLiG.org/xwinman/, and is a consistently good resource for finding out about the variety of window managers available, particularly for finding good window managers to emulate other windowing environments. Many more still are listed at www.PLiG.org/xwinman/others.html, provided by the same author as the previous link, and this is quite a formidable and complete list indeed. You can download Linux versions of most popular window managers at the metalab metalab.unc.edu/pub/Linux/X11/window-managers archive.

3.3 The X Graphical Interfaces

Open Look and Motif were early attempts to standardize X Window, and make it usable in more mainstream environments, around a greater variety of workstations. Both were somewhat successful at those attempts (in look and feel, if not politically) and can be used under a modern Linux system. Both require specific libraries, which can be used to compile a variety of applications specifically designed for one or the other environment, to give all programs a similar look and feel.

Starting with X11 Release 5, Sun Microsystem's OpenWindows graphical interface was available to X users. This includes two versions of the Open Look Window Manager, olwm and olvwm (with a virtual desktop). This was developed by Sun in hopes of making a standard windowing environment, and indeed it was standard with Solaris for many years. If your distribution of Linux did not come with this windowing system installed, you must remember to install the XView libraries to get it to work, and you will also have to put the /usr/openwin/... directories in your search path.

If you want the actual OSF/Motif Toolkit for Linux, you'll have to pay, the programs and toolkit are not free. However, the Hungry Programmers have written LessTif, which allows you to compile Motif programs more or less as if you owned to toolkit. LessTif is a clone of the Motif toolkit. Currently LessTif is partially implemented with most of the API in place. Many programs already work under this free version of the toolkit, and it even comes with a window manager, derived from FVWM code, which you'd swear was the Motif Window Manager.

The most useful feature of this toolkit, however, is compiling programs dependent on having a Motif library on your system. The window manager is nothing spectacular, and mostly useful if you're migrating from the original Motif, and want to keep your configuration file. For all intents and purposes, you will find FVWM much more feature-filled and useful, and it looks and behaves almost identically, even recognizing the window hints supplied by programs built with the Motif toolkit.

Resources:
The Hungry Programmers LessTif can be found at www.lesstif.org/.

3.4 The X Desktop Environments

The second generation of Linux window managers was brought about by KDE, and soon joined by GNOME. There are some striking similarities, and some great differences, between these two, and I will attempt to cover them here. The most important thing to remember at this point is that neither of them is in any way a complete product. Both are at the start of a long development cycle, and not completely stable yet, and as such are not suited to mission-critical work at this time.

The KDE Desktop Environment
(A quote from the home page:) ``KDE is a completely new desktop, incorporating a large suite of applications for Unix workstations. While KDE includes a window manager, file manager, panel, control center and many other components that one would expect to be part of a contemporary desktop environment, the true strength of this exceptional environment lies in the interoperability of its components.''

The KDE Desktop Environment is an attempt to make a desktop environment, not just a window manager. The tools of KDE work together so well, for instance, one might be fooled into thinking KDE was an entire operating system. All the tools to work in a windowing system are included, and many more have been ported to the KDE environment. KDE has achieved a surprising level of maturity already, but many are reluctant to install it on their desktop, because of the licensing stipulations of the QT toolkit, upon which KDE is based. This has changed a little lately, and the licence now qualifies as Open Source by definition, but is not the same as that of GNU software.

GNOME: The GNU Object Model Environment
(A quote from the home page:) ``GNOME stands for GNU Network Object Model Environment. The GNOME project intends to build a complete, user-friendly desktop based entirely on free software. GNOME is part of the GNU project, and GNOME is part of the OpenSource(tm) movement. The desktop will consist of small utilities and larger applications which share a consistent look and feel. GNOME uses GTK+ as the GUI toolkit for all GNOME-compliant applications.''

The GNOME project is an attempt to do much of the same work as KDE, but even a little more than that. GNOME is less tied to one window manager, for instance, and it is interoperable not just between applications, but computers and platforms, as it uses the Common Object Resource Broker Architecture (CORBA). Also, and to many most importantly, GNOME is based on the GTk+ toolkit, which is free and open source, unlike the underlying toolkit of KDE, thereby following in the philosophy of Linux itself.

Resources:
The official KDE website is www.kde.org/. The official GNOME website is www.gnome.org/. More detailed information regarding the issues surrounding GNOME can be found at www.gnome.org/gnomefaq/FAQ.txt[§]. The home page of CORBA is located at www.corba.org/ , and the GTk+ toolkit home is www.gtk.org/ .

3.5 The Flashy Window Managers

The latest generation of window manger is very very pretty indeed. Sporting every convenience you could think of, and emulating the most beautiful operating systems ever used on the most gorgeous workstations in the world, these are the window managers to run if you've got the memory and CPU cycles to burn.

Window Maker
(A quote from the home page:) "Window Maker is an X11 window manager designed to give additional integration support for GNUstep applications. It tries to emulate the elegant look and feel of the NEXTSTEP(tm) GUI. It is relatively fast, feature rich, and easy to configure and use.''

A big strength of this window manager is that it supports the GNU desktop, meaning that it makes a great and very pretty front-end to GNOME. This is also one of the most easily configurable window managers, and can be configured from a graphical interface, and supports the OffiX drag and drop protocol, easy switching of desktop themes, and it's now available within the popular Red Hat distribution, so it's easy and painless to switch from FVWM when the mood finally strikes. As of the 0.50 release, Window Maker supports KDE compliance as well.
This is the author's personal favorite window manager. Get it!

AfterStep
(A quote from the home page:) ``AfterStep is a Window Manager for X which started by emulating the NEXTSTEP look and feel, but which has been significantly altered according to the requests of various users. Many adepts will tell you that NEXTSTEP is not only the most visually pleasant interface, but also one of the most functional and intuitive out there. AfterStep aims to incorporate the advantages of the NEXTSTEP interface, and add additional useful features. The developers of AfterStep have also worked very hard to ensure stability and a small program footprint.''

Enlightenment
Enlightenment is more than just a window manager, it is an extreme, detailed, and configurable environment, and is particularly attractive in that it allows irregular and completely customizable window shapes. It is open in design, and instead of dictating a policy it allows the user to define their own policy right down to the minute and infinitesimal details; from its functionality right on through to its looks.

Enlightenment is still in development currently, and can cause your system to crash. However, Rasterman, the author of Enlightenment, is currently working for Red Hat on the GNOME project, and as that project matures, support for Enlightenment will be maturing as well, making this an environment to keep an eye on.

Resources: The official Window Maker website is www.windowmaker.org/. The official AfterStep website is www.afterstep.org/. Enlightenment can be found, predictably, at www.enlightenment.org/.


4. Working In X
4.1 Command Line Options
4.2 Display Names
4.3 XTerm Versus Rxvt, or, Know Thy Terminal Emulator

In this section we will become familiar with running clients in X Window and the basic procedures involved in using the system. X is not an intuitive interface on its own, and without any window manager, it is easiest to use as a display for programs started from the command line. One of the most common uses for X is just to have several xterm windows open at the same time. Not exactly maxing out the graphics capabilities of the computer, but it's a nice feature to start with.

The flexibility and usefulness of the command line is so great, in fact, that you don't really need a window manager. It's nice, and you will want it very quickly, but the fact is that you can get by without one, just the command line and the mouse. If you give it a shot, you'll be surprised as to the exact distinctions between the clients and the window manager. If you start toying around with this, however, remember that the key combination Ctrl-Alt-Backspace gets you out of X Window in a pinch.

4.1 Command Line Options

Most X programs try to use the same basic names for command line options. All applications written using the MIT X Toolkit Intrinsics automatically accept the following options:

-display display
This option specifies the X server to use. See the section on Display Names for details.

-geometry geometry
The initial size and location of the window, in a format such as widthxheight+hoffset+voffset or +hoffset-voffset. Note that if you put in a negative horizontal or vertical offset, the window will be placed counting backward from the right or the bottom of the screen, respectively.

-font font
The font to use for displaying the text in your window.

-bg color
The color to use for the window background.

-fg color
The color to use for the window foreground.

-name resource-name
Useful for specifying the name under which the resources for this application will be found. This is useful to distinguish between invocations of the same application, for example, two xterms can be named differently so that they may inherit different resources based upon those names in the resource database.

-title string
This is the title to be used for the window on your display, generally used by the window manager to put a descriptive title at the top of the window. Not to be confused with the -name option.

-iconic
Invoke window as an icon.

-xrm resource-string
This option specifies a resource name and value to override any defaults that may already be set. Also useful for setting X resources that do not have explicit command line options. For instance, the command line xterm -xrm "xterm*background: blue" is functionally identical to typing xterm -bg blue.

4.2 Display Names

Every X Server has a display name of the form:

hostname:displaynumber.screennumber

The hostname specifies the name of the machine to which the display is actually, physically connected. The hostname can be omitted, and if so, the server on the same machine will be chosen. In fact, if you are the only one using X on your computer, you will want to just leave this off of your display specifications. The displaynumber should probably be zero, this is used if the X Server is controlling more than one keyboard and monitor unit, for instance, a network of X terminals. The screennumber specifies which monitor in a multiple monitor setup should be used. Following this specification, you would open an xterm window on your local machine with the option -display :0.0. You can see that we have omitted the hostname from the option, so the current machine is assumed.

On Linux systems, your DISPLAY variable holds your display name, which on my system is :0.0. This is usually set by xterm, or one of the scripts that starts X Window for you, although you can set it yourself, or as discussed above, use the -display command line option when invoking your application.

If you have opened an xterm or rxvt window, and then opted to do super-user work via the su command, you will find that if you try to launch an X application you will have no display to launch it on. Silly it seems, because you are sitting right in front of your display, but the trick to getting this to work is to pass an option on the command line to the program such as -display :0.0, and it will work fine.

4.3 XTerm Versus Rxvt, or, Know Thy Terminal Emulator

Your choice of terminal emulator can affect your experience in X almost as much as your window manager, so a little discussion of your best options is due here. A terminal emulator is a program such as xterm, discussed above, which lets you emulate the simple console of Linux in X. You will rely heavily on the program you choose, so it pays to choose it wisely to begin with.

If you have a slow video card, the first thing you should consider doing is switching to rxvt. Using xterm is a good starting point, mainly because it comes standard with all X distributions, but it's not always the best choice. It contains a lot of legacy code, and is quite bloated for a simple terminal emulator. This is partly due to the fact that it's not just a plain text terminal emulator, but also emulates graphics modes that you simply will never use. Because of this, you may wish to switch to rxvt, and also because xterm can be extremely slow. I'm not sure why it's so slow, but if you have a slow video card you'll know what I mean, and you'll be amazed at the difference when you dump xterm.

Some other perks of rxvt include pixmap backgrounds, and a much nicer scrollbar. If you specify the -pixmap option on the command line (and have support compiled in to your version!) you will get any .xpm-type picture in the background. A very cool feature, and it surprisingly doesn't slow down your output at all, it still redraws faster than your xterm window. Give it a shot, I haven't seen it around lately but I think it can be found on metalab.


5. X Startup
5.1 A Sample Starting Configuration
5.2 A More Intelligent Startup
5.3 Getting The Windows Where You Want Them

We will presume for the following examples that we have picked a fairly stable window manager, such as FVWM2, to try out some sample configurations. I would suggest giving that a shot for the purpose of learning these topics, as most of what you will learn here and in the following sections will apply to any window manager out there, but the topics seem most easily picked up using FVWM2.

5.1 A Sample Starting Configuration

Our first step is to write ourselves an initialization file for X itself. This file can be either a system-wide file, in which case it would likely be placed in /var/X11R6/lib/xinit/xinitrc, or it can be overridden on a per-user basis by placing the file .xinitrc in your home directory. Generally, it is expected that there will be a basic, default file in the system-wide location, possibly enforced if necessary for security reasons, but otherwise users will probably wish to configure the file themselves.

First let's create a file in your home directory called .xinitrc. Open up your "favorite'' text editor, and paste the following, or something like it, in that file:

        #!/bin/sh

        # if your backspace and delete are reversed, try this:
        xmodmap -e "keysym BackSpace=Delete" -e "keysym Delete-BackSpace"

        xsetroot -solid darkslateblue

        # start some basic applications
        xclock -geometry 96x96+2+2 -bg grey40 -fg black -hl white &
        xload -geometry 120x96+2+147 -bg grey40 -fg white -hl darkred -update 4 &
        xterm -sb -ls -geom 80x25-2+2 -title "shell" &
        xterm -sb -ls -geom 80x25-2-2 &

        # start the window manager
        fvwm2

There are plenty of things to learn from this example. First of all, this file will be a shell script, as indicated by the first line. The xsetroot command on the second line turns the background of our desktop to a pleasant blue color, not a bad idea if we're going to be staring at that color predominantly all day.

The third and fourth lines are some programs that I like to leave running while I'm fast at work. You'll notice that some of the options make for a nicer setup, for example, specifying the colors and geometry (location on screen). I'll give you some tips for figuring this stuff out in a bit. The fifth and sixth lines follow similarly, opening up two handy xterm windows for us, which we will no doubt be needing soon.

The last line is very important--it is this line that starts up your window manager! Notice that the only commands we did not run as background processes (by putting the & at the end) were xsetroot, xmodmap, fvwm2. With these first two it doesn't matter, as the programs exit immediately. But all the rest of the programs have to be in the background, otherwise when you closed one, it would kill your X Window session. That would not be very pleasant, nor very expected. As shown above, when you close fvwm2, you exit X.

5.2 A More Intelligent Startup

We can add lots to our primitive example of a startup file. For instance, this is a good way to warn yourself when you may have carelessly stared X as the root user. Red Hat users seem to do this often, for many of the configuration programs which must be run as root, must also be run in X. You can avoid this by issuing an su command to become root during your normal X user session, and then calling the program you need to run as root with the option -display :0.0 discussed above.

        # change background color for root
        if [ "$USER" = "root" ];
        then
             xsetroot -solid darkred
        else 
             xsetroot -solid darkslateblue
        fi

This will check to see if you are the user named root, and if you are, it will set the background to a harsh red, rather than the usual friendly blue, to warn you. This next bit of code, also intended for your .xinitrc file, will merge in your user-specific and system-wide resources, first checking to be sure the files exist.

        userresources=$HOME/.Xresources
        usermodmap=$HOME/.Xmodmap
        sysresources=/usr/X11R6/lib/X11/xinit/.Xresources
        sysmodmap=/usr/X11R6/lib/X11/xinit/.Xmodmap
        # Merge in defaults and keymaps
        if [ -f $sysresources ]; then
           xrdb -merge $sysresources; fi
        if [ -f $sysmodmap ]; then
           xmodmap $sysmodmap; fi
        if [ -f $userresources ]; then
           xrdb -merge $userresources; fi
        if [ -f $usermodmap ]; then
           xmodmap $usermodmap; fi
5.3 Getting The Windows Where You Want Them

Placing everything on your screen by guesswork with the -geometry option can get very tedious indeed. Particularly when you consider that you can specify the -geometry option to pretty much any program you can run in X. This allows a great precision in tuning the interface, but that's a heck of a lot of options to set, indeed.

This brings up one very nice feature of the FVWM window managers. By default, when you move a window around the screen, you see the geometry specification appear on the screen. Go ahead, try moving a window around with the left button. Now try resizing it. As you can see, you can get some primitive specifications this way. However, even this method can be a little difficult, and it would be nice to have all the details about your window in one concise list.

It is at this point that we will introduce the program xwininfo. To use this program, go to an xterm window and type in that program name. It will ask you to click on another window that you want information about, and after you click it will dump out useful information that it knows about that window. This is useful for plugging information about windows once you have them set up how you want them on your screen - run this program, then click on the window, then put in those parameters in your startup file, and your window system will henceforth be frozen in a pristine state of immaculate precision.


6. Configuring the Window Manager
6.1 Basic FVWM2 Configuration
6.2 Advanced FVWM2 Configuration
6.3 FVWM2 Configuration Shortcuts
6.4 FVWM2 Themes

Now we take a look at the files to configure your window manager. These vary from manager to manager, but for our examples we will focus on the per-user files, and we are looking at FVWM2 in this example, so you will modify the file .fvwm2rc in your home directory.

6.1 Basic FVWM2 Configuration

Configuring your window manager resource file in earlier versions of FVWM was a rather arduous process, because the order of the items in the file needed to be very particular, but that has relaxed quite a bit in this version. To my knowledge, the only crucial part of the ordering is the bindings for the menus, but we'll cover that a bit later. Your FVWM2 installation should have come with an example resource file, and you should be able to find that in /var/X11R6/lib/fvwm2/system.fvwm2rc. This is the default system-wide configuration file. A good idea would be to copy that file into your home directory and call it .fvwm2rc. From that point on, when FVWM2 starts up it will read the file in your home directory, and ignore the system-wide configuration file.

Now that you've got a working, personalized copy of the window manager resource file in your home directory, open it in your favorite text editor, and take a look at it. If you're in X at the moment, you can see the correlation between the file and what you see on your desktop. Very helpful indeed. Let's try changing something and see if we can make it look a little better. Probably the first entry in your file (that is not followed by the # comment character) is the WindowFont entry, followed by a very bizarre font name. If you want to figure out how to set up the fonts and colors to their fullest, skip ahead to the next section on X Fonts and Colors.

6.2 Advanced FVWM2 Configuration

Configuring FVWM2 can get incredibly subtle and complex. Take this code snippet from the fvwm2gnome setup for the .fvwm2rc file:

        # import config files

        Echo -Styles-
        Read .fvwm2gnome/config/styles/app.styles
        Read .fvwm2gnome/config/styles/window.styles

        Echo -Buttons & Keys-
        Read .fvwm2gnome/config/buttons.config

This is an example of a way to read in other configurations. In this fashion you can modularize your .fvwm2rc -- not a bad idea, considering how jumbled one huge configuration file can become. This can make it easier to change and to debug, and it also makes it easier to configure so-called themes, which we will cover in a moment.

6.3 FVWM2 Configuration Shortcuts

A really neat way to configure your script for FVWM2 (and FVWM, and bash, and a whole lot of other programs besides!) is to use the Dotfile Generator, by Jesper K. Pedersen, available from www.imada.ou.dk/~blackie/dotfile/. You will need to have a recent version of Tcl/Tk installed (available with most Linux distributions). This program starts with a configuration preset, or takes the one you presently have, and allows you to tweak it via many structured menus of options.

Be warned, however, for I advise learning how to set up your configuration file yourself! Not only is this the Unix Way (for what that's worth) but it's much easier to make small and incremental changes to your .fvwm2rc file that way, and get things exactly how you like them. Also, being a Tcl/Tk program, it's a little slow. Nevertheless, if you want a painless way to start with a decent configuration, this is definitely worth a shot.

6.4 FVWM2 Themes

Among the many new possibilities of FVWM2 are something commonly called themes. This basically means that you can switch between a basic look for all of your windows on your desktop, on the fly. Note that if you've made the distinction between the functions of the window manager and the functions of the applications themselves, you will realize that a window manager theme is not going to affect the look and feel of the applications themselves. Integrated toolkits such as KDE and GNOME do have this capability, however, and the two might be used together very effectively.

In order to generate a theme, you must roll up your sleeves and modify your .fvwm2rc file a little bit. Here's something I added near the beginning of my file, try putting it right after your Style definitions:

        # Blue Theme
        DestroyDecor Blue
        AddToDecor Blue
        + WindowFont -b&h-lucida-bold-r-*-*-*-140-*-*-*-*-*-*
        + TitleStyle ActiveDown (Solid DarkSteelBlue)\
            ActiveUp (Solid SteelBlue) Inactive (Solid Grey)
        + HilightColor white blue
        + ButtonStyle 1 -- UseBorderStyle
        Style Blue UseDecor Blue, BorderWidth 5, HandleWidth 5,\
            MWMborder, MWMbuttons

        # Function to change all windows to a new style.
        DestroyFunc ChangeStyle
        AddToFunc ChangeStyle
        + "I" Style $0 $1
        + "I" Recapture

That's a lot to swallow, I know. Basically we're first defining a theme called ``Blue,'' and you can use that first half as a model to design other themes. Themes can describe many more features than that, in fact, and can be quite remarkably different from one another. Then we're defining a function to change all the windows to a new style. Notice in both sections above that we destroy the object before creating it. This is a good idea since you may well be restarting FVWM2 a lot to try out your different styles, and this makes it work a bit more smoothly.

The function call is needed as a generic interface to call the definitions of the styles we have defined. Now we will make the menu items to call them.

        DestroyMenu "Themes"
        AddToMenu "Themes"
        + "Choose a theme..." Title
        + "" Nop
        + "Blue" ChangeStyle "*" "UseStyle Blue"
        + "Mwm" ChangeStyle "*" "UseStyle Mwm"
        + "Flat" ChangeStyle "*" "UseStyle Flat"

We're being a little terse with the menu definition here, but there should be a lot more in the sample file on your system. What we're doing is calling the ChangeStyle function that we defined above to change the style for all the windows on the screen to one of the presets we defined above that. Notice, again, our good practice in destroying the menu before creating it. Now if you restart FVWM2 (you should also have a menu option for that, hopefully!) you will see a new Themes menu selection, and you should be able to try out the different themes.

For more examples of FVWM2 Themes, visit www.vis.colostate.edu/~scriven/Linux/fvwm/index.html[§]


7. Fonts and Colors
7.1 Fonts Demystified
7.2 Font Aliases and Configuration
7.3 Using Type 1 Fonts in X
7.4 Using TrueType Fonts in X
7.5 Colors

There are a lot of tricks to the fonts and colors used in X. They are not quite as simple as in some other systems, for instance, the font is not just a one-word name. You specify these resources quite explicitly, and it seems rather complex at first, but with a little explanation you'll be a whiz in no time.

7.1 Fonts Demystified

The X Logical Font Description (``XLFD'') is the full name for a font. It consists of the following fields:

o fndry - font foundry, the company or individual which made the font
o fmly - font family, the popular nickname of the font

o wght - font weight (bold, medium, etc.)
o slant - font slant (italics, oblique, roman (normal), etc.)

o sWdth - font width (normal, condensed, extended, etc.)
o adstyl - additional style (sans serif, serif, etc.)

o pxlsz - pixel size, the number of pixels vertically in a character
o ptSz - approximate point size of the text (similar to pxlsz)

o resx - horizontal resolution, in dpi
o resy - vertical resolution, in dpi

o spc - spacing, only useful, apparently, in the Schumacher fonts
o avgWidth - average character width of the font

o rgstry - the recognized registry that lists the font
o encdng - nationality encoding

In light of this chaos, the program xfontsel (the default X Window font selection program) will come in enormously useful to you. Try launching it right now. You will see a strange nothing helpful in the main window, but try holding the left button down on the fndry button. If all your fonts are in order, you will see a menu of selections such as adobe and b&h and bitstream and so forth. Select one such as b&h and you will notice that the font in the lower window changes to something intelligible. This is generally the way you will select fonts with this program, starting from the left, which is the most general selection, and moving toward the right, to the more specific options. Selecting an option toward the rightmost end will not make much sense before the foundry, for instance, is selected, because the options are generally ordered by their dependence on each other.

When you go to select from the fmly selection, you will see most of the options greyed out, and only three remaining. That means that these three are the only families of font made by this foundry. Some families appear under more than one foundry, for instance, both Adobe and Bitstream make a variation of the Courier font. Now you can select the wght, and so forth. After you get far enough you will have narrowed it down to the font that you want. You don't necessarily have fill in all the options to choose a single font, there's not that many fonts on your system! The options that you do not select will be represented by a * indicating that any option will do in that spot.

When you are happy with your font selection, you can hit the select button, and your selection will be placed in the X clipboard, ready to be pasted into your document or whatever you are working on. For instance, go to your xterm window and type in something like xterm -font followed by an opening quotation mark. Then point to that spot on your screen, and click your middle mouse button (or click both the left and right, if you're middle-button impaired). This will paste the selection from the clipboard, which should be the font you just selected. Then enter the closing quote, and hit Enter. For instance, a nice big xterm with a Courier font specified would look like this: xterm -font "-adobe-courier-medium-r-*-*-14-*-*-*-*-*-*-*" A fresh xterm should the pop up using the font that you selected.

The utility xfd is very helpful for examining a font. If you launch it with a command line such as xfd -fn fixed, it will show you the character set for the font, much like the keycaps utility on a Macintosh. Note that you can also limit the number of fonts that you want xfontsel to display with the command line option -pattern, followed by a quoted font specification, as discussed above.

7.2 Font Aliases and Configuration

Sometimes it gets tiresome to remember all of the long font names, and very impractical too. Luckily, it is not necessary to type in a hundred keystrokes or so just to get the font name you want, for X provides something called font aliases.

If you look in the directory /usr/X11R6/lib/fonts/misc/fonts.alias, you will find shortcut names for many of the fonts. For example, 8x16 is listed as a shortcut for -sony-fixed-medium-r-normal--16-120-100-100-c-80-iso8859-1, and anywhere you enter 8x16 as an X font resource or at a command line for a font name, the long version of the font will be substituted. The 75dpi and 100dpi directories have similar aliases to take advantage of, on most systems the Lucida Sans font has a nice shortcut.

If you add fonts or aliases to your system, you will have to issue a few commands (probably as root). If you add fonts, you will have to issue the following two commands (these are examples, you will have to put in the correct directory, or perhaps leave it off altogether, to have your fonts re-read correctly.

        mkfontdir /usr/lib/X11/fonts/misc
        xset fp rehash

If you change the alias file for a font, you may only have to issue the last command above, but it may be a good idea to issue them both, to be sure. With the xset command you can explicitly issue a font path you wish the server to use, you can delete a specific directory from your font path, see the man page for more information.

Another common problem is that some distributions (notably Red Hat 5.2, at the moment) come with the fonts configured in the wrong order. If you take a look at your /etc/XF86Config (it may be somewhere else in some distributions, unfortunately, and I'm not sure where it is in Red Hat at the moment, so maybe locate it...) Take a look at this file if you fonts are ugly in X (as in, very difficult to read even at large sizes). You will see a bunch of entries that look something like this:

        FontPath   "/usr/X11R6/lib/X11/fonts/misc/"
        FontPath   "/usr/X11R6/lib/X11/fonts/75dpi/:unscaled"
        FontPath   "/usr/X11R6/lib/X11/fonts/100dpi/:unscaled"
        FontPath   "/usr/X11R6/lib/X11/fonts/Type1/"
        FontPath   "/usr/X11R6/lib/X11/fonts/Speedo/"

The important thing to note here is that we have the unscaled bitmapped fonts (the directories misc, 75dpi, 100dpi) before the scaled fonts (such as Type1 and Speedo). Bitmapped fonts are preferred for the X Server, because scaled fonts don't look very pretty for common use, they're better for things like The Gimp or Netscape, perhaps. You should also do a sanity check to see that these directories all do, in fact exist, and if you have modified any lately, you might need to (as root) go in and issue an mkfontdir * command in the fonts directory.

7.3 Using Type 1 Fonts in X

The font types X generally accepts are of limited use, considering that about the only place you'll find fonts of that kind used are in the X Window System itself, and unfortunately most media junkies and fontaholics work in operating systems that prefer other formats. Type 1 fonts, most commonly used in conjunction with PostScript document formats, can be found for free on the internet with considerable ease. Try ftp.cdrom.com/pub/os2/fonts/ for starters.

To make use of these fonts is not that difficult, and graphics programs like GIMP will take advantage of them tremendously, and best of all, the Linux X servers understand Type 1 fonts ``out of the box.'' To use them, first unpack the archive using the appropriate commands, and put the fonts with a .pfb extension in /usr/X11R6/lib/X11/fonts/type1/ on your system. Then, add mention of those fonts in the fonts.scale file in that directory, using the format for the other fonts, already there. Then save the file.

Now, you should be able to mkfontdir to tell the X server about the updates, and then run xset fp rehash to re-read the font path. If this doesn't work for you, you might have to restart X to see the changes.

If you find yourself using Type 1 fonts a lot, and for things other than just X (GhostScript, for instance, can handle this font format as well), you'll want to check out the type1inst utility by James Macnicol. This program can configure Type 1 fonts for GhostScript and X, and it can also generate sample sheets for your fonts, and does most of the work of configuration for you. This program can usually be found at metalab.unc.edu/pub/Linux/X11/xutils/.

7.4 Using TrueType Fonts in X

If you have been using an operating system such as Windows or the MacOS, you may have lots of fonts sitting on your computer already that are TrueType fonts. TrueType fonts are considered best on smaller, low-resolution displays, such as your computer monitor, and attempt to provide nice features like shading and antialiasing, making your display look smoother. It is also really easy to find cheap TrueType fonts in bulk, and CD's featuring upwards of 500 fonts in the TrueType format are common in computer stores.

X does not understand TrueType fonts, and has no innate capability (at present) to do so, and so it needs a separate program to do the font rendering for it. There is a FreeType library to do this, but if you just want to use them on your computer, all you will need is a program called xfstt, the X font server for TrueType. This program should be available at metalab.unc.edu/pub/Linux/X11/fonts/.

Installation is fairly straightforward. Extract the archive, and make the file, and then make install. You may get a few errors that don't make sense after the second command; ignore them. What you need to do next is create a writable directory called /usr/ttfonts and put some of your .ttf fonts there, just to make sure it's going to work. Then synchronize the font server with the command xfstt --sync.

If you got no errors there, run the font server in the background with the command xfstt & and tell your X11 server about the font service with the command xset fp+ unix/:7100. If you got no errors, you should be able to run Netscape, the GIMP, even xfontsel, and have those fonts available to you. Your biggest problem may be finding the font you want, but that's not really a bad thing.

If everything seems to be working fine, at this point you will want to configure your system so that the fonts will be working when you start X. If you are just starting X from the command line, this is easy. All you have to do is add the two commands from the previous paragraph to your .xinitrc file, in that order. When you next start X, it should work just fine. If you are starting X via xdm, you will need to add /usr/X11R6/bin/xfstt & to /usr/X11R6/lib/X11/xdm/Xsetup_0. Got that? Then add xset vp+ unix/:7100 as well.

Bear in mind that the installation of a TrueType font server can be tricky business. Remember that the order that you issue the above commands is important. The font server must be started before X is started, otherwise you will run into problems. Be sure to read the FAQ file that came with the distribution, and the xfstt man page too.

7.5 Colors

Let's go back to our terminal window and try some more things. Try opening an xterm with a command line like the following:

        xterm -fg darkslateblue -bg red3 &

While that window may not be pretty, and you may not do much of your best work in it, it demonstrates one interesting theme of X, the names of the colors. While not very precise, this is a nice way to remember the colors more easily than remembering a series of hexadecimal numbers. Note that color names are never case-sensitive.

If you're interested in the gory details, or want to see the samples, or even want to replace those silly color names with your own for some strange reason, you can find the file listing all the colors with their hexadecimal representation in /usr/X11R6/lib/X11/rgb.txt on your system. There are also some extremely useful utilities with names like xcolorsel and such. They can be found in the usual locations, on metalab.unc.edu/pub/Linux/ and elsewhere.

A more precise way of specifying colors is through the numerical definition. This consists of a color space name and a set of values in the following syntax:

        <colorspace-name>:<value>/.../<value>

An RGB Device, which you will most likely be using, is specified with the prefix "rgb:" and has the following syntax:

        rgb:<red>/<green>/<blue>

where <color> is a 1 to 4 digit hexadecimal number.

As an example, you might represent the color red with rgb:ffff/0/0. For backward compatibility, you can also specify red with a syntax such as #ff0000 or #ffff00000000, and you will likely be seeing that (older) syntax a lot.


8. The X Resources
8.1 X Resources: The Basics
8.2 Inside The X Resource Database With editred
8.3 The Anatomy of X Resources
8.4 Making Your Changes Last With .Xdefaults
8.5 Your Own User Resource Directory

We will at this point consider some finer modifications to your system. Configuring the window manager only gets you so far. The window manager lets you customize everything that happens outside the windows, the frames, the borders, the buttons, the desktop... but what about making the inside of the windows pretty? The only way to do this is by modifying the X Resources for your system.

X Resources provide a mechanism for storing default values for program resources and tailoring your windowing environment to your favored look and feel. Resources are specified as text strings that are read in from various places when an application is run. Program components are named in a hierarchical fashion, with each object in the hierarchy identified by a class as well as an instance name. At the top level of the hierarchy is the class and instance name of the application itself. By convention, the class name of the application is the same as the program name, but with the first letter capitalized (e.g. Bitmap or Emacs) although some programs that begin with the letter ``X'' also capitalize the second letter for historical reasons (e.g. XTerm).

8.1 X Resources: The Basics

Let's try a few examples to ease you into the world of resources. Start by opening an xterm window. Most likely you have one open already, can open one with a menu selection, or may wish to backtrack a bit in this document to get your bearings! Type something like this into the xterm window:

        xterm -background blue &

This command should have resulted in another xterm window popping up on your screen, but this time with a blue background. ``Wow,'' you say, ``that's amazing!'' Yes, indeed it is.

We'll need a little more background for our next example. Type exit in that xterm (which will close that window) and go back to the original window that you typed that command in. Try this: hold the Ctrl key and then hold the left mouse button. Now try that with the middle mouse button. Now the right. All xterm windows give you options to try while they are running. With the right button, for instance, you can change the font of the window. Notice the color of these menus. Now try this example:

        xterm -xrm 'xterm*fontMenu*background: green' &

This time, it just looks like a normal xterm window. But if you try holding Ctrl and the right mouse button in that window, you will see that this menu (the ``fontMenu'' mentioned in the above example) is green. What just happened? If you look at the man page for xterm, you will see many command-line options, such as -background or -font, that you can set when you launch any given window in X, listed after the options just for xterm windows. These particular options are called X Toolkit Options, and they apply to just about anything in X.

8.2 Inside The X Resource Database With editres

To really get inside the resources of X, we need to run editres. Go ahead and launch it (and a sample program to play with) now:

        xclock &
        editres &

Probably you will see a simple clock, and the rather innocent looking, mostly-blank window of editres. The main window is showing us the resource tree of any given window on our desktop, and upon program launch, there is none. So let's give it one. Hold down the left button on the Commands menu, and select Get Tree. In the top of the window will appear Click the mouse pointer on any toolkit client. This message is more than it seems, and it is a hint to us that not all X applications are toolkit clients (though most of the basic ones are, and the program will usually tell us if it is not in the manual page). The mouse cursor will turn to a crosshair, and wait for you to click on another window.

For this example, let's first click on the xclock. You will see a couple things appear in the editres window. These are the configurable branches that the toolkit sees. Click on the bottom right one (clock). It should invert. Now select ``Show Resource Box'' from the ''Commands'' menu. You will see another window pop up, with the heading ".xclock.clock.unknown". Bingo!

From here you can toy with the configuration options of the main xclock window. First, click on ``Set Save File'' at the bottom, and put in a filename such as /home/yourname/resources, to indicate that you're testing some of the resources here. Now click on ``foreground'' and put in ``blue'' next to the ``Enter Resource Value:'' prompt. Then hit ``Apply'' at the bottom. The minute notches around the clock should turn blue. Go to ``background'' and enter ``navajowhite'' (or whatever color you prefer). The apply that. As you can see, we can configure the whole window just fine this way. But if you were to try launching another xclock, it would appear just as this one appeared before any changes. We need to save these changes.

Click ``Save'' and then ``Popdown Resource Box'' (a fancy name indeed for the ``Close'' function!). If you view the file you just created (cat /home/yourname/resources perhaps) you will see all those resources spelled out, in correct X Toolkit format, for your convenience. But that does us little good, for if you try launching another xclock, it will still look Plain Jane. So here is the last and final step in loading in your resources:

        xrdb -merge /home/yourname/resources

This command merges the resources we just wrote into the X Resource Database (xrdb) for your session of X Window. That means that for all future invocations of the X applications we modified, our changes will take place, and remain binding. So if you run another xclock, it will look as nice as you have just now set it up, every time you run it. Mind you, xrdb is a complex program, and you may want to have a look at the man page before moving on, or playing around with it some more. If you added the modification to .xinitrc listed earlier in this document, to load the resources automatically on X startup, you should only have to worry about the xrdb command when you make changes during your X session.

8.3 The Anatomy of X Resources

As you can see we have stumbled across a plethora of configuration options here. This method of configuring X, as has been stated, offers nearly limitless possibilities, and an equivalent amount of confusion. To get some picture of the scope of the resources in just the X Toolkit Intrinsics alone, run the program viewres, and play around with it a bit. This program graphically displays the tree of resources in the Xt Library.

If you read the manual page for X, you will find a rather obscure definition of the exact syntax for defining resources it understands. We can simplify this quite a bit and break it down into this essential syntax definition:

        <program><binding><widget><binding><widget><...><resource>:<value>

That doesn't really seem that simple, actually. Well, let's define some things about what has just been said, and it will all start to make sense after all. You can peek ahead to the examples in the next section as you read along, if you wish.

The program in this definition is the invocation of an application in the resource database. This would be XTerm for an invocation of xterm, emacs for an invocation of the emacs text editor, or a user-defined name that was given when the applications was launched with the -name command line option. In this way you can define separate resources for xterms which will be used in different ways. Which is pretty cool, really.

The binding can be one of two characters to separate the widgets and such. If you use a . (period), you get a tight binding, which means that one widget is directly above or below the other in the widget hierarchy. This also has the highest precedence of the specification methods. If you use a * (asterisk), you get a so-called loose binding, and you will skip any number of widgets in the hierarchy, and it will attempt to match the next possible widget defined.

The widget entries are items in the widget tree, in order of most- specific to least-specific, that they appear in the widget tree, visible with editres. Any single widget entry can also be replaced with a ? (question mark) to skip a single widget definition, and match any possible widget item.

The resource item must be specified, and cannot be replaced with the ? character. This is the most-specific item in the hierarchy, and usually contains items like the actual color to define, actual font to define, and so forth. In fact, everything else before the resource in this definition can be left out and replaced with a single asterisk, but the actual resource to define must be present. If you just put an asterisk and the most-specific resource name, such as *background: blue, X will attempt to define that resource globally, for all its clients, if possible.

Following the colon is the value entry. This entry defines what the resource will be set to, such as a font name or color value. The value can be specified (depending on context) as a boolean, numeric, or text data type. The value entry, also, cannot be omitted in a valid resource definition.

8.4 Making Your Changes Last With .Xdefaults

There is a magic file you can put in your home directory called .Xdefaults. If you copy the lines in the resources file from the last example into the .Xdefaults in your home directory, you will never have to configure xclock again! While this might not be the finest example of its utility, it makes its point. This file can be crammed full of every option you prefer for every type of program you run in X, and if you take proper care of it, you can still easily go back and make slight changes when you need to. But making lots of changes, and hunting down lots of subtle resources using editres can be an extremely tiring and painstaking procedure. Indeed, sometimes that's too much work, and most of these resources are already waiting for you, neat and orderly, grouped by program, on your system.

In the directory /var/X11R6/lib/app-defaults you will find a great many files, all named after an X Toolkit program. If you examine these files you will find that they contain a great many configuration options for each one, and I do mean a great many! You would not want all of these options from all of these files in your .Xdefaults file, that would be quite tiresome to deal with. These are the defaults, and it is from these that you can decide what you would like to see changed for your particular configuration.

The following are some samples from my .Xdefaults file. Notice a few things we have not yet mentioned about the resource definition files. If a line begins with ! (exclamation point), it is considered a comment, and the rest of the line is ignored. If the line begins with #include filename, that line is an include directive, and at that point in the resources another file will be merged, when it is loaded. This can help keep your resource files from becoming too bloated. And here are some examples:

     ! Default resources for me@localhost xterms
     ! start with the generic, move to the specific...
     *Dialog*Text*font:     -b&h-lucida-medium-r-*-*-12-*-*-*-*-*-*-*
     *dialog*value*background: white
     *Dialog*Label*font:    -adobe-helvetica-bold-r-*-*-12-*-*-*-*-*-*-*
     *MenuButton*font:      -adobe-helvetica-medium-r-*-*-12-*-*-*-*-*-*-*
     *MenuButton*background:        grey80
      *MenuButton*foreground:        black
     *Label.font:           -adobe-helvetica-medium-r-*-*-10-*-*-*-*-*-*-*
     *Label*shadowWidth:    1
     *SmeBSB.font:          -adobe-helvetica-bold-r-*-*-12-*-*-*-*-*-*-*
     *SimpleMenu*font:      -adobe-helvetica-medium-r-*-*-10-*-*-*-*-*-*-*
     *OptionMenu*font:      -adobe-helvetica-medium-r-*-*-10-*-*-*-*-*-*-*
     *Command.font:         -linotype-helvetica-bold-r-narrow-*-12-*-*-*-*-*-*-*
     *commandBox*font:      -b&h-lucida-bold-r-*-*-12-*-*-*-*-*-*-*
     *Toggle.font:          -adobe-helvetica-bold-o-*-*-12-*-*-*-*-*-*-*
     *Form.background:      grey70
     *TransientShell*Dialog.background: grey70
     *Scrollbar.Foreground: grey80
     *Scrollbar.Background: grey50
     *Scrollbar*cursorName: top_left_arrow
     *Scrollbar*width:      16
     *shapeStyle:           Rectangle
     *XlwMenu.shadowThickness: 1
     *shadowWidth:          1

     ! xterm stuff
     xterm*scrollbar.background: grey40
     xterm*foreground: grey90
     xterm*background: grey25
     xterm*cursorColor: white
     xterm*visualbell: on
     ! rxvt stuff (a quicker, better xterm)
     rxvt*color12: steelblue
     rxvt*color15: white
     rxvt*color9: rgb:ff/7f/5f
     rxvt*foreground: grey90
     rxvt*background: grey10
     rxvt*cursorColor: white
     rxvt*font: lucidasanstypewriter-12
     rxvt*loginShell: false
     rxvt*saveLines: 1024
     rxvt*title: shell
     rxvt*geometry: 80x25
     ! Make Xman just a little bit more sane
     xman*topBox: false
     xman*background: lightsteelblue
     xman*foreground: black
     ! xcalc is too bland by default...
     xcalc*Command.font: -adobe-helvetica-bold-r-*-*-10-*-*-*-*-*-*-*
     xcalc*customization: -color
     ! Disallow the <blink> tag in Netscape
     Netscape*blinkingEnabled: False

     ! Merge other resources (example)
     # include $HOME/.otherXresources

One word of warning with regard to X resources. KDE users will find that their X resources are ignored. That's right. They are. I'm not actually aware of any way to get around this at present, nor have I looked into it extensively. KDE configures your resources for you, so that all your X applications have the same look and feel, sort of. This can be very disorienting if you're switching between window managers. If anybody knows how to get around this (read: fix it ;) please let me know.

8.5 Your Own User Resource Directory

You can also create a directory of resource files, just like the system-wide app-defaults directory mentioned above, with one file per program. Just create the directory (for our example we'll use app- defaults under your home directory,) and then set the environment variable XAPPLRESDIR to point to it. A good place to set this variable would be in the beginning of your .xinitrc file, for example, put in the line export XAPPLRESDIR=$HOME/app-defaults (if your files are going to be in an app-defaults directory under your home directory).

Now, whenever you start an X program, this directory will be searched for a file with the same name as the resource name of the program, just like the system-wide directory. This is the client name that you used in .Xdefaults files.

For example, a file called XTerm could contain the line *background: gold, and all your xterms would, by default, come up with a gold background. This is a nice alternative to a single .Xdefaults file, and makes it more clear when trying to decide which settings to configure later on, and to find the ones for a certain program. There are still uses for the .Xdefaults, though. It's useful for setting resources not bound to a single program, like modifications that you would make to turn all of a certain kind of button blue, regardless of the application.


9. Clients and Application Tips
9.1 Screen Savers for X
9.2 Emacs and XEmacs
9.3 Some Useful Programs and Tricks
9.4 Libraries and Compiling X Applications
9.5 Basic X Security

We have covered a few clients in X, and this section will cover some more. We will limit our discussion here to the most basic and important core items, those which come with X or you are likely to find yourself using with X. If you have installed an integrated desktop environment such as KDE or GNOME, you will have many others to choose from which likely perform many of the same functions. However, it is important to know about and understand many of the fundamental programs in X, because they can be very useful for working with your environment and such. Also X offers many new options that even your normal console applications can take advantage of.

9.1 Screen Savers for X

A common feature of many operating systems is the ability to blank the screen after a specified amount of time, and optionally display some sort of nifty graphics demo thing, a screen saver. There are a couple ways to do that in X, too.

The most basic way to use this feature is by putting a command in your .xinitrc startup file such as xset dpms 2400 3600 4800. The xset program can configure the screen saving features of the X server, not to be confused with the screen blanking that the kernel does when you are at the text console. With the dpmi option, X can use the power saving features of your monitor as well. The first option configures how many seconds before the screen blanks, the second option is how many seconds before the power saving feature starts, and the third option is for the "off" mode. Turning on an option implicitly enables the feature, setting a feature to zero explicitly disables it.

Many Linux distributions come with xlock preinstalled, or as an option. This is a pretty basic and fairly nice screen saver. If you run it with the -nolock option, you can see some of the modes that it offers, and if you leave that option off, it will ask you for a password when you move the mouse or press a key, as a security feature. Note that this is no real security, for at a Linux console a user could restart the computer or just drop out of X with a combination of keystrokes. The last method can be disabled, however, and if you are using xdm, it will offer as much security as your login, so it may be that only rebooting will let someone in.

A newer and better program is xscreensaver by Jamie Zawinski. This program offers a great many niceties, for instance, it can run its processes at a nicer priority level, lessening the load to the system while it's running, and it automatically detects when the screen has been powered down by xset and doesn't waste processor time. Also, all of the graphics routines it calls are modular demos, and you can add routines without upgrading the whole package, and it can also call other programs, such as xearth or xdaliclock, as modules.

The latest version of xscreensaver can be found at www.jwz.org/xscreensaver/. Once you get it installed and ready to go, here are some nice additions you might wish to add to your .Xdefaults file:

        !!! some XScreenSaver sample defaults
        ! Time out after 3 minutes, cycle mode after each 2
        xscreensaver.timeout: 3
        xscreensaver.cycle: 2
        ! Run very low priority, and fade between modes
        xscreensaver.nice: 12
        xscreensaver.fadeSeconds: 2
9.2 Emacs and XEmacs

If you are a fan of the text editor EMACS, or just someone who uses it a lot, you will find your work even easier in X Windows. If you have not tried XEmacs, you may want to get it for use in X. There are features in XEmacs that are nice even if you are not in X, for instance, your text can be colored to match the markup style you are editing automatically. You should give the following modification to your .emacs file a shot, and read the info pages for more options. Also look for an option to edit faces in the menus.

        (global-font-lock-mode t)
        (setq font-lock-maximum-decoration t)
9.3 Some Useful Programs and Tricks

appres
The appres program prints the resources seen by an application (or sub-hierarchy of an application) with the specified class and instance names. It can be used to determine which resources a particular program will load. Useful for debugging your X defaults and such.

rclock
Many distributions come with this nice replacement for xclock, which saves memory, alerts you when your mail comes, and can pop up reminder messages and launch programs. The Battery-Powered Mini-HOWTO contains instructions on patching this utility to show how much battery is left in your laptop, too.

rxvt
A nice replacement for xterm - uses less memory, works faster, lets you put in a background pixmap, and lets you switch fonts with keyboard hotkeys, rather than menus.

xcpustate
Displays CPU state (idle, nice, system, kernel) statistics, as well as Ethernet information.

xearth
Display the earth on your root window, many options for display available. Xscreensaver can use this as a screensaver module, for maximum fun.

xfig
A vector drawing program, particularly useful for charts and documentation. Quite useful but hard to get the hang of at first.

xfontsel
Font selection utility for X Window. Try the command xterm -fn `xfontsel -print` & to pick a font and then open the xterm window using that font.

xload
Monitor your memory usage with a moving graph or the lights on your keyboard! If you use Window Maker, look for wmmon to do the same, but prettier.

xmag
A magnifying glass for X, with a couple other useful features.

xman
Manual page browser for X. If the little box it starts with gets annoying, launch it with the -notopbox option.

xmodmap
Edit and display the keyboard modifier map and keymap table that are used by client applications to convert event keycodes into keysyms, usually run from user's startup script. An example was given earlier in this document, see the man pages for more info.

xpaint
Basic bitmap painting program, for any real work you should grab GIMP www.gimp.org/.

xset
User preference utility for X. You can change all sorts of stuff with this. For instance, xset s 600 sets the screen to blank after ten minutes.

xsetroot
Change the color of your desktop. If you have a color selector program like xcolorsel installed, try a command like xsetroot -solid `xcolorsel` to pick a color and set your desktop to that color.

xwininfo
You can run this program and click on any window for lots of useful information about it.

The Intellimouse
You can use the Intellimouse in X with a great many applications. There is an excellent resource page located at www.inria.fr/koala/colas/mouse-wheel-scroll/.

9.4 Libraries and Compiling X Applications

Sooner or later you will have to deal with compiling applications of your own. Later, if you just installed a nice distribution of linux, and are happy with what you've got, sooner, if you're the kind of person who likes to tinker and install. Remember, this is a privelage, not a right, so have fun with it!

First, a few pointers on compiling programs with X. Many newer applications, GNU applictions in particular, come with a script in the root directory called configure. This assumes of course that you've extracted the file and are in the directory. This program should be run as ./configure, and will automatically detect many things about your system. Afterwards, simply running make and perhaps becoming root and running make install will get the program up on your system.

You may have to do a little more tinkering if you do not have a configure script available. Many X programs require you to run a program to make the Makefile, called xmkmf. If you don't see a Makefile in your directory, this will sometimes work, and will generate a suitable configuration for you, and you'll be ready to make from there.

Sometimes you will have run the configure script, and have been warned that you lack a library that would be helpful or necessary to properly use that application. For instance, I recently installed the xscreensaver application, and found that it would support several 3D modes if the Mesa library was installed. If you run into this situation and want that library installed, the first thing you should do is check the CD or installation media for your Linux distribution to see if you have the library on there. That may save you lots of trouble trying to compile the library.

Once you get a library compiled and installed and ready to use, you can go back to the directory you were installing your X program from, remove the config.cache file, and run the configure script again. Hopefully it will find the library you have installed. Sometimes it does not, and you have to tinker to get it working. This happens occasionally with libraries you download off the net, that do not adequately support the Linux File System Standard (most do, however).

9.5 Basic X Security

It has often been said that X has a very simple security model: All or Nothing. This is not much of an exaggeration at all. X can be configured to use somewhat sophisticated security, via encryption, but that is beyond the scope of this HOWTO (for the present). It is assumed that the user is not using any encryption for this discussion.

First of all, you should try and follow some simple rules when you're compiling programs for X (or for any reason, really). Try not to become root any more than necessary. Configure your programs as a normal user with the ./configure && make (or just make if there's no configure script), and then issue the single command to install it as root by typing su -c "make install", and then typing in the root password at the prompt. That way you won't have to be logged in as root, you can just issue a single command, and you're back to your normal user prompt. This is a smart, safe way to install software.

The next thing to think about is running X software as root. Realize that X is more or less inherently insecure, and if your primary concern for a particular Linux box is security, you really don't want to install X at all! Having said that, some folks want to run nice fancy configuration programs or package management tools in X. I do not recommend starting X as root. It's just not a good idea. There's much, much better ways to do these things!

If you want to run an X application as root, just log in under your normal user account, and launch it from there. As I mentioned above, you don't want to be logged in as root any more than absolutely necessary. The root user has the ability to do just about anything on the system, including about a million ways to destroy it completely. Simply go to your xterm or such application and type in a command such as su -c "glint -display :0.0" to launch the window on your desktop. Now you have a single window running as root, and not the whole desktop. You might also want to consider using the complete pathname to the program you're running as root, for extra security.


10. Bibliography and Other Resources

There is lots of information on X Window to be found, on your computer right now, on the Internet, and in some excellent books available at your favorite bookseller. Give some of the following resources a try, they have been extremely helpful to the author, and can be extremely helpful to you, too.

o Check the Linux Documentation Project metalab.unc.edu/LDP website for a lot more documentation on Linux, X, and related items.

o www.x11.org/ is sort of a clearinghouse for all things X.

o www.themes.org/ is a headquarters for themes for various window managers.

o The X Consortium's web site is www.x.org/... or perhaps it's moved to www.opengroup.com/.

o XFree86 can be found at www.xfree86.org/.

o The O'Reilly series on X Window! Visit www.ora.com/ for the definitive books on X.

o Much more information on using TrueType with X is at www.freetype.org/.

o The man pages for X, xterm, XFree86, and for any other clients you find yourself using often, are very useful and quite information- packed, and highly recommended. As the oft-repeated saying goes, RTFM.

o There is a Remote X Apps MINI-HOWTO that is very helpful in figuring out how to run local and remote clients with X.


[§]: link caused problem