[gnome-terminal/wip/rishi/manual] Add a manual
- From: Debarshi Ray <debarshir src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gnome-terminal/wip/rishi/manual] Add a manual
- Date: Fri, 19 Jun 2020 15:16:06 +0000 (UTC)
commit 8e897c7bf3a49e03c9ea5411b4dae445a284aefb
Author: Debarshi Ray <debarshir gnome org>
Date: Wed Jun 17 12:59:48 2020 +0200
Add a manual
https://gitlab.gnome.org/GNOME/gnome-terminal/-/issues/277
Makefile.am | 2 +-
configure.ac | 9 ++
man/Makefile.am | 18 +++
man/gnome-terminal.xml | 385 +++++++++++++++++++++++++++++++++++++++++++++++++
4 files changed, 413 insertions(+), 1 deletion(-)
---
diff --git a/Makefile.am b/Makefile.am
index eb374169..5ec65d8f 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -1,4 +1,4 @@
-SUBDIRS = data src po help
+SUBDIRS = data man src po help
NULL =
diff --git a/configure.ac b/configure.ac
index c816e36f..6c1a2a23 100644
--- a/configure.ac
+++ b/configure.ac
@@ -169,6 +169,14 @@ if test -z "$DESKTOP_FILE_VALIDATE"; then
fi
fi
+AC_ARG_VAR([XSLTPROC],[the xsltproc programme])
+if test -z "$XSLTPROC"; then
+ AC_PATH_PROG([XSLTPROC],[xsltproc],[])
+ if test -z "$XSLTPROC"; then
+ AC_MSG_ERROR([xsltproc not found])
+ fi
+fi
+
# ***************************
# GNOME Shell search provider
# ***************************
@@ -307,6 +315,7 @@ Makefile
org.gnome.Terminal.desktop.in
data/Makefile
data/icons/Makefile
+man/Makefile
src/Makefile
src/terminal-version.h
help/Makefile
diff --git a/man/Makefile.am b/man/Makefile.am
new file mode 100644
index 00000000..ecce224d
--- /dev/null
+++ b/man/Makefile.am
@@ -0,0 +1,18 @@
+XSLTPROC_FLAGS = \
+ --nonet \
+ --stringparam man.output.quietly 1 \
+ --stringparam funcsynopsis.style ansi \
+ --stringparam man.authors.section.enabled 0 \
+ --stringparam man.copyright.section.enabled 0
+
+.xml.1:
+ $(AM_V_GEN) $(XSLTPROC) $(XSLTPROC_FLAGS)
http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $<
+
+man_MANS = \
+ gnome-terminal.1
+
+xml_files = $(man_MANS:.1=.xml)
+
+EXTRA_DIST = $(xml_files)
+
+CLEANFILES = $(man_MANS)
diff --git a/man/gnome-terminal.xml b/man/gnome-terminal.xml
new file mode 100644
index 00000000..abdac002
--- /dev/null
+++ b/man/gnome-terminal.xml
@@ -0,0 +1,385 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ 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>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]