Be sure to MAKE A BACKUP COPY of the Metro Link Motif 2.0 distribution.

Here is the information for accessing the Linux/Motif product
you ordered from us.   Included in this transmission are three
sections:

     1.  The Metro Link Warranty and License Agreement.
     2.  FTP Instructions.
     3.  Release Notes.

If you have any questions or problems, please contact
technical support <tech@metrolink.com>.  Thank you for your order!

Holly Robinson
Metro Link Incorporated                 
holly@metrolink.com   


___________________
_____SECTION 1_____

METRO LINK INCORPORATED
4711 N. Powerline Rd.
Fort Lauderdale, FL  33309
(954) 938-0283  Voice
(954) 938-1982  Fax

 
METRO LINK WARRANTY AND LICENSE AGREEMENT
 
READ THESE LICENSE TERMS BEFORE OPENING THE SOFTWARE PACKAGE.  
OPENING THE SOFTWARE PACKAGE INDICATES YOUR ACCEPTANCE OF THIS LICENSE.  
IF YOU DO NOT AGREE TO THESE LICENSE TERMS, RETURN THE SOFTWARE PACKAGE
UNOPENED (ALONG WITH ALL ASSOCIATED WRITTEN PRODUCT MATERIALS) AND 
WITHIN THE WARRANTY PERIOD TO THE DEALER FROM WHOM YOU OBTAINED IT 
FOR A FULL REFUND.

This License is an agreement between you and METRO LINK INCORPORATED 
(hereafter "ML").

1.  LICENSE GRANT
 
Subject to the terms set forth in this License, you may use the 
enclosed computer product ("SOFTWARE"), including all associated 
software documentation furnished with this package, solely for your 
internal business purposes in the country in which the Software was 
furnished to you and on a single computer system (i.e. single or 
multiple CPU system in the same physical cabinet).

NFS mounting of programs or clients is not permitted.
 

2.  COPYRIGHT AND TITLE.
 
The Software and its copyrights are owned by ML or its suppliers.  
The Software is protected by United States copyright laws and 
international treaty provisions.  Therefore, you must treat the 
Software like any other copyrighted material (e.g., a book or musical
recording) except that you may either (a) make one (1) copy of the 
Software solely for backup purposes or (b) transfer the Software to 
a single hard disk provided you keep the original solely for backup 
or archival purposes.  You must reproduce and include the copyright 
notice on the backup copy.  You may not copy the written materials.
 

3.  RESTRICTED USE.
 
You may not rent or lease the Software, and you may not reverse engineer, 
decompile, or disassemble the Software.  Furthermore, certain components
of the Software are licensed for use exclusively with hardware supplied
by specific manufacturers, and you may not modify the Software so that
it will operate with hardware supplied by alternate manufacturers.
 

4.  ADAPTATIONS
 
Any part of the Software that you merge with other software is still 
property of ML.  In the event this License is terminated, you may not 
use part of the Software even if it has been merged with other software.  
You agree to take reasonable steps to protect ML's Software from theft 
or use contrary to this License.
 

5.  LIMITED 30-DAY WARRANTIES.
 
