GNOME.org
 

Patch for increased readability of Tomboy help files

This is just a small patch to increase the readability of the new Tomboy help files. Commas have been added where I felt it was appropriate, as well as wording being changed in several places. Hopefully, this improves the readability of the documents. 

Thanks!
Harold

diff --git a/help/C/addins-formatting.page b/help/C/addins-formatting.page
index 3902ff3..c38c37c 100644
--- a/help/C/addins-formatting.page
+++ b/help/C/addins-formatting.page
@@ -23,7 +23,7 @@
 
 <section id="fixedwidth">
   <title>Fixed Width Addin</title>
-  <p>The Fixed Width addin changes your to be fixed width in the Tomboy note.
+  <p>The Fixed Width addin changes your text to be of a fixed width in the Tomboy note.
 	This addin is disabled by default.  To enable, press the <gui> Enable
 	</gui> button.</p>
 </section>
@@ -33,8 +33,8 @@
   <p>The Underline addin allows you to underline specific text in your note using
 	the <gui>Text</gui> icon in a note toolbar.  This addin is disabled by
 	 default.  To enable, press the <gui>Enable</gui> button.  Highlight
-	the text you would like to underline and then press the <gui>Text</gui>
-	icon in the note toolbar and choose <gui>Underline</gui> or press
+	the text you would like to underline, press the <gui>Text</gui>
+	icon in the note toolbar, and choose <gui>Underline</gui> or press
 	<keyseq><key>CONTROL + U</key></keyseq>.</p>
 </section>
 
diff --git a/help/C/addins-sync.page b/help/C/addins-sync.page
index 0d850c3..91a7b4c 100644
--- a/help/C/addins-sync.page
+++ b/help/C/addins-sync.page
@@ -38,7 +38,7 @@
   <p>The SSH Sync Service allows you to sync your notes with another computer
 	via the SSH protocol.  This plugin is disabled by default.  You may
 	need to install the <em>sshfs</em> pacakge for your Linux distribution
-	to make this addin work which is outside the scope of this help 
+	to make this addin work, which is outside the scope of this help 
 	document.</p>
 </section>
 
@@ -54,8 +54,7 @@
 <section id="webservice">
   <title>Web Sync Service</title>
   <p>The Web Sync Service addin allows you to sync your notes to a remote 
-	web server or service, such as Tomboy Online.  As of the time of the
-	 writing of this document the Tomboy Online service has not launched.</p>
+	web server or service, such as Tomboy Online.  At the time of writing, the Tomboy Online service has not launched.</p>
 </section>
 
  </page>
diff --git a/help/C/addins-tools.page b/help/C/addins-tools.page
index 3937b53..e531def 100644
--- a/help/C/addins-tools.page
+++ b/help/C/addins-tools.page
@@ -35,7 +35,7 @@
   <title>Export to HTML</title>
   <p>The <gui>Export to HTML</gui> addin is enabled by default and will export
 	an individual note to HTML.</p>
-	<p>To export a note to HTML press the <gui>Tools</gui> icon in the note
+	<p>To export a note to HTML, press the <gui>Tools</gui> icon in the note
 	toolbar and choose <gui>Export to HTML</gui>.  You will immediately be
 	presented with a dialog to save the note.  Choose the directory you 
 	wish to save the note in and change the name of note's new html file if 
@@ -45,7 +45,7 @@
 
 <section id="timestamp">
   <title>Insert Timestamp</title>
-  <p>The <gui>Insert Timestamp</gui> addin is disabled by default.  To enable,
+  <p>The <gui>Insert Timestamp</gui> addin is disabled by default.  To enable it,
 	choose the <gui>Insert Timestamp</gui> addin and then press
 	<gui>Enable</gui> in the Tomboy Preferences.</p>
 	<p>To add a timestamp to your notes, press the <gui>Tools</gui> icon in
diff --git a/help/C/create-note.page b/help/C/create-note.page
index 7dedab5..2215114 100644
--- a/help/C/create-note.page
+++ b/help/C/create-note.page
@@ -25,13 +25,13 @@
   <title>Create a new note</title>    
   
   <p>You can create a new note in Tomboy by clicking on the Tomboy icon in the 
-  GNOME panel, Windows taskbar or OS X dock and then choosing 
+  GNOME panel, Windows taskbar, or OS X dock, and then choosing 
   <gui>Create New Note</gui>.  You can also use the keyboard shortcuts by 
   pressing <keyseq><key>Alt + F12</key></keyseq>.</p>
   
   <p>The new note will display a new window with the title New Note <em>N</em>.
   The note contains a toolbar, with options to search your notes, link notes, 
-  format the text wihin a note and more.  For more information, see 
+  format the text wihin a note, and more.  For more information, see 
   <link xref="edit-notes"/>.
   </p>
 	
