<HTML
><HEAD
><TITLE
>Session Properties</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.54"><LINK
REL="NEXT"
TITLE="Known Bugs and Limitations"
HREF="bugs.html"></HEAD
><BODY
CLASS="ARTICLE"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="ARTICLE"
><DIV
CLASS="TITLEPAGE"
><H1
CLASS="TITLE"
><A
NAME="AEN2"
>Session Properties</A
></H1
><P
CLASS="COPYRIGHT"
><A
HREF="ln7.html"
>Copyright</A
> &copy; 2000 by <SPAN
CLASS="HOLDER"
>Eric Baudais</SPAN
></P
><HR
WIDTH="75%"
ALIGN="CENTER"
COLOR="#000000"
SIZE="1"></DIV
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="index.html#SESSION-PROPERTIES"
>Session Properties</A
></DT
><DT
><A
HREF="bugs.html"
>Known Bugs and Limitations</A
></DT
><DT
><A
HREF="authors.html"
>Authors</A
></DT
><DT
><A
HREF="license.html"
>License</A
></DT
></DL
></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="SESSION-PROPERTIES"
>Session Properties</A
></H1
><P
>      <SPAN
CLASS="SYSTEMITEM"
>Session Properties</SPAN
> monitors the 
      state of current GNOME running applications and capplets, as seen in
      <A
HREF="index.html#SESSION-PROPERTIES-SCREENSHOT"
>Figure 1</A
>.  <SPAN
CLASS="SYSTEMITEM"
>      Session Properties</SPAN
> displays a list of all the 
      applications and capplets currently running, what will happen to 
      the program if you logout, and the state of the application.  It allows 
      you to change the style and priority of each program.  You 
      can shut down applications, if you wish, and those applications 
      will be removed from your GNOME session.  You can also use 
      <SPAN
CLASS="SYSTEMITEM"
>Session Properties</SPAN
> to kill a GNOME 
      application and remove it from <SPAN
CLASS="SYSTEMITEM"
>session management
      </SPAN
> so it will not be restarted when you log in next 
      time.  Of course, there are other ways to kill an 
      application, such as using an explicit kill command, but they 
      would not prevent an application from being restarted if it has 
      the <A
HREF="index.html#SESSION-PROPERTIES-RESPAWN"
><TT
CLASS="GUILABEL"
><B
>Respawn 
      Style</B
></TT
></A
>.  The only way to permanently remove such 
      an application is with the <A
HREF="index.html#SESSION-PROPERTIES-REMOVE"
>      <B
CLASS="GUIBUTTON"
>Remove</B
></A
> button.
    </P
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.png"
HSPACE="5"
ALT="Note"></TD
><TH
ALIGN="LEFT"
VALIGN="CENTER"
><B
>Note:</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>	Applications that are not 100% GNOME compliant are not managed
	by the <SPAN
CLASS="SYSTEMITEM"
>session manager</SPAN
>.  To check if 
	an application is GNOME compliant start <SPAN
CLASS="SYSTEMITEM"
>Session 
	Properties</SPAN
>.  If the application is shown in the 
	list it is compliant with GNOME and is managed by the 
	<SPAN
CLASS="SYSTEMITEM"
>session manager</SPAN
>.  In order 
	to restart non-GNOME complaint applications when you log in 
	see 
	Non-session-managed Startup Programs.
      </P
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="FIGURE"
><A
NAME="SESSION-PROPERTIES-SCREENSHOT"
></A
><P
><IMG
SRC="session-properties.png"></P
><P
><B
>Figure 1. Session Properties Dialog</B
></P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="SESSION-PROPERTIES-SAVE"
>Saving the GNOME Session</A
></H2
><P
>	To save your GNOME session select <B
CLASS="GUIMENU"
>Main Menu</B
>-&gt;<B
CLASS="GUISUBMENU"
>Programs</B
>-&gt;<B
CLASS="GUISUBMENU"
>Settings</B
>-&gt;<B
CLASS="GUISUBMENU"
>Session</B
>-&gt;<B
CLASS="GUIMENUITEM"
>Save Current Session
	</B
>.  This causes all the applications to save 
	their current state: the application's current settings 
	and work (open files and unsaved data).
      </P
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.png"
HSPACE="5"
ALT="Note"></TD
><TH
ALIGN="LEFT"
VALIGN="CENTER"
><B
>Note:</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>	  Applications that are not compliant with GNOME will not save the current settings 
	  or work associated with the application.  It is recommended that you save your work 
	  periodically in case of a calamity.
	</P
></TD
></TR
></TABLE
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="SESSION-PROPERTIES-ORDER"
>Priority Order</A
></H2
><P
>	The <TT
CLASS="GUILABEL"
><B
>priority order</B
></TT
> sets the order the applications 
	will start in the GNOME <A
HREF="index.html#SESSION-PROPERTIES-SCREENSHOT"
>	<SPAN
CLASS="SYSTEMITEM"
>Session Manager</SPAN
></A
>.  This lets applications be started 
	after other applications or capplets they are dependent upon.  
	If an application needs to start before the <SPAN
