[gnome-user-docs: 4/19] Added topics on emblems, hidden files, files with tilde in their names

[Shaun McCance <shaunm src gnome org>]

commit aa451b1af3132b7c0aab617ab184b41f7cd5a91a
Author: Phil Bull <philbull gmail com>
Date:   Mon Jul 26 10:09:33 2010 +0100

    Added topics on emblems, hidden files, files with tilde in their names

 gnome-help/C/files-hidden.page  |   56 +++++++++++++++++++++++++++++++++++++++
 gnome-help/C/files-special.page |   49 ++++++++++++++++++++++++++++++++++
 gnome-help/C/files-tilde.page   |   27 ++++++++++++++++++
 3 files changed, 132 insertions(+), 0 deletions(-)
---
diff --git a/gnome-help/C/files-hidden.page b/gnome-help/C/files-hidden.page
new file mode 100644
index 0000000..edb949f
--- /dev/null
+++ b/gnome-help/C/files-hidden.page
@@ -0,0 +1,56 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="files-hidden">
+
+  <info>
+    <link type="guide" xref="files"/>
+    <desc>Make a file invisible, so you can't see it in the file browser.</desc>
+
+    <revision pkgversion="3.0" version="1.0" date="2010-07-25" status="draft"/>
+    <credit type="author">
+      <name>Phil Bull</name>
+      <email>philbull gmail com</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+
+  </info>
+
+<title>Hide a file</title>
+
+<p>You can hide files by renaming them in a special way. Hidden files are just invisible; they are not displayed in the file browser, but they are still there in the folder.</p>
+
+<p>To hide a file, <link xref="files-renaming">rename it</link> with a <quote>.</quote> at the beginning of its name. For example, to hide a file <file>example.txt</file>, you would rename it to <file>.example.txt</file>.</p>
+
+<note style="tip">
+ <p>You can hide folders in the same way that you can hide files. Rename the folder with a <quote>.</quote> at the beginning of its name.</p>
+</note>
+
+<section>
+ <title>Show all hidden files</title>
+ <p>
+ If you want to see all of the hidden files in a folder, go to that folder  and click <guiseq><gui>View</gui><gui>Show Hidden Files</gui></guiseq>. All of the hidden files will be shown, as well as the files that were not hidden.
+ </p>
+ <p>
+ The hidden files will have a <quote>.</quote> at the beginning of their name. Some might have a <quote>~</quote> at the end of their name instead (see <link xref="files-tilde"/>).
+ </p>
+ <p>
+ To hide the files again, click <guiseq><gui>View</gui><gui>Show Hidden Files</gui></guiseq> again.
+ </p>
+</section>
+
+<section>
+ <title>Unhide a file</title>
+ <p>
+ To unhide a file, go to the folder containing the hidden file and click <guiseq><gui>View</gui><gui>Show Hidden Files</gui></guiseq>. Then, find the hidden file and rename it so that it doesn't have a <quote>.</quote> in front of its name.
+ </p>
+ <p>
+ For example, to unhide a file called <file>.example.txt</file>, you would rename it to <file>example.txt</file>.
+ </p>
+ <p>
+ Once you have renamed the file, click <guiseq><gui>View</gui><gui>Show Hidden Files</gui></guiseq> to hide any other hidden files again.
+ </p>
+</section>
+
+</page>
diff --git a/gnome-help/C/files-special.page b/gnome-help/C/files-special.page
new file mode 100644
index 0000000..73bd218
--- /dev/null
+++ b/gnome-help/C/files-special.page
@@ -0,0 +1,49 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="files-special">
+
+  <info>
+    <link type="guide" xref="files"/>
+    <desc>Use emblems to label a file.</desc>
+
+    <revision pkgversion="3.0" version="1.0" date="2010-07-25" status="draft"/>
+    <credit type="author">
+      <name>Phil Bull</name>
+      <email>philbull gmail com</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+
+  </info>
+
+<title>Mark a file as being special or important</title>
+
+<p>You can use <em>emblems</em> to mark files as being special in some way. For example, if you wanted to</p>
+
+<steps>
+ <item><p>Right-click the file and select <gui>Properties</gui>.</p></item>
+ <item><p>Go to the <gui>Emblems</gui> tab and check the emblems that you want to use.</p></item>
+ <item><p>The emblems you chose will appear over the file. (You can just close the <gui>Properties</gui> window when you've finished.)</p></item>
+</steps>
+
+<p>To remove an emblem, follow the same steps as above, but <em>uncheck</em> the emblem you want to remove.</p>
+
+<p>You can add as many emblems as you like to a file. If you add more than four, however, some of the emblems will not be displayed because there isn't enough space for them all.</p>
+
+<note style="tip">
+ <p>You can add emblems to folders too. The procedure is the same as for files.</p>
+</note>
+
+<p>If you send a file to someone else (for example, by email), the other person will not be able to see the emblems you added. The emblems you add to a file are only visible to you (in your user account).</p>
+
+<list>
+ <title>Other ways of adding emblems</title>
+ <item><p>x</p></item>
+ <item><p>x</p></item>
+ <item><p>x</p></item>
+</list>
+
+<section>
+
+</page>
diff --git a/gnome-help/C/files-tilde.page b/gnome-help/C/files-tilde.page
new file mode 100644
index 0000000..83d480c
--- /dev/null
+++ b/gnome-help/C/files-tilde.page
@@ -0,0 +1,27 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="files-tilde">
+
+  <info>
+    <link type="guide" xref="files"/>
+    <link type="seealso" xref="files-hidden"/>
+    <desc>Files with a <quote>~</quote> at the end of their name (e.g. <file>example.txt~</file>) are hidden files.</desc>
+
+    <revision pkgversion="3.0" version="1.0" date="2010-07-25" status="draft"/>
+    <credit type="author">
+      <name>Phil Bull</name>
+      <email>philbull gmail com</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+
+  </info>
+
+<title>What does it mean when a file has <quote>~</quote> in its name?</title>
+
+<p>Files with <quote>~</quote> at the end of their names (for example, <file>example.txt~</file>) are hidden files. They are often created automatically by applications as backup copies of documents. It is normally safe to delete them, but check before you do.</p>
+
+<p>These files are treated in the same way as normal hidden files. See <link xref="files-hidden"/> for advice on dealing with hidden files.</p>
+
+</page>