README for XFree86 3.1.2D on OS/2 <author>Holger Veit <Date>Last modified on: 20 Feb 1996 <toc> <sect>Introductory Note about the ALPHA release 3.1.2D Before looking into this file, please check for any LATEST.OS2 files that may come with the binary distribution. Some statements made here refer to the official public version of XFree86/OS2, and may not be fully functional in the alpha release. This version of the code is called XFree86/OS2 3.1.2D. The letter ``D'', according to the naming rules of XFree86, usually denotes a (public) beta version of the code. Since this is the first public version of XFree86/OS2 at all, this code is considered having ALPHA quality only. The purpose of this release is to test it widely without restrictions in a large number of configurations and find bugs that are still existing in the distribution. It is also intended as a developer's platform to port and write applications based on the X11 programming interfaces provided here. This release is complete (with one exception) regarding the X11R6.1 ``core'' distribution. The ``contrib'' distribution containing some of the more interesting tools for the end user, will be issued together with a later release (no need to start porting it independently). This version is therefore intended for the experienced and knowledged software engineer only, not for a casual end user. This means - and this should be taken serious - that <itemize> <item> there is no explicit or implicit warranty that certain code works correctly or works at all <item> this code may damage your hardware; this includes improper configuration or bugs still present in the software <item> this code may destroy or damage your data on the storage media, crash or lock up the operating system and even damage data on different disk partitions </itemize> You are urged to make a backup of your complete system and keep it in a safe place before you attempt to load any of this software on your disk. This even holds if you already have a working copy of XFree86-3.1.2D running on another platform, such as Linux, and found it working without problems. This is XFree86/OS2 which differs in a number of critical aspects from any Unix implementation of XFree86. If you are afraid to try out this code, simply don't use it and wait for a future, hopefully more bug-free version. <sect>What and Where is XFree86? XFree86 is a port of X11R6 that supports several versions of Intel-based Unix. It is derived from X386 1.2, which was the X server distributed with X11R5. This release consists of many new features and performance improvements as well as many bug fixes. The release is available as source patches against the X Consortium X11R6 code, as well as binary distributions for many architectures. XFree86/OS2 is the tentative work title for the implementation of XFree86 on OS/2 based systems. See the <url url="COPYRIGHT.html" name="Copyright Notice">.  Binaries for OS/2 2.11 and OS/2 Warp are available from: <url name="ftp.XFree86.org:/pub/XFree86/beta/binaries/OS2" url="ftp://ftp.XFree86.org/pub/XFree86/beta/binaries/OS2"> more archives to be added ... Other versions: XFree86/OS2 will run on all dialects of Warp, including Warp "red spine box", Warp "blue spine box", Warp Connect and Warp Server (beta 1 and 2). Fixpack level 5 is mandatory, a later fixpack level (10 or 17) is recommended. XFree86/OS2 appears to work under OS/2 2.11 with fixpack 100, but this was not checked in all details, so hidden problems may still exist. It is unlikely that it will run stable under OS/2 2.0 and 2.1, and it will definitely not run with any OS/2 1.X. It is possible to build XFree86/OS2 from the sources. Read about this in some section below. <sect>Bug Reports for This Document Send email to <em/Holger.Veit@@gmd.de/ (Holger Veit) or <em/XFree86@@XFree86.org/ if you have comments or suggestions about this file and we'll revise it. <sect>Hardware and Software Requirements <sect1>Supported, Required, and Recommended Hardware <itemize> <item> At least a 486DX33 with 16MB RAM is required. A Pentium or Pentium Pro and more main memory is recommended. A 386 or a system with 8MB or less memory is an insufficient configuration. <item> There are no specific requirements concerning network cards, disk types, or CD ROM equipment; of course the more powerful, the better. <item> Depending on the packages installed, a disk space of 20-55MB on a HPFS formatted partition (or a NFS partition natively allowing long filenames) is required. XFree86/OS2 will not run on FAT partitions. <item> You need a video card that is supported by XFree86. Refer to the general README document for a list of supported cards. Note that the sets of video cards supported by XFree86 on one hand and OS/2 on the other hand overlap, but do not match exactly, i.e. the fact that your card is supported by OS/2 does not mean it works with XFree86 as well, and vice versa. XFree86 does not use the video services of the OS/2 operating system. </itemize> <sect1>Required Software <itemize> <item> OS/2 2.11 with fixpack 100 and all versions of Warp with at least fixpack level 5 are required. <item> In the version 3.1.2D, you need certain networking TCP/IP software. In a future version, this restriction might be no longer present. <enum> <item> For OS/2 2.11, IBM TCP/IP 2.0 or later is mandatory. <item> Warp comes with the Internet Access Kit (IAK), which is sufficient. Warp Connect and Warp Server come with a full version of TCP/IP (3.0). Use of this software is preferred over IAK then. </enum> Other versions of TCP/IP, such as FTP's, DEC's, or Hummingbird's TCP/IP versions, as well as IBM TCP/IP 1.X are not supported. Nor does any networking support from DOS (packet drivers, winsock), Netware, or NetBIOS work, and I won't to provide support for that in the future. <item> If you want to write or port applications for XFree86, you are encouraged to do so. You will need a complete installation of EMX/gcc 0.9B fix 1 or later for doing so. Neither the second (obsolete) implementation of gcc, nor any commercial package, including Cset/2, VAC++, Borland C++/OS2, Watcom C++, Metaware C, and others, is suitable for porting, because various parts of the X DLLs rely on certain features only present with EMX. </itemize> <sect>Installing the System The binary distribution is composed of a number of zip archives which are the executables, servers, fonts, libraries, include files, man pages, and config files. The full distribution requires about 40-55MB of disk space. All archives of this alpha version are packed with the <tt/info-zip/ utility, which is available under the name <tt/UNZ512X2.EXE/ from many OS/2 archives. Please obtain a native OS/2 version of this unpacker. DOS <tt/PKUNZIP/ does not work, because it cannot unpack long file names and extended attributes. At this moment, the distribution covers only the ``core'' distribution which somewhat reduces the usability. Some of the more interesting clients from the ``contrib'' area will be made available in the future. The contents of the packages are: <descrip> <tag/REQUIRED:/ <descrip> <tag/312Dbase/ A special device driver and the SuperProbe program <tag/312Ddoc/ READMEs and XFree86 specific man pages. <tag/312Dbin/ all of the executable X client applications and shared libs <tag/312Dfnts/ the misc and 75dpi fonts <tag/312Dlib/ data files needed at runtime <tag/emxrt/ Runtime libraries of EMX </descrip> Choose at least one of the following to match your hardware: <descrip> <tag/312D8514/ the X server for IBM 8514/A and compatible boards <tag/312DAGX/ the X server for AGX boards <tag/312DI128/ the X server for #9 Imagination 128 boards <tag/312DMa32/ the X server for ATI Mach32 graphics boards <tag/312DMa64/ the X server for ATI Mach64 graphics boards <tag/312DMa8/ the X server for ATI Mach8 graphics boards <tag/312DMono/ the Monochrome X Server <tag/312DP9K/ the X server for P9000 based boards <tag/312DS3/ the X server for S3 based boards <tag/312DSvga/ the 8-bit pseudo-color X server for Super VGA cards <tag/312Dvg16/ the 4-bit pseudo-color X server for VGA & SVGA cards. <tag/312Dw32/ the X server for et4000w32 based boards </descrip> <tag/OPTIONAL:/ <descrip> <tag/312Dman/ pre-formatted man pages for the X11 interface and clients <tag/312Df100/ 100dpi fonts <tag/312Dfscl/ Speedo and Type1 fonts <tag/312Dfnon/ Japanese, Chinese and other fonts <tag/312Dfcyr/ Cyrillic fonts <tag/312Dfsrv/ the font server with man pages. <tag/312Dprog/ the X11 header files and programmer's utilities for compiling other X applications <tag/312Dpex/ PEX fonts and libraries required for PEX applications <tag/312Dnest/ the Xnest X server </descrip> </descrip> In order to save space on your disk and reduce net bandwidth, choose the software to obtain carefully. Each X server is an archive of about 1.4MB and occupies 2.5MB on the disk. You won't normally need more than the single Xserver tailored to your video card. If it is your first time install, get the <tt/312Dbase/ archive before any of the other packages. This package contains a driver and a test program, which analyzes your video hardware. If this program fails or reports an incompatible hardware, it makes no sense to obtain the other packages in the hope that they would magically work. <sect> Checking Compatibility of Video Hardware In the following, we assume that you want to install XFree86/OS2 on a disk drive with the letter Y: (which you probably don't have). Change the letter in all commands accordingly. <enum> <item> Obtain the package <tt/312Dbase/ and install it from the root directory of the Y: drive, by entering the following commands: <tscreen><verb> [C:\] Y: [Y:\] cd \ [Y:\] unzip \path_of_package\312Dbase.zip </verb></tscreen> <item> Edit your CONFIG.SYS file to contain the following line somewhere: <tscreen><verb> DEVICE=Y:\XFree86\lib\xf86sup.sys </verb></tscreen> Of course replace ``Y:'' with the correct drive letter. <item> At this point, you may consider to add the variables required for XFree86/OS2 as well, which will save you from one additional reboot. Refer to section <ref id="envvar" name="Adding Variables to CONFIG.SYS"> below. <item> After adding the device driver entry to the CONFIG.SYS file, you must reboot to install the driver. XFree86/OS2 will not work without this driver. <item> Start a full screen OS/2 CMD session and enter the following command: <tscreen><verb> [C:\] Y:\XFree86\bin\SuperProbe </verb></tscreen> <item> This command will (normally) report important information about your video configuration, i.e. the type of chipset, the available video memory and the RAMDAC circuit available. Please write this down or redirect the output of ``SuperProbe'' into a file by entering: <tscreen><verb> [C:\] Y:\XFree86\bin\SuperProbe >filename </verb></tscreen> <item> SuperProbe can identify many more video cards than are supported by XFree86. Therefore lookup the reported type in the compatibility list, and also check the accompanying README.* files for special conditions and requirements. If the card is not mentioned or marked as unsupported, the game is over for you now, unfortunately. <item> Otherwise chances are good, that you can run XFree86/OS2. Obtain the rest of the software and proceed with the next section. </enum> <sect> Installing the packages XFree86/OS2 assumes a directory hierarchy starting from <tt>drive:\XFree86</tt>. This can be changed, but is strictly discouraged. <enum> <item> Choose a HPFS partition with sufficient free space. <item> For each package to install, go to the root directory of this drive, and type: <tscreen><verb> drive:> cd \ drive:> unzip \path_of_packages\312Dxxxx.zip </verb></tscreen> </enum> <sect> Adding Variables to CONFIG.SYS <label id="envvar"> XFree86/OS2 requires a number of settings in the CONFIG.SYS file to work correctly. Please add the following settings: <descrip> <tag/TERM/ Set the preferred terminal type for the xterm or editor to be used. Some programs need this setting. I have my type set to <tscreen><verb>SET TERM=ansi</verb></tscreen> <tt>\XFree86\lib\X11\etc\termcap.x11</tt> contains a suitable termcap which can be used in place of termcap files that come with EMX, EMACS, or other ported software. <tag/TERMCAP/ This variable must be set to the location where the termcap file used for the above <tt/TERM/ variable is searched. My setting, for instance, is: <tscreen><verb>SET TERMCAP=D:/EMX/ETC/TERMCAP.X11</verb></tscreen> Note that forward ``/'' is used as a directory separator. <tag/ETC/ Set to an ETC directory. Normally, this is already set to the ETC directory of the TCP/IP code, such as <tscreen><verb>SET ETC=C:\TCPIP\ETC</verb></tscreen> <tag/TMP/ Set to an TMP directory. Normally, this is already set to the TMP directory of the TCP/IP code, such as <tscreen><verb>SET TMP=C:\TCPIP\TMP</verb></tscreen> <tag/HOSTNAME/ Set to the internet hostname. Normally, this is already set by the TCP/IP installation program, such as <tscreen><verb>SET HOSTNAME=myhost</verb></tscreen> With IAK, you would normally run a loopback configuration <ref id="loopback" name="Network configuration"> and would then set this to <tscreen><verb>SET HOSTNAME=localhost</verb></tscreen> <tag/USER/ <tag/LOGNAME/ Set both to a username. Currently, they are there just to make some programs happy; in the future, this variable might be set by a login shell of a multiuser configuration. My variable, for instance, is set to <tscreen><verb> SET USER=holger SET LOGNAME=holger </verb></tscreen> <tag/HOME/ Set this to an existing directory that is supposed to be a home directory of a user. Some utilities place temporary and init files here. This is also future investment for a multiuser configuration, but must still be there. For instance, this variable might be set to <tscreen><verb>SET HOME=H:\user\holger</verb></tscreen> <tag/X11ROOT/ This is one of the most important settings, it determines the root of the XFree86 directory tree. Normally, you will set this to the drive letter of the partition where the \XFree86 tree resides, such as in <tscreen><verb>SET X11ROOT=Y:</verb></tscreen> You may try to move the tree to another subdirectory, e.g. to <tt>K:\OS2\X11\XFree86...</tt> and would then have to change this to <tscreen><verb>SET X11ROOT=K:/OS2/X11</verb></tscreen>, but this is discouraged, since some utilities might not accept this. Note the forward ``/'' as a directory separator here. <tag/DISPLAY/ This variable may be set to the display to be used for displaying clients. Normally you will set this variable to the same value as the <tt/HOSTNAME/ variable and simply add a <tt/:0.0/ after it, such as <tscreen><verb>SET DISPLAY=myhost:0.0</verb></tscreen> Read the X11 man page on the exact meaning of these postfixes and other options. <tag/XSERVER/ Set this to the executable name of the X server to be used. This must be a complete path. My setting is as follows: <tscreen><verb>SET XSERVER=D:/XFree86/bin/XF86_Mach64.exe</verb></tscreen> <tag/PATH/ Add the binary directory for the X11 utilities to your search PATH. This is normally the directory (adjust the letter) <tscreen><verb>Y:\XFree86\bin</verb></tscreen> It is possible to move the binaries to another directory in the search path; for maintenance reasons and clarity of the structure, this is not recommended, though. <tag/LIBPATH/ Add the DLL directory for the X11 utilities to the LIBPATH. This is normally the directory (adjust the letter) <tscreen><verb>Y:\XFree86\lib</verb></tscreen> It is possible to move the DLLs to another directory in the library path; for maintenance reasons and clarity of the structure, this is not recommended, though. Note that <tt>Y:\XFree86\lib</tt> has several other subdirectories; these may not be moved elsewhere, rather they must stay there, because most utilities form a path to these directories by using <tt>%X11ROOT%\XFree86\lib</tt> as a base. </descrip> <sect> Remarks on the Network Configuration It is beyond the scope of this document to even give an introduction about the correct installation of the TCP/IP networking system. You must do this yourself or seek assistance elsewhere. It is only possible to say here that a PC working well in a TCP/IP based LAN network will also work with XFree86/OS2 (when all other prerequisites are matched as well). <label id="loopback">With IAK, there is a special configuration necessary, unless you want to use XFree86/OS2 only during a hot link to your Internet provider, the so called ``localhost'' or ``loopback'' configuration. This is a local network interface which ``loops'' back to the same host. The following settings are necessary for this: <enum> <item> Create a file <tt>\tcpip\etc\hosts</tt> with the following content: <tscreen><verb>127.0.0.1 localhost</verb></tscreen> <item> Add the following line to your <tt>\tcpip\bin\tcpstart.cmd</tt>: <tscreen><verb>ifconfig lo 127.0.0.1 up</verb></tscreen> <item> Uncomment the <tt/inetd/ process in the same file. <item> Set the HOSTNAME environment variable to <tt/localhost/ as described in the last section. <item> Add the following line to CONFIG.SYS: <tscreen><verb>SET USE_HOSTS_FIRST=1</verb></tscreen> <item> After rebooting, verify that the following command works: <tscreen><verb>[C:\] ping localhost</verb></tscreen> </enum> If you have problems to get this or other basic networking things running, seek assistance elsewhere. <sect> Configuring X for Your Hardware After you have added the required settings and setup a working network, run the <tt/xf86config/ program to create a standard configuration file in <tt>Y:\XFree86\lib\X11\XConfig</tt> from a windowed or full screen OS/2 text session: <tscreen><verb>[C:\] xf86config</verb></tscreen> This program will ask a number of questions. You will need the information obtained from the SuperProbe program here. The program should be self explanatory; if you have problems to understand something though, seek assistance in the newsgroups. Alternatively, but not recommended for the non-expert, you can edit the <tt/XConfig/ file manually with a text editor. A sample file is in <tt>Y:\XFree86\lib\X11\XConfig.eg</tt>, which can be used as a starting point. For details about the <tt/XF86Config/ file format, refer to the XF86Config(4/5) manual page. If you know the configuration process from Linux or other XFree86 platform, you will encounter a few differences: <itemize> <item> There is no configuration for the mouse type or device. The mouse device name is fixed to OSMOUSE, and this cannot be changed. If you have a three-button-mouse, install the correct OS/2 driver for it, such as <tscreen><verb> DEVICE=D:\OS2\BOOT\PCLOGIC.SYS SERIAL=COM1 DEVICE=D:\OS2\BOOT\MOUSE.SYS TYPE=PCLOGIC$ </verb></tscreen> for a MouseSystems compatible mouse, for instance. <item> Currently, the X server does not read the native OS/2 keyboard map, so you need a xmodmap file for a non-us keyboard. Fortunately, it is the same you use for Linux. The server is compiled with the XKEYBOARD option, so this might be an alternative. At the time of this documentation, unfortunately, some subtle bug in the OS/2 implementation is still waiting for a fix, so this might not yet work. Read the LATEST.OS2 file with the binary distribution. <item> There is no support for the Wacom and Elographics input devices yet. </itemize> Other than that, an existing <tt/XF86Config/ file for the same XFree86 version from Linux or another platform may be used without changes. Once you've set up a XF86Config file, you can fine tune the video modes with the <tt>xvidtune</tt> utility. <sect> Running X 16mb of memory is a recommended minimum for running the network software, X and the presentation manager in parallel. The server, window manager and an xterm take about 4-6 Mb of memory themselves. X will start up on a system with 8MB or less, but the performance will severely suffer from heavy disk swapping. Your mileage may vary, though, so some people might consider this still tolerable. The easiest way for new users to start X windows is to type: <tscreen><verb>[C:\] startx</verb></tscreen>. To get out of X windows, type: ``<tt/exit/'' in the console xterm. You can customize your X by creating <tt/.xinitrc/, <tt/.xserverrc/, and <tt/.twmrc/ files in the directory that the <tt/HOME/ environment variable points to. These files are described in the xinit and startx man pages. <sect> Rebuilding the XFree86 Distribution Do you really want to rebuild XFree86/OS2 from source? If so, here are a few hints: <enum> <item> You need about 250-300 MB of free HPFS space. <item> You must have the complete EMX environment installed. <item> You need most of the GNU utilities that are available from the unix directory of hobbes.nmsu.edu. <item> You need a GNU make 3.71 or 3.72, others often have obscure bugs. You cannot use dmake, nmake, wmake, or other toy software as a replacement. <item> Install the X11R6.1 ``core'' distribution on some disk under a directory like <tt>\X11</tt>, i.e. <tt>\X11\xc\...</tt>. <item> Copy the cmd file <tt>buildos2.cmd</tt> from the directory <tt>\X11\xc\config\util</tt> to the top directory <tt>\X11\xc</tt>. <item> Execute this script; this should recompile everything, thereby producing a logfile <tt>\X11\xc\buildxc.log</tt>. The process requires between 2 and 20 hours depending on your hardware. </enum> Good luck! <sect>Building New X Clients The easiest way to build a new client (X application) is to use <tt/xmkmf/ if an <tt/Imakefile/ is included in the sources. Type ``<tt/xmkmf -a/'' to create the Makefiles, check the configuration if necessary and type ``<tt/xmake/''. ``<tt/xmake/'' is a wrapper for the GNU make program which defeats the improper SHELL setting typically found in a Makefile generated from an Imakefile. <sect> Acknowledgements Many thanks to: <itemize> <item> <bf/Sebastien Marineau/ for his great work on getting the server code debugged <item> <bf/Eberhard Mattes/ for the wonderful base platform EMX which this port heavily relies on <item> <bf/ME/ - no, no, forget this: I won't praise myself :-) </itemize> <verb> $XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/OS2.sgml,v 3.4 1996/03/10 12:05:04 dawes Exp $ $XConsortium$ </verb> </article> @ 1.1 log @Initial revision @ text @@ 1.1.1.1 log @XFree86 3.2 sources @ text @@ 1.1.1.2 log @XFree86 3.3 sources. @ text @d1 1 a1 1 <!DOCTYPE linuxdoc PUBLIC "-//XFree86//DTD linuxdoc//EN"> d4 1 a4 1 <title>README for XFree86 3.3 on OS/2 d6 1 a6 1 <Date>Last modified on: 17 May 1997 d10 1 a10 1 <sect>Introductory Note about the release 3.3 d13 22 a34 2 that may come with the binary distribution. Please also check out the following XFree86/OS2 WWW pages: d36 7 a42 3 <item><htmlurl name="http://set.gmd.de/~veit/os2/xf86os2.html" url="http://set.gmd.de/~veit/os2/xf86os2.html"> <item><htmlurl name="http://set.gmd.de/~veit/os2/xf86bugs.html" url="http://set.gmd.de/~veit/os2/xf86bugs.html"> <item><htmlurl name="http://set.gmd.de/~veit/os2/x11os2faq.html" url="http://set.gmd.de/~veit/os2/x11os2faq.html"> a43 1 before you claim to have found any problems. d45 7 a51 19 This version of the code is called XFree86/OS2 3.3. This is a full, unrestricted version which does not expire, and for which the complete source code is available. In contrast to beta versions, we consider this code as sufficiently stable for use by an end user. Since there have been numerous bugfixes, we recommend this version, even if you had XFree86/OS2 3.2 before and it worked satisfyingly with your hardware. Previous versions have been tested in a large number of configurations and have been found to be working, with some bugs left, rather flawlessly. This release is almost complete (with a few exceptions) regarding the X11R6.3 ``core'' distribution. A subset of the ``contrib'' distribution is available from the ported software page <htmlurl name="http://set.gmd.de/~veit/os2/xf86ported.html" url="http://set.gmd.de/~veit/os2/xf86ported.html"> In the past beta testing, it has been found that the software itself is rather stable and does not damage hardware - provided the user does not try to push the builtin limits and change certain configuration parameters which could operate the video hardware out of specs. d53 2 a54 8 However, <itemize> <item>even with a code we consider stable there is no explicit or implicit warranty that certain code works correctly or works at all <item>although no damage reports are known, it does not mean that it is impossible to damage hardware with this code; some deeply hidden bugs may still be present in the software. </itemize> a55 8 It is recommended that you backup essential data of your system before installing this software, but this should be your general precautions before ANY installation. No reports exist that a crashing X server itself actively destroys or modifies data, but it is possible in rare cases that the system is left in an unusable state (video display mode garbled or system unresponsive, not reacting to mouse or keyboard actions). If you then hard reset or switch off the system, file caches of the operating system might not be written correctly back to disk, thus causing data loss. d66 1 a66 1 XFree86/OS2 is the name of the implementation of XFree86 d69 1 a69 1 See the <htmlurl url="COPYRIGHT.html" name="Copyright Notice">. d74 2 a75 2 <htmlurl name="ftp.XFree86.org:/pub/XFree86" url="ftp://ftp.XFree86.org/pub/XFree86"> d78 3 a80 9 Binaries for OS/2 Warp and Merlin are available from: <htmlurl name="ftp.XFree86.org:/pub/XFree86/beta/OS2" url="ftp://ftp.XFree86.org/pub/XFree86/beta/OS2"> The WWW page <htmlurl name="http://borneo.gmd.de/~veit/os2/xf86os2.html" url="http://borneo.gmd.de/~veit/os2/xf86os2.html"> will usually show more references to FTP or WWW sites to retrieve sources or binaries. d82 2 d87 7 a93 18 XFree86/OS2 will run on all dialects of Warp 3, including Warp "red spine box", Warp "blue spine box", Warp Connect, Warp Server, and Warp 4. For Warp 3 installing fixpack level 17 is strongly recommended, newer fixpacks like 22 also work. There have been a few reports that the installation of FP26 causes XFree86 no longer to work, but I am not sure about a real reason. Warp 4 may be used with or without the recent public fixpack FP1. Please check in all cases a LATEST.OS2 file. OS/2 2.11 is not supported any longer with this release, due to lack of a working test environment. Consequently, OS/2 SMP is not supported either, because this is currently based on OS/2 2.11. Warp Server SMP is supported, but SMP does not give significant advantage, other than the general speedup because of multiple processors working. OS/2 versions 1.X are definitely not supported and will never be. d96 1 a96 1 in the document OS2.NOTES. d112 1 a112 1 <item>At least a 486DX33 with 16MB RAM is required. A Pentium or Pentium Pro d115 1 a115 1 <item>There are no specific requirements concerning network cards, disk types, d117 1 a117 1 <item>Depending on the packages installed, a disk space of 20-55MB on a d120 1 a120 1 <item>You need a video card that is supported by XFree86. Refer to the general d133 4 a136 3 <item>Any version of Warp 3 with at least fixpack 17, or Warp 4 is required <item>XFree86/OS2-3.3 may use a local named-pipe connection or a TCP/IP based network connection. d138 2 a139 1 <item>Warp comes with the Internet Access Kit (IAK), which is a142 4 <item>Warp 4 comes with TCP/IP 4.0 which should also work. <item>The old IBM TCP/IP 2.0, that comes with the IBM PMX product may be used with Warp as well, although it is no longer supported by IBM. Please ensure that you have the latest CSDs installed. d148 1 a148 1 <item>If you want to write or port applications for XFree86, you are d150 1 a150 1 EMX/gcc 0.9C or later for doing so. Neither the second (obsolete) d171 2 a172 3 which somewhat reduces the usability. Refer to WWW sites and archives listed in the XFree86/OS2 FAQ and elsewhere to obtain pre-built X clients which were ported to XFree86. d179 5 a183 4 <tag/X33base/ A special device driver and the SuperProbe program <tag/X33doc/ READMEs and XFree86 specific man pages. <tag/X33bin/ all of the executable X client applications and shared libs <tag/X33fnts/ the misc and 75dpi fonts d190 12 a201 13 <tag/X338514/ the X server for IBM 8514/A and compatible boards <tag/X33AGX/ the X server for AGX boards <tag/XA32AI128/ the X server for #9 Imagination 128 boards <tag/X33Ma32/ the X server for ATI Mach32 graphics boards <tag/X33Ma64/ the X server for ATI Mach64 graphics boards <tag/X33Ma8/ the X server for ATI Mach8 graphics boards <tag/X33Mono/ the Monochrome X Server <tag/X33P9K/ the X server for P9000 based boards <tag/X33S3/ the X server for S3 based boards (excluding S3 ViRGE) <tag/X33S3V/ the X server for S3 ViRGE based boards <tag/X33SVGA/ the 8-bit pseudo-color X server for Super VGA cards <tag/X33VG16/ the 4-bit pseudo-color X server for VGA & SVGA cards. <tag/X33W32/ the X server for et4000w32 based boards d207 7 a213 7 <tag/X33man/ pre-formatted man pages for the X11 interface and clients <tag/X33f100/ 100dpi fonts <tag/X33fscl/ Speedo and Type1 fonts <tag/X33fnon/ Japanese, Chinese and other fonts <tag/X33fcyr/ Cyrillic fonts <tag/X33fsrv/ the font server with man pages. <tag/X33prog/ the X11 header files and programmer's utilities d215 2 a216 1 <tag/X33pex/ PEX fonts and libraries required for PEX applications d221 2 a222 2 software to obtain carefully. Each X server is an archive of about 1.2MB and occupies 3.0MB on the disk. You won't normally need more than the d225 1 a225 1 If it is your first time install, get the <tt/X33base/ archive before any d231 1 a231 32 <sect>Troubleshooting Surprised to see this section directly in the beginning? We have put it here because chances are best here not to overlook it. This does not mean that you will necessarily encounter trouble when installing XFree86, but be warned: the following sections are <bf/IMPORTANT/ and neglecting one or more things out of impatience or sloppiness will leave you with a non-working X11 system and us with unnecessary problems. Still, due to the incredibly large number of hardware configurations, there may be some special situations and configurations where the below description is not successful. If this happens, read - I repeat <bf/READ/ - the list of ``frequently asked questions'' (FAQ) which has meanwhile evolved to a troubleshooting guide. The latest version is always at <htmlurl name="http://set.gmd.de/~veit/os2/x11os2faq.html" url="http://set.gmd.de/~veit/os2/x11os2faq.html"> . Maybe - but we found you must be very creative - you find a bug. Consult the page <htmlurl name="http://set.gmd.de/~veit/os2/xf86bugs.html" url="http://set.gmd.de/~veit/os2/xf86bugs.html"> whether it is already known. If not, you have a case and should report it to XFree86 (<em/xfree86@@xfree86.org/). Please refer to the FAQ about the information to be provided for a complete problem report. The recommended newsgroup for setup questions is <em/comp.os.os2.setup.misc/. I read this group, so it won't speed up the process or enforce anything if you post to other groups, or forward the report to my mail address as well or to xfree86@@xfree86.org. So, not to discourage you completely, the setup section begins: <sect>Checking Compatibility of Video Hardware d239 1 a239 1 <item>Obtain the package <tt/X33base/ and install it from the root directory d244 1 a244 1 [Y:\] unzip \path_of_package\X33base.zip d247 1 a247 1 <item>Edit your CONFIG.SYS file to contain the following line somewhere: d253 1 a253 1 <item>At this point, you may consider to add the variables required for d258 1 a258 1 <item>After adding the device driver entry to the CONFIG.SYS file, you must d262 1 a262 1 <item>Start a full screen OS/2 CMD session and enter the following d268 1 a268 1 <item>This command will (normally) report important information about your d276 5 a280 12 <item>SuperProbe can identify many more video cards than are supported by XFree86. In some cases, SuperProbe unfortunately detects a wrong card, often it claims to have seen a MCGA card which is some sort of a fallback. Generally, if it is approximately right, there are only few reasons for doubts; if it is totally off (e.g. saying it has seen a ET4000, and you have a Cirrus card), you should report a mis-detection as a bug to the given address. In all cases, please take the few minutes and check the accompanying README.* files to check for special precautions, options, or features of the card. <item>If the README files tell you that your hardware is supported, please obtain the rest of the software. d282 2 d286 1 a286 1 <sect>Installing the packages d293 2 a294 2 <item>Choose a HPFS partition with sufficient free space. <item>For each package to install, go to the root directory of this d298 1 a298 1 drive:> unzip \path_of_packages\X33xxxx.zip a299 5 <item>You might encounter that some packages report duplicate files, e.g. the X server packages install corresponding README files, which are also in the X33doc package. This is okay, the files are the same. Let unzip replace the files. <item>There is no special sequence of installing packages required. d302 1 a302 1 <sect>Adding Variables to CONFIG.SYS <label id="envvar"> d326 1 a326 1 <tscreen><verb>SET ETC=C:\TCPIP\ETC</verb></tscreen> d330 1 a330 1 <tscreen><verb>SET TMP=C:\TCPIP\TMP</verb></tscreen> d355 1 a355 1 <tscreen><verb>SET HOME=H:\user\holger</verb></tscreen> d382 1 a382 1 <tscreen><verb>Y:\XFree86\bin</verb></tscreen> d389 1 a389 1 <tscreen><verb>Y:\XFree86\lib</verb></tscreen> d400 1 a400 7 The recent version of XFree86/OS2 has a REXX script named <tt/checkinstall.cmd/ which you can (and should) use to check whether you have entered most things correctly. This is not bullet-proof, but prevents the most obvious setup problems. Also, the X server itself will do some checking and will refuse to start if something is wrong. <sect>Remarks on the Network Configuration d416 1 a416 1 <item>Create a file <tt>\tcpip\etc\hosts</tt> with the d419 1 a419 1 <item>Add the following line to your d422 2 a423 2 <item>Uncomment the <tt/inetd/ process in the same file. <item>Set the HOSTNAME environment variable to <tt/localhost/ as described d425 1 a425 1 <item>Add the following line to CONFIG.SYS: d427 2 a428 2 <item>After rebooting, verify that the following command works: <tscreen><verb>[C:\] ping localhost</verb></tscreen> a430 3 The <tt/checkinstall.cmd/ script coming with XFree86/OS2 gives some advice here as well. d434 1 a434 1 <sect>Configuring X for Your Hardware d441 1 a441 1 <tscreen><verb>[C:\] xf86config</verb></tscreen> d443 3 a445 3 The <tt/xf86config/ program will ask a number of questions. You will need the information obtained from the SuperProbe program here. The program should be self explanatory; if you have problems to understand something though, seek d448 4 a451 5 It is possible, but strongly discouraged for the non-expert, to edit the <tt/XConfig/ file with a text editor. In a few situations, as described in the FAQ, this might even be mandatory. This file is not a hacker's area, such as the Win95 registry, but it has in common with it that you can easily cause damage. d459 1 a459 2 <item>The configuration file is named <tt/XF86Config/ in Unix environments. <item>There is no configuration for the mouse type or device. The mouse d464 2 a465 2 DEVICE=D:\OS2\BOOT\PCLOGIC.SYS SERIAL=COM1 DEVICE=D:\OS2\BOOT\MOUSE.SYS TYPE=PCLOGIC$ d468 1 a468 1 <item>The X server does not read the native OS/2 keyboard map, d470 6 a475 4 is the same you use for Linux. Alternatively, for standard keyboards, you can also use the XKB extension which is offered during the <tt/xf86config/ dialogue, provided your language is available. <item>There is no support for the Wacom and Elographics input devices yet. d478 2 a479 11 In most cases, an existing <tt/XF86Config/ file for the same XFree86 version from Linux or another platform may be used without changes. There is one prominent exception: some S3 805 based VLB cards put their video memory in odd locations. The X server can search for this memory by experimentally mapping and unmapping possible memory regions. In XFree86/OS2, the OS may run out of memory tiles during this process. If this happens, you must find out the location of the memory yourself and add it as an option <tscreen><verb> MemBase 0x12345678 </verb></tscreen> to the XConfig file. d484 1 a484 1 <sect>Running X d495 1 a495 1 <tscreen><verb>[C:\] startx</verb></tscreen>. d499 2 a500 9 and <tt/.twmrc/ files in the directory that the <tt/HOME/ environment variable points to. These files are described in the xinit and startx man pages. By default, the systemwide <tt/xinitrc/ file (in <tt>Y:/XFree86/lib/X11/xinit/xinitrc.cmd</tt>) installs the rather simplistic <tt/twm/ window manager. You can find better window managers on the ported software page at <htmlurl name="http://set.gmd.de/~veit/os2/xf86ported.html" url="http://set.gmd.de/~veit/os2/xf86ported.html"> . d502 1 a502 1 <sect>Rebuilding the XFree86 Distribution d505 21 a525 3 Do you really want to rebuild XFree86/OS2 from source? Read the file <htmlurl name=OS2.Notes url=OS2Notes.html> on details to recompile XFree86/OS2 from scratch. d535 1 a535 2 in a Makefile generated from an Imakefile. Also see the XFree86/OS2 FAQ for more hints about porting X clients. d537 1 a537 1 <sect>Acknowledgements d542 1 a542 1 <item><bf/Sebastien Marineau/ for his great work on getting the server code d544 1 a544 1 <item><bf/Eberhard Mattes/ for the wonderful base platform EMX which this d546 1 a546 1 <item><bf/ME/ - no, no, forget this: I won't praise myself :-) d550 1 a550 1 $XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/OS2.sgml,v 3.9.2.3 1997/05/24 08:36:06 dawes Exp $ d556 1 a556 1 $XConsortium: OS2.sgml /main/4 1996/03/11 10:46:06 kaleb $ @ 1.1.1.3 log @xfree86 3.3.1 sources. @ text @d4 1 a4 1 <title>README for XFree86 3.3.1 on OS/2 d6 1 a6 1 <Date>Last modified on: 2 August 1997 d10 1 a10 1 <sect>Introductory Note about the release 3.3.1 d22 6 a27 10 This version of the code is called XFree86/OS2 3.3.1. This is a bugfix release for 3.3. It is a full, unrestricted version which does not expire, and for which the complete source code is available. In contrast to beta versions, we consider this code as sufficiently stable for use by an end user. Since there have been numerous bugfixes, we recommend this version, even if you had XFree86/OS2 3.2 before and it worked satisfyingly with your hardware. By the time 3.3.1 is released, the older version 3.3 will be withdrawn, and archives will be updated to this version. There may still be references to 3.3 still in documents; these apply to 3.3.1 as well, unless otherwise noted. d136 2 a137 2 HPFS formatted partition (or a NFS or ext2fs partition natively allowing long filenames) is required. XFree86/OS2 will not run on FAT partitions. d152 1 a152 1 <item>XFree86/OS2-3.3.1 may use a local named-pipe connection or a TCP/IP d170 1 a170 1 EMX/gcc 0.9C fix2 or later for doing so. Neither the second (obsolete) d200 4 a203 4 <tag/X331base/ A special device driver and the SuperProbe program <tag/X331doc/ READMEs and XFree86 specific man pages. <tag/X331bin/ all of the executable X client applications and shared libs <tag/X331fnts/ the misc and 75dpi fonts d210 13 a222 13 <tag/X3318514/ the X server for IBM 8514/A and compatible boards <tag/X331AGX/ the X server for AGX boards <tag/X331I128/ the X server for #9 Imagination 128 boards <tag/X331Ma32/ the X server for ATI Mach32 graphics boards <tag/X331Ma64/ the X server for ATI Mach64 graphics boards <tag/X331Ma8/ the X server for ATI Mach8 graphics boards <tag/X331Mono/ the Monochrome X Server <tag/X331P9K/ the X server for P9000 based boards <tag/X331S3/ the X server for S3 based boards (excluding S3 ViRGE) <tag/X331S3V/ the X server for S3 ViRGE based boards <tag/X331SVGA/ the 8-bit pseudo-color X server for Super VGA cards <tag/X331VG16/ the 4-bit pseudo-color X server for VGA & SVGA cards. <tag/X331W32/ the X server for et4000w32 based boards d228 7 a234 7 <tag/X331man/ pre-formatted man pages for the X11 interface and clients <tag/X331f100/ 100dpi fonts <tag/X331fscl/ Speedo and Type1 fonts <tag/X331fnon/ Japanese, Chinese and other fonts <tag/X331fcyr/ Cyrillic fonts <tag/X331fsrv/ the font server with man pages. <tag/X331prog/ the X11 header files and programmer's utilities d236 1 a236 1 <tag/X331pex/ PEX fonts and libraries required for PEX applications d245 1 a245 1 If it is your first time install, get the <tt/X331base/ archive before any d290 1 a290 1 <item>Obtain the package <tt/X331base/ and install it from the root directory d295 1 a295 1 [Y:\] unzip \path_of_package\X331base.zip d354 1 a354 1 drive:> unzip \path_of_packages\X331xxxx.zip d358 1 a358 1 in the X331doc package. This is okay, the files are the same. Let unzip d619 1 a619 1 $XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/OS2.sgml,v 3.9.2.4 1997/08/04 02:10:42 dawes Exp $ @ 1.1.1.4 log @XFree86 3.3.2 sources @ text @d4 1 a4 1 <title>README for XFree86 3.3.2 on OS/2 d6 1 a6 1 <Date>Last modified on: 15 February 1998 d10 1 a10 1 <sect>Introductory Note about the release 3.3.2 d22 4 a25 6 This version of the code is called XFree86/OS2 3.3.2. This is a bugfix release for 3.3.1 which also adds hardware support for some newer cards (including AGP boards. See the RELNOTES document for details. Xfree86/OS2-3.3.2 is a full, unrestricted version which does not expire, and for which the complete source code is available. In contrast to beta versions, we consider this code as sufficiently stable for use by an end user. Since there d27 2 a28 2 XFree86/OS2 3.3 before and it worked satisfyingly with your hardware. By the time 3.3.2 is released, the older version 3.3 will be withdrawn, d30 1 a30 1 to 3.3 still in documents; these apply to 3.3.2 as well, unless otherwise d67 1 a67 1 XFree86 is a port of X11R6.3 that supports several versions of d81 2 a82 2 <htmlurl name="ftp.XFree86.org:/pub/XFree86/3.3.2/source" url="ftp://ftp.XFree86.org/pub/XFree86/3.3.2/source"> d86 2 a87 2 <htmlurl name="ftp.XFree86.org:/pub/XFree86/3.3.2/OS2" url="ftp://ftp.XFree86.org/pub/XFree86/3.3.2/OS2"> d104 1 a104 2 about a real reason. Current fixpacks for Warp 3, like FP32, seem to work well also. d106 1 a106 1 Warp 4 may be used with or without the recent public fixpack FP5. d111 5 a115 4 of a working test environment. Consequently, OS/2 SMP 2.11 is not supported either. Warp Server SMP is supported, but SMP does not give significant advantage, other than the general speedup because of multiple processors working. OS/2 versions 1.X are definitely not supported and will never be. d156 1 a156 1 <item>XFree86/OS2-3.3.2 may use a local named-pipe connection or a TCP/IP a163 2 <item>There are reports that with EMX 0.9 fix 4, you can also use the new 32 bit IBM TCP/IP 4.1 product. d174 1 a174 1 EMX/gcc 0.9C fix4 or later for doing so. Neither the second (obsolete) d190 3 a192 4 which is available under the name <tt/UNZ512X2.EXE/ (or a later version) from many OS/2 archives. Please obtain a native OS/2 version of this unpacker. DOS <tt/PKUNZIP/ does not work, because it cannot unpack long file names and extended attributes. d204 4 a207 4 <tag/X332base/ A special device driver and the SuperProbe program <tag/X332doc/ READMEs and XFree86 specific man pages. <tag/X332bin/ all of the executable X client applications and shared libs <tag/X332fnts/ the misc and 75dpi fonts d214 13 a226 13 <tag/X3328514/ the X server for IBM 8514/A and compatible boards <tag/X332AGX/ the X server for AGX boards <tag/X332I128/ the X server for #9 Imagination 128 boards <tag/X332Ma32/ the X server for ATI Mach32 graphics boards <tag/X332Ma64/ the X server for ATI Mach64 graphics boards <tag/X332Ma8/ the X server for ATI Mach8 graphics boards <tag/X332Mono/ the Monochrome X Server <tag/X332P9K/ the X server for P9000 based boards <tag/X332S3/ the X server for S3 based boards (excluding S3 ViRGE) <tag/X332S3V/ the X server for S3 ViRGE based boards <tag/X332SVGA/ the 8-bit pseudo-color X server for Super VGA cards <tag/X332VG16/ the 4-bit pseudo-color X server for VGA & SVGA cards. <tag/X332W32/ the X server for et4000w32 based boards d232 7 a238 7 <tag/X332man/ pre-formatted man pages for the X11 interface and clients <tag/X332f100/ 100dpi fonts <tag/X332fscl/ Speedo and Type1 fonts <tag/X332fnon/ Japanese, Chinese and other fonts <tag/X332fcyr/ Cyrillic fonts <tag/X332fsrv/ the font server with man pages. <tag/X332prog/ the X11 header files and programmer's utilities d240 1 a240 1 <tag/X332pex/ PEX fonts and libraries required for PEX applications d249 1 a249 1 If it is your first time install, get the <tt/X332base/ archive before any d294 1 a294 1 <item>Obtain the package <tt/X332base/ and install it from the root directory d299 1 a299 1 [Y:\] unzip \path_of_package\X332base.zip d358 1 a358 1 drive:> unzip \path_of_packages\X332xxxx.zip d362 1 a362 1 in the X332doc package. This is okay, the files are the same. Let unzip d364 1 a364 1 <item>No special sequence to unpack the files is required. d371 1 a371 2 correctly. Please add the following settings, and in particular take care to set forward versus backward slashes correctly: d493 1 a493 5 If you don't have such a tcpstart.cmd file (Warp 4 calls this file <tt>\MPTN\BIN\MPTSTART.CMD</tt>), create one, and add a line like the following to your config.sys file: <tt>CALL=C:\OS2\CMD.EXE /Q /C C:\tcpip\bin\tcpstart.cmd >NUL</tt>: (implying that your bootdrive is C:). a501 6 You don't need this ``loopback'' interface if your PC is connected to a LAN (either directly or through SLIP/PPP). In case of a SLIP/PPP line, you have to establish this connection BEFORE you start XFree86. d503 1 a503 1 on the configuration as well. d513 1 a513 1 in <tt>Y:\XFree86\lib\X11\XF86Config</tt> from a windowed d523 2 a524 2 <tt/XF86Config/ file with a text editor. In a few situations as described in the FAQ, however, this might even be mandatory. This file is not a hacker's area, d534 1 d544 5 a548 8 <item>The X server does not read the native OS/2 keyboard map, but the new XKB server extension might already give you a correct keyboard layout, provided your language was selectable in the <tt/xf86config/ program. If you encounter incorrect settings, please send a mail to <tt/XFree86@@XFree86.org/ describing in detail what is wrong. Even with XKB, you have the option to replace some key settings with a xmodmap file. See the man page for xmodmap for details (or use some available xmodmap file from Linux - they are the same). d562 1 a562 1 to the XF86Config file. d623 1 a623 1 $XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/OS2.sgml,v 3.9.2.5 1998/02/22 01:28:24 robin Exp $ @ 1.1.1.5 log @XFree86 3.3.3 sources @ text @d4 1 a4 1 <title>README for XFree86 3.3.3 on OS/2 d6 1 a6 1 <Date>Last modified on: 04 October 1998 d10 1 a10 1 <sect>Introductory Note about the release 3.3.3 d22 12 a33 16 This version of the code is called XFree86/OS2 3.3.3. This is a bugfix release for 3.3 and later which also adds hardware support for some newer cards (including AGP boards). XFree86-3.3.3 contains all security fixes that were released for earlier versions. See the RELNOTES document for details. XFree86/OS2-3.3.3 is a full, unrestricted version which does not expire, and for which the complete source code is available. In contrast to beta versions, we consider this code as sufficiently stable for use by an end user. Since there have been numerous bugfixes, we recommend this version, even if you had XFree86/OS2 3.3 before and it worked satisfyingly with your hardware. By the time 3.3.3 is released, the older version 3.3 will be withdrawn, and archives will be updated to this version. There may still be references to 3.3 still in documents; these apply to 3.3.3 as well, unless otherwise noted. d43 4 a46 5 In the past beta testing, it has been found that the software itself is rather stable and does not damage hardware - provided the user does not try to push the builtin limits and change certain configuration parameters which could operate the video hardware out of specs. d83 2 a84 2 <htmlurl name="ftp.XFree86.org:/pub/XFree86/3.3.3/source" url="ftp://ftp.XFree86.org/pub/XFree86/3.3.3/source"> d88 2 a89 2 <htmlurl name="ftp.XFree86.org:/pub/XFree86/3.3.3/OS2" url="ftp://ftp.XFree86.org/pub/XFree86/3.3.3/OS2"> d103 5 a107 4 For Warp 3 installing fixpack level 17 or later is strongly recommended. There have been a few reports that the installation of FP26 causes XFree86 no longer to work, but I am not sure about a real reason. Current fixpacks for Warp 3, like FP36, seem to work well also. d109 1 a109 1 Warp 4 may be used with or without the recent public fixpack. d158 1 a158 1 <item>XFree86/OS2-3.3.3 may use a local named-pipe connection or a TCP/IP d209 4 a212 4 <tag/X333base/ A special device driver and the SuperProbe program <tag/X333doc/ READMEs and XFree86 specific man pages. <tag/X333bin/ all of the executable X client applications and shared libs <tag/X333fnts/ the misc and 75dpi fonts d219 13 a231 14 <tag/X3338514/ the X server for IBM 8514/A and compatible boards <tag/X333AGX/ the X server for AGX boards <tag/X333Glnt/ the X server for Permedia / GLINT boards <tag/X333I128/ the X server for #9 Imagination 128 boards <tag/X333Ma32/ the X server for ATI Mach32 graphics boards <tag/X333Ma64/ the X server for ATI Mach64 graphics boards <tag/X333Ma8/ the X server for ATI Mach8 graphics boards <tag/X333Mono/ the Monochrome X Server <tag/X333P9K/ the X server for P9000 based boards <tag/X333S3/ the X server for S3 based boards (excluding S3 ViRGE) <tag/X333S3V/ the X server for S3 ViRGE based boards <tag/X333SVGA/ the 8-bit pseudo-color X server for Super VGA cards <tag/X333VG16/ the 4-bit pseudo-color X server for VGA & SVGA cards. <tag/X333W32/ the X server for et4000w32 based boards d237 7 a243 7 <tag/X333man/ pre-formatted man pages for the X11 interface and clients <tag/X333f100/ 100dpi fonts <tag/X333fscl/ Speedo and Type1 fonts <tag/X333fnon/ Japanese, Chinese and other fonts <tag/X333fcyr/ Cyrillic fonts <tag/X333fsrv/ the font server with man pages. <tag/X333prog/ the X11 header files and programmer's utilities d245 1 a245 1 <tag/X333pex/ PEX fonts and libraries required for PEX applications d254 1 a254 1 If it is your first time install, get the <tt/X333base/ archive before any d299 1 a299 1 <item>Obtain the package <tt/X333base/ and install it from the root directory d304 1 a304 1 [Y:\] unzip \path_of_package\X333base.zip d363 1 a363 1 drive:> unzip \path_of_packages\X333xxxx.zip d367 1 a367 1 in the X333doc package. This is okay, the files are the same. Let unzip d641 1 a641 1 $XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/OS2.sgml,v 3.9.2.7 1998/11/04 08:01:53 hohndel Exp $ @ 1.1.1.6 log @XFree86 3.3.3.1 sources @ text @d4 1 a4 1 <title>README for XFree86 on OS/2 d6 1 a6 1 <Date>Last modified on: December 29, 1998 d646 1 a646 1 $XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/OS2.sgml,v 3.9.2.8 1998/12/29 07:54:29 hohndel Exp $ @ 1.1.1.7 log @XFree86 3.3.4 sources @ text @d6 1 a6 1 <Date>Last modified on: July 6th, 1999 d10 1 a10 1 <sect>Introductory Note about the release 3.3.4 d22 3 a24 3 This version of the code is called XFree86/OS2 3.3.4. This is a bugfix release for 3.3.3 and later which also adds hardware support for some newer cards (including AGP boards). XFree86-3.3.4 contains all d28 1 a28 1 XFree86/OS2-3.3.4 is a full, unrestricted version which does not d32 1 a32 1 bugfixes, we recommend this version, even if you had XFree86/OS2 3.3.x d34 1 a34 1 3.3.4 is released, the older version 3.3 will be withdrawn, and d36 2 a37 2 references to 3.3 or 3.3.x still in documents; these apply to 3.3.4 as well, unless otherwise noted. d88 2 a89 2 <htmlurl name="ftp.XFree86.org:/pub/XFree86/3.3.4/source" url="ftp://ftp.XFree86.org/pub/XFree86/3.3.4/source"> d93 2 a94 2 <htmlurl name="ftp.XFree86.org:/pub/XFree86/3.3.4/OS2" url="ftp://ftp.XFree86.org/pub/XFree86/3.3.4/OS2"> d162 1 a162 1 <item>XFree86/OS2-3.3.4 may use a local named-pipe connection or a TCP/IP d213 4 a216 4 <tag/Xbase/ A special device driver and the SuperProbe program <tag/Xdoc/ READMEs and XFree86 specific man pages. <tag/Xbin/ all of the executable X client applications and shared libs <tag/Xfnts/ the misc and 75dpi fonts d223 14 a236 14 <tag/X8514/ the X server for IBM 8514/A and compatible boards <tag/XAGX/ the X server for AGX boards <tag/XGlnt/ the X server for Permedia / GLINT boards <tag/XI128/ the X server for #9 Imagination 128 boards <tag/XMa32/ the X server for ATI Mach32 graphics boards <tag/XMa64/ the X server for ATI Mach64 graphics boards <tag/XMa8/ the X server for ATI Mach8 graphics boards <tag/XMono/ the Monochrome X Server <tag/XP9K/ the X server for P9000 based boards <tag/XS3/ the X server for S3 based boards (excluding S3 ViRGE) <tag/XS3V/ the X server for S3 ViRGE based boards <tag/XSVGA/ the 8-bit pseudo-color X server for Super VGA cards <tag/XVG16/ the 4-bit pseudo-color X server for VGA & SVGA cards. <tag/XW32/ the X server for et4000w32 based boards d242 9 a250 9 <tag/Xman/ pre-formatted man pages for the X11 interface and clients <tag/Xf100/ 100dpi fonts <tag/Xfscl/ Speedo and Type1 fonts <tag/Xfnon/ Japanese, Chinese and other fonts <tag/Xfcyr/ Cyrillic fonts <tag/Xfsrv/ the font server with man pages. <tag/Xprog/ the X11 header files and programmer's utilities for compiling other X applications <tag/Xpex/ PEX fonts and libraries required for PEX applications d259 1 a259 1 If it is your first time install, get the <tt/Xbase/ archive before any d304 1 a304 1 <item>Obtain the package <tt/Xbase/ and install it from the root directory d309 1 a309 1 [Y:\] unzip \path_of_package\Xbase.zip d368 1 a368 1 drive:> unzip \path_of_packages\Xxxxx.zip d372 1 a372 1 in the Xdoc package. This is okay, the files are the same. Let unzip d646 1 a646 1 $XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/OS2.sgml,v 3.9.2.9 1999/07/13 07:09:49 hohndel Exp $ @ 1.1.1.8 log @XFree86 3.3.5 sources @ text @d6 1 a6 1 <Date>Last modified on: August 1st, 1999 d10 1 a10 1 <sect>Introductory Note about the release 3.3.5 a11 1 d22 5 a26 5 This version of the code is called XFree86/OS2 3.3.5. This is a bugfix release for 3.3.3.1 (3.3.4 was never released for XFree86/OS2) which also adds hardware support for some newer cards, including AGP boards. XFree86-3.3.5 contains all security fixes that were released for earlier versions. See the RELNOTES document for details. d28 1 a28 1 XFree86/OS2-3.3.5 is a full, unrestricted version which does not d34 1 a34 1 3.3.5 is released, the older version 3.3 will be withdrawn, and d37 1 a37 1 to 3.3.5 as well, unless otherwise noted. d88 2 a89 2 <htmlurl name="ftp.XFree86.org:/pub/XFree86/3.3.5/source" url="ftp://ftp.XFree86.org/pub/XFree86/3.3.5/source"> d93 2 a94 2 <htmlurl name="ftp.XFree86.org:/pub/XFree86/3.3.5/OS2" url="ftp://ftp.XFree86.org/pub/XFree86/3.3.5/OS2"> d162 1 a162 1 <item>XFree86/OS2-3.3.5 may use a local named-pipe connection or a TCP/IP d646 1 a646 1 $XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/OS2.sgml,v 3.9.2.10 1999/08/02 08:38:16 hohndel Exp $ @ 1.1.1.9 log @XFree86 3.3.6 @ text @d6 1 a6 1 <Date>Last modified on: December 12th, 1999 d10 1 a10 1 <sect>Introductory Note about the release 3.3.6 d17 3 a19 3 <item><htmlurl name="http://ais.gmd.de/~veit/os2/xf86os2.html" url="http://ais.gmd.de/~veit/os2/xf86os2.html"> <item><htmlurl name="http://ais.gmd.de/~veit/os2/xf86bugs.html" url="http://ais.gmd.de/~veit/os2/xf86bugs.html"> <item><htmlurl name="http://ais.gmd.de/~veit/os2/x11os2faq.html" url="http://ais.gmd.de/~veit/os2/x11os2faq.html"> d23 4 a26 4 This version of the code is called XFree86/OS2 3.3.6. This is a bugfix release for 3.3.5 and previous versions which again adds hardware support for some newer cards, including AGP boards. XFree86-3.3.6 contains all security fixes that were released d28 2 a29 2 XFree86/OS2-3.3.6 is a full, unrestricted version which does not d35 1 a35 1 3.3.6 is released, the older version 3.3 will be withdrawn, and d38 1 a38 1 to 3.3.6 as well, unless otherwise noted. d46 1 a46 1 <htmlurl name="http://ais.gmd.de/~veit/os2/xf86ported.html" url="http://ais.gmd.de/~veit/os2/xf86ported.html"> d89 2 a90 2 <htmlurl name="ftp.XFree86.org:/pub/XFree86/3.3.6/source" url="ftp://ftp.XFree86.org/pub/XFree86/3.3.6/source"> d93 3 a95 3 Binaries for OS/2 Warp, Merlin, and Aurora are available from: <htmlurl name="ftp.XFree86.org:/pub/XFree86/3.3.6/OS2" url="ftp://ftp.XFree86.org/pub/XFree86/3.3.6/OS2"> d147 1 a147 1 HPFS formatted partition (or a JFS, NFS or ext2fs partition natively d163 1 a163 1 <item>XFree86/OS2-3.3.6 may use a local named-pipe connection or a TCP/IP a214 4 <em/Note:/ In order to fix a problem occurring with WSeB (Aurora), you must install the most recent version of the xf86sup.sys driver that comes with this file. Older versions won't work. d281 1 a281 1 <htmlurl name="http://ais.gmd.de/~veit/os2/x11os2faq.html" url="http://ais.gmd.de/~veit/os2/x11os2faq.html"> . d284 1 a284 1 page <htmlurl name="http://ais.gmd.de/~veit/os2/xf86bugs.html" url="http://ais.gmd.de/~veit/os2/xf86bugs.html"> a318 1 a403 2 For Warp 4 and later, this may point to the <tt/\MPTN\/ directory. This is okay. d405 2 a406 4 Set to an TMP directory which should reside on a HPFS drive (or other filesystem that has real long names). Often, this variable is already set to the TMP directory of the TCP/IP code, such as a407 2 If you have installed additional software, like VisualAge for C++, it might be that this variable points to some directory <tt/\ibmcpp\tmp/ . d454 1 a454 1 must be a complete path. My setting, for instance, looks as follows: d462 1 a462 2 is not recommended, though. You might, of course, use a software like TVFS to redirect these files to elsewhere. a474 17 <tscreen><verb>SET MANPATH=Y:\XFree86\man;Y:\EMX\man</verb></tscreen> Note: xman alone might not be sufficient to display arbitrary Unix man pages correctly. You might have to install the <tt/GROFF/ formatter tool as well. See FAQ for more details. <tag/OS2_SHELL/ <tag/COMSPEC/ <tag/SHELL/ <tag/X11SHELL/ Some scripts in XFree86 rely on a shell that is compatible to the standard CMD.EXE. CMD.EXE has some essential properties that allows it to work correctly in an xterm. Third party shells may not been developed with running in an environment that, like xterm. accept input and output from the stdin/stdout file channels, but access keyboard and video services directly. The above variables allow reconfiguration of your system in order to run any favorite shell outside XFree86 and still have XFree86 use CMD.EXE. See the FAQ for more details. d522 1 a522 7 you start XFree86. See the next section for more details. Note that the ability to use host names, for instance in the <tt/DISPLAY/ variable, correlates with the existance of a name resolver. If you don't have a LAN-based DNS server available, you have to add the relevant hostnames to your <tt>HOSTS/ file. The TCP/IP configuration dialogue in your system configuration folder allows you to edit this file. d528 1 a528 25 seek assistance in the FAQ, the <htmlurl name="xf86os2 mailing list" url="http://ais.gmd.de/~veit/os2/xf86mail.html"> or the <htmlurl name="mailing list archive" url="http://ais.gmd.de/~veit/os2/xf86search.html">. <sect>Dynamic IP Considerations Generally, the whole stuff works best, if your machine has a fixed IP address. The localhost address, and also fixed (non-routable) local addresses (10.x.x.x, 192.168.x.x, 172.16.x.x-172.31.x.x) work fine. A problem occurs on both sides of such an X connection if there are dynamic IP addresses involved, for instance in case of a PPP line to an ISP. Unfortunately, the XFree86/OS2 net community hasn't come up with a set of helpful scripts yet (which I would integrate), so there are here only some hints what the problem really is: The X server listens for X protocol packets on some defined host/port socket. It gets the information about the socket from either the command line or the resolved hostname (which it gets from the <tt/HOSTS/ file or the DNS server). Here the <tt/HOSTNAME/ variable comes into play. Once the server is running, a change in the IP/HOSTNAME configuration won't be recognized any more. Thus, the general approach for X over a dynamic IP line is: build the connection to the ISP first, then start the server. The relevant script that is responsible for starting the server is the startx.cmd script which executes (indirectly) the \XFree86\lib\X11\xinit\xinitrc.cmd script. You have to modify these scripts in order to set the <tt/HOSTNAME/ and <tt/DISPLAY/ variables correctly and start the server with the right IP address. The X server log shows, right to the beginning, at which IP address it is listening, for debug purposes. d577 6 a582 10 from Linux or another platform may be used without changes. There are two prominent exceptions: some S3 805 based VLB cards put their video memory in odd locations, and there seems to be an unresolvable PM driver inconsistency with Matrox cards. For S3 VLB cards, the X server can search for this memory by experimentally mapping and unmapping possible memory regions. However, in XFree86/OS2, the OS may run out of memory tiles during this process. If this happens, you must find out the location of the memory yourself and add it as an option d586 1 a586 10 to the section "Device" of your XF86Config file. For Matrox cards, the X server may fail to detect the PCI ID of the card correctly, as the PM driver and Matrox BIOS may have reprogrammed the card's PCI configuration in a non-standard way. The server will then fall into a VGA compatible mode at 320x200 resolution. To prevent this, add a <tscreen><verb> PCIProbe2 </verb></tscreen> to the section "ServerFlags" of your XF86Config file. d589 1 a589 3 modes with the <tt>xvidtune</tt> utility. Note this is an X11 program which has to be executed in a local xterm window of a running X server, not in a PM window. d599 1 a599 12 consider this still tolerable. Some more on resource requirements: With the arrival of complex desktops like WindowMaker, KDE, Gnome, Enlightment, etc. which add a lot of graphical features, resource requirements grow. The X server will cache used fonts and resource settings internally, and depending on the number of windows (backing- store) it may require much more memory and swapspace than the mentioned few MBs. Also take into consideration that X runs in parallel to PM which also takes its share. My own system, albeit meanwhile rather outdated, is a PII-233 with 128MB, however, it is a development system. 64 MB are meanwhile standard, and okay for the purpose, and my laptop runs Aurora with XFree86 in 32MB, as well. d602 1 a602 3 <tscreen><verb>startx</verb></tscreen> in a PM CMD window. People have reported problems when starting this in a fullscreen session or through a remote telnet session, so don't try it. d613 1 a613 1 <htmlurl name="http://ais.gmd.de/~veit/os2/xf86ported.html" url="http://ais.gmd.de/~veit/os2/xf86ported.html"> . d647 1 a647 1 $XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/OS2.sgml,v 3.9.2.11 1999/12/20 12:55:51 hohndel Exp $ @