<appendix id="command-line-options">
<title>Command Line Options</title>
  <para>
    You can pass any number of URLs to Galeon and they will be opened on
    startup. If a Galeon process is currently running, the URLs will be
    forwarded to the existing process. Galeon supports standard GNOME and
    GTK options (such as <command>--help</command>, <command>-?</command>)
    and the following Galeon-specific command line options:

    <variablelist>

      <varlistentry>
        <term><command>--new-tab</command>,
        <command>-n</command></term>
        <listitem><para>
	  Opens the specified URL in a new tab in an existing window.
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><command>--new-window</command>,
        <command>-w</command></term>
        <listitem><para>
          Opens the specified URL in a new window.
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><command>--fullscreen</command>,
        <command>-f</command></term>
        <listitem><para>
          Starts <application>Galeon</application> in fullscreen mode.
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><command>--existing</command>,
        <command>-x</command></term>
        <listitem><para>
          Opens the specified URL in an existing window (if one exists) 
          instead of creating a new one.
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term><command>--server</command>,
        <command>-s</command></term>
        <listitem><para>
	  Launches <application>Galeon</application> in server mode.  In
	  this mode, no windows are opened, but most of the data that
	  <application>Galeon</application> needs is loaded and kept in
	  memory.  After running a copy of
	  <application>Galeon</application> in server mode, future
	  instances of <application>Galeon</application> will take much
	  less time to start.
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term>
          <command>--add-temp-bookmark=<replaceable>URL</replaceable></command>, 
          <command>-t <replaceable>URL</replaceable></command>
        </term>
        <listitem><para>
          Adds a temporary bookmark and exits. Only a URL can be specified.
        </para></listitem>
      </varlistentry>

      <varlistentry>
        <term>
          <command>--geometry=<replaceable>GEOMETRY</replaceable></command>, 
          <command>-g <replaceable>GEOMETRY</replaceable></command>
        </term>
        <listitem>
        <para>
          Open a window with the specified GEOMETRY. Window geometry is
          specified in the following format:
	  <command><replaceable>width</replaceable>x<replaceable>height</replaceable>+<replaceable>x</replaceable>+<replaceable>y</replaceable></command>
        </para>
        <para>
	  E.g. <command>800x600+0+0</command> would open a browser window
	  positioned in the top left corner of the screen with a width of
	  800 pixels and a height of 600 pixels.
        </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>
	  <command>--close</command>, <command>-c</command>
	</term>
	<listitem><para>
	  Closes all <application>Galeon</application> windows.
	</para></listitem>
      </varlistentry>

      <varlistentry>
        <term>
	  <command>--quit</command>, <command>-q</command>
	</term>
	<listitem><para>
	  Closes all <application>Galeon</application> windows and exits
	  from server mode.
	</para></listitem>
      </varlistentry>

    </variablelist>
  </para>
</appendix>

