# Introduction to GNOME V&manrevision;

2001
2003
Alexander Kirillov
2000
2001
Red Hat, Inc.
2000
2001
David A. Wheeler
GNOME Documentation Project

&legal;

Alexander
Kirillov
GNOME Documentation Project

     kirillov@math.sunysb.edu

David
Mason
Red Hat, Inc.

     dcm@redhat.com

David
Wheeler
Introduction to GNOME V&manrevision;
&date;

Alexander Kirillov kirillov@math.sunysb.edu, David C. Mason, David A. Wheeler

GNOME Documentation Project

Introduction to GNOME V2.0
June 2002

Alexander Kirillov kirillov@math.sunysb.edu, David C. Mason, David A. Wheeler

GNOME Documentation Project

Updated for GNOME 2.0. Some descriptions and screenshots are borrowed from GNOME Desktop 2.0 User Guide (May 2002), by Sun GNOME Documentation Team gdocteam@sun.com>, published by GNOME Documentation Project

Introduction to GNOME
April 2001

Alexander Kirillov kirillov@math.sunysb.edu, David C. Mason, David A. Wheeler

GNOME Documentation Project

This version described GNOME 1.4

This document was last updated in &date;. It describes GNOME 2.2.

## Feedback

To report a bug or make a suggestion regarding this document, follow the directions in the GNOME Feedback Page.

## What Is GNOME?

GNOME is a user-friendly graphical desktop environment for UNIX and UNIX-like systems. GNOME includes a panel (for starting applications and displaying status), a desktop (where data and applications can be placed), a set of standard desktop tools and applications, and a set of conventions that make it easy for applications to cooperate and be consistent with each other. Users of other operating systems or environments should feel right at home using the powerful graphics-driven environment GNOME provides. GNOME runs on a number of UNIX-like operating systems, including Linux, FreeBSD, and Solaris.

GNOME is completely open source (free software) developed by hundreds of programmers around the world. Both the source code and ready-to-run binaries of GNOME are available for download on the Internet; they are distributed under the terms of the GNU General Public License (and its cousins, Lesser General Public License and Free Documentation License for libraries and documentation respectively). In particular, this means that everyone is free to use, copy or distribute GNOME. If you would like to learn more about the GNOME project please visit the GNOME website.

GNOME is highly configurable, enabling you to set your desktop the way you want it to look and feel. GNOME supports many human languages, and more are added every month. GNOME even supports several drag and drop protocols for maximum interoperability with non-GNOME applications.

GNOME comes from the acronym for the GNU Network Object Model Environment (GNOME). GNOME is a part of the larger GNU project, started in 1984 to develop a completely free UNIX-like operating system. For more information, visit the GNU website.

This guide describes GNOME 2.2 which is the latest (as of March 2003) release of GNOME.

## Purpose of This Document

This document gives you a short introduction to GNOME. It is not intended to cover all details of GNOME; if you need more information, you should read the detailed manuals listed in . Also, this document assumes you already have GNOME installed; if you need help installing GNOME, please check the instructions on the GNOME website.

This document was written by the members of the GNOME Documentation Project (GDP). If you have any comments or suggestions about this document or if you can offer any other help in improving or translating GNOME documentation, please send an e-mail to docs@gnome.org, or visit the GDP website.

The authors of this document assume that you are using the default configuration of GNOME. GNOME is highly configurable, so it is easy to change not only the look but also the behavior of GNOME; however, we recommend that you do so only after you already have some experience with GNOME.

## Mouse Conventions Used in This Document

Before describing GNOME, let us introduce some terms used not only in this guide but in all GNOME documents. Most importantly, we need to clarify the use of mouse buttons and clicks.

Most GNOME documents assume that you are using a standard (for UNIX) 3-button mouse and talk about left, right, and middle mouse buttons; if a document says click without explicitly specifying the button, the left button is assumed.

If you are using a two-button mouse, you can emulate the middle mouse button by pressing left and right buttons simultaneously; if you have a wheel mouse, the wheel can be used in place of the middle mouse button.

