glfs/lxqt/desktop/lxqt-session.xml
2024-03-06 10:12:21 -06:00

237 lines
7.2 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY lxqt-session-download-http "https://github.com/lxqt/lxqt-session/releases/download/&lxqt-version;/lxqt-session-&lxqt-version;.tar.xz">
<!ENTITY lxqt-session-download-ftp " ">
<!ENTITY lxqt-session-md5sum "b8a4d40eeaf6972cfa23467043e2f5c4">
<!ENTITY lxqt-session-size "184 KB">
<!ENTITY lxqt-session-buildsize "8.6 MB">
<!ENTITY lxqt-session-time "0.3 SBU">
]>
<sect1 id="lxqt-session" xreflabel="lxqt-session-&lxqt-version;">
<?dbhtml filename="lxqt-session.html"?>
<title>lxqt-session-&lxqt-version;</title>
<indexterm zone="lxqt-session">
<primary sortas="a-lxqt-session">lxqt-session</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to lxqt-session</title>
<para>
The <application>lxqt-session</application> package contains the default
session manager for <application>LXQt</application>.
</para>
&lfs121_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&lxqt-session-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&lxqt-session-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &lxqt-session-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &lxqt-session-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &lxqt-session-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &lxqt-session-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">lxqt-session Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required">
<xref linkend="liblxqt"/>,
<xref linkend="lxqt-kwindowsystem"/>,
<xref linkend="qtxdg-tools"/>, and
<xref linkend="xdg-user-dirs"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of lxqt-session</title>
<para>
Install <application>lxqt-session</application> by running the following
commands:
</para>
<screen><userinput>sed -e '/TryExec/s|=|=/usr/bin/|' \
-i xsession/lxqt.desktop.in &amp;&amp;
mkdir -v build &amp;&amp;
cd build &amp;&amp;
cmake -DCMAKE_INSTALL_PREFIX=/usr \
-DCMAKE_BUILD_TYPE=Release \
.. &amp;&amp;
make</userinput></screen>
<para>
This package does not come with a test suite.
</para>
<para>
Now, as the &root; user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para>
<command>sed -e '/TryExec/s|=|='/usr'/bin/|' -i xsessions/lxqt.desktop.in</command>:
If you are using a display manager, the full path of the
<quote>TryExec</quote> directive has to be given so that the
<application>LXQt</application> desktop will appear in the sessions list.
</para>
</sect2>
<sect2 role="configuration">
<title>Configuring lxqt-session</title>
<para>
Window Managers other than <xref linkend="openbox"/> may be used, e.g.
<xref linkend="xfwm4"/>. Please note that <xref linkend="icewm"/> is not a
good substitute. <application>Fluxbox</application> does work, although
in this context (with <xref linkend="lxqt-config"/>), <xref
linkend="openbox"/> is better. The configuration file
<filename>/usr/share/lxqt/windowmanagers.conf</filename> comes with many
examples of Window Managers and the ones which are installed will appear
in a drop down list of <command>lxqt-config-session</command>. For the
ones not included in
<filename>/usr/share/lxqt/windowmanagers.conf</filename>, you can use
<command>lxqt-config-session</command>'s "search" button, e.g. for <xref
linkend="fluxbox"/>, navigating through the file system until you can
choose <command>fluxbox</command>. <!--Alternatively, if you wish the Window
Manager of your choice to appear in the drop down list, include it in
<filename>/etc/xdg/lxqt/windowmanagers.conf</filename>. For <xref
linkend="fluxbox"/>, include the line
</para>
<screen role="nodump"><userinput><literal>fluxbox/Name=Fluxbox</literal></userinput></screen>
<para>
and it will appear as an option in the drop down list. To change the WM,
after selecting it, you need to restart the session.
-->
</para>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>
lxqt-config-session,
lxqt-leave,
lxqt-session, and
startlxqt
</seg>
<seg>
None
</seg>
<seg>
None
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="lxqt-config-session-prog">
<term><command>lxqt-config-session</command></term>
<listitem>
<para>
is a GUI configuration tool for <command>lxqt-session</command>
</para>
<indexterm zone="lxqt-session lxqt-config-session-prog">
<primary sortas="b-lxqt-config-session">lxqt-config-session</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="lxqt-leave-prog">
<term><command>lxqt-leave</command></term>
<listitem>
<para>
is a graphical dialog to terminate the session
</para>
<indexterm zone="lxqt-session lxqt-leave-prog">
<primary sortas="b-lxqt-leave">lxqt-leave</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="lxqt-session-prog">
<term><command>lxqt-session</command></term>
<listitem>
<para>
is a lightweight X session manager
</para>
<indexterm zone="lxqt-session lxqt-session-prog">
<primary sortas="b-lxqt-session">lxqt-session</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="startlxqt">
<term><command>startlxqt</command></term>
<listitem>
<para>
is used to start the desktop session for
<application>LXQt</application>
</para>
<indexterm zone="lxqt-session startlxqt">
<primary sortas="b-startlxqt">startlxqt</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>