GNOME.org
 

[gnome-user-docs] Update session pages

commit 8335c22198c324d462859a438f421e15e3fef1d5
Author: Petr Kovar <pkovar redhat com>
Date:   Wed Jun 18 15:03:45 2014 -0400

    Update session pages

 system-admin-guide/C/session-custom.page |   16 ++++---
 system-admin-guide/C/session-user.page   |   68 ++++++++++++++++++++++--------
 2 files changed, 59 insertions(+), 25 deletions(-)
---
diff --git a/system-admin-guide/C/session-custom.page b/system-admin-guide/C/session-custom.page
index d090f27..50608ed 100644
--- a/system-admin-guide/C/session-custom.page
+++ b/system-admin-guide/C/session-custom.page
@@ -1,10 +1,11 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic" style="task"
-      id="custom-session-create">
+      id="session-custom">
 
   <info>
     <link type="guide" xref="index#session" />
-    <revision pkgversion="3.11" date="2014-01-27" status="draft" />
+    <link type="guide" xref="login#management" />
+    <revision pkgversion="3.12" date="2014-06-17" status="review" />
 
     <credit type="author copyright">
       <name>minnie_eg</name>
@@ -24,7 +25,7 @@
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
-    <desc>Install a desktop session file.</desc>
+    <desc>Create a custom session by installing a desktop session file.</desc>
   </info>
 
   <title>Create a custom session</title>
@@ -56,7 +57,7 @@ Exec=<input>gnome-session --session=new-session</input></code>
    <cmd>gnome-session --session=<var>new-session</var></cmd>
    command.</p>
    <p>For more information on the parameters that you can use with
-   <cmd>gnome-session</cmd>, see the <cmd>gnome-session</cmd>(1)
+   <cmd>gnome-session</cmd>, see the <link href="man:gnome-session">gnome-session</link>
    man page.</p>
   </item>
   <item><p>Create a custom session file in
@@ -65,14 +66,15 @@ Exec=<input>gnome-session --session=new-session</input></code>
    <code>[GNOME Session]
 Name=<input>Custom Session</input>
 RequiredComponents=<input>gnome-shell-classic;gnome-settings-daemon;</input></code>
+  <p>Note that any item that you specify in <code>RequiredComponents</code>
+  needs to have its corresponding <file>.desktop</file> file in
+  <file>/usr/share/applications/</file>.</p>
   </item>
 </steps>
 
-<note style="note style">
   <p>After configuring the custom session files, the new session will be
   available in the session list on the GDM login
   screen.</p>
-</note>
 
   <section id="custom-session-issues">
   <title>Known issues</title>
@@ -83,7 +85,7 @@ RequiredComponents=<input>gnome-shell-classic;gnome-settings-daemon;</input></co
     session.</screen>
 
     <p>Should this happen to you, follow these steps to change the  
-    <file>/etc/X11/Xsession.d/20x11-common_process-args</file> file.</p>
+    <file>/etc/X11/Xsession.d/20x11-common_process-args</file> file:</p>
     <steps>
     <item><p>Change <code>STARTUP_FULL_PATH=$(/usr/bin/which <input>"$1"</input>|| true)</code>
     to <code>STARTUP_FULL_PATH=$(/usr/bin/which <input>$1</input> || true)</code>
diff --git a/system-admin-guide/C/session-user.page b/system-admin-guide/C/session-user.page
index 741337c..665e844 100644
--- a/system-admin-guide/C/session-user.page
+++ b/system-admin-guide/C/session-user.page
@@ -1,13 +1,14 @@
 <page xmlns="http://projectmallard.org/1.0/";
       xmlns:its="http://www.w3.org/2005/11/its";
       type="topic" style="task"
-      id="user-session">
+      id="session-user">
 
   <info>
     <link type="guide" xref="index#session" />
     <link type="guide" xref="login#management" />
     <revision pkgversion="3.4.2" date="2012-12-01" status="draft"/>
     <revision pkgversion="3.8" date="2013-08-06" status="review" />
+    <revision pkgversion="3.12" date="2014-06-17" status="review" />
 
     <credit type="author copyright">
       <name>minnie_eg</name>
@@ -19,13 +20,18 @@
       <email>jana svarova gmail com</email>
       <years>2013</years>
     </credit>
+    <credit type="editor">
+      <name>Petr Kovar</name>
+      <email>pknbe volny cz</email>
+      <years>2014</years>
+    </credit>
 
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
 
     <desc>Specify the default session for a user.</desc>
    </info>
 
-  <title>User default sessions</title>
+  <title>Configure a user default session</title>
 
   <comment>
     <cite date="2012-11-20"
@@ -35,25 +41,51 @@
     users.</p>
   </comment>
 
-  <p>You can retrieve the default session from a new program called
+  <p>The default session is retrieved from a program called
   <app>AccountsService</app>. <app>AccountsService</app> stores this information
   in the <file>/var/lib/AccountsService</file> directory.</p>
 
-  <p>To specify a default session for a user, update the user's
-  <app>account service</app> in
-  <file>/var/lib/AccountsService/users/<var>username</var></file>.
-  In the following example, GNOME Classic has been set as the default session:</p>
-  <screen><output>[User]
-  Language=
-  XSession=<input>gnome-classic</input>
-  </output></screen>
-  
-  <p>The list of sessions which you can choose from can be found in
-  <file>.desktop</file> files in the
-  <file>/usr/share/xsessions</file> directory.</p>
-
 <note style="note">
-  <p>In GNOME 2, the .dmrc file in the home directory was used to create default
-  sessions. This .dmrc file is no longer used.</p>
+  <p>In GNOME 2, the <file>.dmrc</file> file in the user home directory was used
+  to create default sessions. This <file>.dmrc</file> file is no longer used.</p>
 </note>
+
+  <steps>
+    <title>Specify a default session for a user</title>
+    <item>
+      <p>
+        Make sure that you have the <sys>gnome-session-xsession</sys>
+        package installed on your system.
+      </p>
+    </item>
+    <item>
+      <p>
+         Navigate to the <file>/usr/share/xsessions</file> directory
+         where you can find <file>.desktop</file> files for each of the
+         available sessions. Consult the contents of the
+         <file>.desktop</file> files to determine the session you want to
+         use.
+      </p>
+    </item>
+    <item>
+      <p>
+        To specify a default session for a user, update the user's
+        <sys>account service</sys> in the
+        <file>/var/lib/AccountsService/users/<var>username</var>
+        file</file>:
+      </p>
+<code>[User]
+Language=
+XSession=gnome-classic</code>
+       <p>
+         In this sample, GNOME Classic has been set as the default session,
+         using the <file>/usr/share/xsessions/gnome-classic.desktop</file> file.
+       </p>
+     </item>
+  </steps>
+
+  <p>After specifying a default session for the user, that session will be
+  used the next time the user logs in, unless the user selects a different
+  session from the login screen.</p>
+
 </page>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]