Pileus Git - ~andy/gtk/blob - docs/reference/gtk/gtk-launch.xml

   1 <?xml version="1.0"?>
   2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
   3                "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
   4 ]>
   5 <refentry id="gtk-launch">
   6
   7 <refentryinfo>
   8   <title>gtk-launch</title>
   9   <productname>GTK+</productname>
  10   <authorgroup>
  11     <author>
  12       <contrib>Developer</contrib>
  13       <firstname>Tomáš</firstname>
  14       <surname>Bžatek</surname>
  15       <email>tbzatek@redhat.com</email>
  16     </author>
  17   </authorgroup>
  18 </refentryinfo>
  19
  20 <refmeta>
  21   <refentrytitle>gtk-launch</refentrytitle>
  22   <manvolnum>1</manvolnum>
  23   <refmiscinfo class="manual">User Commands</refmiscinfo>
  24 </refmeta>
  25
  26 <refnamediv>
  27   <refname>gtk-launch</refname>
  28   <refpurpose>Launch an application</refpurpose>
  29 </refnamediv>
  30
  31 <refsynopsisdiv>
  32 <cmdsynopsis>
  33 <command>gtk-launch</command>
  34 <arg>APPLICATION</arg>
  35 <arg choice="opt" rep="repeat">URI</arg>
  36 </cmdsynopsis>
  37 </refsynopsisdiv>
  38
  39 <refsect1><title>Description</title>
  40 <para>
  41 <command>gtk-launch</command> launches an application using the given name.
  42 The application is started with proper startup notification on a default
  43 display, unless specified otherwise.
  44 </para>
  45 <para>
  46 <command>gtk-launch</command> takes at least one argument, the name of
  47 the application to launch. The name should match application desktop file name,
  48 as residing in /usr/share/application, with or without the '.desktop' suffix.
  49 </para>
  50 <para>
  51 If called with more than one argument, the rest of them besides the application
  52 name are considered URI locations and are passed as arguments to the launched
  53 application.
  54 </para>
  55 </refsect1>
  56
  57 <refsect1><title>Options</title>
  58   <para>The following options are understood:</para>
  59   <variablelist>
  60     <varlistentry>
  61     <term><option>-?</option>, <option>--help</option></term>
  62       <listitem><para>Prints a short help text and exits.</para></listitem>
  63     </varlistentry>
  64   </variablelist>
  65 </refsect1>
  66
  67 </refentry>