diff --git a/help/C/delete-notes.page b/help/C/delete-notes.page
index 41860e7..99d5d8b 100644
--- a/help/C/delete-notes.page
+++ b/help/C/delete-notes.page
@@ -28,9 +28,9 @@
   toolbar of the note you wish to delete.</p>
   
 <note style="warning">
-	<p>Deleting a note is permanent.  You will be prompted <gui>Really delete 
-	this note?</gui> when deleting a note and after deletion the note is 
-	not recoverable.</p>
+	<p>Deleting a note is permanent.  After deletion, the note is 
+	not recoverable.</p>  You will be prompted <gui>Really delete 
+	this note?</gui> when deleting a note.  
 </note>
 	
 </page>
diff --git a/help/C/edit-note.page b/help/C/edit-note.page
index d60502d..464b153 100644
--- a/help/C/edit-note.page
+++ b/help/C/edit-note.page
@@ -26,7 +26,7 @@
   
 		<p>Tomboy Notes allows you to format the text within a note in 
 		a number of different ways, including undo and redo, bold, 
-		italics, underline and more.</p>
+		italics, underline, and more.</p>
 		
    <section id="redo-undo">
 	
@@ -37,7 +37,7 @@
 		icon in the toolbar and choose <gui>Undo</gui>.</p>
 
 		<p>If you want to redo a word or text after using Undo, 
-		press <gui>Text</gui> icon in the toolbar and choose 
+		press the <gui>Text</gui> icon in the toolbar and choose 
 		<gui>Redo</gui>.</p>
 	
   </section>
@@ -47,8 +47,8 @@
 	<title>Formatting Text</title>
 	
 		<p>You can format the text of your notes in a number of 
-		different ways, including underlining words
-		making text bold or italics, highlighting words or phrases 
+		different ways, including underlining words,
+		making text bold or italics, highlighting words or phrases, 
 		or striking through text.</p>
   </section>
 	 
@@ -75,7 +75,7 @@
 		<p>To manually create a bullet, type the asterisk key 
 		<key>*</key> and then type your text.  After pressing
 		enter, Tomboy will automatically convert a line starting 
-		with an asterisk into a bullet and the next
+		with an asterisk into a bullet, and the next
 		line will be auto-formatted as a bullet as well.  If you want 
 		to create a sub-bullet, press <key>Tab</key>
 		immediately after pressing <key>Enter</key>.</p>
diff --git a/help/C/hotkeys.page b/help/C/hotkeys.page
index a383a41..1153be4 100644
--- a/help/C/hotkeys.page
+++ b/help/C/hotkeys.page
@@ -24,7 +24,7 @@
 
 	<p>Hotkeys allow you to access your notes and Tomboy features from
 	anywhere, even when using other applications on your desktop.  Hotkeys
-	are activated by pressing keys on your multiple keys on your keyboard
+	are activated by pressing multiple keys on your keyboard
 	together.
 	</p>
 	
diff --git a/help/C/introduction.page b/help/C/introduction.page
index 350062d..5572aa5 100644
--- a/help/C/introduction.page
+++ b/help/C/introduction.page
@@ -24,8 +24,8 @@
   <title>Introduction</title>
 
   <p>
-    <app>Tomboy</app> is a note taking application for the GNOME Desktop, Microsoft Windows and Mac OS X.
-    Tomboy is simple and easy to use, and helps you organize the ideas and information you work
+    <app>Tomboy</app> is a note taking application for the GNOME Desktop, Microsoft Windows, and Mac OS X.
+    <app>Tomboy</app> is easy to use, and helps you organize the ideas and information you work
     with everyday.
   </p>
   <p>
@@ -34,7 +34,7 @@
     also organize multiple notes in a notebook to make grouping notes together easier.
   </p>
   <p>
-    You can also sync your notes across multiple computers making it easy to take your notes with you 
+    You can also sync your notes across multiple computers, making it easy to take your notes with you 
     wherever you are.
   </p>
 
diff --git a/help/C/note-edit-prefs.page b/help/C/note-edit-prefs.page
index 1512ffd..7277f69 100644
--- a/help/C/note-edit-prefs.page
+++ b/help/C/note-edit-prefs.page
@@ -26,10 +26,10 @@
  	in Tomboy.  To change your note settings, open
  	 <gui>Tomboy Preferences</gui> by 
 	using your mouse to right click on the Tomboy icon in your panel,
-	taskbar or dock and choose <gui>Preferences</gui> and then select
+	taskba,r or dock, and choose <gui>Preferences</gui> and  select
 	the <gui>Hotkeys</gui> tab.  You can also open <gui> Tomboy
 	Preferences</gui> from the <gui>Search All Notes</gui> dialog. From
