Changeset afea77c

Timestamp:

09/18/2022 04:46:51 PM (19 months ago)

Author:

Xi Ruoyao <xry111@…>

Branches:

11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, xry111/llvm18, xry111/xf86-video-removal

Children:

9c44927

Parents:

1b32f1a

Message:

mutter: add a section about running it directly

File:

• gnome/platform/mutter.xml (modified) (3 diffs)

gnome/platform/mutter.xml

@@ -182 +182 @@
     </para>
     -->
+
     <para>
       The test suite requires debug functions to be enabled in the build, and an
@@ -204 +205 @@
 
     <para>
+      You can also test basic functions of <application>Mutter</application>
+      following <xref linkend='mutter-starting'/>, after installing it.
+    </para>
+
+    <para>
       Now, as the <systemitem class="username">root</systemitem> user:
     </para>
@@ -236 +242 @@
     </para>
 
+  </sect2>
+
+  <sect2 role="starting" id="mutter-starting">
+    <title>Starting Mutter</title>
+
+    <!-- Mutter as a Wayland compositor Works with mutter-42.4 and 43.0.
+         IIRC mutter can also be used as a X window manager: just replace
+         "twm" with "mutter &dash;&dash;x11" in xinitrc. But I've not tested
+         such a configuration recently (I don't build Xorg Server or xinit
+         these days.  -->
+
+    <para>
+      <application>Mutter</application> is normally used as a component of
+      <application>gnome-shell</application>, but it can be used as a
+      standalone Wayland compositor too.  To run
+      <application>Mutter</application> as a Wayland compositor, in a
+      virtual console, issue:
+    </para>
+
+    <screen role='nodump'><userinput>mutter --wayland -- vte-2.91</userinput></screen>
+
+    <para>
+      Replace <command>vte-2.91</command> with the command line for the
+      first application you want in the Wayland session. Note that once this
+      application exits, the Wayland session will be terminated.
+    </para>
+
+    <para>
+      <application>Mutter</application> can also function as a nested
+      compositor in another Wayland session.  In a terminal emulator, issue:
+    </para>
+
+    <screen role='nodump'><userinput>MUTTER_DEBUG_DUMMY_MODE_SPECS=1920x1080 mutter --wayland --nested -- vte-2.91</userinput></screen>
+
+    <para>
+      Replace <replaceable>1920x1080</replaceable> with the size you want
+      for the nested Wayland session.
+    </para>
   </sect2>