doc/fvwm/session.xml

   1 <?xml version="1.0" encoding="UTF-8" ?>
   2 <!DOCTYPE part PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
   3   "../docbook-xml/docbookx.dtd"
   4 [
   5 <!ENTITY % myents SYSTEM "../fvwm.ent" >
   6 %myents;
   7 ]>
   8
   9 <!-- $Id: session.xml,v 1.1 2007/03/10 05:15:34 scott Exp $ -->
  10
  11 <section id='session_management'>
  12 <title>Session Management</title>
  13 <para>Fvwm supports session management according to the X Session
  14 Management Protocol.  It saves and restores window position, size,
  15 stacking order, desk, stickiness, shadiness, maximizedness,
  16 iconifiedness for all windows. Furthermore, some global state is
  17 saved.</para>
  18
  19 <para>Fvwm doesn't save any information regarding styles, decors,
  20 functions or menus.  If you change any of these resources during a
  21 session (e.g. by issuing
  22 <fvwmref cmd="Style"/>
  23 commands or by using various modules), these changes are lost
  24 after saving and restarting the session.  To become permanent,
  25 such changes have to be added to the configuration file.</para>
  26
  27 <para>Note further that the current implementation has the following
  28 anomaly when used on a multi-screen display: Starting fvwm for the
  29 first time, fvwm manages all screens by forking a copy of itself
  30 for each screen.  Every copy knows its parent and issuing a
  31 <fvwmref cmd="Quit"/>
  32 command to any instance of fvwm kills the master and thus all
  33 copies of fvwm.  When you save and restart the session, the
  34 session manager brings up a copy of fvwm on each screen, but this
  35 time they are started as individual instances managing one screen
  36 only.  Thus a
  37 <fvwmref cmd="Quit"/>
  38 kills only the copy it was sent to.  This is probably not a very
  39 serious problem, since with session management, you are supposed
  40 to quit a session through the session manager anyway. If it is
  41 really needed,</para>
  42
  43 <programlisting>
  44 <fvwmref cmd="Exec"/> exec killall fvwm
  45 </programlisting>
  46
  47 <para>still kills all copies of fvwm.  Your system must have the
  48 <command>killall</command>
  49 command though.</para>
  50
  51 </section>