You can switch the roles of the buttons using the Mouse preference tool in the Desktop Preferences submenu of Applications menu. Many left-handers choose to reverse the right and left buttons. If you have done so, you need to use the right mouse button whenever a document instructs you to click, and use the left mouse button whenever a document talks about right-clicking or mouse button 3.

If you use a mouse with an unusual placement of buttons, a trackball, or some other input device, you need to find out which buttons correspond to right, left and middle; this information can usually be found in the manual which came with your device. Usually, the left button (MB1) is the one under your index finger.

## First Glance at GNOME: Desktop and Panel

shows an example of GNOME running. GNOME is very configurable, so your screen may look quite different.

### Sample GNOME Display.

Figure of GNOME desktop, with menu panel, usual panel, Nautilus window, and standard desktop icons: home folder, Start here and Trash

### Panel

The two long bars at the top and bottom of are panels. The top one is called the menu panel, the bottom one is an edge panel (you can have more than one edge panel). Panels can contain a number of useful objects, such as

Applications and Actions menus

  Applications menu gives you access to all GNOME applications installed on your system. Actions menu contains useful commands such as Search for files, Run command, Open recent (documents), and Log Out command. In the screenshot above, you can see both these menus on left side of the top panel.

Other menus

  Panels can also contain other menus. Most important of them is the Main Menu (sometimes also called GNOME Menu) which combines Applications and Actions menu. The panel can also contain other menus created by the user.

Launchers

  These are buttons that start various programs.

Applets

  These are tiny programs designed to work inside the panel. For example, the clock applet in the middle of the top panel shows the current time, and the Window List applet in the left side of the bottom panel shows the list of all application windows on your desktop (this will be discussed in detail in ).

As with all GNOME components, panels are highly configurable: you can add or remove application launchers and applets, edit the Applications menu, change the panel background, or even remove and create new panels. This will be discussed in .

#### NOTE

The top panel in is called the menu panel and has slightly different properties than other panels. For example, you can not move it to a different location.

To configure an object, get help on it, or remove it from the panel, right-click on it and choose the appropriate item from the context menu. To hide the panel when you are not using it, click on one of the Hide buttons. They are the small arrows at the ends of the panel.

More panel operations are available from the Panel menu, which you can open by right-clicking in any vacant space on the panel (for example, in the hide arrows). To learn more about using panel, choose Help from the Panel menu.

### Desktop

Everything outside the panel is called the desktop background. You can place icons for files, applications, and other items on the desktop background (a default collection of icons is installed with GNOME). You can then double-click on an item to use it:

- If the item is a program, that program will start.

- If it is a data file, the appropriate program will start up with that data loaded.

- If it is a folder, the File Manager will start and show the contents of that directory.

The easiest way to place an item on the desktop is to drag a file from a file manager window, as described in detail in the Nautilus manual. Once the item is placed on the desktop, you can move it around the desktop using the left mouse button, or you can click on it with the right mouse button to bring up the context menu which allows you to delete the item or change its properties.

By default, your desktop contains the following objects:

Home folder

  This icon provides access to your home folder.

Start Here

  This object provides access to special functions of GNOME file manager, Nautilus. These special functions include menu editing (see ), desktop preference tools (see ), and access to machines on your local local network (if you have any).

Trash can

  Double-clicking on the trash can icon shows all files you have removed using the file manager. This gives you an opportunity to restore a file which was removed by mistake. You can also empty the trash can which permanently and irrevocably deletes all these files.

### Using the Mouse

As you have already seen, you can do almost anything just by clicking with your mouse. Here are some conventions which work almost anywhere in GNOME:

- Clicking on an item with the left mouse button selects (hilights) it. If you need to select several objects, hold down the Ctrl key while clicking.

- Double-clicking on an item runs the default action for this item (running an application, opening the file, etc.)

- Clicking on an item with the right mouse button brings up the context menu, which contains all the commands and information available for this item. If you have selected a group of items, right-clicking on any of them will bring up the context menu which applies to all of these items.

- You can select text anywhere on the screen using the left mouse button, and then insert this text into any other place on the screen which accepts text input, by clicking with the middle mouse button.

In addition, right-clicking on any vacant place on your desktop background brings up the Desktop Background menu, which allows you to change the desktop background image or other properties, or add a new object to the desktop.

### Logging Out

