[gnome-user-docs] Use <file> to tag parts of filenames



commit c3e17c46dda32738186f7f45b8d615775309d9fd
Author: Sebastian Rasmussen <sebras hotmail com>
Date:   Mon Sep 8 22:50:17 2014 +0200

    Use <file> to tag parts of filenames
    
    Consistency is good and while the previous patch archieved this
    it unfortunately settled on the wrong tag to use for identifying
    parts of file names. In this case <file> ought to be used as
    <key> is reserved for keystrokes and keyboard shortcuts.
    
    Fixes https://bugzilla.gnome.org/show_bug.cgi?id=736212

 gnome-help/C/files-hidden.page |   16 ++++++++--------
 gnome-help/C/files-lost.page   |    4 ++--
 gnome-help/C/files-rename.page |   16 ++++++++--------
 gnome-help/C/files-select.page |    4 ++--
 gnome-help/C/files-tilde.page  |    4 ++--
 5 files changed, 22 insertions(+), 22 deletions(-)
---
diff --git a/gnome-help/C/files-hidden.page b/gnome-help/C/files-hidden.page
index 153b0c8..8336442 100644
--- a/gnome-help/C/files-hidden.page
+++ b/gnome-help/C/files-hidden.page
@@ -26,14 +26,14 @@
   your discretion. When a file is hidden, it isn't displayed by the file
   manager, but it's still there in its folder.</p>
 
-  <p>To hide a file, <link xref="files-rename">rename it</link> with a <key>.</key>
-  at the beginning of its name. For example, to hide a file named <file>
-  example.txt</file>, you should rename it to <file>.example.txt</file>.
-  </p>
+  <p>To hide a file, <link xref="files-rename">rename it</link> with a
+  <file>.</file> at the beginning of its name. For example, to hide a file
+  named <file>example.txt</file>, you should rename it to
+  <file>.example.txt</file>.</p>
 
 <note>
   <p>You can hide folders in the same way that you can hide files. Hide a
-  folder by placing a <key>.</key> at the beginning of the folder's name.</p>
+  folder by placing a <file>.</file> at the beginning of the folder's name.</p>
 </note>
 
 <section id="show-hidden">
@@ -56,7 +56,7 @@
   <p>To unhide a file, go to the folder containing the hidden file and click
   the <media its:translate="no" type="image" src="figures/go-down.png"><span 
its:translate="yes">down</span></media> button in the
   toolbar and pick <gui>Show Hidden Files</gui>. Then, find the hidden file and
-  rename it so that it doesn't have a <key>.</key> in front of its name. For
+  rename it so that it doesn't have a <file>.</file> in front of its name. For
   example, to unhide a file called <file>.example.txt</file>, you should rename
   it to <file>example.txt</file>.</p>
 
@@ -71,8 +71,8 @@
   file manager will always show hidden files, see <link xref="nautilus-views"/>.
   </p></note>
 
-  <note><p>Most hidden files will have a <key>.</key> at the
-  beginning of their name, but others might have a <key>~</key> at the end of
+  <note><p>Most hidden files will have a <file>.</file> at the
+  beginning of their name, but others might have a <file>~</file> at the end of
   their name instead. These files are backup files. See
   <link xref="files-tilde"/> for more information.</p></note>
 </section>
diff --git a/gnome-help/C/files-lost.page b/gnome-help/C/files-lost.page
index 37c8d20..15960f6 100644
--- a/gnome-help/C/files-lost.page
+++ b/gnome-help/C/files-lost.page
@@ -47,8 +47,8 @@ follow these tips.</p>
   recover a deleted file.</p></item>
 
   <item><p>You might have renamed the file in a way that made the file hidden.
-  Files that start with a <key>.</key> or end with a <key>~</key> are hidden
-  in the file manager. Click the
+  Files that start with a <file>.</file> or end with a <file>~</file> are
+  hidden in the file manager. Click the
   <media its:translate="no" type="image" src="figures/go-down.png"><span 
its:translate="yes">down</span></media> button in the file
   manager toolbar and pick <gui>Show Hidden Files</gui> to display them. See
   <link xref="files-hidden"/> to learn more.</p></item>
diff --git a/gnome-help/C/files-rename.page b/gnome-help/C/files-rename.page
index fc34f5f..7b5b3df 100644
--- a/gnome-help/C/files-rename.page
+++ b/gnome-help/C/files-rename.page
@@ -42,7 +42,7 @@
   <link xref="nautilus-file-properties-basic">properties</link> window.</p>
 
   <p>When you rename a file, only the first part of the name of the file is
-  selected, not the file extension (the part after the <key>.</key>). The
+  selected, not the file extension (the part after the <file>.</file>). The
   extension normally denotes what type of file it is (e.g. <file>file.pdf</file>
   is a PDF document), and you usually do not want to change that. If you need
   to change the extension as well, select the entire file name and change
@@ -56,17 +56,17 @@
 
   <section id="valid-chars">
     <title>Valid characters for file names</title>
-    <p>You can use any character except the <key>/</key> (slash) character in
+    <p>You can use any character except the <file>/</file> (slash) character in
     file names. Some devices, however, use a <em>file system</em> that has more
     restrictions on file names. Therefore, it is a best practice to avoid the
-    following characters in your file names: <key>|</key>, <key>\</key>,
-    <key>?</key>, <key>*</key>, <key>&lt;</key>, <key>"</key>, <key>:</key>,
-    <key>&gt;</key>, <key>/</key>.</p>
+    following characters in your file names: <file>|</file>, <file>\</file>,
+    <file>?</file>, <file>*</file>, <file>&lt;</file>, <file>"</file>,
+    <file>:</file>, <file>&gt;</file>, <file>/</file>.</p>
 
     <note style="warning">
-    <p> If you name a file with a <key>.</key> as the first character, the file
-    will be <link xref="files-hidden">hidden</link> when you attempt to view
-    it in the file manager.</p>
+    <p>If you name a file with a <file>.</file> as the first character, the
+    file will be <link xref="files-hidden">hidden</link> when you attempt to
+    view it in the file manager.</p>
     </note>
   </section>
 
diff --git a/gnome-help/C/files-select.page b/gnome-help/C/files-select.page
index cb7a2ef..52e1b76 100644
--- a/gnome-help/C/files-select.page
+++ b/gnome-help/C/files-select.page
@@ -25,9 +25,9 @@
   two wild card characters available:</p>
 
   <list style="compact">
-    <item><p><key>*</key> matches any number of any characters, even
+    <item><p><file>*</file> matches any number of any characters, even
     no characters at all.</p></item>
-    <item><p><key>?</key> matches exactly one of any character.</p></item>
+    <item><p><file>?</file> matches exactly one of any character.</p></item>
   </list>
 
   <p>For example:</p>
diff --git a/gnome-help/C/files-tilde.page b/gnome-help/C/files-tilde.page
index 64e9129..8855943 100644
--- a/gnome-help/C/files-tilde.page
+++ b/gnome-help/C/files-tilde.page
@@ -21,9 +21,9 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-<title>What is a file with a <key>~</key> at the end of its name?</title>
+<title>What is a file with a <file>~</file> at the end of its name?</title>
 
-  <p>Files with a <key>~</key> at the end of their names (for example,
+  <p>Files with a <file>~</file> at the end of their names (for example,
  <file>example.txt~</file>) are automatically created backup copies of documents
  edited in the <app>gedit</app> text editor or other applications. It is
  safe to delete them, but there's no harm to leave them on your computer.</p>


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]