[gnome-devel-docs] terms-complete: Starting to add some terms

[Shaun McCance <shaunm src gnome org>]

commit e02f2da08062a87d5383869a3277e3acd5d5c256
Author: Shaun McCance <shaunm gnome org>
Date:   Tue Sep 27 12:44:24 2011 -0400

    terms-complete: Starting to add some terms

 style-guide/terms-complete.page |   77 +++++++++++++++++++++++++++++++++------
 1 files changed, 66 insertions(+), 11 deletions(-)
---
diff --git a/style-guide/terms-complete.page b/style-guide/terms-complete.page
index 46ad6e7..79a05ae 100644
--- a/style-guide/terms-complete.page
+++ b/style-guide/terms-complete.page
@@ -1,21 +1,76 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic"
+      xmlns:gloss="http://projectmallard.org/experimental/gloss/";
+      xmlns:rev="http://projectmallard.org/experimental/review/";
+      type="gloss:glossary"
       id="terms-complete">
 
-  <info>
+<info>
   
-    <link type="guide" xref="index#terms"/>
+  <link type="guide" xref="index#terms"/>
     
-    <desc>A complete list of terminology recommendations.</desc>
+  <desc>A complete list of terminology recommendations.</desc>
     
-    <revision pkgversion="3.0" version="0.1" date="2010-12-23" status="stub"/>
+  <revision pkgversion="3.0" version="0.1" date="2010-12-23" status="stub"/>
     
-    <credit type="author">
-      <name>GNOME Documentation Project</name>
-      <email>gnome-doc-list gnome org</email>
-    </credit>
-    
-  </info>
+  <credit type="author">
+    <name>GNOME Documentation Project</name>
+    <email>gnome-doc-list gnome org</email>
+  </credit>
+
+  <gloss:term id="backup" rev:date="2011-09-27" rev:status="proposed">
+    <title>back up</title>
+    <title>backup</title>
+    <p>Copy files to another location as a precaution in case of loss of the original files.
+    Spell with two words as a verb, one word as a noun or adjective. Do not split âbackâ and
+    âupâ when used as a verb.</p>
+    <list style="compact">
+      <title>Correct</title>
+      <item><p>Back up your files regularly.</p></item>
+      <item><p>Create a backup of your files.</p></item>
+    </list>
+    <list style="compact">
+      <title>Incorrect</title>
+      <item><p>Back your files up regularly.</p></item>
+      <item><p>Backup your files regularly.</p></item>
+      <item><p>Create a back up of your files.</p></item>
+    </list>
+  </gloss:term>
+  <gloss:term id="cursor" rev:date="2011-09-27" rev:status="proposed">
+    <title>cursor</title>
+    <p>A symbol indicating where text will be inserted or deleted when the user types.
+    The term âtext cursorâ is redundant, but sometimes useful. Do not use âcaretâ unless
+    you need to refer to the use of that term in some piece of software. The cursor is
+    the visual representation that indicates the insertion point. Do not use âinsertion
+    pointâ unless you need to be very pedantic.</p>
+    <p>Do not use âcursorâ as a synonym for âpointerâ.</p>
+  </gloss:term>
+  <gloss:term id="pointer" rev:date="2011-09-27" rev:status="proposed">
+    <title>pointer</title>
+    <p>The arrow or other symbol that moves when the user moves the pointing device and
+    indicates where on the screen clicks will go. Use âpointerâ even when it takes on a
+    shape other than an arrow, although you may use a descriptive adjective, such as
+    âhand pointerâ, âI-beam pointerâ, or âresize pointerâ.</p>
+  </gloss:term>
+  <gloss:term id="screenshot" rev:date="2011-09-27" rev:status="proposed">
+    <title>screenshot</title>
+    <p>An image showing the display of the screen or an area of the screen. Spell as one word;
+    do not use âscreen shotâ or âscreen-shotâ. Do not use âscreen grabâ, âscreen captureâ, or
+    any other term. Do not use âscreenshotâ as a verb. Write âtake a screenshotâ instead. Do
+    not use âscreenshootâ or any variant.</p>
+  </gloss:term>
+  <gloss:term id="top-bar" rev:date="2011-09-27" rev:status="proposed">
+    <title>top bar</title>
+    <p>The bar at the top of the screen containing <gui>Activities</gui>, the clock, and
+    the system status area. Do not use âtop panelâ. Menus are âon the top barâ, not
+    âin the top barâ.</p>
+  </gloss:term>
+  <gloss:term id="windows-key" rev:date="2011-09-27" rev:status="proposed">
+    <title>windows key</title>
+    <p>The key that has a Windows logo on most PC keyboards. This key is mapped to Super, and
+    activates the overview. Prefer this term over âlogo keyâ or âsuper keyâ, as it's more likely
+    to be recognized by users. Do not capitalize âwindowsâ. Do not use mark up the key name.</p>
+  </gloss:term>
+</info>
 
 <title>Complete list of terms</title>