[PATCH] g-h: Various edits in a11y-*, backup-*, and shell-* for clarity and consistency.
- From: Kelly Sinnott <ksinnott5ht gmail com>
- To: gnome-doc-list gnome org
- Subject: [PATCH] g-h: Various edits in a11y-*, backup-*, and shell-* for clarity and consistency.
- Date: Fri, 27 May 2011 10:25:55 -0700
Hi all,
I realize that I committed kind of a faux pas by pushing all these changes to git without checking with anyone, and with including them all at once. To be honest I'm still getting the hang of git as well as the whole open source order of things. In any case, here is my ugly mega-patch, feel free to criticize and pick it apart. (There are some grammar things that I realize might be up for debate.) Once again, my apologies if I overstepped my bounds. (I'm just so excited to get started on my OPW internship!)
--
Regards,
Kelly Sinnott
From ad8dc571c5d06fb8f1180bb5a3f3227d99a28c7f Mon Sep 17 00:00:00 2001
From: Kelly Sinnott <ksinnott5ht gmail com>
Date: Tue, 24 May 2011 14:21:14 -0700
Subject: [PATCH] g-h: Various edits in a11y-*, backup-*, and shell-* for
clarity and consistency.
GNOME Bugzilla bug: https://bugzilla.gnome.org/show_bug.cgi?id=650980
modified: gnome-help/C/files-search.page
modified: gnome-help/C/a11y-icon.page
modified: gnome-help/C/a11y-mag.page
modified: gnome-help/C/backup-check.page
modified: gnome-help/C/backup-frequency.page
modified: gnome-help/C/backup-how.page
modified: gnome-help/C/backup-thinkabout.page
modified: gnome-help/C/backup-what.page
modified: gnome-help/C/files-search.page
modified: gnome-help/C/shell-apps-open.page
modified: gnome-help/C/shell-notifications.page
modified: gnome-help/C/shell-terminology.page
---
gnome-help/C/a11y-icon.page | 13 ++++++++++---
gnome-help/C/a11y-mag.page | 6 ++++--
gnome-help/C/backup-check.page | 10 +++++++---
gnome-help/C/backup-frequency.page | 10 +++++++---
gnome-help/C/backup-how.page | 19 +++++++++++++------
gnome-help/C/backup-thinkabout.page | 26 +++++++++++++++++++-------
gnome-help/C/backup-what.page | 18 +++++++++++++-----
gnome-help/C/files-search.page | 6 +++++-
gnome-help/C/shell-apps-open.page | 2 +-
gnome-help/C/shell-notifications.page | 4 ++--
gnome-help/C/shell-terminology.page | 4 ++--
11 files changed, 83 insertions(+), 35 deletions(-)
diff --git a/gnome-help/C/a11y-icon.page b/gnome-help/C/a11y-icon.page
index 95c7578..636044e 100644
--- a/gnome-help/C/a11y-icon.page
+++ b/gnome-help/C/a11y-icon.page
@@ -12,19 +12,26 @@
<email>philbull gmail com</email>
</credit>
- <desc>The universal access menu is the icon on the top bar that looks like a man.</desc>
+ <desc>The universal access menu is the icon on the top bar that looks like a person.</desc>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
</info>
<title>Find the universal access menu</title>
-<p>The <em>universal access menu</em> is where you can turn on various accessibility settings. You can find this menu by clicking the icon which looks like a man surrounded by a circle on the top bar.</p>
+
+<p>The <em>universal access menu</em> is where you can turn on various accessibility settings.
+You can find this menu by clicking the icon which looks like a person surrounded by a circle on the top bar.</p>
<figure>
<desc>The universal access menu can be found on the top bar.</desc>
<media type="image" mime="image/png" src="figures/universal-access-menu.png"/>
</figure>
-<p>To access this menu using the keyboard rather than the mouse, press <keyseq><key>Ctrl</key><key>Alt</key><key>Tab</key></keyseq> to move the keyboard focus to the top bar. A white line will appear underneath the <gui>Activities</gui> button - this tells you which item on the top bar is selected. Use the arrow keys on the keyboard to move the white line under the universal access menu icon and then press <key>Enter</key> to open it. You can use the up and down arrow keys to select items in the menu.</p>
+<p>To access this menu using the keyboard rather than the mouse, press
+<keyseq><key>Ctrl</key><key>Alt</key><key>Tab</key></keyseq> to move the keyboard focus to the top bar.
+A white line will appear underneath the <gui>Activities</gui> button - this tells you which item on the
+top bar is selected. Use the arrow keys on the keyboard to move the white line under the universal
+access menu icon and then press <key>Enter</key> to open it. You can use the up and down arrow keys
+to select items in the menu. Press <key>Enter</key> to toggle the selected item.</p>
</page>
diff --git a/gnome-help/C/a11y-mag.page b/gnome-help/C/a11y-mag.page
index 8858131..c553049 100644
--- a/gnome-help/C/a11y-mag.page
+++ b/gnome-help/C/a11y-mag.page
@@ -18,13 +18,15 @@
<title>Magnify the screen area</title>
-<p>Magnifying the screen is not just enlarging the <link xref="a11y-font-size">text size</link>. This feature is like having a magnifying glass, allowing you to move around by zooming in on parts of the screen.</p>
+<p>Magnifying the screen is different than just enlarging the <link xref="a11y-font-size">text size</link>.
+This feature is like having a magnifying glass, allowing you to move around by zooming in on parts of the screen.</p>
<steps>
<item><p>Click on the universal access icon in the top panel.</p></item>
<item><p>Turn <gui>Zoom</gui> <gui>ON</gui>.</p></item>
<item><p>Part of the screen will immediately become magnified.</p></item>
- <item><p>You can now move around the screen area. By moving your mouse to the edges of the screen, you will move the magnified area in different directions, allowing you to view your area of choice.</p></item>
+ <item><p>You can now move around the screen area. By moving your mouse to the edges of the screen, you will
+move the magnified area in different directions, allowing you to view your area of choice.</p></item>
</steps>
</page>
diff --git a/gnome-help/C/backup-check.page b/gnome-help/C/backup-check.page
index bf7e644..bba9943 100644
--- a/gnome-help/C/backup-check.page
+++ b/gnome-help/C/backup-check.page
@@ -19,13 +19,17 @@
After you have backed up your files, you should make sure that the backup was successful.
</p>
<p>
- A file integrity check is not done on a copy/move operation. This means if you are copying files to other drives/media, it is not easy to verify data integrity or to single out files that have failed.
+ A file integrity check is not done on a copy/move operation. This means if you are copying files to other drives/media,
+it is not easy to verify data integrity or to single out files that have failed.
</p>
<p>
- You can do a check by looking through the copied files and directories in the destination media. By opening and checking the copied files, you can see whether the files you check copied successfully.
+ You can do a check by looking through the copied files and directories in the destination media. By opening
+and checking the copied files, you can see whether the files you check copied successfully.
</p>
- <note style="tip"><p>If you find that you do regular backups of large amounts of data, you may find it easier to use a dedicated backup program, such as <app>Déjà Dup</app>. Such a program is more powerful and more reliable than just copying and pasting data.</p></note>
+ <note style="tip"><p>If you find that you do regular backups of large amounts of data, you may find it easier to
+use a dedicated backup program, such as <app>Déjà Dup</app>. Such a program is more powerful and more reliable than
+just copying and pasting data.</p></note>
<comment>
<cite date="2010-06-29" href="mailto:gnome-doc-list gnome org">GNOME Documentation Project</cite>
diff --git a/gnome-help/C/backup-frequency.page b/gnome-help/C/backup-frequency.page
index 63e050e..45406bd 100644
--- a/gnome-help/C/backup-frequency.page
+++ b/gnome-help/C/backup-frequency.page
@@ -20,7 +20,8 @@
<title>Frequency of backups</title>
-<p>How often you make backups will depend on the type of data to be backed up. For example, if you are running a network environment with critical data stored on your servers, then even nightly backups may not be enough.</p>
+<p>How often you make backups will depend on the type of data to be backed up. For example, if you are running a network environment
+with critical data stored on your servers, then even nightly backups may not be enough.</p>
<p>
On the other hand, if you are backing up the data on your home computer then you may need to factor in a few things, such as:
@@ -32,9 +33,12 @@ On the other hand, if you are backing up the data on your home computer then you
</list>
<p>
-If it is just some music, e-mails and family photos, then weekly or even monthly backups may suffice. However, if you happen to be in the middle of a tax audit, more frequent backups may be necessary.
+If the data you want to back up is lower priority or subject to few changes like music, e-mails and family photos, then
+weekly or even monthly backups may suffice. However, if you happen to be in the middle of a tax audit, more frequent backups may be necessary.
</p>
-<p>As a general rule, the amount of time in between backups should be no more than the amount of time you could stand to spend re-doing any lost work. For example, if spending a week re-writing lost documents is too long for you, you should back up at least once per week.</p>
+<p>As a general rule, the amount of time in between backups should be no more than the amount of time
+you are willing to spend re-doing any lost work. For example, if spending a week re-writing lost documents
+is too long for you, you should back up at least once per week.</p>
</page>
diff --git a/gnome-help/C/backup-how.page b/gnome-help/C/backup-how.page
index 55a3cc3..dd5b63f 100644
--- a/gnome-help/C/backup-how.page
+++ b/gnome-help/C/backup-how.page
@@ -20,17 +20,24 @@
<title>How to back up</title>
-<p>The easiest way of backing up your files and settings is to let a backup application manage the backup process for you. A number of different backup applications are available, for example <app>Déjà Dup</app>.</p>
+<p>The easiest way of backing up your files and settings is to let a backup application manage the backup process for you.
+A number of different backup applications are available, for example <app>Déjà Dup</app>.</p>
-<p>The help for your chosen backup application will walk you through setting your preferences for the backup, as well as how to restore your data if something goes wrong.</p>
+<p>The help for your chosen backup application will walk you through setting your preferences for the backup, as
+well as how to restore your data if something goes wrong.</p>
-<p>An alternative option is to just <link xref="files-copy">copy your files</link> to a safe location, such as an external hard drive, another computer on the network, or a USB drive. Your <link xref="backup-thinkabout">personal files</link> and settings are usually in your Home folder, so you can copy them from there.</p>
+<p>An alternative option is to <link xref="files-copy">copy your files</link> to a safe location, such as an
+external hard drive, another computer on the network, or a USB drive. Your <link xref="backup-thinkabout">personal files</link>
+and settings are usually in your Home folder, so you can copy them from there.</p>
-<p>The amount of data you can back up is limited by the size of the storage device. If you have the room on your backup device, it is best to back up the entire Home folder with the following exceptions:</p>
+<p>The amount of data you can back up is limited by the size of the storage device. If you have the room
+on your backup device, it is best to back up the entire Home folder with the following exceptions:</p>
<list>
- <item><p>Files that you have copied from a CD, DVD, or other removable media, since it would be faster to copy them again than to restore them from backup.</p></item>
- <item><p>Files that you can regenerate easily. For example, PDFs that can be generated from TeX files, or object files that can be made with the Make utility. Just ensure the source is backed up.</p></item>
+ <item><p>Files that you have copied from a CD, DVD, or other removable media, since it would be faster
+to copy them again than to restore them from backup.</p></item>
+ <item><p>Files that you can regenerate easily. For example, PDFs that can be generated from TeX files,
+or object files that can be made with the Make utility. These generated files are disposable as long as the source is backed up.</p></item>
<item><p>Your trashed files, which can be found in <cmd>~/.local/share/Trash</cmd> (the Trash folder).</p></item>
</list>
diff --git a/gnome-help/C/backup-thinkabout.page b/gnome-help/C/backup-thinkabout.page
index 5d8ae23..f74e6fa 100644
--- a/gnome-help/C/backup-thinkabout.page
+++ b/gnome-help/C/backup-thinkabout.page
@@ -22,22 +22,31 @@
<title>Where can I find the files I want to back up?</title>
<p>
-Deciding what files to backup and finding where they all are is the most difficult step when attempting to perform a backup. Below is a list of where most of your important files should be, so you can find them more easily.
+Deciding what files to back up and locating them is the most difficult step when attempting to perform a backup.
+Listed below are the most common locations of important files and settings that you may want to back up.
</p>
<terms>
<item>
<title>Your personal files and settings</title>
-<p>These are usually stored in your Home folder (<cmd>/home/your_name</cmd>). They could be in subfolders such as Desktop, Documents, Pictures, Music, Videos and/or .evolution (for email). If your backup medium has sufficient space, consider backing up the entire <cmd>/home</cmd> folder. This is the simplest way.</p>
+<p>These are usually stored in your <file>Home</file> folder (<cmd>/home/your_name</cmd>).
+They could be in subfolders such as <file>Desktop</file>, <file>Documents</file>,
+<file>Pictures</file>, <file>Music</file>, <file>Videos</file>
+and/or <file>.evolution</file> (for email). If your backup medium has
+sufficient space, consider backing up the entire <cmd>/home</cmd> folder.
+This is the simplest way.</p>
<p>
- If you are not able to backup all of <cmd>/home</cmd>, see below for a list of some subfolders of the <cmd>/home</cmd> folder to check for important files.
+ If you are not able to backup all of <cmd>/home</cmd>, see below for a list of some
+subfolders of the <cmd>/home</cmd> folder to check for important files.
</p>
<note>
<list>
<item><p><cmd>~/</cmd> represents your home folder <cmd>/home/your_name</cmd> </p></item>
- <item><p>Any file or folder name that starts with a period is hidden by default. To view hidden files, click <guiseq><gui>View</gui><gui>Show Hidden Files</gui></guiseq> or press <keyseq><key>Ctrl</key><key>H</key></keyseq>.
+ <item><p>Any file or folder name that starts with a period is hidden by default.
+To view hidden files, click <guiseq><gui>View</gui><gui>Show Hidden Files</gui></guiseq> or
+press <keyseq><key>Ctrl</key><key>H</key></keyseq>.
</p></item>
</list>
</note>
@@ -46,12 +55,15 @@ Deciding what files to backup and finding where they all are is the most difficu
<table shade="rows">
<tr>
- <td><p>Your personal files</p></td><td><p><cmd>~/</cmd>, <cmd>~/Desktop</cmd>, <cmd>~/Documents</cmd>, <cmd>~/Pictures</cmd>, <cmd>~/Music</cmd>, <cmd>Videos</cmd>, <cmd>~/bin</cmd>, and others</p></td> <td><p>Contain files you actively created.</p></td>
+ <td><p>Your personal files</p></td><td><p><cmd>~/</cmd>, <cmd>~/Desktop</cmd>,
+<cmd>~/Documents</cmd>, <cmd>~/Pictures</cmd>, <cmd>~/Music</cmd>, <cmd>Videos</cmd>, <cmd>~/bin</cmd>,
+and others</p></td> <td><p> Contain files you actively created.</p></td>
</tr>
<tr>
- <td><p>Your personal settings</p></td> <td><p><cmd>~/.config</cmd>, <cmd>~/.gconf</cmd>, <cmd>~/.gnome3</cmd>, <cmd>~/.local</cmd></p></td>
- <td><p>Contain settings you set for your desktop and some applications.</p></td>
+ <td><p>Your personal settings</p></td> <td><p><cmd>~/.config</cmd>, <cmd>~/.gconf</cmd>,
+<cmd>~/.gnome3</cmd>, <cmd>~/.local</cmd></p></td>
+ <td><p>Contain your settings for the desktop and some applications.</p></td>
</tr>
<tr>
<td><p>System settings</p></td> <td><p><cmd>/etc</cmd> located in the File System outside of your Home folder.</p></td>
diff --git a/gnome-help/C/backup-what.page b/gnome-help/C/backup-what.page
index 9713aa7..5e00802 100644
--- a/gnome-help/C/backup-what.page
+++ b/gnome-help/C/backup-what.page
@@ -21,23 +21,29 @@
<title>What to back up</title>
<p>
-Your priority should be to backup your <link xref="backup-thinkabout">most important files</link> as well as those that are difficult to recreate. An example of most important to least important:
+Your priority should be to backup your <link xref="backup-thinkabout">most important files</link> as
+well as those that are difficult to recreate. An example, ranked from most important to least important:
</p>
<terms>
<item>
<title>Your personal files </title>
- <p>Documents, spreadsheets, email, calendar appointments, financial data, family photos, anything that you made that has importance to you. These are clearly the most important as they may be irreplaceable.</p>
+ <p>This may include documents, spreadsheets, email, calendar appointments, financial data, family photos,
+or any other personal files that you would consider irreplaceable.</p>
</item>
<item>
<title>Your personal settings</title>
- <p> This includes changes you may have made to colors, backgrounds, screen resolution and mouse settings on your desktop. This also includes application preferences, such as settings for <app>LibreOffice</app>, your music player, and your email program. These are replaceable, but may take a while to recreate.</p>
+ <p> This includes changes you may have made to colors, backgrounds, screen resolution
+and mouse settings on your desktop. This also includes application preferences, such as settings
+for <app>LibreOffice</app>, your music player, and your email program. These are replaceable,
+but may take a while to recreate.</p>
</item>
<item>
<title>System settings</title>
-<p>Most people never change the settings that are created during installation. If you do customize your system, you may wish to backup these settings.
+<p>Most people never change the settings that are created during installation.
+If you do customize your system, you may wish to backup these settings.
</p>
</item>
@@ -48,6 +54,8 @@ Your priority should be to backup your <link xref="backup-thinkabout">most impor
</terms>
<p>
- In general, you will want to backup files that are irreplaceable and files that require a great time investment to replace without a backup. If things are easy to replace, on the other hand, you may not want to use up disk space by having backups of them.</p>
+ In general, you will want to backup files that are irreplaceable and files that require
+ a great time investment to replace without a backup. If things are easy to replace, on the other hand,
+you may not want to use up disk space by having backups of them.</p>
</page>
diff --git a/gnome-help/C/files-search.page b/gnome-help/C/files-search.page
index cf0e8fe..4920f16 100644
--- a/gnome-help/C/files-search.page
+++ b/gnome-help/C/files-search.page
@@ -70,6 +70,10 @@
<item><p>Give the search a name and click <gui>Save</gui>. If you
like, select a different folder to save the search in. When you
view that folder, you will see your saved search as an orange
- folder icon with a magnifying glass on it.</p></item>
+ folder icon with a magnifying glass on it. In order to remove the search file
+ when you are done with it, simply <link xref="files-delete">delete</link>
+the search as you would any other file. Please note that this saved
+search behaves like a file rather than a folder, and does not actually
+contain the items it lists. Deleting the search does not affect those files.</p></item>
</steps>
</page>
diff --git a/gnome-help/C/shell-apps-open.page b/gnome-help/C/shell-apps-open.page
index 92cdf2b..0b4932f 100644
--- a/gnome-help/C/shell-apps-open.page
+++ b/gnome-help/C/shell-apps-open.page
@@ -40,7 +40,7 @@
</item>
<item>
- <p>You can launch an application in a separate workspace by dragging an application's icon from the dash (or from the list of applications), and dropping it on one of the workspaces on the right-hand side of the screen. The application will open in the workspace that you choose.</p>
+ <p>You can launch an application in a separate <link xref="shell-workspaces">workspace</link> by dragging an application's icon from the dash (or from the list of applications), and dropping it on one of the workspaces on the right-hand side of the screen. The application will open in the workspace that you choose.</p>
</item>
</list>
diff --git a/gnome-help/C/shell-notifications.page b/gnome-help/C/shell-notifications.page
index 2ceb6b9..98a186e 100644
--- a/gnome-help/C/shell-notifications.page
+++ b/gnome-help/C/shell-notifications.page
@@ -23,13 +23,13 @@
<title>What's a notification?</title>
<p>If an application or a system component wants to get your attention, a notification will be shown at the bottom of the screen.</p>
<p>For example, if you get a new chat message, new updates are available for your computer, or your computerâ??s battery is low, you will get a notification informing you about that.</p>
-<p>The notification will first appear as a single line, so as to be least distracting. You can move your mouse over it if you want to see its full content.</p>
+<p>To minimize distraction, the notification will first appear as a single line. You can move your mouse over it if you want to see its full content.</p>
</section>
<section id="messagingtray">
<title>The Messaging Tray</title>
<p>The Messaging Tray gives you a way to get back to your notifications when it is convenient for you. It appears when you move your mouse to the bottom right corner of the screen and contains all the notifications that you have not acted upon or that permanently reside in it.</p>
-<p>You can view the notifications by clicking on the Messaging Tray items. The items in the Messaging Tray are usually applications that sent you notifications. However, chat notifications are given a special treatment and are represented by the individual contacts who sent you the chat messages.</p>
+<p>You can view the notifications by clicking on the Messaging Tray items. The items in the Messaging Tray are usually applications that sent you notifications. However, chat notifications are given special treatment and are represented by the individual contacts who sent you the chat messages.</p>
<p>The Messaging Tray is always visible in the Activities Overview.</p>
</section>
diff --git a/gnome-help/C/shell-terminology.page b/gnome-help/C/shell-terminology.page
index 8c8440b..8441adb 100644
--- a/gnome-help/C/shell-terminology.page
+++ b/gnome-help/C/shell-terminology.page
@@ -29,7 +29,7 @@
<item>
<title>Alt-Tab window switcher</title>
- <p>When you hold down the <key>Alt</key> key and then press <key>Tab</key>, a <em>window switcher</em> appears. This shows a list of the windows you have open, with a preview and the name of the currently-selected window.</p>
+ <p>When you hold down the <key>Alt</key> key and then press <key>Tab</key>, a <em>window switcher</em> appears. This shows a list of the windows you have open, with a preview and the name of the currently selected window.</p>
</item>
<item>
@@ -44,7 +44,7 @@
<item>
<title>Notifications</title>
- <p><em>Notifications</em> are messages that pop up at the bottom of the screen, telling you that something just happened. For example, when someone chatting with you sends a message, a message will pop up to tell you. If you don't want to deal with a message right now, it hides to your messaging tray. Move your mouse to the bottom-right corner to see your messaging tray.</p>
+ <p><em>Notifications</em> are messages that pop up at the bottom of the screen, telling you that something just happened. For example, when someone chatting with you sends a message, a message will pop up to tell you. If you don't want to deal with a message right now, it is hidden in your Messaging Tray. Move your mouse to the bottom-right corner to see your Messaging Tray.</p>
</item>
<item>
--
1.7.5.2
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
