[gnome-user-docs] g-h/nautilus-file-properties-permissions: Wrote, final

[Shaun McCance <shaunm src gnome org>]

commit 5bdb3ff7641b10910f378f6d5c93157f185d60a8
Author: Shaun McCance <shaunm gnome org>
Date:   Mon Apr 4 11:20:28 2011 -0400

    g-h/nautilus-file-properties-permissions: Wrote, final

 gnome-help/C/files.page                            |    5 -
 .../C/nautilus-file-properties-permissions.page    |  130 +++++++++++++-------
 2 files changed, 86 insertions(+), 49 deletions(-)
---
diff --git a/gnome-help/C/files.page b/gnome-help/C/files.page
index 8b97055..2c44d10 100644
--- a/gnome-help/C/files.page
+++ b/gnome-help/C/files.page
@@ -46,11 +46,6 @@
   <links type="topic" style="2column"/>
 </section>
 
-<section id="manage-prefs">
-  <title>File Management Preferences</title>
-  <links type="topic" style="2column"/>
-</section>
-
 <section id="faq">
   <title>Tips and questions</title>
   <links type="topic" style="2column"/>
diff --git a/gnome-help/C/nautilus-file-properties-permissions.page b/gnome-help/C/nautilus-file-properties-permissions.page
index 77b4450..1f2ad0b 100644
--- a/gnome-help/C/nautilus-file-properties-permissions.page
+++ b/gnome-help/C/nautilus-file-properties-permissions.page
@@ -1,62 +1,104 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic" style="ui"
+      type="topic" style="task"
       id="nautilus-file-properties-permissions">
 
   <info>
-    <link type="guide" xref="files#manage-prefs"/>
+    <link type="guide" xref="files#faq"/>
+    <link type="seealso" xref="nautilus-file-properties-basic"/>
 
-    <desc>Left click on the file, select <gui>Properties</gui>, select <gui>Permissions</gui> tab.</desc>
+    <desc>Control who can view and edit your files and folders.</desc>
 
-    <revision pkgversion="3.0" version="0.1" date="2011-03-25" status="incomplete"/>
+    <revision pkgversion="3.0" date="2011-04-04" status="final"/>
     <credit type="author">
       <name>Tiffany Antopolski</name>
       <email>tiffany antopolski com</email>
     </credit>
+    <credit type="author">
+      <name>Shaun McCance</name>
+      <email>shaunm gnome org</email>
+    </credit>
     <license>
       <p>Creative Commons Share Alike 3.0</p>
     </license>
 
   </info>
-<title>Setting file permissions</title>
-
-  <p>To view the file properties you can do one of the following:</p>
-  <list>
-   <item><p>Right click on the file, select <gui>Properties</gui>.</p></item>
-   <item><p>Open the file and click on <guiseq><gui>File</gui><gui>Properties</gui></guiseq>.</p></item>
-   <item><p>Select the file in the <app>Files</app> application by clicking on it once.  Then press <guiseq><gui>Alt</gui><gui>Enter</gui></guiseq>.</p></item>
-  </list>
-  <p>Select the <gui>Permissions</gui> tab.</p>
-
-<section id="owner-group-others">
- <title>Owner, group, and others access</title>
-   <terms>
-     
-    <item>
-      <title>Owner</title>
-      <p></p>
-    </item>
-     
-    <item>
-      <title>Group</title>
-      <p></p>
-    </item>
-     
-    <item>
-      <title>Others</title>
-      <p></p>
-    </item>
-
-
-
-   </terms>
-
-</section>
-
-<section id="execute">
- <title>Execute</title>
-   <p>Select this option for files that contain programs that you can run.  You can also <link xref="nautilus-behavior#executable">set the default behavior</link> options for opening executable text files.</p>
-
-</section>
+  <title>Set file permissions</title>
+
+  <p>You can use file permissions control who can view and edit files that
+  you own. To view and set the permissions for a file, right click it and
+  select <gui>Properties</gui>, then select the <gui>Permissions</gui> tab.</p>
+
+  <p>See <link xref="#files"/> and <link xref="#folders"/> below for details
+  on the types of permissions you can set.</p>
+
+  <section id="files">
+    <title>Files</title>
+
+    <p>You can set the permissions for the file owner, the group owner,
+    and all other users of the system. For your files, you are the owner,
+    and you can give yourself read-only or read-and-write permission.
+    Set a file to read-only if you don't want to accidentally change it.</p>
+
+    <p>Every user on your computer belongs to a group. On home computers,
+    it is common for each user to have their own group, and group permissions
+    are not often used. In corporate environments, groups are sometimes used
+    for departments or projects. As well as having an owner, each file belongs
+    to a group. You can set the file's group and control the permissions for
+    all users in that group. You can only set the file's group to a group you
+    belong to.</p>
+
+    <p>You can also set the permissions for users other than the owner and
+    those in the file's group.</p>
+
+    <p>If the file is a program, such as a script, you must select <gui>Allow
+    executing file as program</gui> to run it. Even with this option selected,
+    the file manager may still open the file in an application or ask you
+    what to do. See <link xref="nautilus-behavior#executable"/> for more
+    information.</p>
+  </section>
+
+  <section id="folders">
+    <title>Folders</title>
+    <p>You can set permissions on folders for the owner, group, and other users.
+    See the details of file permissions above for an explanation of owners,
+    groups, and other users.</p>
+    <p>The permissions you can set for a folder are different from those you
+    can set for a file.</p>
+    <terms>
+      <item>
+        <title><gui>None</gui></title>
+        <p>The user will not even be able to see what files are in
+        the folder.</p>
+      </item>
+      <item>
+        <title><gui>List files only</gui></title>
+        <p>The user will be able to see what files are in the folder,
+        but will not be able to open, create, or delete files.</p>
+      </item>
+      <item>
+        <title><gui>Access files</gui></title>
+        <p>The user will be able to open files in the folder (provided
+        they have permission to do so on the particular file), but will
+        not be able to create new files or delete files.</p>
+      </item>
+      <item>
+        <title><gui>Create and delete files</gui></title>
+        <p>The user will have full access to the directory, including
+        opening, creating, and deleting files.</p>
+      </item>
+    </terms>
 
+    <p>You can also quickly set the file permissions for all the files
+    in the folder by using the <gui>File access</gui> drop-down lists
+    and the <gui>Execute</gui> option. Leave the drop-down lists as
+    <gui>---</gui> for no change, or the <gui>Execute</gui> check box
+    in the indeterminate state (a horizontal line across it).</p>
+    <p>If you click <gui>Apply Permissions to Enclosed Files</gui>, the
+    file manager will adjust the read, write, and execute permissions of
+    contained files based on the <gui>File access</gui> and <gui>Execute</gui>
+    options you set. It will also change the permissions of contained folders
+    to match the permissions of that folder. Permissions for enclosed files
+    are applied to files in subfolders as well, to any depth.</p>
+  </section>
 
 </page>