cygwin-x-doc/faq cygwin-x-faq.xml, 1.6, 1.7 errors.xml, 1.11, 1.12 general.xml, 1.4, 1.5 trouble.xml, 1.9, 1.10

[Alexander Gottwald]

Committed by: ago

Update of /cvs/xserver/cygwin-x-doc/faq
In directory gabe:/tmp/cvs-serv14907

Modified Files:
	cygwin-x-faq.xml errors.xml general.xml trouble.xml 
Log Message:
Added FAQ:
    What does :0.0 mean?
created shortcuts for commonly used terms like XWin.exe, multiwindow ...    


Index: cygwin-x-faq.xml
===================================================================
RCS file: /cvs/xserver/cygwin-x-doc/faq/cygwin-x-faq.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -d -r1.6 -r1.7
--- cygwin-x-faq.xml	20 Apr 2004 23:58:59 -0000	1.6
+++ cygwin-x-faq.xml	24 Sep 2004 12:37:25 -0000	1.7
@@ -63,6 +63,15 @@
 <!ENTITY atw-home "http://www.answersthatwork.com/">
 <!ENTITY atw-url-tasklist-a "http://www.answersthatwork.com/Tasklist_pages/tasklist_a.htm">
 <!ENTITY atw-title-tasklist-a "Task List Programs - A">
+
+<!-- commonly used strings -->
+<!ENTITY XWin "<filename>&file-server-exe;</filename>">
+
+<!ENTITY multiwindow "<parameter>-multiwindow</parameter>">
+<!ENTITY fullscreen "<parameter>-fullscreen</parameter>">
+<!ENTITY nodecoration "<parameter>-nodecoration</parameter>">
+
+<!ENTITY DISPLAY "<parameter>DISPLAY</parameter>">
 ]>
 
 <article class="faq" id="cygwin-x-faq">
@@ -79,6 +88,11 @@
 <lineage>II</lineage>
 </author>
 
+<author>
+<firstname>Alexander</firstname>
+<surname>Gottwald</surname>
+</author>
+
 <legalnotice id="legal-notice">
 <blockquote id="legal-notice-quote"><para> Copyright (c) 2001 Harold L
 Hunt II.  Permission is granted to copy, distribute and/or modify this

Index: errors.xml
===================================================================
RCS file: /cvs/xserver/cygwin-x-doc/faq/errors.xml,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -d -r1.11 -r1.12
--- errors.xml	24 Sep 2004 09:31:08 -0000	1.11
+++ errors.xml	24 Sep 2004 12:37:25 -0000	1.12
@@ -31,16 +31,16 @@
 <para>Duplicate invocation on display number: 0.  Exiting.</para>
 </question>
 <answer>
-<para>Most likely you have started <filename>&file-server-exe;</filename> 
-twice with <filename>startxwin.bat</filename> or <filename>startx</filename> 
+<para>Most likely you have started &XWin; twice with <filename>startxwin.bat
+</filename> or <filename>startx</filename> 
 or a similar script.</para>
 
-<para>if you start multiple instances of <filename>&file-server-exe;</filename> you have to start to number them
-</para>
+<para>if you start multiple instances of &XWin; you have to start to number 
+them </para>
 
-<para><screen>XWin -query foo
-XWin :1 -query bar
-XWin :2 -query blubb
+<para><screen>&file-server-exe; -query foo
+&file-server-exe; :1 -query bar
+&file-server-exe; :2 -query blubb
 </screen>
 Specifying no number is the same as using <parameter>:0</parameter></para>
 

Index: general.xml
===================================================================
RCS file: /cvs/xserver/cygwin-x-doc/faq/general.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5
--- general.xml	3 Apr 2004 07:14:26 -0000	1.4
+++ general.xml	24 Sep 2004 12:37:25 -0000	1.5
@@ -81,6 +81,45 @@
 </answer>
 </qandaentry>
 
+<qandaentry>
+<question id="display-and-screen">
+<para>What does :0.0 mean?</para>
+</question>
+<answer>
+<para>The <replaceable>:0.0</replaceable> part of the &DISPLAY; variable denote
+the display and the screen of an X server.</para>
+<para>The display is the first number and equals to a running instance of an 
+X server. If it is using TCP/IP for communication it listens on port 6000 + 
+<replaceable>display-number</replaceable> for connections.
+With local (UNIX domain sockets) it uses the socket 
+<filename>/tmp/.X11-unix/X<replaceable>display-number</replaceable></filename>
+</para>
+<para> The screen denotes different output devices of the X server. You could 
+start &XWin; with two <parameter>-screen</parameter> options and would end up 
+with two X11 windows. Each of them is a different screen. Other X servers open
+different screens for different monitors connected to the computer.</para>
+<para>&project; supports different formats of the &DISPLAY; variable
+<itemizedlist>
+<listitem>
+<para>
+<replaceable>:0.0</replaceable> or <replaceable>unix:0.0</replaceable>
+</para>
+<para>
+This names a local X server and the communication uses the UNIX domain sockets.
+</para>
+</listitem>
+<listitem>
+<para>
+<replaceable>hostname:0.0</replaceable>
+</para>
+<para>
+This names a remote X server and the communication uses the TCP/IP network.
+</para>
+</listitem>
+</itemizedlist>
+</para>
+</answer>
+</qandaentry>
 
 <qandaentry>
 <question id="q-why-port-to-windows">

Index: trouble.xml
===================================================================
RCS file: /cvs/xserver/cygwin-x-doc/faq/trouble.xml,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -d -r1.9 -r1.10
--- trouble.xml	23 Sep 2004 19:46:12 -0000	1.9
+++ trouble.xml	24 Sep 2004 12:37:25 -0000	1.10
@@ -187,7 +187,9 @@
 <para>Why is the root window not shown in normal mode?</para>
 </question>
 <answer>
-<para>This is a small problem with <filename>run.exe</filename>. If you start <filename>&file-server-exe;</filename> with <parameter>-nodecoration</parameter>, <parameter>-multiwindow</parameter> or <parameter>-fullscreen</parameter> the window will come up normally.</para>
+<para>This is a small problem with <filename>run.exe</filename>. If you start 
+&XWin; with &nodecoration;, &multiwindow; or &fullscreen; the window will come 
+up normally.</para>
 </answer>
 </qandaentry>