[pkgsrc/trunk]: pkgsrc/doc/guide/files Add "Limitations of the Interix platfo...

[tv <tv%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/dc6d81066c88
branches:  trunk
changeset: 502019:dc6d81066c88
user:      tv <tv%pkgsrc.org@localhost>
date:      Tue Nov 01 17:14:04 2005 +0000

description:
Add "Limitations of the Interix platform" subsection.

diffstat:

 doc/guide/files/platforms.xml |  65 ++++++++++++++++++++++++++++++++++++++++--
 1 files changed, 61 insertions(+), 4 deletions(-)

diffs (86 lines):

diff -r 1cca8888cda3 -r dc6d81066c88 doc/guide/files/platforms.xml
--- a/doc/guide/files/platforms.xml     Tue Nov 01 16:30:05 2005 +0000
+++ b/doc/guide/files/platforms.xml     Tue Nov 01 17:14:04 2005 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: platforms.xml,v 1.17 2005/11/01 14:27:10 tv Exp $ -->
+<!-- $NetBSD: platforms.xml,v 1.18 2005/11/01 17:14:04 tv Exp $ -->
 
 <chapter id="platforms">
   <title>Using pkgsrc on systems other than &os;</title>
@@ -313,6 +313,64 @@
 </programlisting>
 
       </sect3>
+      <sect3 id="platform.interix-limits">
+       <title>Limitations of the Interix platform</title>
+
+       <para>Though Interix suffices as a familiar and flexible substitute
+         for a full Unix-like platform, it has some drawbacks that should
+         be noted for those desiring to make the most of Interix.</para>
+
+       <itemizedlist>
+
+         <listitem><emphasis role="strong">X-Windows:</emphasis>
+           <para>Interix comes with the standard set of X11R6 client libraries,
+           and can run X-Windows based applications, but it does
+           <emphasis>not</emphasis> come with an X server.  Some options are
+           <ulink url="http://www.starnet.com/products/xwin32/";>StarNet X-Win32</ulink>,
+           <ulink url="http://connectivity.hummingbird.com/products/nc/exceed/";>Hummingbird Exceed</ulink>,
+           and the free X-Windows server included with
+           <ulink url="http://x.cygwin.com/";>Cygwin</ulink>.</para>
+
+           <para>Also, StarNet Communications has graciously provided a free
+           version of their X-Win32 product that accepts connections only
+           from localhost:
+           <ulink url="http://www.starnet.com/xwin32LX/get_xwin32LX.htm";>X-Win32 LX</ulink>,
+           recommended by the maintainer of Interix pkgsrc support.</para></listitem>
+
+         <listitem><emphasis role="strong">X-Windows acceleration:</emphasis>
+           <para>Because Interix runs in a completely different NT subsystem from
+           Win32 applications, it does not currently support various X11
+           protocol extensions for acceleration (such as MIT-SHM or DGA).
+           Most interactive applications to a local X server will run
+           reasonably fast, but full motion video and other graphics
+           intensive applications may require a faster-than-expected CPU.</para></listitem>
+
+         <listitem><emphasis role="strong">Audio:</emphasis>
+           <para>Interix has no native support for audio output.  To provide audio
+           support, pkgsrc uses the <command>esound</command> client/server
+           audio system on Interix.  Unlike on most platforms, the
+           <filename role="pkg">audio/esound</filename> package does
+           <emphasis>not</emphasis> contain the <command>esound</command>
+           server component.  To output audio, the
+           <filename role="pkg">emulators/cygwin_esound</filename> package
+           must also be installed.</para></listitem>
+
+         <listitem><emphasis role="strong">CD/DVDs, USB, and SCSI:</emphasis>
+           <para>Direct device access is not currently supported in Interix, so it
+           is not currently possible to access CD/DVD drives, USB devices,
+           or SCSI devices through non-filesystem means.  Among other things,
+           this makes it impossible to use Interix directly for CD/DVD
+           burning.</para></listitem>
+
+         <listitem><emphasis role="strong">Tape drives:</emphasis>
+           <para>Due to the same limitations as for CD-ROMs and SCSI devices, tape
+           drives are also not directly accessible in Interix.  However,
+           support is in work to make tape drive access possible by using
+           Cygwin as a bridge (similarly to audio bridged via Cygwin's
+           esound server).</para></listitem>
+
+       </itemizedlist>
+      </sect3>
       <sect3 id="platform.interix-knownissues">
        <title>Known issues for pkgsrc on Interix</title>
 
@@ -328,9 +386,8 @@
          Administrator (or your language equivalent), or run the following
          command after installing a package to work around the issue:</para>
 
-<programlisting>
-    chmod -R g+w $PKG_DBDIR
-</programlisting>
+       <screen>
+&rprompt; <userinput>chmod -R g+w $PKG_DBDIR</userinput></screen>
 
       </sect3>
     </sect2>