ML warrants to you (the original Licensee) for thirty (30) days from 
the date of delivery to you of the Software, as evidenced by a copy 
of your license purchase receipt ( the Warranty Period"), that the 
Software shall be in operable condition as described in the documentation
provided with the product code, and that the media upon which the 
Software is furnished to you will be free from defects in material and
workmanship under normal use.  FOR WARRANTY ASSISTANCE, YOU MAY EITHER 
RETURN THE SOFTWARE TO THE DEALER FROM WHICH YOU PURCHASED THE LICENSE, 
OR CONTACT THAT DEALER (WHOSE NAME AND ADDRESS IS SET FORTH ON THE BOX
CONTAINING THIS WARRANTY), OR CONTACT ML AT THE ADDRESS STATED ON THIS 
LICENSE, ATTN: CUSTOMER SERVICE DEPARTMENT.  This warranty allocates
risks of product failure between you and ML.
 

6.  NO OTHER WARRANTIES.
 
The agents, employees, distributors, and dealers of ML are not 
authorized to make modifications to this warranty, nor are additional
warranties binding on ML.  Accordingly, additional statements such as 
dealer advertising or presentations, whether oral or written, do not 
constitute warranties by ML and should not be relied upon as a limited 
warranty of ML.

ML AND ITS SUPPLIERS MAKE NO OTHER REPRESENTATIONS, CONDITIONS, OR 
WARRANTIES, EXPRESSED OR IMPLIED.  ANY IMPLIED WARRANTY OR CONDITION OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE IS LIMITED IN 
DURATION TO THE WARRANTY PERIOD.  SOME STATES DO NOT ALLOW LIMITATIONS 
ON HOW LONG AN IMPLIED WARRANTY LASTS, SO THE ABOVE LIMITATIONS MAY NOT 
APPLY TO YOU.  THIS WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS AND YOU MAY 
ALSO HAVE OTHER LEGAL RIGHTS WHICH VARY FROM STATE TO STATE.
 

7.  CUSTOMER REMEDIES
 
YOUR SOLE AND EXCLUSIVE REMEDY AND ML'S SOLE LIABILITY HEREUNDER 
SHALL BE, UPON YOUR RETURN OF THE SOFTWARE TO ML WITH THE RECEIPT 
WITHIN THE WARRANTY PERIOD, AT ML'S OPTION, REPLACEMENT OR REPAIR 
OF SOFTWARE THAT DOES NOT MEET ML'S LIMITED WARRANTY OR A REFUND OF 
THE SOFTWARE'S PURCHASE PRICE.  ML'S SUPPLIERS SHALL NOT BE HELD TO 
ANY LIABILITY FOR ANY DAMAGES SUFFERED OR INCURRED BY YOU.  IN NO EVENT 
SHALL ML OR ITS SUPPLIERS BE LIABLE TO YOU OR ANY OTHER PERSON FOR ANY 
INCIDENTAL, COLLATERAL, SPECIAL, OR CONSEQUENTIAL DAMAGES, INCLUDING 
WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, LOSS OF CUSTOMERS, 
LOSS OF GOOD WILL, WORK STOPPAGE, DATA LOSS, COMPUTER FAILURE OR 
MALFUNCTION, CLAIMS BY ANY PARTY OTHER THAN YOU, OR ANY OR ALL OTHER 
SIMILAR DAMAGES OR LOSS EVEN IF ML, ITS SUPPLIERS, OR ITS AGENT HAS 
BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.  SOME STATES DO NOT 
ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL 
DAMAGES, SO THE ABOVE LIMITATIONS OR EXCLUSION MAY NOT APPLY TO YOU.

ML shall have no liability or responsibility for Software altered, 
modified, or converted by you or a third party, damages resulting 
from accident, abuse, or misapplication, or for problems due to the 
malfunction of your equipment or software not supplied by ML.
 

8.  TERMINATION
 
This License is in effect until terminated and terminates without 
notice from ML if you fail to comply with any of its provisions.  
Upon termination you shall either destroy the Software and all copies 
or portions thereof or return the Software and all copies as portions 
thereof to ML.
 

9.  GENERAL
 
This License is governed by the laws of the State of Florida.  This 
License represents the entire statement of the understandings and 
agreements among the parties.
 

10. U.S. GOVERNMENT RESTRICTED RIGHTS
 
This Software and documentation is provided with RESTRICTED RIGHTS.  
Use, duplication, or disclosure by the Government is subject to 
restrictions as set forth in subparagraph (c)(1)(ii) of the Rights 
in Technical Data and Computer FAR 52.227-14 (Alternate III) or the 
Software clause at DFAR 252.227-7013.  Contractor/manufacturer is 
METRO LINK INCORPORATED, 4711 North Powerline Road, Fort Lauderdale, 
FL  33309.

Metro-X, Metro-Xv, Metro-XIE are trademarks of METRO LINK Incorporated.



___________________
_____SECTION 2_____


 FTP INSTRUCTIONS 

NOTE:
THE PROGRAMS ON THESE FILES ARE LICENSED TO 
THE USER.  BY ACCESSING THESE FILES, YOU AGREE
TO THE METRO LINK SOFTWARE LICENSE AGREEMENT.

ftp to:
  ftp.metrolink.com

Login: linmtf

Password: t1mB8rbq
(This password expires Aug 5, 1996 at 10:00 AM EDT)

Change to the "tar" directory.  There is an "rpm" directory too.
If your system supports RPM packages, feel free to try them.
We cannot help you install the RPM's though, only the tarballs.
If you need more information on RPM, please visit
http://www.redhat.com/redhat/products/rpm/

    cd tar

Make sure you turn on binary transfer.

    binary

Retrieve these files:
    aout20.tar.gz
    catman20.tar.gz
    demos20.tar.gz
    demosbin20.tar.gz
    devel20.tar.gz
    exec20.tar.gz
    mwm20.tar.gz
    usrman20.tar.gz

You can get them all with the command:

    mget *.gz

The motif2.0-doc directory contains the PostScript version of the Motif
2.0
manuals. You do not have to download these files to use Motif 2.0, but you
may find it useful to print the documentation.

Follow the installation instructions in SECTION 3.

If you have problems please send email to:

     tech@metrolink.com

         or call

     (954) 938-0283


___________________
_____SECTION 3_____


                            OSF/Motif 2.0
                  Quick Installation and Release Notes
                                 for
                                Linux

Thank you for purchasing Metro Link's enhanced version of OSF/Motif 2.0
for Linux. Metro Link's Motif is derived from OSF/Motif under license from
OSF.

We recommend reading these instructions completely before 
installing the product. The entire installation must be done as the 
superuser (root). 

HARDWARE REQUIREMENTS

The full installation of Metro Link Motif 2.0 requires 30 megabytes 
of disk space, or 20 MB if you compress the man pages. 8 MB of 
RAM is required. 16 MB or more are recommended.

SOFTWARE REQUIREMENTS

The tar, cpio, and gzip utilities are required to extract the
distribution.
The following are the minimum versions of system software required.
Be sure you have the proper versions of system software installed before
beginning the installation.

    Linux 1.1.92
    libc 5.0.9
    ld.so 1.6.5
    binutils 2.5.2l.15
    XFree86 3.1.1
    xpm 3.4f
    To compile programs, gcc 2.7.0.


INSTALLATION INSTRUCTIONS

Motif 2.0:

0.  MAKE A BACKUP COPY of the Metro Link Motif 2.0 distribution.

1.  Log in to a text console as root.

2.  If you haven't already, please make these symbolic links, as 
    suggested by the Linux Filesystem Standard. This assumes 
    your filesystem setup is fsstnd-compliant. If not, complain
    to your Linux vendor, and ask him to comply with the standard
    in future releases.  You will have to find your X binaries,
    library directories (app-defaults, config, etc.), and include files,
    and make the appropriate symbolic links yourself.

        ln -s /usr/X11R6/lib/X11        /usr/lib/X11 
        ln -s /usr/X11R6/bin            /usr/bin/X11 
        ln -s /usr/X11R6/include/X11    /usr/include/X11



3.  Download the files as described in SECTION 2 into your /tmp directory.
    Be sure to make a backup copy of the Metro Link Motif distribution!

4.  Use the following commands to extract these files into your 
    filesystem:

    NOTE: It is very important to "cd" to the root directory (/) 
    before executing tar.

        cd /
	tar -zxvf /tmp/aout20.tar.gz

    Tar lists the files as it extracts them.

5.  Remove the temporary file (Did you make a backup in step 0, above?):

        rm /tmp/aout20.tar.gz

6.  Repeat steps 4 and 5 for each of the components of the 
    distribution shown in table 1, below.
	

                   TABLE 1:  Distribution Components

        FILE NAME          CONTENTS
       
---------------------------------------------------------------------
        aout20.tar.gz      a.out shared Motif widget library
        catman20.tar.gz    preformatted ASCII man pages
        demos20.tar.gz     source to OSF demos (for instructional
purposes)
        demosbin20.tar.gz  prebuilt demo programs (for instructional
purposes)
        devel20.tar.gz     development system
        exec20.tar.gz      shared Motif widget library
        mwm20.tar.gz       Motif window manager, icons, xbmbrowser, pixmap
        usrman20.tar.gz    roff source to man pages

7.  In the BeforeVendorCF section of your site.def file
    (/usr/X11R6/lib/X11/config/site.def), add the 
    following three lines:

        #define LocalTmplFile <Motif.tmpl>
        #define LocalRulesFile <Motif.rules>
        #define BuildPlusPlus

8.  Run "ldconfig -v". Observe the output and make sure 
    the system finds your new libXm.so.2.0.

9.  Please execute these commands (see discussion in step 2, 
    above):

        ln -s /usr/X11R6/include/Mrm    /usr/include/Mrm
        ln -s /usr/X11R6/include/Xm     /usr/include/Xm
        ln -s /usr/X11R6/include/XmCxx  /usr/include/XmCxx
        ln -s /usr/X11R6/include/uil    /usr/include/uil

10. Congratulations!  You have completed the installation. 
    Enjoy Motif.  What do you do now?  Here are some suggestions:

    a.  Edit your ~/.xinitrc file to run mwm.
    b.  Set up your own ~/.mwmrc.  The default is in
        /etc/X11/system.mwmrc.
    c.  Edit your ~/.Xresources (or ~/.Xdefaults) as you like.


VERSION NUMBERS

If you are not sure which version of a particular software package 
you have, here are the commands to find out:

Linux:     uname -r
libc:      ls /lib/libc.so.*
gcc:       gcc -v
ld.so:     ldd -v
binutils:  ld -v
tar:       tar --version
cpio:      cpio --version
XFree86:   Check the file name (e.g. X311lib.tgz for 3.1.1) from
           the distribution.


COMPILING MOTIF PROGRAMS

Your programs should include the file <X11/Xlocale.h> instead 
of <locale.h> and be compiled with -DX_LOCALE.

The Motif widget library, libXm, requires the X Pixmap library, 
libXpm. So the shortest link command you will probably use is

   gcc -o foo foo.o -L/usr/X11R6/lib -lXm -lXpm -lXt -lXext -lX11

If your application uses the Motif resource manager library, you 
want to link with it. If your application uses other libraries from the 
core X distribution, you want to link with them. Example:

   gcc -o foo foo.o -L/usr/X11R6/lib -lMrm -lXm -lXpm -lXmu -lXt -lXext 
-lX11 -lSM -lICE


BUILDING THE DEMOS

Motif demo source code is included for instructional purposes only.
The Motif demo programs are not to be considered production-quality code.
Prebuilt demos are part of the core distribution.
Technical support for building the demos is not available.
If you wish to build the demos, please try:

    cd /usr/src/motif
    xmkmf
    make Makefiles
    make includes
    make depend
    make -k

The file /usr/src/motif/demos/lib/Exm/wml/Exm.wmd is 
included because it requires portions of Motif that cannot be 
shipped.  A copy is also in Exm.wmd.dist.


MAN PAGES

Source code and preformatted ASCII versions of the man pages are 
included. To generate PostScript versions, do, e.g.:

   groff -t -Tps -mandoc Application.3x >/tmp/Application.3x.ps

The man pages--roff source and preformatted ASCII--take up 15 
megabytes. Some man page readers know how to uncompress or 
gunzip man pages. If yours does, you may compress or gzip these 
files to save space. When the man pages are gzipped, they take up 5 
megabytes.


BEFORE YOU CALL

If you get "Missing separator" errors from make, be sure you have 
done step 7 in the Installation Instructions, above.

If you are unable to link a program to a shared library that
"ldconfig -p" knows about, you may have to make a symbolic link like
    ln -s /usr/X11R6/lib/libXm.so.2 /usr/X11R6/lib/libXm.so

If you do not install the static Motif widget library (libXm.a), you 
cannot link programs with gcc -g or gcc -static.

If you get "Unable to load shared library libXmu.so.6",
this means your system does not have an ELF shared libXmu.
Try installing the XFree86 ELF libraries from
ftp://sunsite.unc.edu/pub/Linux/X11/XFree86-3.1.1/ELF/


QUESTIONS/COMMENTS?

If you have problems with the product, you can reach Metro Link's 
technical support department in the following ways:

       E-Mail: tech@metrolink.com
       Phone: (954) 938-0283 ext. 2
       E-Mail: tech@metrolink.com
       Fax: (954) 938-1982
       E-Mail: tech@metrolink.com

Please have the following information available:

* Linux version
* C library version
* XFree86 version
* GCC version
* ld.so version
* binutils version
* contents of /etc/ld.so.conf (cat /etc/ld.so.conf)
* output from "ldconfig -p"
* Motif version (2.0)
* Description of the problem
* How to reproduce the problem
* Suggested fix (optional)


FOR MORE INFORMATION

The Usenet newsgroups comp.windows.x and comp.windows.x.motif 
may be helpful.

There are many books on X and Motif. The complete X bibliography 
is available via ftp from ftp.x.org:/contrib/docs/Xbibliography.ps.

The Motif FAQ also has information on Motif books and journals. It 
is available via ftp from
rtfm.mit.edu:/pub/usenet-by-hierarchy/comp/windows/x/motif

O'Reilly and Associates publishes a series of books on X, Motif, and 
Linux.  Here are some pertinent O'Reilly titles:

Running Linux. By Matt Welsh & Lar Kaufman. 1st Edition 
February 1995.  ISBN: 1-56592-100-3. 600 pages.

Volume 3M: X Window System User's Guide:Motif Edition. By Valerie 
Quercia & Tim O'Reilly. 2nd Edition January 1993.
ISBN: 1-56592-015-5. 956 pages.

Volume 6A: Motif Programming Manual. By Dan Heller, Paula 
Ferguson & David Brennan. 2nd Edition February 1994.
ISBN: 1-56592-016-3. 1016 pages.

Volume 6B: Motif Reference Manual. By Paula Ferguson & David 
Brennan. 1st Edition June 1993. ISBN: 1-56592-038-4. 920 pages.