summaryrefslogtreecommitdiffstats
path: root/gnome-users-guide
diff options
context:
space:
mode:
authorAlexander Kirillov <sasha@src.gnome.org>2001-03-28 17:06:23 +0000
committerAlexander Kirillov <sasha@src.gnome.org>2001-03-28 17:06:23 +0000
commit1461cd6c6f72706ca1f12c3cba17afb373f46f2d (patch)
tree7135723be11f29baadc006eaca9222c138d677fc /gnome-users-guide
parent26b769b6e153b40a1b2880feb9ee2e3f35912b40 (diff)
downloadgnome-user-docs-1461cd6c6f72706ca1f12c3cba17afb373f46f2d.tar.gz
gnome-user-docs-1461cd6c6f72706ca1f12c3cba17afb373f46f2d.tar.xz
gnome-user-docs-1461cd6c6f72706ca1f12c3cba17afb373f46f2d.zip
fixed conflicting id's and other technical problems, added words 1.4 to
* gnome-users-guide/gnome-users-guide-1.4/C: fixed conflicting id's and other technical problems, added words 1.4 to users guide and replaced newbies' appendix with a newer version. ALso, removed "mime type capplet" from gnomecc.sgml. Should now build without error messages (if you have patched docbook package to allow for self-closing tags)
Diffstat (limited to 'gnome-users-guide')
-rw-r--r--gnome-users-guide/gnome-users-guide-1.4/C/applets/desk-guide-ug.sgml2
-rw-r--r--gnome-users-guide/gnome-users-guide-1.4/C/applets/gkb-ug.sgml4
-rw-r--r--gnome-users-guide/gnome-users-guide-1.4/C/applets/jbc-ug.sgml2
-rw-r--r--gnome-users-guide/gnome-users-guide-1.4/C/applets/mini-commander-ug.sgml2
-rw-r--r--gnome-users-guide/gnome-users-guide-1.4/C/applets/screenshooter-ug.sgml2
-rw-r--r--gnome-users-guide/gnome-users-guide-1.4/C/applets/swapload-ug.sgml4
-rw-r--r--gnome-users-guide/gnome-users-guide-1.4/C/applets/tasklist-ug.sgml5
-rw-r--r--gnome-users-guide/gnome-users-guide-1.4/C/gnome-users-guide.sgml4
-rw-r--r--gnome-users-guide/gnome-users-guide-1.4/C/gnomecc.sgml9
-rw-r--r--gnome-users-guide/gnome-users-guide-1.4/C/gpl-appendix.sgml20
-rw-r--r--gnome-users-guide/gnome-users-guide-1.4/C/nautilus-user-manual.sgml28
-rw-r--r--gnome-users-guide/gnome-users-guide-1.4/C/ug-applets.sgml4
-rw-r--r--gnome-users-guide/gnome-users-guide-1.4/C/unix-primer.sgml (renamed from gnome-users-guide/gnome-users-guide-1.4/C/newbies.sgml)467
-rw-r--r--gnome-users-guide/gnome-users-guide-1.4/C/wheeler.sgml8
14 files changed, 311 insertions, 250 deletions
diff --git a/gnome-users-guide/gnome-users-guide-1.4/C/applets/desk-guide-ug.sgml b/gnome-users-guide/gnome-users-guide-1.4/C/applets/desk-guide-ug.sgml
index f08278d..47d839a 100644
--- a/gnome-users-guide/gnome-users-guide-1.4/C/applets/desk-guide-ug.sgml
+++ b/gnome-users-guide/gnome-users-guide-1.4/C/applets/desk-guide-ug.sgml
@@ -594,7 +594,7 @@
</para>
</sect3>
--->
+
</sect2>
diff --git a/gnome-users-guide/gnome-users-guide-1.4/C/applets/gkb-ug.sgml b/gnome-users-guide/gnome-users-guide-1.4/C/applets/gkb-ug.sgml
index 777aebc..cd4b63d 100644
--- a/gnome-users-guide/gnome-users-guide-1.4/C/applets/gkb-ug.sgml
+++ b/gnome-users-guide/gnome-users-guide-1.4/C/applets/gkb-ug.sgml
@@ -105,10 +105,10 @@
<guilabel>Options</guilabel> tab you can set the appearance of the
applet (flag, label or flag+label) and its size (Normal or Big), as
well as the key sequence to use to get GKB to switch between
- keyboard layouts (see <xref linkend="bugs"> section.)
+ keyboard layouts (see <xref linkend="gkb-bugs">).
</para>
<sect4 id="gkb-prefs-add">
- <title>Setting keyboard layouts for you language</title>
+ <title>Setting keyboard layouts for your language</title>
<para>
Setting up keymaps can consist in one or more of the following steps:
<itemizedlist>
diff --git a/gnome-users-guide/gnome-users-guide-1.4/C/applets/jbc-ug.sgml b/gnome-users-guide/gnome-users-guide-1.4/C/applets/jbc-ug.sgml
index 6208e98..136d9cc 100644
--- a/gnome-users-guide/gnome-users-guide-1.4/C/applets/jbc-ug.sgml
+++ b/gnome-users-guide/gnome-users-guide-1.4/C/applets/jbc-ug.sgml
@@ -28,7 +28,7 @@
</figure>
<!-- ============= Usage ================================ -->
- <sect3 id="APPLET-usage">
+ <sect3 id="jbc-usage">
<title>Usage</title>
<para>
You don't need to do anything special to this clock. It just
diff --git a/gnome-users-guide/gnome-users-guide-1.4/C/applets/mini-commander-ug.sgml b/gnome-users-guide/gnome-users-guide-1.4/C/applets/mini-commander-ug.sgml
index 65cdcff..cbedcce 100644
--- a/gnome-users-guide/gnome-users-guide-1.4/C/applets/mini-commander-ug.sgml
+++ b/gnome-users-guide/gnome-users-guide-1.4/C/applets/mini-commander-ug.sgml
@@ -37,7 +37,7 @@
</figure>
<!-- ============= Usage ================================ -->
- <sect3 id="APPLET-usage">
+ <sect3 id="mini-commmander-usage">
<title>Usage</title>
<para>
diff --git a/gnome-users-guide/gnome-users-guide-1.4/C/applets/screenshooter-ug.sgml b/gnome-users-guide/gnome-users-guide-1.4/C/applets/screenshooter-ug.sgml
index 6e4a63d..6bedb76 100644
--- a/gnome-users-guide/gnome-users-guide-1.4/C/applets/screenshooter-ug.sgml
+++ b/gnome-users-guide/gnome-users-guide-1.4/C/applets/screenshooter-ug.sgml
@@ -710,5 +710,5 @@
Table</ulink>.
</para>
</sect3>
- -->
+
</sect2>
diff --git a/gnome-users-guide/gnome-users-guide-1.4/C/applets/swapload-ug.sgml b/gnome-users-guide/gnome-users-guide-1.4/C/applets/swapload-ug.sgml
index 3bfc3fe..2ea2f70 100644
--- a/gnome-users-guide/gnome-users-guide-1.4/C/applets/swapload-ug.sgml
+++ b/gnome-users-guide/gnome-users-guide-1.4/C/applets/swapload-ug.sgml
@@ -39,7 +39,7 @@
available.
</para>
- <figure id="cpuload-applet-fig">
+ <figure id="swapload-applet-fig">
<title>Swap Load Applet</title>
<screenshot>
<screeninfo>Swap Load Applet</screeninfo>
@@ -100,7 +100,7 @@
<sect3 id="swapload-properties">
<title>Properties</title>
- <figure id="cpuload-default-fig">
+ <figure id="swapload-default-fig">
<title>Default Properties Dialog</title>
<screenshot>
<screeninfo>Swap Load Applet Default Properties Dialog</screeninfo>
diff --git a/gnome-users-guide/gnome-users-guide-1.4/C/applets/tasklist-ug.sgml b/gnome-users-guide/gnome-users-guide-1.4/C/applets/tasklist-ug.sgml
index 3c03d74..e2e08b0 100644
--- a/gnome-users-guide/gnome-users-guide-1.4/C/applets/tasklist-ug.sgml
+++ b/gnome-users-guide/gnome-users-guide-1.4/C/applets/tasklist-ug.sgml
@@ -97,17 +97,16 @@
multiple instances of a program are running. A number in parentheses
appears to next to the application. Clicking on the icon brings up a menu
listing all of the running instances.</para>
- <figure id="tasklist-applet-grouping-fig">
+<!-- <figure id="tasklist-applet-grouping-fig">
<title>Task Grouping</title>
- <!--
<screenshot>
<screeninfo>Task Grouping</screeninfo>
<graphic format="png" fileref="figures/tasklist-grouping"
srccredit="John Fleck">
</graphic>
</screenshot>
- -->
</figure>
+ -->
<para>Clicking on an item in the list brings that window to the foreground
and gives it focus.</para>
<para>By default, <application>Tasklist</application> groups four or more
diff --git a/gnome-users-guide/gnome-users-guide-1.4/C/gnome-users-guide.sgml b/gnome-users-guide/gnome-users-guide-1.4/C/gnome-users-guide.sgml
index 25684f5..bfaf158 100644
--- a/gnome-users-guide/gnome-users-guide-1.4/C/gnome-users-guide.sgml
+++ b/gnome-users-guide/gnome-users-guide-1.4/C/gnome-users-guide.sgml
@@ -8,7 +8,7 @@
<!ENTITY NAUTILUS SYSTEM "nautilus-user-manual.sgml">
<!ENTITY GNOMECC SYSTEM "gnomecc.sgml">
<!ENTITY GNOME-APPLETS SYSTEM "ug-applets.sgml">
-<!ENTITY NEWBIES SYSTEM "newbies.sgml">
+<!ENTITY NEWBIES SYSTEM "unix-primer.sgml">
<!ENTITY FDL SYSTEM "fdl.sgml">
<!ENTITY GPL SYSTEM "gpl-appendix.sgml">
<!ENTITY FIFTEEN SYSTEM "applets/fifteen-ug.sgml">
@@ -59,7 +59,7 @@
<Book id="index">
<bookinfo>
<graphic fileref="./figures/gnome-logo-large" format="png"></graphic>
- <title>GNOME User's Guide</title>
+ <title>GNOME 1.4 User's Guide</title>
<authorgroup>
<author>
<firstname>GNOME User's Guide</firstname>
diff --git a/gnome-users-guide/gnome-users-guide-1.4/C/gnomecc.sgml b/gnome-users-guide/gnome-users-guide-1.4/C/gnomecc.sgml
index 5cf5956..fa7861b 100644
--- a/gnome-users-guide/gnome-users-guide-1.4/C/gnomecc.sgml
+++ b/gnome-users-guide/gnome-users-guide-1.4/C/gnomecc.sgml
@@ -23,7 +23,7 @@
<para> <application>Control Center</application> is a part of
Gnome desktop environment; it is included in
<filename>control-center</filename> package. This manual
- describes version 1.2.3 of <application>Control
+ describes version 1.4 of <application>Control
Center</application>.
</para>
@@ -364,7 +364,10 @@
</screenshot>
</figure>
</sect2>
- <sect2 id="gccmime">
+<!-- Here we go again - seems that after all, this capplet is not
+ included in 1.4
+
+ <sect2 id="gccmime">
<title>Gnome Mime Types</title>
<para>
<indexterm id="idx-a77">
@@ -405,7 +408,7 @@
action and the <guilabel>Edit</guilabel> action.
</para>
</sect2>
-
+ -->
<sect2 id="gccURL">
diff --git a/gnome-users-guide/gnome-users-guide-1.4/C/gpl-appendix.sgml b/gnome-users-guide/gnome-users-guide-1.4/C/gpl-appendix.sgml
index 4e8b1e4..6aa6b96 100644
--- a/gnome-users-guide/gnome-users-guide-1.4/C/gpl-appendix.sgml
+++ b/gnome-users-guide/gnome-users-guide-1.4/C/gpl-appendix.sgml
@@ -1,4 +1,4 @@
-<appendix id="gpl" label="C">
+<appendix id="gpl" label="D">
<title>GNU General Public License</title>
<!-- <copyright>
@@ -54,10 +54,6 @@
Last Modified: Nov 16, 2000
-->
-
-
-
-
<sect1 id="gpl-preamble">
<title>Preamble</title>
@@ -164,7 +160,7 @@
</para>
</sect2>
- <sect2 id="gpl-sect2">
+ <sect2 id="gpl-sect1">
<title>Section 1</title>
<para>
You may copy and distribute verbatim copies of the Program's source code as you
@@ -186,7 +182,7 @@
<para>
You may modify your copy or copies of the Program or any portion of it, thus
forming a work based on the Program, and copy and distribute such modifications
- or work under the terms of <link linkend="gpl-sect2">Section 1</link> above, provided
+ or work under the terms of <link linkend="gpl-sect1">Section 1</link> above, provided
that you also meet all of these conditions:
<orderedlist numeration="loweralpha">
@@ -258,7 +254,7 @@
<para>
You may copy and distribute the Program (or a work based on it, under
<link linkend="gpl-sect2">Section 2</link> in object code or executable form under the terms of
- <link linkend="gpl-sect2">Sections 1</link> and <link linkend="gpl-sect2">2</link> above provided that
+ <link linkend="gpl-sect1">Sections 1</link> and <link linkend="gpl-sect2">2</link> above provided that
you also do one of the following:
<orderedlist numeration="loweralpha">
@@ -411,7 +407,7 @@
</para>
</sect2>
- <sect2 id="gpl-sect20">
+ <sect2 id="gpl-sect10">
<title>Section 10</title>
<para>
@@ -423,7 +419,7 @@
</para>
</sect2>
- <sect2 id="gpl-sect21">
+ <sect2 id="gpl-sect11">
<title>NO WARRANTY</title>
<subtitle>Section 11</subtitle>
@@ -437,7 +433,7 @@
</para>
</sect2>
- <sect2 id="gpl-sect22">
+ <sect2 id="gpl-sect12">
<title>Section 12</title>
<para>
@@ -451,5 +447,7 @@
</para>
</sect2>
</sect1>
+
+
</appendix>
diff --git a/gnome-users-guide/gnome-users-guide-1.4/C/nautilus-user-manual.sgml b/gnome-users-guide/gnome-users-guide-1.4/C/nautilus-user-manual.sgml
index 8ff2085..5a3f4fe 100644
--- a/gnome-users-guide/gnome-users-guide-1.4/C/nautilus-user-manual.sgml
+++ b/gnome-users-guide/gnome-users-guide-1.4/C/nautilus-user-manual.sgml
@@ -1,19 +1,6 @@
<chapter id="nautilus">
<title>Nautilus User Manual</title>
- <edition>v1.0</edition>
- <authorgroup>
- <author>
- <firstname>Vera</firstname>
- <surname>Horiuchi</surname>
- <authorblurb>
- <para>
- <email>
- vera@eazel.com
- </email>
- </para>
- </authorblurb>
- </author>
- </authorgroup>
+
<!--
<copyright>
<year>2001</year>
@@ -64,12 +51,11 @@
</para>
</legalnotice>
- -->
- <!-- this is the version of manual, not application -->
+
<releaseinfo>
This is version 1.0.2 of the Nautilus User's Manual.
</releaseinfo>
-
+-->
@@ -289,7 +275,7 @@
<!-- Introducing Nautilus: Setting Nautilus to Start Automatically -->
- <sect2 id="session">
+ <sect2 id="nau-session">
<title>Setting Nautilus to Start Automatically</title>
<para>
@@ -832,7 +818,7 @@
<para>
Note: You can control which viewer or application an individual
- file automatically opens in. See <link linkend="chapter6">Choosing
+ file automatically opens in. See <link linkend="file">Choosing
Applications to Handle Files</link>.
</para>
@@ -905,7 +891,7 @@
<para>
Note: If the application you want to use is not listed when you
choose Open With, you can add the application to the list. See
- <link linkend="chapter6">Choosing Applications to Handle Files</link>.
+ <link linkend="file">Choosing Applications to Handle Files</link>.
</para>
</sect2>
@@ -1656,7 +1642,7 @@
</sect2>
<!-- Searching Your Computer and the Internet: Searching the Internet -->
- <sect2 id="search">
+ <sect2 id="search-net">
<title>Searching the Internet</title>
<para>
diff --git a/gnome-users-guide/gnome-users-guide-1.4/C/ug-applets.sgml b/gnome-users-guide/gnome-users-guide-1.4/C/ug-applets.sgml
index 40bb687..cc67b51 100644
--- a/gnome-users-guide/gnome-users-guide-1.4/C/ug-applets.sgml
+++ b/gnome-users-guide/gnome-users-guide-1.4/C/ug-applets.sgml
@@ -40,7 +40,7 @@
</para>
<para>
- <figure id="example-applets-fig">
+ <figure id="example-applets-fig2">
<title>Example Applets</title>
<screenshot>
<screeninfo>Example Applets</screeninfo>
@@ -50,7 +50,7 @@
</screenshot>
</figure>
Several example applets are shown in <xref
- linkend="example-applets-fig">. From left to right, they are: (1)
+ linkend="example-applets-fig2">. From left to right, they are: (1)
<application>Mixer Applet</application>, which allows you to turn
on/off sound and control its volume by clicking on the applet. (2)
<application>Sound Monitor</application> Applet, which displays
diff --git a/gnome-users-guide/gnome-users-guide-1.4/C/newbies.sgml b/gnome-users-guide/gnome-users-guide-1.4/C/unix-primer.sgml
index e53263b..391cc1c 100644
--- a/gnome-users-guide/gnome-users-guide-1.4/C/newbies.sgml
+++ b/gnome-users-guide/gnome-users-guide-1.4/C/unix-primer.sgml
@@ -1,15 +1,16 @@
-<appendix id="newbies" label="A">
+
+ <appendix id="newbies" label="A">
<title> If you are new to Linux/UNIX</title>
-
+
<para> One of the goals of GNOME is to make your system easy to use,
- without requiring you to learn the syntax of most UNIX commands.
- However, there are some basic UNIX notions that you have to be
- familiar with, even while using the easy graphical interface
- provided by GNOME. For the convenience of new users, these basics
- are collected in this appendix. If you need further information on
- UNIX, you should read the documentation which came with your
- system; there are also a number of books and on-line guides
- available for all versions of UNIX.
+ without requiring you to learn the technical details about your
+ operating system. However, there are some basic UNIX notions that
+ you have to be familiar with even while using the easy graphical
+ interface provided by GNOME. For the convenience of new users,
+ these basics are collected in this document. If you need further
+ information on UNIX, you should read the documentation which came
+ with your system; there are also a number of books and on-line
+ guides available for all versions of UNIX.
</para>
<para> The following guide applies to all versions of UNIX and
@@ -19,13 +20,15 @@
<systemitem>Linux</systemitem>. Some of the material here is based
on <citetitle>Linux Installation and Getting Started</citetitle>
guide, by Matt Welsh, Phil Hughes, David Bandel, Boris Beletsky,
- Sean Dreilinger, Robert Kiesling, Evan Liebovitch, and Henry
+ Sean Dreilinger, Robert Kiesling, Evan Leibovitch, and Henry
Pierce. The guide is available for download or online viewing from
the <ulink url="http://www.linuxdoc.org" type="http">Linux
Documentation Project</ulink> or from the <ulink
url="http://www.oswg.org">Open Source Writers Group</ulink>.
</para>
- <sect1 id="new-users">
+
+
+ <sect1 id="new-users">
<title>Users</title>
<para> UNIX is a multiuser operating system: it
was designed to allow many users to work on the same computer,
@@ -42,7 +45,7 @@
</para>
<para> Each user has a separate place to keep his files (called
his <emphasis>home directory</emphasis>). UNIX has a system of
- permissions (see <xref linkend="permissions">), so that on a
+ permissions (see <xref linkend="primer-permissions">), so that on a
properly configured UNIX system a user can't change other users'
or system files. This also allows every user to customize
various aspects of the system &mdash; in particular, GNOME
@@ -113,20 +116,21 @@
<itemizedlist>
<listitem>
<para> It is customary to use the format
- <filename>filename.extension</filename> for filenames, where the
- extension indicates the file type; for example, the
- extension <filename>txt</filename> is usually used for plain
- text files, while the extension <filename>jpeg</filename> is
- used for graphics in JPEG format, and so on. In
- particular, the <application>Nautilus File
- Manager</application> (<application>Nautilus</application>)
- uses extensions to determine file type. You can view all
- the file extensions recognized by
- <application>Nautilus</application> by choosing the
- <guimenuitem>File types and Programs</guimenuitem> capplet in the
- <guimenu>Document Handlers</guimenu> section of the
- <application>Control-center</application>. Note that the standard
- convention in UNIX is that the
+ <filename>filename.extension</filename> for filenames,
+ where the extension indicates the file type; for
+ example, the extension <filename>txt</filename> is
+ usually used for plain text files, while the extension
+ <filename>jpeg</filename> is used for graphics in JPEG
+ format, and so on. In particular, the <application>GNOME
+ File Manager</application>
+ (<application>Nautilus</application>) uses extensions to
+ determine file type. You can view or change file
+ extensions recognized by
+ <application>GNOME</application> by selecting the
+ section <menuchoice><guimenu>Document Handlers</guimenu>
+ <guimenuitem>MIME types</guimenuitem> </menuchoice> in
+ <application>GNOME Control Center</application>. Note
+ that the standard convention in UNIX is that the
<emphasis>executables</emphasis> (i.e., the program
files) have no extension at all.
</para>
@@ -144,7 +148,8 @@
edit these files manually, or even know their precise
names and locations, <application>Nautilus</application>
usually doesn't show these files. You can change this
- setting using the <guimenuitem>Preferences</guimenuitem> dialog.
+ setting as described in <ulink type="help"
+ url="gnome-help:nautilus">Nautilus manual</ulink>.
</para>
</listitem>
@@ -155,9 +160,7 @@
<filename> myfile.txt</filename> with
<application>emacs</application>, it
saves the previous version in the file
- <filename>myfile.txt~</filename>. Again, you can control whether
- you want Nautilus File Manager to show these files or not
- in <guimenuitem>Preferences</guimenuitem> dialog.
+ <filename>myfile.txt~</filename>.
</para>
</listitem>
</itemizedlist>
@@ -181,35 +184,31 @@
<filename>chapter1.txt, chapter2.txt</filename> , but not
<filename>chapter10.txt</filename>
</para>
- </sect2>
+ <para>Most new GNOME users prefer using the <application>GNOME
+ File Manager</application> for operations with files, rather
+ than working from the command line. Wildcards can also be
+ used in <application>Nautilus</application> in the file
+ selection and view filter dialogs. </para>
+ </sect2>
<sect2 id="quoting">
<title>Using spaces, commas, etc. in file names</title>
<para>
As was mentioned above, a file name may contain not only
- letters and numbers, but also spaces, commas, etc. - any
+ letters and numbers, but also spaces, commas, etc. &mdash; any
characters other than slash (/). However, if you are using
commands typed on the command line, you should be careful when
- dealing with such files. For example, if you have a file named
- <filename>My file</filename>, and you want to delete it,
- typing <command>rm My file</command> will not give the desired
- effect: the command <command>rm</command> will assume that you
- want to remove files <filename>My</filename> and
- <filename>file</filename>. At best, it will give you an error
- message; at worst (if you do have a file named
- <filename>My</filename>) it will remove a wrong file. The
- right way to do this is to enclose the file name in single
- quotes: <command>rm 'My File'</command>. The same should be
- done for file names containing any symbols that are normally
- considered as "separators", or have some special meaning; this
- includes comma (,), star (*), question mark (?), and more. To
- be on the safe side, quote in this way all file names that
- contain anything other than letters, numbers, and
- dots. </para>
+ dealing with such files. To avoid problems, it is advised that
+ you enclose filenames that contain anything other than
+ letters, numbers, and dots, in single quotes: to delete file
+ <filename>My File</filename>, you should type <command>rm 'My
+ File'</command> rather than <command>rm My
+ File</command>.
+ </para>
<para>
- Of course, if you are only using graphical tools such as Nautilus
+ Of course, if you are only using graphical tools such as GNOME
File Manager, than you do not need to worry about this: to
- delete file <filename>My file</filename>, just drag it to the
+ delete file <filename>My File</filename>, just drag it to the
trash can.
</para>
</sect2>
@@ -222,27 +221,29 @@
<para>
Now, let's discuss the concept of directories. A
<emphasis>directory</emphasis> is a collection of files. It
- can be thought of as a "folder" that contains many different
- files. Directories are given names, with which they can be
- identified. Furthermore, directories are maintained in a
- tree-like structure; that is, directories may contain other
- directories. The top level directory is called the "root
- directory" and denoted by <filename>/</filename>; it contains
- all the files in your system.
+ can be thought of as a <quote>folder</quote> that contains
+ many different files. Directories are given names, with which
+ they can be identified. Furthermore, directories are
+ maintained in a tree-like structure; that is, directories may
+ contain other directories. The top level directory is called
+ the <quote>root directory</quote> and denoted by
+ <filename>/</filename>; it contains all the files in your
+ system.
</para>
<sect3 id="new-path">
<title>Pathnames</title>
<para>
- A <emphasis>pathname</emphasis> is a file's "full name"; it
- contains not only filename but also its locaion. It is
- made up of the filename, preceded by the name of the
- directory containing that file. This, in turn, is preceded
- by the name of directory containing <emphasis>that
- directory</emphasis>, and so on. A typical pathname may
- look like <filename>/home/sasha/talk.txt</filename> which
- refers to the file <filename>talk.txt</filename> in the
- directory <filename>sasha</filename> which in turn is a
- subdirectory in <filename>/home</filename>.
+ A <emphasis>pathname</emphasis> is a file's <quote>full
+ name</quote>; it contains not only filename but also its
+ location. It is made up of the filename, preceded by the
+ name of the directory containing that file. This, in turn,
+ is preceded by the name of directory containing
+ <emphasis>that directory</emphasis>, and so on. A typical
+ pathname may look like
+ <filename>/home/sasha/talk.txt</filename> which refers to
+ the file <filename>talk.txt</filename> in the directory
+ <filename>sasha</filename> which in turn is a subdirectory
+ in <filename>/home</filename>.
</para>
<para>
As you can see, the directory and filename are separated by
@@ -271,13 +272,13 @@
At any moment, commands that you enter are assumed to be
<emphasis>relative</emphasis> to your current working
directory. You can think of your working directory as the
- directory in which you are currently ``located''. When you
- first log in, your working directory is set to your home
- directory &mdash; for user sasha, it would be
- <filename>/home/sasha</filename>. Whenever you refer to a
- file, you may refer to it in relationship to your current
- working directory, rather than specifying the full pathname of
- the file.
+ directory in which you are currently
+ <quote>located</quote>. When you first log in, your working
+ directory is set to your home directory &mdash; for user
+ sasha, it would be <filename>/home/sasha</filename>. Whenever
+ you refer to a file, you may refer to it in relationship to
+ your current working directory, rather than specifying the
+ full pathname of the file.
</para>
<para>
For example, if your current directory is
@@ -332,7 +333,7 @@
</para>
</sect2>
</sect1>
- <sect1 id="permissions">
+ <sect1 id="primer-permissions">
<title>Permissions</title>
<para>
Every file on your system has an <emphasis>owner</emphasis> &mdash; one
@@ -361,71 +362,71 @@
</para>
<para>
- All newly created files carry some standard permissions,
- usually read/write for user and read only for
- everyone else. You can view the permissions using the Nautilus File
- Manager, by right-clicking on the file, choosing
- <guimenuitem>Show Properties</guimenuitem> in the pop-up menu, and then the
- <guilabel>Permissions</guilabel> tab. Using this dialog, you can also
- change the permissions &mdash; just click on a square
- representing the permission to toggle it. Of course, only the
- file owner or the system administrator can change the
- permissions of a file. Advanced users can also change the default
- file permissions which are assigned to newly created
+ All newly created files carry some standard permissions, usually
+ read/write for user and read only for everyone else. You can
+ view the permissions using the GNOME File Manager, by
+ right-clicking on the file, choosing
+ <guimenuitem>Properties</guimenuitem> in the pop-up menu, and
+ then the <guilabel>Permissions</guilabel> tab. Using this
+ dialog, you can also change the permissions &mdash; just click
+ on a square representing the permission to toggle it. Of
+ course, only the file owner or the system administrator can
+ change the permissions of a file. Advanced users can also change
+ the default file permissions which are assigned to newly created
files&mdash;see the manual pages for your default shell (usually
- <command>bash</command>,
- <command>csh</command> or <command>tcsh</command>) and look for the command
- <command>umask</command>.
+ <command>bash</command>, <command>csh</command> or
+ <command>tcsh</command>) and look for the command
+ <command>umask</command>.
</para>
<para>
- A file can also have some special permission properties such
- as UID, GID, and "sticky" bit. They are for experienced users
- only &mdash; do not change them unless you know what you are
- doing. (If you are curious: these permissions are typically
+ A file can also have some special permission properties such as
+ UID, GID, and <quote>sticky</quote> bit. They are for advanced
+ users only &mdash; do not change them unless you know what you
+ are doing. (If you are curious: these permissions are typically
used on executable files to allow the user to execute
- <emphasis>some</emphasis> commands
- which read or modify files to which the user himself doesn't
- have access.)
+ <emphasis>some</emphasis> commands which read or modify files to
+ which the user himself doesn't have access.)
</para>
<para> Similar to files, the directories also have
- permissions. Again, there are 3 possible
- permissions: read, write, and execute. However, they have
- different meaning: namely, "read" permission for a directory
- means permission to list the contents of the directory or
- search for a file; "write" means permission to create and
- remove files in the directory, and "execute" means permission
- to access files in the directory.
+ permissions. Again, there are 3 possible permissions: read,
+ write, and execute. However, they have different meaning:
+ namely, <quote>read</quote> permission for a directory means
+ permission to list the contents of the directory or search for a
+ file; <quote>write</quote> means permission to create and remove
+ files in the directory, and <quote>execute</quote> means
+ permission to access files in the directory.
</para>
<para>
Note that the permissions granted to a file depend on the
permissions of the directory in which the file is located: in
order to be able to read a file, a user needs to have the read
- permission for the file itself and "execute" permission
- for the directory that contains it. So, if user sasha doesn't
- want anybody else to see his files, he can achieve this by
- removing the execute permission on his home directory for all
- other users. This way, no one but himself (and, of course,
- root) will be able to read any of his files, no matter what
- the permissions of individual files are.
- </para>
- <para> Detailed explanation of the permission system can be
- found, for example, in the info page for the GNU "File
- Utilities" package. You can view this info page using GNOME Help
- browser.
+ permission for the file itself and <quote>execute</quote>
+ permission for the directory that contains it. So, if user sasha
+ doesn't want anybody else to see his files, he can achieve this
+ by removing the execute permission on his home directory for all
+ other users. This way, no one but himself (and, of course, root)
+ will be able to read any of his files, no matter what the
+ permissions of individual files are.
+ </para>
+ <para> Detailed explanation of the permission system can be found,
+ for example, in the <ulink type="info" url="info:fileutils">info
+ page</ulink> for the GNU <citetitle>File Utilities</citetitle>
+ package.
</para>
</sect1>
- <sect1 id="syslinks">
+ <sect1 id="symlinks">
<title>Symbolic links</title>
<para>
- In addition to regular files, UNIX also has special files
- called <emphasis>symbolic links</emphasis> (or
+ In addition to regular files, UNIX also has special files called
+ <emphasis>symbolic links</emphasis> (or
<emphasis>symlinks</emphasis> for short). These files do not
- contain any data; instead, they are just "pointers," or
- "shortcuts" to other files. For example, sasha can have a
- symlink named <filename>ft.txt</filename> pointing to the file
+ contain any data; instead, they are just
+ <quote>pointers</quote>, or <quote>shortcuts</quote> to other
+ files. For example, sasha can have a symlink named
+ <filename>ft.txt</filename> pointing to the file
<filename>papers/fieldtheory.txt</filename>; this way, when a
program tries to access the file <filename>ft.txt</filename>,
the file <filename>papers/fieldtheory.txt</filename> will be
@@ -445,13 +446,13 @@
<para> Symlinks can also point to directories. For example, on
the GNOME FTP server (<systemitem>ftp.gnome.org</systemitem>),
- there is a file <filename>/pub/GNOME/latest</filename>, which at
- the time of this writing is a symlink to directory
- <filename>/pub/GNOME/gnome-1.0.53</filename>. By the time you
- read this, the latest version of GNOME is likely to change, and
- the GNOME maintainers will change the symlink correspondingly,
- so that it will point to
- <filename>/pub/GNOME/gnome-1.2</filename> or something similar.
+ there is a file
+ <filename>/pub/GNOME/stable/releases/october-gnome</filename>,
+ which is actually a symlink to directory
+ <filename>/pub/GNOME/stable/releases/gnome-1.0.53</filename>
+ &mdash; as one would expect, since <quote>October GNOME</quote>
+ is just another name for 1.0.53 release
+ of GNOME.
</para>
</sect1>
<sect1 id="new-mount">
@@ -470,9 +471,11 @@
CD-ROM, you must give to your system a command to incorporate
the contents of this diskette into the main directory tree,
which is referred to as <emphasis>mounting</emphasis> the
- diskette. Typically the contents of the CD-ROM will appear under
- the name <filename>/mnt/cdrom</filename>; the floppy diskette
- under <filename>/mnt/floppy</filename> (these are called the
+ diskette. You can think of it as the software analog of
+ connecting the drive to your system. Typically the contents of
+ the CD-ROM will appear under the name
+ <filename>/mnt/cdrom</filename>; the floppy diskette under
+ <filename>/mnt/floppy</filename> (these are called the
<emphasis>mount points</emphasis> and are defined in the special
configuration file, <filename>/etc/fstab</filename>). Accessing
a drive in this fashion doesn't mean that the system will copy
@@ -486,8 +489,8 @@
</para>
<para>
So, in short: before you can use files on a drive, you must
- "mount" it. Similarly, <emphasis>before removing the disk from
- the drive, you must unmount it.</emphasis>
+ <quote>mount</quote> it. Similarly, <emphasis>before removing
+ the disk from the drive, you must unmount it.</emphasis>
</para>
<para>
When using GNOME, you usually do not have to worry about
@@ -497,18 +500,20 @@
mounts the corresponding drive (if it was not already mounted)
and starts the file manager in the appropriate directory.
Similarly, if you right-click on the drive icon and choose the
- command <guimenuitem>Unmount Volume</guimenuitem> from the pop-up
+ command <guimenuitem>Eject device</guimenuitem> from the pop-up
menu, GNOME automatically unmounts it before ejecting. You can
- also mount a drive by right-clicking on the desktop and choosing
- <guimenuitem>Disks | cdrom</guimenuitem> from the pop-up menu,
+ also mount/unmount a drive by right-clicking on its icon on the
+ desktop and choosing <guimenuitem>Mount device</guimenuitem> or
+ <guimenuitem>Unmount device</guimenuitem> from the pop-up menu,
or by using the disk mount applet.
</para>
<para>
- Note that you can't unmount a drive if it is being used by some program;
- for example, if you have a terminal windows open in a directory on the
- drive you're trying to unmount. So, if you get the error message "Device
- busy" while trying to unmount a drive, make sure that none of your open
- applications is accessing a file or directory on this drive.
+ Note that you can't unmount a drive if it is being used by some
+ program; for example, if you have a terminal windows open in a
+ directory on the drive you're trying to unmount. So, if you get
+ the error message <quote>Device busy</quote> while trying to
+ unmount a drive, make sure that none of your open applications
+ is accessing a file or directory on this drive.
</para>
<para>
However, GNOME cannot prevent you from ejecting the disk using the
@@ -527,24 +532,26 @@
</para>
</important>
- <para> Some systems are running a special program, called the
- automount <emphasis>daemon</emphasis> (you do not need to know
- what a daemon is),
- which automatically mounts a drive when a disk is inserted and unmounts a
+ <para> Some systems are running special programs such as
+ <application>supermount</application> or
+ <application>magicdev</application>
+ which automatically mount a drive when a disk is inserted and unmount a
drive if it hasn't been used for a specified period of time. In
this case, you will probably never need to worry about
- mounting/unmounting drives yourself.
+ mounting/unmounting drives yourself; you don't even need to read
+ this section.
</para>
<para>
- Allowing users to mount and unmount drives carries some security risks,
- so many systems are configured so that only root can mount or unmount
- drives. This is the most probable cause of error messages while trying
- to mount a drive. In this case, discuss this matter with your system
- administrator.
+ Allowing users to mount and unmount drives carries some security
+ risks, so many multi-user systems are configured so that only
+ root can mount or unmount drives. This is the most probable
+ cause of error messages you may be getting while trying to mount
+ a drive. In this case, discuss this matter with your system
+ administrator.
</para>
<para>
- If the computer is your personal workstation or home computer,
- so that you are not worried about security, you can give mount
+ If the computer is your personal workstation or home computer
+ and you are not worried about security, you can give mount
permission to ordinary users. The easiest way to allow this is
to use the application
<application><emphasis>linuxconf</emphasis></application> (which
@@ -555,19 +562,21 @@
be mountable by users.
</para>
<para>
- If <application><emphasis>linuxconf</emphasis></application> is not
- available, then you must manually edit the file
- <filename>/etc/fstab</filename> to include user access. This is done
- by adding the "user" attribute to the drive. For example:
+ If <application><emphasis>linuxconf</emphasis></application> is
+ not available, then you must manually edit the file
+ <filename>/etc/fstab</filename> to include user access. This is
+ done by adding the <quote>user</quote> attribute to the
+ drive. For example:
</para>
<para>
- If your fstab file contains a line like this:
+ If your <filename>fstab</filename> file contains a line like
+ this:
</para>
<programlisting>
/dev/cdrom /mnt/cdrom iso9660 exec,dev,ro,noauto 0 0
</programlisting>
<para>
- add the word "user" to the fourth column:
+ add the word <quote>user</quote> to the fourth column:
</para>
<programlisting>
/dev/cdrom /mnt/cdrom iso9660 user,exec,dev,ro,noauto 0 0
@@ -577,25 +586,25 @@
<sect1 id="devices">
<title>Drives and devices</title>
<para>
- Under UNIX, the word "device" is used for all peripheral
- devices connnected to your computer; this includes hard drives,
- floppy and CD-ROM drives, audio and video cards, serial and
- parallel ports, and much more. Each device has a name, such as
- <filename>/dev/hda</filename>. The most common device names are
- listed below.
+ Under UNIX, the word <quote>device</quote> is used for all
+ peripheral devices connected to your computer; this includes
+ hard drives, floppy and CD-ROM drives, audio and video cards,
+ serial and parallel ports, and much more. Each device has a
+ name, such as <filename>/dev/hda</filename>. The most common
+ device names are listed below (for Linux; other varieties of
+ UNIX may use slightly different device names).
</para>
<itemizedlist>
- <listitem><para>
- <filename>/dev/hd*</filename> (where *=a,b,c, &hellip;):
- these are IDE devices, such as hard drives, CD-ROM drives
- and ZIP drives. <filename>/dev/hda</filename> denotes the
- master drive on the first IDE controller (usually your first
- hard drive, <filename>C:</filename> under Windows),
- <filename>/dev/hdb</filename> is the slave drive on the fist
- controller (this can be a second hard drive or a CD-ROM),
- and so on. See also the <link linkend="zippartition">note</link> below
- about ZIP drives.
- </para></listitem>
+ <listitem><para> <filename>/dev/hd*</filename> (where *=a,b,c,
+ &hellip;): these are IDE devices, such as hard drives,
+ CD-ROM drives and ZIP drives. <filename>/dev/hda</filename>
+ denotes the master drive on the first IDE controller
+ (usually your first hard drive, <filename>C:</filename>
+ under Windows), <filename>/dev/hdb</filename> is the slave
+ drive on the fist controller (this can be a second hard
+ drive or a CD-ROM), and so on. See also the <link
+ linkend="zippartition">note</link> below about ZIP drives.
+ </para></listitem>
<listitem><para>
<filename>/dev/sd*</filename> (where *=a,b,c, &hellip;):
@@ -634,7 +643,7 @@
</listitem>
<listitem><para> <filename>/dev/ttyS*</filename> (where *=0,1,
etc) are serial ports; these ports are commonly used for
- connnecting a mouse or a
+ connecting a mouse or a
modem. <filename>/dev/ttyS0</filename> corresponds to
<filename>COM1</filename> under Windows,
<filename>/dev/ttyS1</filename> to <filename>COM2</filename>,
@@ -672,33 +681,33 @@
symlink <filename>/dev/modem</filename>).
</para>
<para> And just for fun: there is also a device
- <filename>/dev/null</filename> which acts as a "black hole": you
- can send to it any information, and it never returns. So if you do
- not want to be bothered by error messages, re-direct them to
- <filename>/dev/null</filename> -:).
+ <filename>/dev/null</filename> which acts as a <quote>black
+ hole</quote>: you can send to it any information, and it never
+ returns. So if you do not want to be bothered by error messages,
+ re-direct them to <filename>/dev/null</filename> -:).
</para>
<sect2 id="partitions">
<title>Partitions</title>
<para>
- Note that it is possible to subdivide a hard
- drive (or a similar device) into parts which for all practical
- purposes behave as independent disks, even though physically
- they reside on the same disk. These parts are called
- "partitions" (under Windows, the name "logical disk" is
- used). For example, you can partition your hard drive into
- several partitions, and install different operating systems in
- different partitions; you can reformat each partition
- independently of the others. This partitioning of the hard
- drive is usually done during the installation of the operating
- system; refer to your installation guide for more
- information.
+ Note that it is possible to subdivide a hard drive (or a
+ similar device) into parts which for all practical purposes
+ behave as independent disks, even though physically they
+ reside on the same disk. These parts are called
+ <quote>partitions</quote> (under Windows, the name
+ <quote>logical disk</quote> is used). For example, you can
+ partition your hard drive into several partitions, and install
+ different operating systems in different partitions; you can
+ reformat each partition independently of the others. This
+ partitioning of the hard drive is usually done during the
+ installation of the operating system; refer to your
+ installation guide for more information.
</para>
<para>
- If your hard drive has been partitioned, then each partition
+ If your hard drive has been partitioned then each partition
is considered as a separate device. For example, if your hard
drive is <filename>/dev/hda</filename>, then the first
- partition on this drive would be referrred to as
+ partition on this drive would be referred to as
<filename>/dev/hda1</filename>, the second as
<filename>/dev/hda2</filename>, and so on.
</para>
@@ -708,7 +717,7 @@
<para> For reasons unknown to us, the pre-formatted
ZIP disks sold in stores or formatted using Iomega's ZIP
tools under Windows are partitioned in a strange way:
- they have only one parition (of Windows type, of course),
+ they have only one partition (of Windows type, of course),
but this partition has number 4. Thus, if your ZIP drive is
<filename>/dev/hdc</filename>, the correct device name you
should use for such disks is <filename>/dev/hdc4</filename>.
@@ -716,4 +725,68 @@
</warning>
</sect2>
</sect1>
+ <sect1 id="X11">
+ <title>Graphical user interface: X Window System, window
+ managers, and desktop environments.</title>
+ <para>
+ UNIX is a modular system: it consists of many components so that
+ a user (or system administrator) can choose those components he
+ needs. In particular, there are several layers of software
+ responsible for graphical user interface. These layers are: X
+ Window System, window managers, and desktop environment.
+ </para>
+ <para> <emphasis>X Window System</emphasis> (also known as X, or
+ X11) is the component of UNIX systems responsible for virtually
+ all basic graphics &mdash; in particular, for drawing icons,
+ backgrounds, and windows in which your applications
+ work. Without X, you only have command line. X11 sets the screen
+ resolution and color depth, moves the mouse cursor around the
+ screen, etc. It serves as a foundation for other components of
+ graphical user interface such as window managers and desktop
+ environments.
+ </para>
+ <para> <emphasis>Window manager</emphasis> extends capabilities of
+ X Window System by placing borders and buttons around windows,
+ which allows the user to move, close, hide or resize the
+ windows. X11 is virtually always used in combination with a
+ window manager, since it would be pretty much unusable without
+ one. There are many window managers available for X11; most
+ popular are <application>fvwm</application>,
+ <application>mwm</application>, <application>kwm</application>
+ (used by KDE), <application>Enlightenment</application>, and
+ <application>Sawfish</application>.
+ </para>
+ <para> Finally, a <emphasis>desktop environment</emphasis> goes
+ one more step further than a window manager by adding a
+ graphical file manager from which you can drag-and-drop items on
+ your desktop, a panel which can be used to launch frequently
+ used applications, and a set of applications and utilities.
+ There are several desktop environments available for all
+ versions of UNIX; the most popular ones are <ulink type="http"
+ url="http://www.gnome.org">GNOME</ulink>, <ulink type="http"
+ url="http://www.kde.org">KDE</ulink> and <ulink type="http"
+ url="http://www.sun.com/solaris/cde/">CDE</ulink> (soon to be
+ replaced by GNOME).
+ </para>
+ <para> Most desktop environments contain a window manager as their
+ integral part; for example, KDE contains its own window manager,
+ <application>kwm</application> (it is possible to use KDE with
+ another window manager, but few people do so). GNOME has no
+ window manager of its own; it will allow you to choose any
+ window manager you already have on your system. To make life
+ easier for new users, usually the
+ <application>Sawfish</application> window manager is distributed
+ with GNOME and is used by default; you can switch to
+ another window manager using <application>GNOME Control
+ Center</application>. Note however that you will need a
+ GNOME-compliant window manager to use such features of GNOME as
+ session management, taskbar applet, etc.
+ </para>
+
+ </sect1>
+
+
</appendix>
+
+
+
diff --git a/gnome-users-guide/gnome-users-guide-1.4/C/wheeler.sgml b/gnome-users-guide/gnome-users-guide-1.4/C/wheeler.sgml
index e3d190a..4c01545 100644
--- a/gnome-users-guide/gnome-users-guide-1.4/C/wheeler.sgml
+++ b/gnome-users-guide/gnome-users-guide-1.4/C/wheeler.sgml
@@ -70,9 +70,11 @@
GNOME Web Site</ulink> to find out more information on translation.
</para>
<para>
- GNOME is rapidly developing, so some parts of this guide may be not up to
- date; in these cases, please use on-line help in the application you are
- having trouble with.
+ This guide describes GNOME 1.4, which is the latest (as of March
+ 2001) release of GNOME. GNOME is rapidly developing, so by the
+ time you read this some parts of
+ this guide may be not up to date; in these cases, please use on-line
+ help in the application you are having trouble with.
</para>
<para>
This manual was written by Dave Mason (<email>dcm@redhat.com</email>),