Move documentation to inline comments: GtkToggleButton

[~andy/gtk] / docs / reference / gtk / x11.sgml

diff --git a/docs/reference/gtk/x11.sgml b/docs/reference/gtk/x11.sgml
index 9054e42a913b651299da4373a863bb6fbf27bf32..0a8ad33f90e8517391c173086a2393751e4ec483 100644 (file)
--- a/docs/reference/gtk/x11.sgml
+++ b/docs/reference/gtk/x11.sgml
@@ -1,4 +1,8 @@
-<refentry id="gtk-x11" revision="17 Jan 2002">
+<?xml version="1.0"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
+]>
+<refentry id="gtk-x11">
 <refmeta>
 <refentrytitle>Using GTK+ on the X Window System</refentrytitle>
 <manvolnum>3</manvolnum>
@@ -16,17 +20,42 @@ X11 aspects of using GTK+
 <title>GTK+ for the X Window System</title>
 
 <para>
-On UNIX, the X backend is the default build for GTK+. So 
-you don't need to do anything special when compiling it,
+On UNIX, the X backend is the default build for GTK+.
+So you don't need to do anything special when compiling it,
 and everything should "just work."
 </para>
 
 <para>
-To mix low-level Xlib routines into a GTK program, 
+To mix low-level Xlib routines into a GTK program,
 see <link linkend="gdk-X-Window-System-Interaction">GDK X Window
 System interaction</link> in the GDK manual.
 </para>
 
+<para>
+GTK+ includes an cross-process embedding facility in the form of
+the #GtkSocket and #GtkPlug widgets. These are X11-specific, and
+you have to include the <filename>gtk/gtkx.h</filename> header
+to use them.
+</para>
+
+<refsect2 id="x11-cmdline">
+<title>X11-specific commandline options</title>
+
+<para>
+The X backend understands some additional command line arguments.
+</para>
+
+<formalpara>
+<title><systemitem>--display <replaceable>display</replaceable></systemitem></title>
+
+<para>
+The name of the X display to open instead of the one specified
+in the <envar>DISPLAY</envar> environment variable.
+</para>
+</formalpara>
+
+</refsect2>
+
 </refsect1>
 
 <refsect1 id="gtk-X11-arch">
@@ -96,6 +125,11 @@ window managers <emphasis>will</emphasis> ignore certain requests from
 time to time, in the interests of good user interface.
 </para>
 
+<!--
+May also want to explain DESKTOP_STARTUP_ID here. 
+http://www.freedesktop.org/Standards/startup-notification-spec
+-->
+
 </refsect2>
 
 </refsect1>