# @(#)21 1.6.1.9 src/gos/2d/XTOP/clients/README, xsample, gos720 3/25/99 16:45:35 # IBM_PROLOG_BEGIN_TAG # This is an automatically generated prolog. # # gos720 src/gos/2d/XTOP/clients/README 1.6.1.9 # # Licensed Materials - Property of IBM # # COPYRIGHT International Business Machines Corp. 1990,1994 # All Rights Reserved # # US Government Users Restricted Rights - Use, duplication or # disclosure restricted by GSA ADP Schedule Contract with IBM Corp. # # IBM_PROLOG_END_TAG # # COMPONENT_NAME: xsample # # FUNCTIONS: README # # ORIGINS: 27 # # (C) COPYRIGHT International Business Machines Corp. 1990, 1994 # All Rights Reserved # Licensed Materials - Property of IBM # # US Government Users Restricted Rights - Use, duplication or # disclosure restricted by GSA ADP Schedule Contract with IBM Corp. # ------------------------------------------------------------------------------- This README file will describe how to create the executables in the X Samples or Motif demos source directories. THE INFORMATION IN THIS EXAMPLE SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY IBM. IBM MAKES NO REPRESENTATIONS ABOUT THE SUITABILITY OF THIS SOFTWARE FOR ANY PURPOSE. IT IS SUPPLIED "AS IS" WITHOUT EXPRESS OR IMPLIED WARRANTY. THE BINARIES CONTAINED IN THE DIRECTORY /usr/lpp/X11/Xamples/bin HAVE BEEN COMPILED AS A CONVENIENCE TO OUR CUSTOMERS AND ARE UNSUPPORTED. IF THE X SAMPLE CLIENTS ARE REBUILT USING THE SAMPLE CONFIGURATION IN /usr/lpp/X11/Xamples THE RESULTING BINARIES MAY BE DIFFERENT FROM THOSE ORIGINALLY SHIPPED DUE TO CHANGES IN THE COMPILER AND THE AIX OPERATING SYSTEM. ------------------------------------------------------------------------------- Table of Contents: A. Building the X Samples B. Building the Motif Demos C. Building 64-bit X or Motif Sample Programs D. Need to install bos.mh if building xmh ------------------------------------------------------------------------------- New in 430/X11R6: The top-level Makefile is not over-written by the first build. Instead, a new file 'xmakefile' is created. DO NOT RUN 'xmkmf -a' in this directory. This will overwrite the seed Makefile found in /usr/lpp/X11/Xamples and the ability to re-build the X samples by running 'make World' will be lost. Also, some X11R6 source directories changed names: - "clients" is renamed to "programs" - "lib/X" is renamed to "lib/X11" ------------------------------------------------------------------------------- A. Creating the Sample Clients To create all of the executables in the Xamples directory tree, follow these steps: 1. Make sure the date is set correctly. 2. Type "cd /usr/lpp/X11/Xamples" 3. Type "make World" 4. (optional) Type "make -k install", this will install all samples into the standard system directories. WARNING: this will overwrite any links that have been established into the sample directory at install time. For example, all links in /usr/bin/X11 to the sample binaries in /usr/lpp/X11/Xamples/bin to will be broken. Any further updates applied to the sample files on the system will install the files in their original physical locations (in the above example, /usr/lpp/X11/Xamples/bin) and the links will not be re-established. Therefore, to use the updated versions of sample files, they will need to be relinked by hand, or in the case of the binaries, the PATH environment variable will need to be set to include their physical locations. The following links will potentially be broken: /usr/bin/X11/ --> /usr/lpp/X11/Xamples/bin/ /usr/lib/X11/app-defaults/ --> /usr/lpp/X11/Xamples/programs/*/.ad /usr/include/X11/bitmaps/ --> /usr/lpp/X11/Xamples/programs/*/ /usr/lib/libXaw.a --> /usr/lpp/X11/Xamples/lib/Xaw/libXaw.a /usr/lib/libXmu.a --> /usr/lpp/X11/Xamples/lib/Xaw/libXmu.a 5. (optional) Type "make install.man", this will put all sample man-pages into /usr/lpp/X11/Xamples/man; add this directory to the MANPATH environment variable. The Makefiles needed are created dynamically using the seed Makefile found in this directory (/usr/lpp/X11/Xamples). The dependencies are then added to these Makefiles. Finally, each subdirectory is visited and the executables are made. This may take several hours to finish. The native C compiler must be installed before the executables can be created. For convenience, all unsupported sample binaries are supplied in /usr/lpp/X11/Xamples/bin and symbolically linked back to /usr/lpp/X11/bin which is linked to /usr/bin/X11. B. Building the Motif demos To compile the sample demos provided for Motif, do the following: 1. Type "cd /usr/samples/Motif2.1" 2. Type "xmkmf -a" 3. Type "make" C. Building 64-bit X11 or Motif Sample Programs To compile the sample programs in 64bit mode, all you need to do is: export OBJECT_MODE=64 and then follow the same steps above. All the X11 Xamples will build and run fine. However, because 64-bit UIL is not supported at this time, and because most of the Motif samples use UIL, you cannot make all the Motif samples in 64bit mode. However you may be able to build some of the Motif samples individually. For example, cd /usr/samples/Motif2.1/programs/earth export OBJECT_MODE=64 xmkmf -a make This will build the earth Motif application for 64-bit execution. D. Need to install bos.mh if building xmh If you build the xmh client then you need to install the bos.mh fileset. This is required because the xmh client uses commands that are contained within the bos.mh fileset. Without the installation of bos.mh xmh will not work properly.