[gnome-user-docs: 5/19] Added topics on arranging/sorting files, topic documenting listview columns (needs attention)

[Shaun McCance <shaunm src gnome org>]

commit 20e901dfe8a2d87d4f2326ff1c88d641ec72961d
Author: Phil Bull <philbull gmail com>
Date:   Mon Jul 26 11:32:23 2010 +0100

    Added topics on arranging/sorting files, topic documenting listview columns (needs attention)

 gnome-help/C/files-arrange.page          |   72 +++++++++++++++++++++++++++++
 gnome-help/C/files-hidden.page           |    2 +-
 gnome-help/C/files-listview-columns.page |   74 ++++++++++++++++++++++++++++++
 gnome-help/C/files-special.page          |   32 ++++++++++---
 4 files changed, 172 insertions(+), 8 deletions(-)
---
diff --git a/gnome-help/C/files-arrange.page b/gnome-help/C/files-arrange.page
new file mode 100644
index 0000000..7baa470
--- /dev/null
+++ b/gnome-help/C/files-arrange.page
@@ -0,0 +1,72 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="files-arrange">
+
+  <info>
+    <link type="guide" xref="files"/>
+    <desc>Learn how to sort and arrange files in a folder.</desc>
+
+    <revision pkgversion="3.0" version="1.0" date="2010-07-26" 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>Arrange files in a different order</title>
+
+<p>You can arrange files in <link xref="ways">lots of different ways</link> in a folder, for example by sorting them in order of date or file size.</p>
+
+<p>The way that you can arrange files depends on the <em>folder view</em> that you are using (Icon, List, or Compact). The current view is displayed in a drop-down list at the top of the window. You can change it using the drop-down list, or by clicking one of the three options in the <gui>View</gui> menu.</p>
+
+<section>
+ <title>Icon View</title>
+ <p>To sort files in a different order, right-click a blank space in the folder and choose an option from the <gui>Arrange Items</gui> menu. Alternatively, use the <guiseq><gui>View</gui><gui>Arrange Items</gui></guiseq> menu.</p>
+ <p>As an example, if you select <gui>Sort by Name</gui> from the <gui>Arrange Items</gui> menu, the files will be arranged by their names, in alphabetical order. See <link xref="#ways"/> for other options.</p>
+ <p>You can sort in the reverse order by selecting <gui>Reversed Order</gui>  from the <gui>Arrange Items</gui> menu.</p>
+ <p>For complete control over the order and position of files in the folder, right-click a blank space in the folder and select <guiseq><gui>Arrange Items</gui><gui>Manually</gui></guiseq>. You can then rearrange the files by dragging them around in the folder.</p>
+ <p>The <gui>Compact Layout</gui> option in the <gui>Arrange Items</gui> menu arranges the files so they take up as little space as possible. This is useful if you want to have lots of files visible at once in a folder.</p>
+</section>
+
+<section>
+ <title>List View</title>
+ <p>To sort files in a different order, click one of the column headings in the file browser (for example, click <gui>Type</gui> to sort by file type). Click the column heading again to sort in the reverse order.</p>
+ <p>You can add other columns to sort by. Click <guiseq><gui>View</gui><gui>Visible Columns</gui></guiseq>, check the columns that you want to be visible, then click <gui>Close</gui>. You will then be able to sort by those columns. (See <link xref="files-listview-columns"/> for descriptions of available columns.)</p>
+</section>
+
+<section>
+ <title>Compact View</title>
+ <p>You can arrange files in Compact view in the same way that you can arrange them in the Icon view. The only difference is that you can't manually position the files anywhere you want; they are always organized as a list in this view.</p>
+</section>
+
+<section id="ways">
+ <title>Ways of sorting files</title>
+ <terms>
+  <item>
+   <title>By Name</title>
+   <p>Sorts by filename.</p>
+  </item>
+  <item>
+   <title>By Size</title>
+   <p>Sorts by the size of the file (how much disk space it takes up).</p>
+  </item>
+  <item>
+   <title>By Type</title>
+   <p>Sorts by the file type. Files of the same type are grouped together, then sorted by name.</p>
+  </item>
+  <item>
+   <title>By Modification Date</title>
+   <p>Sorts by the date that a file was last changed.</p>
+  </item>
+  <item>
+   <title>By Emblems</title>
+   <p>Sorts by the <link xref="files-special">emblems</link> that a file has. Files with the same emblems are grouped together, then sorted by name.</p>
+  </item>
+ </terms>
+</section>
+
+</page>
diff --git a/gnome-help/C/files-hidden.page b/gnome-help/C/files-hidden.page
index edb949f..0d7dc62 100644
--- a/gnome-help/C/files-hidden.page
+++ b/gnome-help/C/files-hidden.page
@@ -30,7 +30,7 @@
 <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.
