Copyright © 2020 Red Hat, Inc.

  This program is free software; you can redistribute it and/or modify

  it under the terms of either:

  * the GNU General Public License as published by the Free

    Software Foundation; either version 3 of the License, or (at your

    option) any later version.

  or

  * the GNU Free Documentation License version 1.3 as published by the

    Free Software Foundation; with no Invariant Sections, no Front-Cover

    Texts, and no Back-Cover Texts.

  or both in parallel, as here.

  This program is distributed in the hope that it will be useful,

  but WITHOUT ANY WARRANTY; without even the implied warranty of

  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

  GNU General Public License and the GNU Free Documentation License

  for more details.

  You should have received a copy of the GNU General Public License and

  of the GNU Free Documentation License along with this program.

  If not, see <https://www.gnu.org/licenses/>.

-->

<refentry id="gnome-terminal.1">

  <refentryinfo>

    <title>gnome-terminal</title>

    <date>June 2020</date>

    <productname>GNOME</productname>

  </refentryinfo>

  <refmeta>

    <refentrytitle>gnome-terminal</refentrytitle>

    <manvolnum>1</manvolnum>

    <refmiscinfo class="manual">User Commands</refmiscinfo>

  </refmeta>

  <refnamediv>

    <refname>gnome-terminal</refname>

    <refpurpose>A terminal emulator for GNOME</refpurpose>

  </refnamediv>

  <refsynopsisdiv>

    <cmdsynopsis>

      <command>gnome-terminal</command>

    </cmdsynopsis>

  </refsynopsisdiv>

  <refsect1>

    <title>DESCRIPTION</title>

    <para>

      <command>gnome-terminal</command> is a terminal emulator application for

      accessing a UNIX shell environment which can be used to run programs

      available on your system. It supports several profiles, multiple tabs and

      implements several keyboard shortcuts.

    </para>

  </refsect1>

  <refsect1>

    <title>OPTIONS</title>

    <variablelist>

      <varlistentry>

        <term><option>--help, -h</option></term>

        <listitem>

          <para>

            Show a brief overview of all the options.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--help-all</option></term>

        <listitem>

          <para>

            Show all the options in detail.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--help-gtk</option></term>

        <listitem>

          <para>

            Show all the GTK options.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--help-terminal</option></term>

        <listitem>

          <para>

            Show all the options to select between new terminal tabs or

            windows.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--help-terminal-options</option></term>

        <listitem>

          <para>

            Show all the options to change the attributes of terminals

            regardless of whether they are in separate tabs or windows.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--help-window-options</option></term>

        <listitem>

          <para>

            Show all the options to change the attributes of windows

            containing terminals.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--load-config=FILE</option></term>

        <listitem>

          <para>

            Restore the application to a previously saved state by loading it

            from a configuration file.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--preferences</option></term>

        <listitem>

          <para>

            Show the preferences window.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--print-environment, -p</option></term>

        <listitem>

          <para>

            Print the environment variables to interact with newly created

            terminals.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--quiet, -q</option></term>

        <listitem>

          <para>

            Suppress diagnostics.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--verbose, -v</option></term>

        <listitem>

          <para>

            Increase diagnostic verbosity.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--tab</option></term>

        <listitem>

          <para>

            Open a new tab containing a terminal in the last-opened window with

            the default profile.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--window</option></term>

        <listitem>

          <para>

            Open a new window with a tab containing a terminal with the default

            profile.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--command, -e=COMMAND</option></term>

        <listitem>

          <para>

            Execute the argument to this option inside the terminal.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--fd=FD</option></term>

        <listitem>

          <para>

            Forward file descriptor.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--profile=PROFILE-NAME</option></term>

        <listitem>

          <para>

            Use the given profile instead of the default profile.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--title, -t=TITLE</option></term>

        <listitem>

          <para>

            Set the initial terminal title.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--wait</option></term>

        <listitem>

          <para>

            Wait until the terminal's child exits.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--working-directory=DIRNAME</option></term>

        <listitem>

          <para>

            Set the terminal's working directory.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--zoom=ZOOM</option></term>

        <listitem>

          <para>

            Set the terminal's zoom factor. 1.0 is normal size.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--active</option></term>

        <listitem>

          <para>

            Set the last specified tab as the active one in its window.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--full-screen</option></term>

        <listitem>

          <para>

            Full-screen the window.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--geometry=GEOMETRY</option></term>

        <listitem>

          <para>

            Set the window size as COLSxROWS+X+Y. For example, 80x24 or

            80x24+200+200.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--hide-menubar</option></term>

        <listitem>

          <para>

            Turn off the menubar for the window.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--show-menubar</option></term>

        <listitem>

          <para>

            Turn on the menubar for the window.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--maximize</option></term>

        <listitem>

          <para>

            Maximize the window.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--role=ROLE</option></term>

        <listitem>

          <para>

            Set the X window role.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--class=CLASS</option></term>

        <listitem>

          <para>

            Program class as used by the window manager.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--display=DISPLAY</option></term>

        <listitem>

          <para>

            X display to use.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--g-fatal-warnings</option></term>

        <listitem>

          <para>

            Make all warnings fatal.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--gdk-debug=FLAGS</option></term>

        <listitem>

          <para>

            GDK debugging flags to set.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--gdk-no-debug=FLAGS</option></term>

        <listitem>

          <para>

            GDK debugging flags to unset.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--gtk-debug=FLAGS</option></term>

        <listitem>

          <para>

            GTK debugging flags to set.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--gtk-no-debug=FLAGS</option></term>

        <listitem>

          <para>

            GTK debugging flags to unset.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--gtk-module=MODULES</option></term>

        <listitem>

          <para>

            Load additional GTK modules.

          </para>

        </listitem>

      </varlistentry>

      <varlistentry>

        <term><option>--name=NAME</option></term>

        <listitem>

          <para>

            Program name as used by the window manager.

          </para>

        </listitem>

      </varlistentry>

    </variablelist>

  </refsect1>

  <refsect1>

    <title>BUGS</title>

    <para>

      Please read

      <ulink url="https://wiki.gnome.org/Apps/Terminal/ReportingBugs"></ulink>

      on how to report bugs.

    </para>

  </refsect1>

  <refsect1>

    <title>SEE ALSO</title>

    <para>

      For further information, visit the website

      <ulink url="https://wiki.gnome.org/Apps/Terminal"></ulink>. There's a

      list of frequently asked questions at

      <ulink url="https://wiki.gnome.org/Apps/Terminal/FAQ"></ulink>.

    </para>

  </refsect1>

</refentry>