To log out of GNOME, click on the Actions menu and choose Log Out. GNOME will automatically save the current session (that is, information about currently open applications and their location on the screen), so that when you log in next time, the same applications will be in the same places. Note this only works for applications which are fully GNOME-compliant.

## Working With Windows

As most modern desktop environments, GNOME allows you to have several windows on your screen, with a different application running in each window. This section describes various windows operations: moving, resizing, closing, hiding.

Many of these operation are controlled by buttons located in the window titlebar. Descriptions in this section assume that you are using the default configuration of GNOME, so the buttons in the window titlebar look as shown in .

### Window Titlebar Using Default Theme

Titlebar in default style, focused. Window ops button in the left side, minimize, maximize, and close buttons on the right.

### Note for advanced users

All the windows operations are actually managed by a piece of software called window manager. By default, GNOME uses Metacity window manager, which is included with GNOME. GNOME can also be used with other window managers, such as Sawfish (which was used in GNOME 1.4). To switch to Sawfish window manager, open a terminal window and enter the following command: `killall metacity; sawfish&`. If everything worked smoothly, save current session by entering the command `gnome-session-save` so that next time you login, Sawfish is started automatically.

So, what can you do with windows?

Closing, Minimizing, and Maximizing Windows

  To close a window, click on the Close Window button (with the small x) in the right side of window titlebar. If the application has any unsaved data, it will prompt you to save it. You can also use keyboard shortcut AltF4.

  To maximize a window, i.e. make it fill the entire screen (except for the part taken by the panels), click on the Maximize button (middle button on the right side). Clicking on this button once again will restore the window to its original size.

  To minimize (sometimes also called hide or iconify) a window, click on the Minimize button. The window will disappear from the screen. However, it is not lost: the application in this window continues running, no data is lost — it is just temporarily hidden. All minimized windows are shown in the Window List applet and can be restored as described below.

  A convenient alternative to minimizing windows is to shade it, or roll up a window into its own titlebar, so the titlebar is the only part of the window left on the screen. You can roll up and unroll a window by double-clicking on the titlebar.

Raising and Lowering Windows

  Windows on your screen can overlap, so that one of the windows is on top of another. You can raise a window (i.e., put it on top of all others) by clicking anywhere in that window.

Focus

  Of all the windows on your screen, only one is active (in computer parlance, focused), which means that anything you type on the keyboard will be sent to the application running in that window. (It does not mean that the applications in other windows are idle — they can be running as well.) To help you see which window has focus, the titlebar of this window has a different color (the left side is blue, as opposed to gray for all other windows). By default, clicking in a window both raises it and gives focus to it.

  You can also use the Alt Tab shortcut to switch between windows. This cyclically switches between all existing windows. The window to which you switch is raised and given focus.

Moving and Resizing Windows

  To move a window, drag its titlebar to a new location using the left mouse button. You can also move a window by clicking anywhere inside the window while holding down the Alt key.

  To resize a window, place the mouse cursor on any of the window borders or corners. The mouse cursor will change to an arrow pushing a line or corner, allowing you to drag the border or corner to a new position.

### Window List Applet

All the windows on your desktop (including the minimized ones) are shown in the Window List applet, located on your panel. For each window, a mini-icon and the beginning of the window title is shown. To restore a minimized window, just click on its title in the Window List applet. Right-clicking on the window title brings up the context menu which allows you to shade a window, close it, etc.

### Window Menu

GNOME also provides a menu for each window; this menu contains all the operations for this window described above, and then some. To access this menu, click on the Window Menu button at the left side of the window titlebar, or use keyboard shortcut AltSpace.

## Nautilus: GNOME File Manager

GNOME includes a graphical shell, Nautilus. It combines a file manager, a web browser, an FTP client, and much more. It also provides access to tools for customizing GNOME (thus replacing the GNOME Control Center which was included in GNOME 1.4 and earlier releases).

To open a new Nautilus window, choose Home folder from the Applications menu, or double-click on any folder icon on your desktop, such as the Home icon.

### Managing Your Files With Nautilus

#### Nautilus Window

Nautilus Window, in icon mode