CLASS="SYSTEMITEM"
>window manager
	</SPAN
>, like a server, you can change the <TT
CLASS="GUILABEL"
><B
>order</B
></TT
>
	number to be lower than the <SPAN
CLASS="SYSTEMITEM"
>window manager's</SPAN
>
	<TT
CLASS="GUILABEL"
><B
>order</B
></TT
> number.  Usually most applications will have 
	an order number of 50.  If the application or capplet is a part of the 
	<SPAN
CLASS="SYSTEMITEM"
>window manager</SPAN
> or critical system then it 
	should be assigned a lower <TT
CLASS="GUILABEL"
><B
>order</B
></TT
> number.
      </P
><DIV
CLASS="IMPORTANT"
><P
></P
><TABLE
CLASS="IMPORTANT"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/important.png"
HSPACE="5"
ALT="Important"></TD
><TH
ALIGN="LEFT"
VALIGN="CENTER"
><B
>Important:</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>	  The <TT
CLASS="GUILABEL"
><B
>priority order</B
></TT
> is for advanced user only.  Unless you are familiar 
	  with the <TT
CLASS="GUILABEL"
><B
>priority order</B
></TT
> you should not change it.
	</P
></TD
></TR
></TABLE
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="SESSION-PROPERTIES-STYLE"
>Style Options</A
></H2
><P
>	The <TT
CLASS="GUILABEL"
><B
>Style</B
></TT
> option sets the restart style of 
	each application running in the GNOME <A
HREF="index.html#SESSION-PROPERTIES-SCREENSHOT"
>	<SPAN
CLASS="SYSTEMITEM"
>Session Manager</SPAN
></A
>.  When an application closes the <TT
CLASS="GUILABEL"
><B
>style
	</B
></TT
> option controls what happens to the program.  The style most 
	applications run with is <TT
CLASS="GUILABEL"
><B
>Normal</B
></TT
>.  There are currently 
	four styles of applications and capplets.
      </P
><P
></P
><UL
><LI
STYLE="list-style-type: opencircle"
><P
>	    <TT
CLASS="GUILABEL"
><B
>Normal</B
></TT
> - This style starts the application 
	    when you log back in, but it allows the application to close 
	    normally given a <B
CLASS="COMMAND"
>kill</B
> command.
	    The vast majority of applications you run will have this style 
	    and it is safe to assume this style when in doubt.  All you will 
	    see is a blank space in the <TT
CLASS="GUILABEL"
><B
>style</B
></TT
> row unlike 
	    other styles.
	  </P
></LI
><LI
STYLE="list-style-type: opencircle"
><P
>	    <B
CLASS="GUIICON"
>	      <IMG
SRC="stock_refresh.png">
	    </B
>
	    <TT
CLASS="GUILABEL"
><B
>Respawn</B
></TT
> - This style starts the application 
	    or capplet again once it is given the <B
CLASS="COMMAND"
>kill</B
> 
	    command.  It is used primarily for applications or servers that 
	    need to run continuously regardless of user intervention.  Two 
	    examples of applications running with the <TT
CLASS="GUILABEL"
><B
>respawn</B
></TT
> 
	    style is the GNOME <SPAN
CLASS="SYSTEMITEM"
>Session Manager</SPAN
> and 
	    the GNOME <SPAN
CLASS="SYSTEMITEM"
>Panel</SPAN
>.
	  </P
></LI
><LI
STYLE="list-style-type: opencircle"
><P
>	    <B
CLASS="GUIICON"
>	      <IMG
SRC="stock_trash.png">
	    </B
>
	    <TT
CLASS="GUILABEL"
><B
>Trash</B
></TT
> - This style indicates applications 
	    or capplets that are only temporary.  When you logout, the applications 
	    with this style are killed, after saving their data, and do not restart 
	    when you login again.
	  </P
></LI
><LI
STYLE="list-style-type: opencircle"
><P
>	    <B
CLASS="GUIICON"
>	      <IMG
SRC="stock_preferences.png">
	    </B
>
	    <TT
CLASS="GUILABEL"
><B
>Settings</B
></TT
> - This style indicates applications 
	    or capplets used only for storing and relaying your settings to 
	    GNOME and GNOME compliant applications.  These applications and 
	    capplets usually have a lower priority order and handle configurations.
	  </P
></LI
></UL
><DIV
CLASS="IMPORTANT"
><P
></P
><TABLE
CLASS="IMPORTANT"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/important.png"
HSPACE="5"
ALT="Important"></TD
><TH
ALIGN="LEFT"
VALIGN="CENTER"
><B
>Important:</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>	  The <TT
CLASS="GUILABEL"
><B
>Style</B
></TT
> option is for advanced users only.  
	  Unless you are familiar with the <TT
CLASS="GUILABEL"
><B
>Style</B
></TT
> settings 
	  you should not change it.
	</P
