summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAlexander Kirillov <sasha@src.gnome.org>2002-08-06 11:06:36 +0000
committerAlexander Kirillov <sasha@src.gnome.org>2002-08-06 11:06:36 +0000
commit66afe65576d0ff21ee9aa45777574268cbec96c8 (patch)
treecd4669cba55de1ec1ce59caa740da3731dea02da
parentdc08633be4cd496a0e70e3dd5fa129b4083c3a96 (diff)
downloadgnome-user-docs-66afe65576d0ff21ee9aa45777574268cbec96c8.tar.gz
gnome-user-docs-66afe65576d0ff21ee9aa45777574268cbec96c8.tar.xz
gnome-user-docs-66afe65576d0ff21ee9aa45777574268cbec96c8.zip
introduction-to-gnome/C/introduction-to-gnome.xml: commited style
and grammar corrections by Steph Donovan <sdonovan@achilles.net>
-rw-r--r--ChangeLog6
-rw-r--r--introduction-to-gnome/C/introduction-to-gnome.xml375
2 files changed, 199 insertions, 182 deletions
diff --git a/ChangeLog b/ChangeLog
index 78375e6..e09f24f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2002-08-06 Alexander Kirillov <kirillov@math.sunysb.edu>
+
+ * introduction-to-gnome/C/introduction-to-gnome.xml: committed
+ style and grammar corrections by Steph Donovan
+ <sdonovan@achilles.net>
+
2002-07-19 Chris Lyttle <chris@wilddev.net>
* *.omf: reverted files to previous version now that SK support works
diff --git a/introduction-to-gnome/C/introduction-to-gnome.xml b/introduction-to-gnome/C/introduction-to-gnome.xml
index 8e32006..2e246bf 100644
--- a/introduction-to-gnome/C/introduction-to-gnome.xml
+++ b/introduction-to-gnome/C/introduction-to-gnome.xml
@@ -123,7 +123,7 @@
<para> 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 <ulink
+ the Internet; they are distributed under the terms of the <ulink
type="help" url="ghelp:gpl"> GNU General Public
License</ulink> (and its cousins, <ulink type="help"
url="ghelp:lgpl">Lesser General Public License</ulink> and
@@ -150,7 +150,7 @@
url="http://www.gnu.org" type="http">GNU website</ulink>.
</para>
<para>
- This guide describes GNOME 2.0 which the latest (as of June
+ This guide describes GNOME 2.0 which is the latest (as of June
2002) release of GNOME.
</para>
</sect1>
@@ -161,18 +161,18 @@
<para>
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 detailed manuals listed in <xref
+ information, you should read the detailed manuals listed in <xref
linkend="otherinfo"/>. Also, this document assumes you already have
GNOME installed; if you need help installing GNOME, please check
- the instructions on <ulink url="http://www.gnome.org"
+ the instructions on the <ulink url="http://www.gnome.org"
type="http">GNOME website</ulink>.
</para>
- <para> This document was written by the members of GNOME
+ <para> 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 <email>docs@gnome.org</email>, or visit <ulink
+ send an e-mail to <email>docs@gnome.org</email>, or visit the <ulink
url="http://developer.gnome.org/projects/gdp/" type="http">GDP
website</ulink>.
</para>
@@ -210,23 +210,23 @@
middle mouse button.
</para>
<para>
- You can switch the roles of the buttons using <application>Mouse
- preference tool</application> in <guisubmenu>Desktop
+ You can switch the roles of the buttons using the <application>Mouse
+ preference tool</application> in the <guisubmenu>Desktop
Preferences</guisubmenu> submenu of
<guimenu>Applications</guimenu> 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 document
- instructs you to click, and use <emphasis>left</emphasis> mouse
+ so, you need to use the right mouse button whenever a document
+ instructs you to click, and use the <emphasis>left</emphasis> mouse
button whenever a document talks about
<quote>right-clicking</quote> or mouse button 3.
</para>
<para>
- If you use a mouse with some unusual placement of buttons, a
+ 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 <quote>right</quote>,
<quote>left</quote> and <quote>middle</quote>; this information
can usually be found in the manual which came with your
- device. Usually, <quote>left</quote> button (MB1) is the one
+ device. Usually, the <quote>left</quote> button (MB1) is the one
under your index finger.
</para>
@@ -288,9 +288,9 @@
<para>
Panels can also contain other menus, either submenus of
the <guimenu>GNOME Menu</guimenu> or menus created by
- user. In the example above, the top panel contains
+ the user. In the example above, the top panel contains
<guimenu>Applications</guimenu> and
- <guimenu>Actions</guimenu> menus. Both of them are
+ <guimenu>Actions</guimenu> menus. Both are
actually submenus of the <guimenu>GNOME Menu</guimenu>.
</para>
</listitem>
@@ -300,7 +300,7 @@
<varlistentry>
<term>Application launchers</term>
<listitem>
- <para>These are buttons that start various programs.
+ <para>These buttons start various programs.
</para>
</listitem>
</varlistentry>
@@ -308,10 +308,10 @@
<varlistentry>
<term>Panel applets</term>
<listitem>
- <para>These are are tiny programs designed to
+ <para>These are tiny programs designed to
work inside the panel. For example, the
<application>clock</application> applet on the far right
- of the top panel shows the current time, and
+ of the top panel shows the current time, and the
<application>Window List</application> applet (in the
left side of the bottom panel) shows the list of all application
windows on your desktop (this will be discussed in
@@ -325,15 +325,15 @@
<para> As with all GNOME components, panels are highly
configurable: you can add or remove application launchers and
- applets, edit the <guimenu>GNOME Menu</guimenu>, change panel
+ applets, edit the <guimenu>GNOME Menu</guimenu>, change the panel
background, or even remove and create new panels. This will be
discussed in <xref linkend="customizing-panel"/>.
</para>
<note>
<title>NOTE</title>
<para>
- The top panel in <xref linkend="desktop-fig"/> is called
- <emphasis>menu</emphasis> panel and is slightly different
+ The top panel in <xref linkend="desktop-fig"/> is called the
+ <emphasis>menu</emphasis> panel and has slightly different
properties than other panels. For example, you can not move
it to a different location.
</para>
@@ -343,7 +343,7 @@
from the panel, right-click on it and select the appropriate
item from the popup menu. To hide the panel when you are not
using it, click on one of the <guibutton>Hide
- buttons</guibutton> (with small arrows) at the ends of the
+ buttons</guibutton>. They are the small arrows at the ends of the
panel.
</para>
<para>More panel operations are available from the
@@ -351,7 +351,7 @@
right-clicking in any vacant space on the panel (for example,
in the hide arrows) and selecting
<guisubmenu>Panel</guisubmenu> from the menu. The
- <guimenu>Panel</guimenu> menu also contains <ulink type="help"
+ <guimenu>Panel</guimenu> menu also contains the <ulink type="help"
url="ghelp:panel">Panel manual</ulink>, which describes
all these options in detail. </para>
</sect2>
@@ -359,10 +359,10 @@
<sect2 id="desktop">
<title>Desktop</title>
<para>
- Everything outside the panel is called
+ Everything outside the panel is called the
<quote>desktop</quote>. You can place icons for files, applications,
and other items on the desktop (a default collection of icons is
- installed with GNOME), after which you can double-click on an item
+ installed with GNOME). You can then double-click on an item
to use it:
</para>
<itemizedlist mark="bullet">
@@ -380,13 +380,13 @@
<listitem>
<para>
- If it is a folder (directory), <application>File
+ If it is a folder (directory), the <application>File
Manager</application> will start and show the contents of
- that directory. Your desktop will probably have a icon
- showing a house and labeled
+ that directory. Your desktop will probably have an icon
+ showing a house and labeled as
<guilabel><replaceable>yourname</replaceable>'s
Home</guilabel>. Double-clicking on this icon will start
- the <application>File Manager</application> at your home
+ the <application>File Manager</application> in your home
directory.
</para>
</listitem>
@@ -416,7 +416,7 @@
<listitem><para>
Clicking on an item with the left mouse button selects
(hilights) it. If you need to select several objects, hold down
- <keycap>Ctrl</keycap> key while clicking.
+ the <keycap>Ctrl</keycap> key while clicking.
</para></listitem>
<listitem><para>
Double-clicking on an item runs the default action for
@@ -440,7 +440,7 @@
<para>
In addition, right-clicking on any vacant
place on your desktop brings up the <guimenu>Desktop
- Background</guimenu> menu, which allows you to change desktop
+ Background</guimenu> menu, which allows you to change the desktop
background or other properties, or add a new object to the
desktop. Clicking on the desktop with the middle mouse button
produces the <guimenu>Root</guimenu> menu, provided by the
@@ -468,27 +468,28 @@
<sect1 id="windows">
<title>Working With Windows</title>
<para>
- The graphical system used by all UNIX-like operating systems, X
- Window System, allows you to have several windows on your
+ The X
+ Window System, a graphical system used by all UNIX-like
+ operating systems, allows you to have several windows on your
screen, with a different application running in each window. By
- itself, however, X Window System can only do very low-level
+ itself, however, the X Window System can only do very low-level
operations, so it is always used in combination with another
- piece of software, called <emphasis>window manager</emphasis>. A
- window manager provides windows' frames, titlebar, and buttons,
- allows you to move, close, and resize windows, etc. GNOME can
+ piece of software, called a <emphasis>window manager</emphasis>. A
+ window manager provides windows' frames, titlebar, and buttons.
+ It also allows you to move, close, and resize windows. GNOME can
work with many window managers. The most popular are <ulink
type="http" url="http://sawmill.sourceforge.net">
<application>Sawfish</application></ulink> (included as part of
- GNOME distribution) and <ulink type="http"
+ the GNOME distribution) and <ulink type="http"
url="http://www.gnome.org/softwaremap/projects/Metacity">
<application>Metacity</application></ulink>. Each window manager
- can use many different styles of window decorations and buttons
- (this is referred to as <quote>window manager
- theme</quote>). Since it is impossible to cover them all, in
+ can use many different styles of window decorations and buttons.
+ (This is referred to as the <quote>window manager
+ theme</quote>.) Since it is impossible to cover them all, in
this section we only describe the default window manager shipped
with GNOME, <application>Sawfish</application>, and its default
theme, <guilabel>Crux</guilabel>. An example of the window
- titlebar using <guilabel>Crux</guilabel> theme is shown in <xref
+ titlebar using the <guilabel>Crux</guilabel> theme is shown in <xref
linkend="cruxborder"/>
</para>
@@ -536,7 +537,7 @@
<para> To <emphasis>minimize</emphasis> (sometimes also
called hide or iconify) a window, click on the
<guibutton>Minimize</guibutton> button. The window will
- disappear from screen. However, it is not lost: the
+ disappear from the screen. However, it is not lost: the
application in this window continues running, no data is
lost &mdash; it is just temporarily hidden. All
minimized windows are shown in the <link
@@ -546,10 +547,10 @@
<para> A convenient alternative to minimizing windows is
<emphasis>shading</emphasis> them. When you shade a window, it
<quote>rolls up</quote> into its own titlebar, so the
- titlebar is the only part of the window left on
- screen. To shade a window, click on
+ titlebar is the only part of the window left on the
+ screen. To shade a window, click on the
<guibutton>Shade</guibutton> button; to unshade, click
- on this button again. You can also shade and unshade
+ on this button again. You can also shade and unshade a
window by double-clicking on the titlebar.
</para>
</listitem>
@@ -565,7 +566,7 @@
all others) by clicking on the window titlebar. You can
also switch a window from raised to lowered and back by
right-clicking in the titlebar, or by right-clicking
- anywhere inside the window while holding down
+ anywhere inside the window while holding down the
<keycap>Alt</keycap> key.
</para>
</listitem>
@@ -581,15 +582,15 @@
application running in that window. (It does not mean that the
applications in other windows are idle &mdash; they can
be running as well.) To help you see which window has
- focus, the titlebar of this window has different color
- (left side is blue, as opposed to gray for all other
- windows). To change focus to another window, just click
+ focus, the titlebar of this window has a different color
+ (the left side is blue, as opposed to gray for all other
+ windows). To change the focus to another window, just click
anywhere in that window. You can also click in the
window titlebar to focus and raise the window
simultaneously.
</para>
<para>
- You can also use <keycombo><keycap>Alt</keycap>
+ You can also use the <keycombo><keycap>Alt</keycap>
<keycap>Tab</keycap> </keycombo> shortcut to switch
between windows. This cyclically switches all existing
windows. The window to which you switch is raised and
@@ -603,7 +604,7 @@
</term>
<listitem>
<para> To move a window, drag its titlebar to a new
- location using left mouse button (i.e., click in the
+ location using the left mouse button (i.e., click in the
title bar and move the mouse without releasing the
button). You can also move a window by clicking anywhere
inside the window while holding down the
@@ -627,7 +628,7 @@
All the windows on your desktop (including the minimized ones)
are shown in the <application>Window List</application>
applet, located on your panel. For each window, a mini-icon
- and beginning of the window title is shown. To restore a
+ and the beginning of the window title is shown. To restore a
minimized window, just click on its title in the
<application>Window List</application>
applet. Right-clicking on the window title brings up the
@@ -656,7 +657,7 @@
<sect2 id="wm-desktop-menu">
<title>Root Menu</title>
<para>
- Finally, <application>Sawfish</application> also provides
+ Finally, <application>Sawfish</application> also provides a
so-called <guimenu>Root</guimenu> menu. It can be accessed by
clicking on any empty space of the desktop with the <link
linkend="conventions">middle mouse button</link>. It contains
@@ -671,7 +672,7 @@
<para>
Provides list of all windows, including minimized
ones. Selecting one of these windows restores it (if it
- was minimized) and raises it over other windows. Very
+ was minimized), and raises it over other windows. Very
convenient if you have so many windows that the one you
need is completely covered by others.
</para>
@@ -683,7 +684,7 @@
</term>
<listitem>
<para>Allows you to switch from one workspace to another,
- create and delete workspaces. See <citetitle>GNOME Desktop
+ create and delete workspaces. See the <citetitle>GNOME Desktop
User Guide</citetitle> for details.
</para>
</listitem>
@@ -694,7 +695,7 @@
</term>
<listitem>
<para>
- Same as <guisubmenu>Applications</guisubmenu> submenu
+ Same as the <guisubmenu>Applications</guisubmenu> submenu
of the <guimenu>GNOME Menu</guimenu>.
</para>
</listitem>
@@ -717,13 +718,13 @@
</term>
<listitem>
<para>
- Provides links to <application>Sawfish</application>
- website, <application>Sawfish</application> manual
+ Provides links to the <application>Sawfish</application>
+ website, the <application>Sawfish</application> manual
(beware: this is not a user's manual but rather a manual
for people who write extensions/customizations to
- <application>Sawfish</application> using LISP
- programming language), link to <citetitle>GNOME User
- Guide</citetitle>, and to <ulink type="http"
+ <application>Sawfish</application> using the LISP
+ programming language), link to the <citetitle>GNOME User
+ Guide</citetitle>, and to the <ulink type="http"
url="http://www.gnome.org">GNOME website</ulink>.
</para>
</listitem>
@@ -738,18 +739,18 @@
<title>Nautilus: GNOME File Manager</title>
<para>
GNOME includes a <quote>graphical shell</quote>,
- <application>Nautilus</application>. It combines file manager,
- web browser, FTP client, and much more. It also provides access
- to tools for customizing GNOME (thus replacing
+ <application>Nautilus</application>. 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
<application>GNOME Control Center</application> which was
included in GNOME 1.4 and earlier releases).
</para>
<para>To open a new <application>Nautilus</application> window,
- choose <menuchoice><guimenu>Applications</guimenu>
+ choose the <menuchoice><guimenu>Applications</guimenu>
<guimenuitem>Home folder</guimenuitem></menuchoice> in the
<guimenu>GNOME Menu</guimenu>, or double-click on any folder
- icon on your desktop, such as <guiicon>Home</guiicon> icon.
+ icon on your desktop, such as the <guiicon>Home</guiicon> icon.
</para>
<sect2 id="nautilus-fm">
@@ -777,7 +778,7 @@
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 <application>File Types and
+ opens this file, as configured in the <application>File Types and
Programs </application> preference tool). Right-clicking on a
file or folder produces a popup menu. Using this menu, you
can delete or rename the file, view and change file properties
@@ -787,13 +788,13 @@
<para> <application>Nautilus</application> 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
- <application>Nautilus</application> windows (you can use
+ <application>Nautilus</application> windows (you can use the
<menuchoice><guimenu>File</guimenu><guimenuitem>New
window</guimenuitem></menuchoice> 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 file, press-and-hold <keycap>Ctrl</keycap>
- while dragging the file.
+ desktop. To copy a file, press-and-hold the <keycap>Ctrl</keycap>
+ key while dragging the file.
</para>
<para>
To delete files, drag them to the trash can icon on your
@@ -803,9 +804,9 @@
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 detailed description of all these
- possibilities, read <citetitle>Nautilus manual</citetitle>,
- available from <guimenu>Help</guimenu> menu of
+ given file). For a detailed description of all these
+ possibilities, read the <citetitle>Nautilus manual</citetitle>,
+ available from the <guimenu>Help</guimenu> menu of
<application>Nautilus</application>.
</para>
</sect2>
@@ -818,10 +819,10 @@
media, right-click on any vacant spot on the desktop and
choose the required media from the
<guisubmenu>Disks</guisubmenu> submenu of the
- <guimenu>Desktop Background</guimenu> menu (assuming that your
+ <guimenu>Desktop Background</guimenu> menu. (This assumes your
system is correctly configured, that is, you have the
appropriate entry in <filename>/etc/fstab</filename>
- file). This will open a <application>Nautilus</application>
+ file.) This will open a <application>Nautilus</application>
window showing the contents of the selected media.
</para>
<warning>
@@ -856,18 +857,18 @@
In addition to the basic features listed above,
<application>Nautilus</application> has many other advanced
and exciting capabilities. Here we list some of them,
- referring the reader to <citetitle>>Nautilus
+ referring the reader to the <citetitle>>Nautilus
manual</citetitle> for detailed descriptions.
</para>
<itemizedlist>
<listitem>
<para><application>Nautilus</application> can be customized
- in many ways. In particular, you can change background and
- icons used for files and folders and font used for captions.
+ in many ways. In particular, you can change the background and
+ icons used for files and folders, and the fonts used for captions.
</para>
</listitem>
<listitem>
- <para>You can assign custom icon to a specific file, or
+ <para>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.
</para>
@@ -885,7 +886,7 @@
</listitem>
<listitem>
<para><application>Nautilus</application> can also be used
- as Web browser (with limited capabilities) and FTP client:
+ as a Web browser (with limited capabilities) and FTP client:
just enter the URL (for example,
<systemitem>ftp://ftp.gnome.org</systemitem>) in the
<guilabel>Go To</guilabel> field.
@@ -909,10 +910,10 @@
<title>Customizing GNOME</title>
<para>
GNOME is highly configurable &mdash; you can change almost
- anything: background color, key bindings, location of panels and
+ anything: background color, key bindings, location of panels,
contents of the <guimenu>GNOME Menu</guimenu>, and more. To see
- examples of different customizations of GNOME desktop, take a
- look at the screenshots on <ulink type="http"
+ examples of different customizations of the GNOME desktop, take a
+ look at the screenshots on the <ulink type="http"
url="http://www.gnome.org/start/2.0/screenshots/index.html">GNOME
website</ulink> and notice how different they look.
</para>
@@ -936,10 +937,10 @@
<para>
To customize the appearance of your desktop and user
interface, use special <emphasis>desktop preference
- tools</emphasis>, which can be found in <guisubmenu>Desktop
- Preferences</guisubmenu> submenu of <guimenu>Applications
+ tools</emphasis>, which can be found in the <guisubmenu>Desktop
+ Preferences</guisubmenu> submenu of the <guimenu>Applications
</guimenu> menu. You can also access the preferences tools by
- double-clicking on <guiicon>Start Here</guiicon> icon on your
+ double-clicking on the <guiicon>Start Here</guiicon> icon on your
desktop. This will open a <application>Nautilus</application>
window. Double-click on <guiicon>Preferences</guiicon> and
then on the tool you require.
@@ -961,11 +962,11 @@
<tip>
<title>TIP</title>
<para>
- You can also change desktop background color by
- right-clicking on desktop background and choosing
+ You can also change the desktop background color by
+ right-clicking on the desktop background and choosing
<guimenuitem>Change Desktop Background</guimenuitem>, or
by dragging a color from another window or dialog to
- desktop background.
+ the desktop background.
</para>
</tip>
</listitem>
@@ -976,7 +977,7 @@
<listitem>
<para>
This tool allows you to change the desktop theme (to be
- precise, GTK2 theme). A <emphasis>theme</emphasis> is a
+ precise, the GTK2 theme). A <emphasis>theme</emphasis> is a
collection of settings that determine the look of all menus,
panels, toolbars, scrollbars, checkbuttons and other elements
of graphical user interface for all GNOME applications.
@@ -985,20 +986,20 @@
You can select one of the themes installed as part of your
GNOME distribution, or download and install more themes
from the Internet. In particular, you can find many GTK
- themes at <ulink type="http"
+ themes at the <ulink type="http"
url="http://sunshineinabag.co.uk/">Sunshine In a
Bag</ulink> website (look for GTK2 themes).
</para>
<para>
- Please note that GTK2 theme will not change the appearance
- of window decorations (borders, titlebars, and buttons in
+ Please note that a GTK2 theme will not change the appearance
+ of the window decorations, (the borders, titlebars, and buttons in
window titlebar); this is determined by your window
manager settings and can be changed as described in <xref
- linkend="customizing-wm"/>. Also, GTK 2 theme only
+ linkend="customizing-wm"/>. Also, a GTK 2 theme only
controls GNOME 2 applications. If you are using GNOME 1.x
applications in GNOME 2, their appearance will not be
- affected (it is determined by GTK1 theme which is
- configured independently from GTK 2 themes).
+ affected (it is determined by a GTK1 theme which is
+ configured independently from the GTK2 themes).
</para>
</listitem>
</varlistentry>
@@ -1029,10 +1030,10 @@
</variablelist>
</sect2>
<sect2 id="customizing-wm">
- <title>Customizing Window Manager</title>
+ <title>Customizing the Window Manager</title>
<para>
- To customize <application>Sawfish</application> window
- manager, middle-click on the desktop and choose
+ To customize the <application>Sawfish</application> window
+ manager, middle-click on the desktop and choose the
<guimenuitem>Customize</guimenuitem> submenu. This submenu
contains a number of customization tools. The same tools can
also be accessed using <menuchoice>
@@ -1043,11 +1044,11 @@
</menuchoice>.
</para>
<para>
- Most popular customization tool is
+ The most popular customization tool is
<guilabel>Appearance</guilabel>, which allows you to select
the window manager theme (which determines the appearance of
- window frame, titlebar, and buttons) and font to use in window
- titlebar. Other tools (such as <guilabel>Bindings</guilabel>
+ the window frame, titlebar, and buttons) and the font to use in the window
+ titlebar. Other tools (such as the <guilabel>Bindings</guilabel>
tool which allows you to specify keybindings for various
window operations) are only recommended for advanced users.
</para>
@@ -1055,7 +1056,7 @@
<sect2 id="customizing-panel">
<title>Customizing Panels</title>
<para>
- You can customize GNOME panels as follows:
+ You can customize the GNOME panels as follows:
<itemizedlist>
<listitem><para>
To remove a panel, right-click on a vacant space on the
@@ -1077,13 +1078,13 @@
</note>
</listitem>
<listitem><para>
- To modify panel properties (background, size,
+ To modify a panel's properties (background, size,
auto-hide), right-click on a vacant space on the
panel and choose <guimenuitem>Properties</guimenuitem>
from the panel popup menu.
</para></listitem>
<listitem><para>
- To remove an object (menu, applet, application launcher)
+ To remove an object (menu, applet, or application launcher),
from the panel, right-click on the object and choose
<guimenuitem>Remove from panel</guimenuitem> from the
object popup menu.
@@ -1128,21 +1129,20 @@
<para>
Below is a partial list of some of the most useful tools and
- applications which you can find in <guimenu>GNOME
- Menu</guimenu>.
+ applications found in the <guimenu>GNOME Menu</guimenu>.
</para>
<note>
<title>NOTE</title>
<para>
- The contents of <guimenu>GNOME Menu</guimenu> depends on the
+ The contents of the <guimenu>GNOME Menu</guimenu> depends on the
applications installed on your system. In addition, if you are
- using a copy of GNOME packaged by someone other than GNOME
- project (for example, packaged as part of your a Linux
+ using a copy of GNOME packaged by someone other than the GNOME
+ project (for example, packaged as part of your Linux
distribution), the menu is likely to be slightly different
from the one described here. For example, distributors can add
some distribution-specific applications to the menu, or even
- completely reorganize the menus. In this case refer to
- documentation which came with your distribution.
+ completely reorganize the menus. In this case refer to the
+ documentation that came with your distribution.
</para>
</note>
@@ -1167,8 +1167,8 @@
<tip>
<title>TIP</title>
<para>
- You can also start <application>Run
- Program</application> dialog by using <keycombo>
+ You can also start the <application>Run
+ Program</application> dialog by using the <keycombo>
<keycap>Alt</keycap><keycap>F2</keycap></keycombo>
shortcut.
</para>
@@ -1191,7 +1191,7 @@
</term>
<listitem>
<para>
- Takes a screenshot of your desktop and saves it in a
+ This utility takes a screenshot of your desktop and saves it in a
file.
</para>
</listitem>
@@ -1210,32 +1210,37 @@
</term>
<listitem>
<para> These include office and productivity applications
- such as </para>
+ such as:
+ </para>
<itemizedlist>
- <listitem><para>
+
+ <!-- <listitem><para>
<application>Gnumeric</application>,
- a full-featured Excel-compatible spreadsheet
+ a full-featured Excel-compatible spreadsheet.
</para>
+ This is not under accessories. On my menu this goes
+ under Other. Moving this to under Other.
</listitem>
- <!-- <listitem><para>
+ <listitem><para>
<application>AbiWord</application>, a lightweight
word processing application.
</para>
- </listitem> -->
+ </listitem> -->
+
<listitem><para>
<application>GNOME Calculator</application>
</para>
</listitem>
- <listitem><para> Several text editors, from simple and
+ <listitem><para> Several text editors, from the simple and
easy to use <application>Gnome editor</application>
- (gedit) to the (arguably) the most powerful text
+ (gedit), to (arguably) the most powerful text
editor ever created, <application>Emacs</application>
(which is not a GNOME application)
</para>
</listitem>
<listitem><para>
<application>Dictionary</application>, allowing you
- to look up a word in one of freely available
+ to look up a word in one of the many freely available
dictionaries on the Internet.
</para></listitem>
@@ -1272,14 +1277,14 @@
<itemizedlist>
<listitem><para>
<application>Gimp</application> &mdash;
- image editing program for power users; rivals
- <application>Photoshop</application>
+ an image editing program for power users; it rivals
+ <application>Photoshop</application>.
</para>
</listitem>
<listitem>
<para>Image viewers such as <application>Eye of
GNOME</application>, <application>GQview</application> and
- <application>gThumb</application>
+ <application>gThumb</application>.
</para>
</listitem>
<listitem>
@@ -1296,14 +1301,14 @@
<term><guisubmenu>Internet</guisubmenu></term>
<listitem>
<para>
- Here you will find <application>Galeon</application> web
+ Here you will find the <application>Galeon</application> web
browser. If you haven't used it before, give it a try
- &mdash; you will never want to go back to
+ &mdash; you will never go back to
<application>Netscape</application>.
</para>
<para>Depending on the
software installed on your system, you are also likely to find
- here
+ here:
</para>
<itemizedlist>
<listitem>
@@ -1313,16 +1318,16 @@
</para>
</listitem>
<listitem><para> <application>X-Chat</application>, an
- Internet Relay Chat (IRC) client
+ Internet Relay Chat (IRC) client.
</para></listitem>
<listitem><para>
<application>GNOME-ICU</application> for talking
- with other people using ICQ protocol
+ with other people using ICQ protocol.
</para></listitem>
<listitem><para>
<application>gftp</application>, a graphical
tool for file transfers, supporting FTP, HTTP, and
- SSH protocols. Note that GNOME file manager,
+ SSH protocols. Note that the GNOME file manager,
<application>Nautilus</application>, also has
built-in FTP capabilities.
</para>
@@ -1342,6 +1347,12 @@
processing application.
</para>
</listitem>
+ <listitem>
+ <para>
+ <application>Gnumeric</application>,
+ a full-featured Excel-compatible spreadsheet.
+ </para>
+ <!-- Hopefully I did the formatting is corrrectly. -->
</varlistentry>
<!-- ########## -->
@@ -1359,7 +1370,7 @@
<term><guisubmenu>Sound &amp; Video</guisubmenu></term>
<listitem>
<para>
- Here you will find <application>CD player</application>,
+ Here you will find a <application>CD player</application>,
<application>Volume Control</application>, and an MP3
player <application>XMMS</application>.
</para>
@@ -1371,7 +1382,7 @@
<listitem>
<para>
This submenu contains various tools used for managing
- your system, such as
+ your system, such as:
</para>
<itemizedlist>
<listitem>
@@ -1379,7 +1390,7 @@
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 <application>System
+ they use. You can also use the <application>System
Monitor</application> to kill a frozen or otherwise
misbehaving application.
</para>
@@ -1394,7 +1405,7 @@
linkend="customizing-desktop">preferences
tools</link> which only cover some of the
settings). However, it provides little assistance
- or safeguards, so it is easy to make your system
+ or safeguards; it can easily make your system
completely unusable if you do not know what you are
doing.
</para>
@@ -1402,14 +1413,15 @@
<listitem>
<para>
- <application>Archive Generator</application>, tool
+ <application>Archive Generator</application>, a tool
for creating archive files.
</para>
</listitem>
<listitem>
<para>
- <application>Floppy Formatter</application>
+ <application>Floppy Formatter</application>, a tool
+ for formatting floppy disks.
</para>
</listitem>
</itemizedlist>
@@ -1434,9 +1446,9 @@
<para>
And finally, the same submenu also contains various
terminal emulators (<application>xterm</application>,
- <application>Color xterm</application>,
+ <application>Color xterm</application>, and
<application>GNOME Terminal</application>) letting you use
- the most powerful (although not most user friendly) interface
+ the most powerful (but not the most user friendly) interface
ever created &mdash; the command line prompt.
</para>
@@ -1447,7 +1459,7 @@
<term><guisubmenu>Help</guisubmenu></term>
<listitem>
<para>
- This starts GNOME help browser,
+ This starts the GNOME help browser,
<application>Yelp</application>, described in <xref
linkend="Gnome-docs"/>.
</para>
@@ -1490,15 +1502,15 @@
button at the bottom. You can also right-click on the
application name and choose <guimenuitem>End
process</guimenuitem>; if it doesn't help, right-click and
- choose choose <guimenuitem>Kill process</guimenuitem>. Using
+ choose <guimenuitem>Kill process</guimenuitem>. Using the
<application>GNOME System monitor</application> also allows
you to find and kill all helper processes started by this
application.
</para>
<para>
If a GNOME application freezes or crashes (unexpectedly dies)
- repeatedly, you should file a bug report as described in
- <ulink type="help" url="ghelp:gnome-feedback">GNOME feedabck
+ repeatedly, you should file a bug report as described in the
+ <ulink type="help" url="ghelp:gnome-feedback">GNOME feedback
page</ulink>.
</para>
</sect2>
@@ -1509,16 +1521,16 @@
hurry to push the power button on the computer
&mdash; 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, X Window
- System. In this case, you can try to restart X Window System by
+ 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
<keycombo>
<keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>Backspace</keycap>
</keycombo>. This should work for
- the implementation of X Window system used on Linux and *BSD,
+ 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 to mess up the whole file
+ data, but at least you do not risk harming the whole file
system.
</para>
</sect2>
@@ -1543,29 +1555,29 @@
scratch. This is an emergency solution, as you lose all
configuration settings and will need to configure your menus,
panels, etc. again from scratch, that is, from the default GNOME
- configuration. However, this only affects GNOME configuration,
+ configuration. However, this only affects your GNOME configuration,
so your data files and settings for non-GNOME applications
remain intact.
</para>
<para> To remove all your GNOME configuration settings and return
to the original GNOME configuration, logout then log in again
- holding down keys <keycap>Ctrl</keycap> and
- <keycap>Shift</keycap> (immediately after entering your
- password in the login dialog). You will be presented a dialog,
- offering you the choice to reset the saved session (that is,
- which applications were open when you last logged out); reset
+ holding down the keys <keycap>Ctrl</keycap> and
+ <keycap>Shift</keycap>. (Do so immediately after entering your
+ password in the login dialog.) You will be presented with a dialog,
+ offering you the choice of resetting the saved session (that is,
+ the applications open when you last logged out); resetting
your GNOME configuration settings; or both.
</para>
<para>
Finally, if you have really severe problems and your system
freezes or becomes otherwise unusable as soon as you login,
- you have one last option. You can select
+ you have one last option. You can select the
<guimenuitem>Failsafe</guimenuitem> session type instead of
the default <guimenuitem>GNOME</guimenuitem> in the login
screen. Both GNOME and KDE Login Managers support this. In
this session type, GNOME is not started; instead, you are
presented with a single terminal window. This is almost
- guaranteed to start OK, and if you know how to use
+ guaranteed to start, and if you know how to use
command-line tools to find and fix your problem, you have a
chance. Otherwise, ask an expert.
</para>
@@ -1579,13 +1591,13 @@
<title>GNOME Help System</title>
<para>
GNOME includes detailed documentation for the majority
- of applications, utilities and other components, such as Panel
- or Nautilus file manager. To view a manual for an application,
- choose <guimenu>Help</guimenu> menu in the application; to
+ of applications, utilities and other components, such as the panel
+ or the Nautilus file manager. To view a manual for an application,
+ choose the <guimenu>Help</guimenu> menu in the application; to
view help about the panel or panel objects, right-click on it
and choose <guimenuitem>Help</guimenuitem> from the popup
- menu. This will automatically launch GNOME help browser,
- <application>Yelp</application>, showing appropriate
+ menu. This will automatically launch the GNOME help browser,
+ <application>Yelp</application>, showing the appropriate
manual.
</para>
<para>
@@ -1608,9 +1620,9 @@
</term>
<listitem>
<para> This user
- guide provides general overview of GNOME and detailed
+ guide provides a general overview of GNOME and detailed
documentation for core GNOME
- components (desktop, panel, Nautilus, and desktop
+ components (such as the desktop, panel, Nautilus, and desktop
preferences tools).
</para>
</listitem>
@@ -1627,7 +1639,7 @@
including such things as filenames, paths and
directories, permissions, symbolic links and most
confusing of them all, the notion of
- <quote>mounting</quote>. If you never used UNIX system
+ <quote>mounting</quote>. If you have never used a UNIX system
before, be sure to read this.
</para>
</listitem>
@@ -1635,7 +1647,7 @@
</variablelist>
<para><application>Yelp</application> can also be used for
- viewing non-GNOME documentation, namely man pages and info
+ viewing non-GNOME documentation, such as man pages and info
pages (see below).
</para>
@@ -1644,7 +1656,7 @@
<title> GNOME Resources on the Internet</title>
<para>
In addition to documentation shipped with GNOME, there is also
- wealth of information available on the Internet. A good
+ a wealth of information available on the Internet. A good
starting point is the <ulink type="http"
url="http://www.gnome.org">GNOME website</ulink>. There you
will find instructions for installing GNOME, reviews and tips,
@@ -1652,19 +1664,19 @@
</para>
<para>
If you can not find an answer to your question there, you
- may ask other GNOME users and developers on GNOME mailing list
+ may ask other GNOME users and developers on the GNOME mailing list
(subscription instructions can be found <ulink type="http"
url="http://mail.gnome.org/mailman/listinfo/gnome-list">here</ulink>).
Note, however, that this list is for GNOME-related questions
- only (do not ask how to configure X Window System, for instance),
+ only (do not ask how to configure the X Window System, for instance),
and it is impolite (to say the least) to ask a question without
- first checking if this question is already answered in available
- documents such as <ulink type="ghelp"
+ first checking if this question has already been answered in other
+ available documents such as the <ulink type="ghelp"
url="ghelp:gnome2-user-guide">GNOME User Guide</ulink>.
</para>
<para>
Finally, if you use IRC (Internet Relay Chat), you can find
- other GNOME users and developers and ask questions on
+ other GNOME users and developers and ask questions on the
<systemitem>#gnome</systemitem> and
<systemitem>#gnome-help</systemitem> channels on
<systemitem>irc.gnome.org</systemitem>.
@@ -1678,10 +1690,10 @@
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
- (X Window System). Each of these components usually comes with
+ (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 <quote>manual pages</quote>, or man pages
- for short. You can view them using
+ for short. You can view them using the
<application>Yelp</application> help browser
(see <xref linkend="Gnome-docs"/>). This documentation is usually
very detailed and more technical than most users would like.
@@ -1689,23 +1701,23 @@
GNU project is called <quote>info pages</quote>. They, too,
can be viewed using <application>Yelp</application>. Many
applications also have documentation in other formats. Sometimes
-` it is not easy to find documentation for a given application &mdash;
+ it is not easy to find documentation for a given application &mdash;
try looking in the directories <filename>/usr/share/doc</filename>
- and <filename>/usr/doc</filename>
+ and <filename>/usr/doc</filename>.
</para>
- <para> Documentation for operating system itself varies from one
+ <para> 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 <ulink type="http"
- url="http://www.linuxdoc.org">http://www.linuxdoc.org</ulink>).
+ documentation on the Internet at <ulink type="http"
+ url="http://www.linuxdoc.org">http://www.linuxdoc.org</ulink>.
Virtually all Linux distributions also include copies of LDP
documents; usually they are found at
<filename>/usr/share/doc/LDP</filename> or
<filename>/usr/share/doc/HOWTO</filename>.
</para>
<para>
- And of course, there is a number of books available about all
+ 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.
</para>
@@ -1713,10 +1725,10 @@
<sect2 id="feedback">
<title>Feedback</title>
<para>
- If you have found a bug in one of GNOME applications, or have
+ 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 <ulink type="help"
+ bug reports and comments are given in the <ulink type="help"
url="ghelp:gnome-feedback">GNOME Feedback Page</ulink>.
</para>
</sect2>
@@ -1729,4 +1741,3 @@
-