+ 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 along with 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"/>).
diff --git a/gnome-help/C/files-listview-columns.page b/gnome-help/C/files-listview-columns.page
new file mode 100644
index 0000000..1b171ce
--- /dev/null
+++ b/gnome-help/C/files-listview-columns.page
@@ -0,0 +1,74 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="files-listview-columns">
+
+  <info>
+    <desc>Descriptions of the columns of information that can be viewed in the file browser's list view.</desc>
+
+    <revision pkgversion="3.0" version="1.0" date="2010-07-26" status="stub"/>
+    <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>Listview column descriptions</title>
+
+<p>There are 12 columns of information that you can display in the file browser's list view. Click <guiseq><gui>View</gui><gui>Visible Columns</gui></guiseq> to see which columns are available. They are described below.</p>
+
+<terms>
+ <item>
+  <title>Name</title>
+  <p></p>
+ </item>
+ <item>
+  <title>Size</title>
+  <p></p>
+ </item>
+ <item>
+  <title>Type</title>
+  <p></p>
+ </item>
+ <item>
+  <title>Date Modified</title>
+  <p></p>
+ </item>
+ <item>
+  <title>Date Accessed</title>
+  <p></p>
+ </item>
+ <item>
+  <title>Group</title>
+  <p></p>
+ </item>
+ <item>
+  <title>Location</title>
+  <p></p>
+ </item>
+ <item>
+  <title>MIME Type</title>
+  <p></p>
+ </item>
+ <item>
+  <title>Octal Permissions</title>
+  <p></p>
+ </item>
+ <item>
+  <title>Owner</title>
+  <p></p>
+ </item>
+ <item>
+  <title>Permissions</title>
+  <p></p>
+ </item>
+ <item>
+  <title>SELinux Context</title>
+  <p></p>
+ </item>
+</terms>
+
+</page>
diff --git a/gnome-help/C/files-special.page b/gnome-help/C/files-special.page
index 73bd218..37555d5 100644
--- a/gnome-help/C/files-special.page
+++ b/gnome-help/C/files-special.page
@@ -19,9 +19,10 @@
 
 <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>
+<p>You can use <em>emblems</em> to mark files as being special in some way. For example, if you wanted to mark a report as being urgent, you could put the <gui>Urgent</gui> emblem on the file.</p>
 
 <steps>
+ <title>Adding an emblem</title>
  <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>
@@ -29,7 +30,7 @@
 
 <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>
+<p>You can add as many emblems as you like to a file. If you add too many, 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>
@@ -37,13 +38,30 @@
 
 <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>
+<section>
  <title>Other ways of adding emblems</title>
- <item><p>x</p></item>
- <item><p>x</p></item>
- <item><p>x</p></item>
-</list>
+ <list>
+  <item>
+   <p>In the file browser, choose <gui>Emblems</gui> from the drop-down list at the top of the side pane (the drop-down list is normally underneath the <gui>Back</gui> button). Then, drag an emblem from the side pane onto your file.</p>
+   <p>To remove an emblem using the side pane, drag the <gui>Erase</gui> item onto the file. This will remove all of the emblems for that file.</p>
+  </item>
+  <item>
+   <p>In the file browser, click <guiseq><gui>Edit</gui><gui>Backgrounds and Emblems</gui></guiseq> and click <gui>Emblems</gui>. Drag an emblem onto the file to add it.</p>
+   <p>There is also an <gui>Erase</gui> item that you can use to remove emblems.</p>
+  </item>
+ </list>
+</section>
 
 <section>
+ <title>Making your own custom emblems</title>
+ <p>You can make your own emblems to supplement the default ones.</p>
+ <steps>
+  <item><p>In a file browser, click <guiseq><gui>Edit</gui><gui>Backgrounds and Emblems</gui></guiseq> and click <gui>Emblems</gui>.</p></item>
+  <item><p>Click <gui>Add a New Emblem</gui> and choose a name (<quote>Keyword</quote>) for your emblem.</p></item>
+  <item><p>Click the <gui>Image</gui> button and look for a picture that you want to use as the emblem. If you click once on a picture file in the window that appears, a preview of it will be shown. Once you have made your selection, click <gui>Open</gui>.</p></item>
+  <item><p>Click <gui>OK</gui> and your new emblem will be added to the list of emblems.</p></item>
+ </steps>
+ <p>You can remove a custom emblem by clicking <gui>Remove an Emblem</gui> in the <gui>Backgrounds and Emblems</gui> window. You cannot remove any of the default emblems.</p>
+</section>
 
 </page>