></TD
></TR
></TABLE
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="STARTUP-PROGRAMS-STATE"
>State</A
></H2
><P
>	The <TT
CLASS="GUILABEL"
><B
>state</B
></TT
> of an application tells you what the 
	application or capplet is doing, at the moment, in the GNOME 
	<A
HREF="index.html#SESSION-PROPERTIES-SCREENSHOT"
><SPAN
CLASS="SYSTEMITEM"
>	Session Manager</SPAN
></A
>.  Most of the time you will see 
	they are either in the <A
HREF="index.html#SESSION-PROPERTIES-INACTIVE"
>	Inactive</A
> state or in the <A
HREF="index.html#SESSION-PROPERTIES-RUN"
>	Running</A
> state.
      </P
><P
></P
><UL
><LI
STYLE="list-style-type: opencircle"
><P
>	    <TT
CLASS="GUILABEL"
><B
>Inactive</B
></TT
> - Applications in the <TT
CLASS="GUILABEL"
><B
>inactive 
	    state</B
></TT
> are either waiting to start or have finished running.  
	    These applications are waiting for you or another user to run them.  
	    Unlike other states the <TT
CLASS="GUILABEL"
><B
>inactive state</B
></TT
> has no 
	    icon associated with it.  All you will see is a blank space in the 
	    <TT
CLASS="GUILABEL"
><B
>state</B
></TT
> row.
	  </P
></LI
><LI
STYLE="list-style-type: opencircle"
><P
>	    <B
CLASS="GUIICON"
>	      <IMG
SRC="stock_exec.png">
	    </B
>
	    <TT
CLASS="GUILABEL"
><B
>Running</B
></TT
> - Applications in the <TT
CLASS="GUILABEL"
><B
>running 
	    state</B
></TT
> are running normally in your session.  This is the 
	    default state for applications and the most common.
	  </P
></LI
><LI
STYLE="list-style-type: opencircle"
><P
>	    <B
CLASS="GUIICON"
>	      <IMG
SRC="stock_timer.png">
	    </B
>
	    <TT
CLASS="GUILABEL"
><B
>Starting</B
></TT
> - Applications in the <TT
CLASS="GUILABEL"
><B
>starting 
	    state</B
></TT
> are being given time to get running.  Most applications 
	    go to the <TT
CLASS="GUILABEL"
><B
>running state</B
></TT
> almost instanteously.  You 
	    usually won't see this state unless it takes a little bit of time for the 
	    application to start.
	  </P
></LI
><LI
STYLE="list-style-type: opencircle"
><P
>	    <B
CLASS="GUIICON"
>	      <IMG
SRC="stock_save.png">
	    </B
>
	    <TT
CLASS="GUILABEL"
><B
>Saving</B
></TT
> - Applications in the <TT
CLASS="GUILABEL"
><B
>saving 
	    state</B
></TT
> are saving their current settings and data.  This 
	    state occurs when the GNOME <SPAN
CLASS="SYSTEMITEM"
>session manager</SPAN
> 
	    tells each application to save when you logout or when you 
	    <A
HREF="index.html#SESSION-PROPERTIES-SAVE"
>save the session</A
> manually.
	  </P
></LI
><LI
STYLE="list-style-type: opencircle"
><P
>	    <B
CLASS="GUIICON"
>	      <IMG
SRC="stock_help.png">
	    </B
>
	    <TT
CLASS="GUILABEL"
><B
>Unknown</B
></TT
> - Applications in the <TT
CLASS="GUILABEL"
><B
>unknown 
	    state</B
></TT
> do not have any contact with the GNOME <SPAN
CLASS="SYSTEMITEM"
>	    session manager</SPAN
>.  This usually means the application 
	    has crashed.  If this happens highlight the application in <SPAN
CLASS="SYSTEMITEM"
>	    Session Properties</SPAN
> and then click the <A
HREF="index.html#SESSION-PROPERTIES-REMOVE"
>	    <B
CLASS="GUIBUTTON"
>Remove</B
></A
> button.
	  </P
></LI
></UL
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="SESSION-PROPERTIES-REMOVE"
>Remove Button</A
></H2
><P
>	<B
CLASS="GUIICON"
>	  <IMG
SRC="button_remove.png">
	</B
>
	The <B
CLASS="GUIBUTTON"
>Remove</B
> button removes the application from the GNOME 
	<A
HREF="index.html#SESSION-PROPERTIES-SCREENSHOT"
><SPAN
CLASS="SYSTEMITEM"
>session manager</SPAN
>
	</A
> and kills the application.  You should 
	use the <B
CLASS="GUIBUTTON"
>Remove</B
> button to kill an application after it 
	crashes or when its <TT
CLASS="GUILABEL"
><B
>state</B
></TT
> is <A
HREF="index.html#SESSION-PROPERTIES-RESPAWN"
>	<TT
CLASS="GUILABEL"
><B
>Respawn</B
></TT
></A
>.
      </P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="bugs.html"
>Next &#62;&#62;&#62;</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Known Bugs and Limitations</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>