-	the menu choose <guiseq><gui>Edit</gui><gui>Preferences</gui>
+	the menu, choose <guiseq><gui>Edit</gui><gui>Preferences</gui>
 	</guiseq>.
 	</p>
  
@@ -37,7 +37,7 @@
    <title>Spell Check</title>
    <p>Tomboy can check the spelling of your words as you type in a note.
    Spell check is enabled by default and Tomboy will underline any 
-   misspelled words and you can see spelling suggestions by using your mouse
+   misspelled words.  You can see spelling suggestions by using your mouse
    to right click on the misspelled word.
    </p>
    
@@ -55,7 +55,7 @@
    the link will create a new note with the WikiWord as the note title.
    </p>
    
-   <p>WikiWords are disabled by default.  To enable WikiWords use your mouse
+   <p>WikiWords are disabled by default.  To enable WikiWords, use your mouse
    or the spacebar to check the box to enable <gui>Highlight WikiWords</gui> in
     the <gui>Editing</gui> tab of Tomboy's Preferences.</p>
    
@@ -66,7 +66,7 @@
    <p>Tomboy can create bulleted list automatically.  This option is enabled
    by default and when you are editing a note, typing <key>*</key> followed
    by the text and pressing <key>Enter</key> will automatically create a 
-   bulleted list.  After pressing <key>Enter</key> the next line will start 
+   bulleted list.  After pressing <key>Enter</key>, the next line will start 
    with a bullet too.
    </p>
    
@@ -86,9 +86,9 @@
    to uncheck <gui>Use custom font</gui> in the <gui>Editing</gui>
    tab of Tomboy's Preferences.</p>
 
-   <p>You can then press the font button and a font dialog box will appear
-    allowing you to choose which font you wish to use, the style such as bold
-    or italic and the size of the font.  Press <key>Ok</key> to save your 
+   <p>You can then press the font button and a font dialog box will appear,
+    allowing you to choose which font you wish to use, the style, such as bold
+    or italic, and the size of the font.  Press <key>Ok</key> to save your 
     selection.</p>
    
  </section>
@@ -99,7 +99,7 @@
    <p>Tomboy automatically creates links between notes when you type the
    title of a saved note in your current note.  If you try to rename a note
    that has links to it in other notes in Tomboy, you can choose the default
-   behavior Tomboy should do when detecting a change.  Your options include:
+   behavior Tomboy should use when detecting a change.  Your options include:
    </p>
    
    <list>
@@ -127,7 +127,7 @@
   <gui>Editing</gui> tab of Tomboy's Preferences. A new template will be
   displayed that looks similar to a Tomboy Note.  Replace the <gui>Describe
   your new note here.</gui> text in the note with the text that should be the
-  new template.  Close the note and you have completed creating a new template.
+  new template.  Close the note to complete creating a new template.
   Each time you create a new note that template will be displayed in the new 
   note.</p>
    
diff --git a/help/C/search.page b/help/C/search.page
index 581396b..e890fd5 100644
--- a/help/C/search.page
+++ b/help/C/search.page
@@ -29,9 +29,9 @@
 	the <gui>Search</gui> icon in a note's toolbar to bring up the 
 	Search All Notes dialog.</p>
 	<p>Enter your search term in the <gui>Search</gui> box and press
-	<key>Enter</key> and all notes containing your search term will be listed.</p>
+	<key>Enter</key>, and all notes containing your search term will be listed.</p>
 	<p>If you have organized your notes into notebooks, you can also search
 	for specific terms only in that notebook by selecting the notebook
-	you want to search first and then entering your search criteria.</p>
+	you want to search and then entering your search criteria.</p>
 
  </page>
diff --git a/help/C/sync-setup.page b/help/C/sync-setup.page
index 313ff85..c185a6e 100644
--- a/help/C/sync-setup.page
+++ b/help/C/sync-setup.page
@@ -122,7 +122,7 @@
 	</p>
 	
 	<p>In Tomboy, choose <gui>SSH</gui> from the <gui>Service</gui>
-	drop-down list. Fill in the connection information for your server, and 	then select the <gui>Save</gui> button.  The <gui>Folder Path</gui>, 
+	drop-down list. Fill in the connection information for your server, and select the <gui>Save</gui> button.  The <gui>Folder Path</gui>, 
 	while optional, should point at an empty folder. You are now ready to 		synchronize your notes.</p>
 
  </section>
@@ -137,7 +137,7 @@
 
 	<p>Choose Local Folder from the <gui>Service</gui>
 	drop-down list. Choose the desired synchronization 
-	<gui>Folder Path</gui> and then select the <gui>Save</gui> button.  
+	<gui>Folder Path</gui> and then click the <gui>Save</gui> button.  
 	You are now ready to synchronize your notes.</p>
 
  </section>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]