/usr/share/help/C/system-admin-guide/session-custom.page is in gnome-user-docs 3.28.1-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 | <page xmlns="http://projectmallard.org/1.0/"
type="topic" style="task"
id="session-custom">
<info>
<link type="guide" xref="sundry#session" />
<link type="guide" xref="login#management" />
<revision pkgversion="3.12" date="2014-06-17" status="review" />
<credit type="author copyright">
<name>minnie_eg</name>
<email>amany.elguindy@gmail.com</email>
<years>2012</years>
</credit>
<credit type="editor">
<name>Jana Svarova</name>
<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>Create a custom session by installing a desktop session file.</desc>
</info>
<title>Create a custom session</title>
<comment>
<cite date="2012-11-19"
href="mailto:amany_elguindy@gmail.com">minnie_eg</cite>
<p>This assumes the reader knows how to edit files as the root user and how
to navigate through the manual page. By the end of this page,
the reader will be able to create custom sessions with different
options.</p>
</comment>
<p>To create your own session with customized configuration, follow these
steps:</p>
<steps>
<item><p>Create a <file>.desktop</file> file in
<file>/etc/X11/sessions/<var>new-session</var>.desktop</file>. Make sure that
the file specifies the following entries:</p>
<code>[Desktop Entry]
Encoding=UTF-8
Type=Application
Name=<input>Custom session</input>
Comment=<input>This is our custom session</input>
Exec=<input>gnome-session --session=new-session</input></code>
<p>The <code>Exec</code> entry specifies the command, possibly
with arguments, to execute. You can run the custom session with the
<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 <link href="man:gnome-session">gnome-session</link>
man page.</p>
</item>
<item><p>Create a custom session file in
<file>/usr/share/gnome-session/sessions/<var>new-session</var>.session</file>
where you can specify the name and required components for the session:</p>
<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>
<p>After configuring the custom session files, the new session will be
available in the session list on the GDM login
screen.</p>
<section id="custom-session-issues">
<title>Known issues</title>
<p>On a Debian or Debian-based system, the following error may occur:</p>
<screen>Xsession: unable to launch ""
Xsession --- "" not found; falling back to default
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>
<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>
</p></item>
<item><p>Change <code>STARTUP=<input>"$1"</input></code> to <code>STARTUP=<input>$1</input></code>
</p></item>
</steps>
</section>
</page>
|