As most modern graphic file managers, Nautilus shows the contents of a selected folder using icons to represent files and subfolders. Double-clicking on any file or folder opens it (for data files, it starts the appropriate application which opens this file, as configured in the File Types and Programs preference tool). Right-clicking on a file or folder produces a context menu. Using this menu, you can delete or rename the file, view and change file properties or permissions, and more.

Nautilus also provides an easy way to move and copy files between folders. To move a file from one folder to another, open these folders in separate Nautilus windows (you can use the File New window command). Select the file you want to move, and drag it from one window into another using the mouse. You can also drag a file or folder to the desktop. To copy a file, press-and-hold the Ctrl key while dragging the file. You can also copy and move files using keyboard shortcuts CtrlC, CtrlX, and CtrlV (see Nautilus manual for details).

To delete files, drag them to the trash can icon on your desktop.

Nautilus provides many more tools to manipulate your files. It is also highly customizable, so you can easily change the way files are displayed (for example, you can choose a custom icon for a given file). For a detailed description of all these possibilities, read the Nautilus manual, available from the Help menu of Nautilus.

### Accessing Floppies and Other Removable Media

To access files on floppy disks, CD-ROMs and other removable media, insert the disk in drive. Depending on configuration of your sytem, it may automatically recognize an inserted disk and put an icon for it on the desktop (in technical language, this is called automounting). Otherwise, right-click on any vacant spot on the desktop and choose the required media from the Disks submenu of the Desktop Background menu. (This assumes your system is correctly configured, that is, you have the appropriate entry in `/etc/fstab` file.) This will place an icon for the disk on the desktop. Double-clicking on this icon will open a Nautilus window showing the contents of the selected media.

#### WARNING

Before removing a floppy disk or other removable media from the drive, you must

1. Close all windows accessing files on this disk, including Nautilus windows, terminal windows, and others

2. Unmount the disk by right-clicking on the disk icon on the desktop and choosing Unmount volume from the context menu.

If you remove the disk without unmounting it first, you may lose data!

### Other Features of Nautilus

In addition to the basic features listed above, Nautilus has many other advanced and exciting capabilities. Here we list some of them, referring the reader to the Nautilus manual for detailed descriptions.

- Nautilus can be customized in many ways. In particular, you can change the background and icons used for files and folders, and the fonts used for captions.

- You can assign a custom icon to a specific file, or rescale the icon for a specific file, so that the most important files really stand out.

- You can assign an emblem (such as New or Favorite) to a file. This emblem will be put on top of the file icon.

- Files can be sorted by name, type, modification date, or the emblem you assigned to them.

