[gnome-user-docs] Review lockdown-printing.page



commit e17a5b38ee3c1dc56af9ececdbff45b9c5e250a2
Author: Ekaterina Gerasimova <kittykat3756 gmail com>
Date:   Thu Dec 4 21:47:59 2014 +0000

    Review lockdown-printing.page
    
    Remove whitespace. Improve style and indentation. Improve language.
    Make it clearer that the feature is pretty useless as most applications
    don't support it. Use consistent language with other pages.

 system-admin-guide/C/lockdown-printing.page |   90 +++++++++++++++++----------
 1 files changed, 56 insertions(+), 34 deletions(-)
---
diff --git a/system-admin-guide/C/lockdown-printing.page b/system-admin-guide/C/lockdown-printing.page
index aac2600..e5cea15 100644
--- a/system-admin-guide/C/lockdown-printing.page
+++ b/system-admin-guide/C/lockdown-printing.page
@@ -5,56 +5,78 @@
      
   <info>
     <link type="guide" xref="user-settings#lockdown"/>
-    <revision pkgversion="3.11" date="2014-10-14" status="draft"/>
     <link type="seealso" xref="dconf-lockdown" />
-    
+    <revision pkgversion="3.11" date="2014-12-04" status="review"/>
+
     <credit type="author copyright">
       <name>Jana Svarova</name>
       <email its:translate="no">jana svarova gmail com</email>
       <years>2014</years>
     </credit>
-    
+    <credit type="author copyright">
+      <name>Ekaterina Gerasimova</name>
+      <email its:translate="no">kittykat3756 gmail com</email>
+      <years>2014</years>
+    </credit>
+
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
-       
-    <desc>Prevent applications from printing documents.</desc>
+
+    <desc>Prevent the user from printing documents.</desc>
   </info>
-  
+
   <title>Disable printing</title>
-  <p>Prevent applications from printing by locking down the
-  <code>org.gnome.desktop.lockdown.disable-printing</code> key.</p>
-  
+
+  <p>You can disable the print dialog from being shown to users. This can be
+  useful if you are giving temporary access to a user or you do not want the
+  user to print to network printers.</p>
+
+  <note style="warning">
+    <p>This feature will only work in applications which support it! Not all
+    GNOME and third party applications have this feature enabled. These changes
+    will have no effect on applications which do not support this feature.</p>
+  </note>
+
   <steps>
-    <title>Lock down the org.gnome.desktop.lockdown.disable-printing key</title>
+    <title>Disable printing</title>
+    <include href="dconf-snippets.xml"
+             xpointer="xpointer(/*/*[ xml:id='dconf-profile-user'])"
+             xmlns="http://www.w3.org/2001/XInclude"/>
+    <include href="dconf-snippets.xml"
+             xpointer="xpointer(/*/*[ xml:id='dconf-profile-user-dir'])"
+             xmlns="http://www.w3.org/2001/XInclude"/>
     <item>
-      <p>Create the user profile if it already does not exist (<file>/etc/dconf/profile/user</file>):</p>
-<screen>
-user-db:user
-system-db:local
-</screen>
-    </item>
-    <item>
-      <p>Create a <code>local</code> database for machine-wide settings in
-      <file>etc/dconf/db/local.d/00-lockdown</file>:</p>
-<screen>
+      <p>Create the key file
+      <file>/etc/dconf/db/local.d/00-printing</file> to provide
+      information for the <sys>local</sys> database.</p>
+      <listing>
+        <title><file>/etc/dconf/db/local.d/00-printing</file></title>
+<code>
+# Specify the dconf path
 [org/gnome/desktop/lockdown]
  
 # Prevent applications from printing
 disable-printing=true
-</screen>
-   </item>
-   <item>
-      <p>Override the user's setting and prevent the user from changing it in
-      <file>/etc/dconf/db/local.d/locks/lockdown</file>:</p>
-<screen>
-# List the keys used to configure lockdown
+</code>
+     </listing>
+    </item>
+    <item>
+      <p>To prevent the user from overriding these settings, create the file
+      <file>/etc/dconf/db/local.d/locks/printing</file> with the following
+      content:</p>
+      <listing>
+        <title><file>/etc/dconf/db/local.db/locks/printing</file></title>
+<code>
+# Lock file saving settings
 org.gnome.desktop.lockdown.disable-printing
-</screen>
+</code>
+      </listing>
     </item>
-      <include href="dconf-snippets.xml"
-      xpointer="xpointer(/*/*[ xml:id='dconf-update'])"
-      xmlns="http://www.w3.org/2001/XInclude"/>
+    <include href="dconf-snippets.xml"
+             xpointer="xpointer(/*/*[ xml:id='dconf-update'])"
+             xmlns="http://www.w3.org/2001/XInclude"/>
+    <include href="dconf-snippets.xml"
+             xpointer="xpointer(/*/*[ xml:id='dconf-logoutin'])"
+             xmlns="http://www.w3.org/2001/XInclude"/>
   </steps>
-  <p>Having followed these steps, applications supporting this lockdown key
-  will disable printing. Among such applications there are <app>Evolution</app>, 
-  <app>Evince</app>, <app>Eye of GNOME</app>, <app>Epiphany</app>, and <app>Gedit</app>.</p>
+
 </page>


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