aboutsummaryrefslogtreecommitdiff
path: root/nx-X11/lib/GLw/README.txt
diff options
context:
space:
mode:
Diffstat (limited to 'nx-X11/lib/GLw/README.txt')
-rw-r--r--nx-X11/lib/GLw/README.txt199
1 files changed, 199 insertions, 0 deletions
diff --git a/nx-X11/lib/GLw/README.txt b/nx-X11/lib/GLw/README.txt
new file mode 100644
index 000000000..4892f1e78
--- /dev/null
+++ b/nx-X11/lib/GLw/README.txt
@@ -0,0 +1,199 @@
+ GL widgets for Xt/Motif
+
+ XFree86 implementation
+
+ by Carlos A. M. dos Santos
+ casantos@cpmet.ufpel.tche.br
+
+ ------------------------------------------------------------------------
+
+1. Introduction
+
+This directory contains the source code for SGI's OpenGL Xt/Motif(TM)
+widgets, slightly modified to generate both Motif 1.x and 2.x versions of
+the widget even if Motif is not available, as in the XFree86 distribution of
+the X Window System. This code is based on that distributed by Silicon
+Graphics as part of it's OpenGL Sample Implementation, not on the modified
+version distributed with Mesa.
+
+2. Installation
+
+This code is intended to be compiled as part of the normal XFree86 building
+process, under the xc/lib/GLw directory. To compile the library out of the X
+source tree, follow instructions below.
+
+2.1. Requirements
+
+Gzip and tar are needed to extract the files from the distribution archive.
+Tar is a standard UNIX utility but if you don't have it use GNU tar,
+available in source form at ftp://ftp.gnu.org/pub/gnu/. Gzip is not a
+standard UNIX utility, though available in many systems. You may obtain it
+(also source form) at the same FTP server as GNU tar.
+
+You need xmkmf and imake too. Depending on your operating system you may
+need to install some kind of X Window System development kit, so check the
+vendor documentation first. I was told that some UNIX systems don't have
+imake: report this as a bug (to your vendor, not me).
+
+Of course you will need a C compiler.
+
+2.2. Steps
+
+ 1. Extract the source code from the distribution archive.
+
+ gzip -dc GLw.tar.gz | tar xf -
+
+ 2. Go to the surce code directory and generate the makefile.
+
+ cd GLw
+ xmkmf
+
+ For LessTif, use "mxmkmf" instead of "xmkmf". Imake support is much
+ better in recent versions of LessTif (since late july 2000). If your
+ Motif or OpenGL libraries and/or include files are installed in
+ non-standard locations (some UNIX vendors seem to be very creative :-)
+ then edit the file named Imakefile, remove the leading XCOMM of the
+ lines containing MOTIF_INCLUDES and MOTIF_LDFLAGS and set the
+ appropriate values.
+
+ 3. Compile the code with
+
+ make includes
+ make standalone
+
+ 4. Install the library and manual pages with
+
+ make install
+ make install.man
+
+ 5. Optionally, you may compile two test programs: xmdemo and xtdemo. You
+ need OpenGL (or Mesa) for both and Motif (or LessTif) for xmdemo. There
+ are four extra make targers for these programs: demos, stand-demos,
+ stand-xmdemo and stand-xtdemo. You may use them with:
+
+ make stand-demos
+ ./xmdemo ./xtdemo
+
+2.3. Creating a shared library
+
+By default only a static library is created because most of the UNIX
+loaders, if not all, complain about unresolved symbols even if the
+application doesn't use the modules in which such symbols are referenced.
+However, if your system supports libraries with weak symbols (e.g. Solaris,
+FreeBSD and Linux) it is possible to fool the loader. All you have to do is
+edit the Imakefile, changing "#define SharedLibGLw" and "#define
+GLwUseXmStubs" to YES, then repeat the compilation process starting from
+step 2 in the previous section.
+
+2.4. Problems
+
+If you have trouble, ask for help in the XFree86 "xperts" mailing list. Look
+at http://www.xfree86.org for instructions on how to subscribe. In
+desperation, send an email to casantos@cpmet.ufpel.tche.br.
+
+PLEASE DO NOT SEND ME EMAIL ASKING HOW TO INSTALL OR CONFIGURE YOUR
+OPERATING SYSTEM, MODEM, NETWORK CARD, BREAD TOASTER, COFEE MAKER OR
+WHATEVER ELSE!
+
+3. Copyrights
+
+Most of the code is covered by the following license terms:
+
+ License Applicability. Except to the extent portions of this file
+ are made subject to an alternative license as permitted in the SGI
+ Free Software License B, Version 1.1 (the "License"), the contents
+ of this file are subject only to the provisions of the License.
+ You may not use this file except in compliance with the License.
+ You may obtain a copy of the License at Silicon Graphics, Inc.,
+ attn: Legal Services, 1600 Amphitheatre Parkway, Mountain View, CA
+ 94043-1351, or at:
+
+ http://oss.sgi.com/projects/FreeB
+
+ Note that, as provided in the License, the Software is distributed
+ on an "AS IS" basis, with ALL EXPRESS AND IMPLIED WARRANTIES AND
+ CONDITIONS DISCLAIMED, INCLUDING, WITHOUT LIMITATION, ANY IMPLIED
+ WARRANTIES AND CONDITIONS OF MERCHANTABILITY, SATISFACTORY
+ QUALITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+
+ Original Code. The Original Code is: OpenGL Sample Implementation,
+ Version 1.2.1, released January 26, 2000, developed by Silicon
+ Graphics, Inc. The Original Code is Copyright © 1991-2000 Silicon
+ Graphics, Inc. Copyright in any portions created by third parties
+ is as indicated elsewhere herein. All Rights Reserved.
+
+ Additional Notice Provisions: The application programming
+ interfaces established by SGI in conjunction with the Original
+ Code are The OpenGL® Graphics System: A Specification (Version
+ 1.2.1), released April 1, 1999; The OpenGL® Graphics System
+ Utility Library (Version 1.3), released November 4, 1998; and
+ OpenGL® Graphics with the X Window System® (Version 1.3), released
+ October 19, 1998. This software was created using the OpenGL®
+ version 1.2.1 Sample Implementation published by SGI, but has not
+ been independently verified as being compliant with the OpenGL®
+ version 1.2.1 Specification.
+
+The demonstration programs are covered by the following license terms:
+
+ Copyright © Mark J. Kilgard, 1995, 1996.
+
+ NOTICE: This source code distribution contains source code
+ contained in the book "Programming OpenGL for the X Window System"
+ (ISBN: 0-201-48359-9) published by Addison-Wesley. The programs
+ and associated files contained in the distribution were developed
+ by Mark J. Kilgard and are Copyright 1994, 1995, 1996 by Mark J.
+ Kilgard (unless otherwise noted). The programs are not in the
+ public domain, but they are freely distributable without licensing
+ fees. These programs are provided without guarantee or warrantee
+ expressed or implied.
+
+The files contained in directory GLwXm are fake Motif headers, covered by
+the XFree86 license, they permit us to generate both Motif 1.x and 2.x
+versions of the widget without having Motif. Notice that they are NOT part
+of a standard Motif distribution and shall not be used to compile any other
+code.
+
+4. Thanks
+
+Many thanks to Silicon Graphics and Mark J. Kilgard for making their
+software free.
+
+5. No thanks
+
+ THIS SECTION CONTAINS MY PERSONAL OPINIONS AND DOESN'T REPRESENT
+ AN OFFICIAL POSITION OF THE XFree86 PROJECT.
+
+The first incarnation of this version of libGLw used eight header files from
+LessTif, four for each Motif version. LessTif is covered by the GNU Library
+General Public License (LGPL) whose terms are not compatible with the
+XFree86 licensing policy. Since the copyright holder of LessTif is the Free
+Software Foundation (FSF), I asked Richard Stallman, president of FSF and so
+called "leader of the Free Software movement", permission to redistribute a
+copy of those eight headers under XFree86 terms, still maintaining the FSF
+copyright.
+
+Observe that I was not asking him to change the license of LessTif as a
+whole, but only to allow me to distribute copies of some header files
+containing function prototypes, variable declarations and data type
+definitions. Even so, Stallman said no because the files contained "more
+than 6000 lines of code". Which code? The LessTif headers are mostly copies
+of the Motif ones and don't contain any original GNU "code"! I can't still
+imagine a reason for Stallman's negative answer except for paranoia. He
+seems to ignore what Motif is and that LessTif's API is simply a copy of
+Motif's one.
+
+After spending some time, I made my own headers, that became much smaller
+than the previous ones because I included only a subset of the Motif API and
+merged everything into four files: 417 lines instead 6000. Humm, perhaps I
+should be grateful to Sallman too :-).
+
+6. Trademarks
+
+ * OpenGL is a trademark of Silicon Graphics, Inc.
+ * Motif is a trademark of the Open Group.
+
+ ------------------------------------------------------------------------
+
+
+
+$XFree86$