- Nautilus can also be used as a Web browser (with limited capabilities) and FTP client: just enter the URL (for example, ftp://ftp.gnome.org) in the Go To field.

- Nautilus can also be used as a music player: just open a folder containing music files in MP3 format, and Nautilus switches to music player mode.

## Customizing GNOME

GNOME is highly configurable — you can change almost anything: background color, key bindings, location of panels, contents of the GNOME Menu, and more. To see examples of different customizations of the GNOME desktop, take a look at the screenshots in GNOME users gallery and notice how different they look.

The following sections list some of the most common customizations. In addition, you can change properties of various items — most notably, panels and icons on your desktop — by clicking on them with the right mouse button and choosing Properties from the context menu.

Almost every GNOME application has its own preferences settings (look for Preferences or Settings in the menus), so you can change, for example, colors used by the GNOME Terminal or make it transparent — the possibilities are unlimited!

### Desktop Preferences

To customize the appearance of your desktop and user interface, use special desktop preference tools, which can be found in the Desktop Preferences submenu of the Applications menu. You can also access the preferences tools by double-clicking on the Start Here icon on your desktop. This will open a Nautilus window. Double-click on Preferences and then on the tool you require.

Below you will find an overview of the most commonly used preferences tools.

Background

  This tool allows you to change desktop background. You can select solid color, gradient (visual effect where one color blends gradually into another color), or an image file.

  #### TIP

  You can also change the desktop background color by right-clicking on the desktop background and choosing Change Desktop Background, or by dragging a color from another window or dialog to the desktop background.

Theme

  This tool allows you to change the desktop theme. A theme is a collection of settings that determine the look of your desktop and all GNOME applications. It consists of the following components:

  Controls

    This component (sometimes also called widget theme) determines the appearance of menus, panels, toolbars, buttons, and other elements of user interface in all GNOME applications.

  Window borders

    This component determines the appearance of window borders, titlebar, and buttons placed in the titlebar.

  Icon theme

    This component determines the set of icons used by GNOME file manager and other applications for files of various types. These icons are also used on the desktop, for files you place there and for standard objects such as home directory or Start Here location.

  #### NOTE

  Users upgrading from GNOME 2.0 will notice that the layout of this tool and terminology has changed: GNOME 2.2 uses the word theme to refer to the complete collection of appearance settings, so a theme now consists of several components. In GNOME 2.0, this was called a metatheme.

  The theme tool allows you to select one of the themes installed as part of your GNOME distribution. You can also create a custom theme by selecting individual theme components (Icon, Window border). To do so, click on Details button. Finally, you can download and install more themes from the Internet. In particular, you can find many themes at the GNOME theme website. Please note that this site (as well as many other Interent resources) use more technical (and more precise) terminology: the Controls component is called a GTK2 theme, and Window borders component is called a Metacity theme.

Font

  This tool allows you to choose the default font which will be used by menus, dialogs, and other user interface elements. You can also choose fonts to be used for icon captions on the desktop and for windows titlebars.

### Customizing Panels

You can customize the GNOME panels as follows:

- To remove a panel, right-click on a vacant space on the panel and choose Remove this panel from the panel context menu.

- To create a new panel, right-click on a vacant space on any existing panel and choose Create panel from the panel context menu.

- To move an existing panel to a new location, drag it with the middle mouse button.

  #### NOTE

  The menu panel can not be moved.

- To modify a panel's properties (background, size, auto-hide), right-click on a vacant space on the panel and choose Properties from the panel context menu.

- To remove an object (menu, applet, or application launcher) from the panel, right-click on the object and choose Remove from panel from the object context menu.

- To add a new object to the panel, right-click on a vacant space on the panel and choose Add to panel from the panel context menu. Alternatively, to add an application from one of the menus as a launcher to the panel, right-click on the menu item and choose Add this launcher to panel from the context menu.

- To move a panel object, drag it with the middle mouse button. You can even drag an object from one panel to another.

- To configure a panel object, right-click on it and choose Properties from the context menu.

### Customizing Menus

To modify the appearance of menus, use Theme and Font preference tools described in . You can also customize the contents of the Applications menu. To do this, open Start Here object on the desktop and double-click on Applications icon. This will show the contents of the Applications menu as if it were a folder. Now you can move, add, and delete items in this menu in the same way you move or delete files. For more information, see Working With Menus chapter of GNOME User Guide.

## GNOME Applications and Utilities

GNOME comes with many applications and utilities; in addition, GNOME allows you to use any third party applications such as Netscape, KDE applications, or other applications and utilities installed on your system. You can also use GNOME 1.x applications under GNOME 2.2 (if you have installed appropriate GNOME 1.x libraries). Note, however, that GNOME 1.x applications will not use font and theme settings of GNOME 2.2, so their appearance will differ from that of GNOME 2.2 applications.

Below is a partial list of some of the most useful tools and applications found in the Applications and Actions menus. You can access these menus by clicking on the corresponding button in the Menu Panel, or by using keyboards shortcut AltF1.

### Actions Menu

This menu contains the following utilities.

Run Program

  This allows you to manually enter a command to run, saving you from starting full-blown terminal emulator.

  #### TIP

  You can also start the Run Program dialog by using the AltF2 shortcut.

Search for Files

  This utility allows you to search for files and folders on your system.

Screenshot

  This utility takes a screenshot of your desktop and saves it in a file.

Open Recent

  This utility shows the list of files you have recently accessed. You can choose one of these files to open it using the appropriate application.

Lock Screen

  This utility locks the screen, starting a screensaver. In order to unlock the screen and continue the work, you will need to enter your password. This is useful when you need to leave the computer running unattended for some time.

Log Out

  This finishes your GNOME session, stopping all running applications and returning you to login screen.

### Core GNOME Applications

Applications menu contains all GNOME applications installed on your system. In addition, it also shows many non-GNOME applications which are installed on your system. Here we list those GNOME applications which form part of GNOME Desktop environment. These applications are included in the standard GNOME distributions and must be available on any system running GNOME.

Accessories

  These include productivity applications such as:

  - Calculator

  - Character Map, which allows you to select any symbol in virtually any human alphabet (provided that you have fonts to show these symbols). This is a quick way to insert in text you are typing a symbol that can not be directly entered from the keyboard.

  - File Roller, a utility for viewing, unpacking and creating compressed archive files.

  - Text Editor (gedit), a lightweight text editor capable of handling multilanguage texts.

  - Dictionary, allowing you to look up a word in one of the many freely available dictionaries on the Internet.

Desktop Preferences

  This submenu contains preferences tools used to customize your desktop; see for details.

Games

  Lots of them — just try!

Graphics

  - Eye of GNOME image viewer

  - Ggv Postscript Viewer, which can also be used for viewing PDF files.

Programming

  Bug Report tool. Use this tool to make suggestions and report bugs in GNOME applications.

Sound & Video

  Here you will find a CD player, Volume Control, and Sound Recorder.

System Tools

  This submenu contains various tools used for managing your system, such as:

  - System Monitor. This application can be used to view all processes (tasks) currently running on your system and the resources (memory and processor time) they use. You can also use the System Monitor to kill a stalled or otherwise misbehaving application.

  - Configuration Editor. This tool is only recommended for advanced users. It allows you to change all settings used by GNOME applications (unlike preferences tools which only cover some of the settings). However, it provides little assistance or safeguards; it can easily make your system completely unusable if you do not know what you are doing.

  - Floppy Formatter, a tool for formatting floppy disks.

  - Terminal, which gives you access to the most powerful (but not the most user friendly) interface ever created — the command line prompt.

  This submenu may also contain tools for managing software installed on your system, such as Red Carpet (if you are using the distribution of GNOME prepared by Ximian, Inc.). Red Carpet provides an extremely easy, almost one-click, way to update your GNOME installation. This requires that you have system administrator (root) privileges.

Help

  This starts the GNOME help browser, Yelp, described in .

Home Folder

  This opens a new Nautilus window showing the contents of your home folder.

### Other Applications

In addition to the core applications listed above, there is also a variety of GNOME applications that can be installed separately. Most likely, you will find many of them already installed on your system and shown in the Applications menu. Here we list the most important of them. A full list of software available for GNOME with links to individual projects' web pages and download locations can be found in GNOME Software Map.

Internet

  - Galeon, a fast web browser based on Mozilla

  - Evolution, an email client, calendar and contact manager.

  - X-Chat, an Internet Relay Chat (IRC) client.

  - GNOME-ICU for talking with other people using ICQ protocol.

  - gftp, a graphical tool for file transfers, supporting FTP, HTTP, and SSH protocols. Note that the GNOME file manager, Nautilus, also has built-in FTP capabilities.

Graphics

  - The GIMP, professional grade image editing program.

  - gThumb, a program for viewing and organizing collections of images (for examples, digital camera photos).

Sound & Video

  - XMMS, player for audio CDs and aduio files in MP3 and Ogg Vorbis formats.

  - Rhythmbox, an audio player for MP3 and Ogg Vorbis files. It also has powerful capabilities for organizing large music collections, creating and editing playlists, searching for songs by artist, name, or other parameters, and more.

  - Totem video player, based on Xine project. It can hanlde most of video formats and codecs available. It can also be used for viewing Video CDs and DVDs. Viewing DVDs requires special decryption software, whose legal status is unclear in the US. For this reason, this software is usually not installed by default but can be downloaded separately if it is legal in your locality.

Office

  - Gnumeric, a full-featured Excel-compatible sreadsheet.

  - AbiWord, a fast and light word processor.

## Help — I Am in Trouble!

Everyone runs into trouble sooner or later. Here is some advice on how to handle the most common problems:

### Killing a Stalled Application

If an application is stalled or frozen — that is, if it does not respond to your mouse clicks and keyboard commands, you can either wait and hope that it wakes up, or kill it. If you decide to kill it (NOTE: You will lose all unsaved data), start the System Monitor (from Applications System Tools ). Select the application you want to kill and click on End process button at the bottom. You can also right-click on the application name and choose End process; if it doesn't help, right-click and choose Kill process. Using the GNOME System monitor also allows you to find and kill all helper processes started by this application.

If a GNOME application freezes or crashes (unexpectedly dies) repeatedly, you should file a bug report as described in the GNOME feedback page.

### My Whole System Froze!

If your whole system is frozen and is not responding, do not hurry to push the power button on the computer — this is usually the worst solution. Most probably, it is not the operating system itself that is frozen (UNIX systems are known for stability), but just the graphical part, the X Window System. In this case, you can try to restart the X Window System by simultaneously pressing CtrlAltBackspace . This should work for the implementation of the X Window system used on Linux and *BSD, XFree86 (unless it was disabled by your system administrator). Of course, in this way you also lose all unsaved data, but at least you do not risk harming the whole file system.

## Where to Find More Information

### GNOME Help System

GNOME includes detailed documentation for the majority of applications, utilities and other components, such as the panel or the Nautilus file manager. To view a manual for an application, choose the Help menu in the application, or press F1. To view help about the panel or panel objects, right-click on it and choose Help from the context menu. This will automatically launch the GNOME help browser, Yelp, showing the appropriate manual.

You can also start Yelp by choosing Applications Help . This will show the top-level help system page, listing all GNOME documents conveniently organized by topic.

In addition to the manuals for individual applications, GNOME documentation also includes:

GNOME Desktop 2.2 User Guide

  This user guide provides a general overview of GNOME and detailed documentation for core GNOME components (such as the desktop, panel, Nautilus, and desktop preferences tools).

Introduction to GNOME

  This is the document you are reading.

GNOME 2.2 System Administrator Guide

  This guide provides in-depth discussion of GNOME internals. In particular, it explains where GNOME stores various configuration settings (both per-user and system-wide). It also contains instructions on setting system-wide GNOME preferences. It is mostly intended for system administrators; however, advanced users may also find it useful.

Yelp can also be used for viewing non-GNOME documentation, such as man pages and info pages (see below).

### GNOME Resources on the Internet

In addition to documentation shipped with GNOME, there is also a wealth of information available on the Internet. A good starting point is the GNOME website. There you will find instructions for installing GNOME, reviews and tips, developer information, and more.

If you can not find an answer to your question there, you may ask other GNOME users in one of the forums on GNOME User's Board. Before asking a question, please make sure that it has not been answered in avaialble documents such as GNOME User Guide.

Finally, if you use IRC (Internet Relay Chat), you can find other GNOME users and developers and ask questions on the #gnome and #gnome-help channels on irc.gnome.org.

### Everything Not GNOME

You should realize that GNOME is just part of your computer system. If you want to unleash the full potential of your computer, you need to understand not just GNOME but also the underlying operating system (UNIX/Linux/FreeBSD), various tools and utilities included with it, and its graphics system (the X Window System). Each of these components usually comes with its own documentation. Most of UNIX commands and utilities are documented in so-called manual pages, or man pages for short. You can view them using the Yelp help browser (see ). This documentation is usually very detailed and more technical than most users would like. Another documentation format used by utilities from the GNU project is called info pages. They, too, can be viewed using Yelp. Many applications also have documentation in other formats. Sometimes it is not easy to find documentation for a given application — try looking in the directories `/usr/share/doc` and `/usr/doc`.

Documentation for the operating system itself varies from one system to another. The best advice is to check the printed manual which came with your system. For Linux, a good source of information is the Linux Documentation Project (LDP); you can read their documentation on the Internet at http://www.tldp.org. Virtually all Linux distributions also include copies of LDP documents; usually they are found at `/usr/share/doc/LDP` or `/usr/share/doc/HOWTO`.

And of course, there are a number of books available about all flavors of UNIX/Linux, GNOME, and about anything else you might be interested in. Check your local bookstore.

### Feedback

If you have found a bug in one of the GNOME applications, or have some comments or suggestions regarding GNOME applications or documentation, please let us know! Instructions for submitting bug reports and comments are given in the GNOME Feedback Page.