\input cyginfo

Installation and Release Notes
******************************

Cygnus Support M88K Developer's Kit

release m88k--11--91

This note is about the Cygnus M88K Developer's Kit: what's in it and how to install it.

Release Contents
================

This Developer's Kit is a Cygnus Support Release: the programs in the release have been tested both individually and as a coordinated suite of tools.

The programs in this Developer's Kit are shipped as binaries, preconfigured to run on Motorola 88K-based workstations ``out of the box.''

We also include the full source code.

The individual programs are:

  * GNU EMACS (v18.57), the extensible text editor

  * GCC (v1.95.02), the GNU C compiler

  * G++ (v1.95.02), the GNU C++ compiler

  * GDB (v4.2.2), the GNU debugger

Supported Platforms
===================

88open BCS
     Release m88k--11--91 of the Cygnus Developer's Kit is supported on any system running an 88open compliant operating system.

Other Platforms
     The Developer's Kit is likely to work when compiled for other machines, but no other platforms are currently supported by Cygnus as part of Release m88k--11--91.

Disk Space
==========

The total space required to extract and install binaries for all programs in Release m88k--11--91 is 32 megabytes.

The software is configured to go in /usr/cygnus; if you have space available, but not in the same file system as /usr, you can create /usr/cygnus as a symbolic link to the file system where you do have the space available.

Installation From Tape
======================

In all examples, the system name is assumed to be ``eg;'' we show the system prompt as eg$.

Reading the Tape
----------------

For certification purposes, the M88K Developer's Kit is packaged as two QIC 150 tapes; one containing only binaries for all programs, and one containing source.

Load the Cygnus Support binary tape into your system's tape drive. You can extract the complete tape contents as follows:

     eg$ mkdir /usr/cygnus    only if /usr/cygnus did not exist
     eg$ cd /usr/cygnus
     eg$ tar xfv /dev/TAPE

This will create subdirectories bin, lib, and man, with the conventional meanings.

If you also want the source, for reference or modification, load the Cygnus Support source tape into your tape drive, and repeat the tar command:

     eg$ tar xfv /dev/TAPE

Running the Programs
--------------------

Any users who wish to run the Cygnus development tools will need to make sure the PATH environment variable will find them.  For example, the following should go in a Bourne shell initialization file:

     PATH=/usr/cygnus/bin:$PATH

To use the Cygnus man pages on line, you'll need to install them in your system's /usr/catman/u_man/man1 directory.  For example, you can copy them like this:

     eg$ cp /usr/cygnus/man/man1/* /usr/catman/u_man/man1

Removing the Developer's Kit
============================

To remove this release of the Developer's Kit from your system (if, eventually, you no longer want it):

 1. remove the man pages for this release from your system's /usr/catman/u_man/man1 directory, if you had chosen to install them there.  For example, in a Bourne-compatible shell,

          eg$ cd /usr/cygnus/man/man1
          eg$ for m in *; do
          eg> rm /usr/catman/u_man/man1/$m
          eg> done

 2. delete the directory /usr/cygnus and all its contents.

Where to report bugs
====================

If you find a bug in this release, please report it to Cygnus Support. The easiest way to report a bug is via Internet electronic mail to bugs@cygnus.com; for other contact methods, see Cygnus Support.  Do not report these bugs directly to the GNU project at the Free Software Foundation!  Cygnus is distributing an early release of advanced versions of the GNU compiler and development tools, and we therefore have full responsibility for supporting this release.  The FSF will not respond to bugreports on this software until release 2.0 of the compilers.  You, the FSF, and Cygnus will all be best served if you send bugreports directly to Cygnus Support.

Cygnus and FSF Releases
=======================

The tools in this Developer's Kit are originally from the Free Software Foundation, and versions of all these tools can be obtained from the FSF as well as from Cygnus.  Release m88k--11--91 contains the most current versions; similar versions of the compilers, in particular, will eventually be available from the FSF as version 2.00.  In general, Cygnus Releases add to FSF software as follows:

  * Commercial support is available.  Cygnus adds value to FSF releases in large measure by offering outstanding support services.

  * Bug fixes.  Cygnus performs necessary repairs to bugs discovered during testing, and also tracks and includes bug fixes developed for other Cygnus customers or distributed over the Internet.

  * Documentation.  Cygnus has revised and added to available FSF documentation to give you better descriptions of all the software tools.

  * Coordination.  The tools in your Developer's Kit are certified to work together; you need not worry about one tool being ahead of another.

Cygnus Support
==============

Cygnus Support was founded in 1989 to provide commercial support for free software.  Cygnus supplies products and services that benefit advanced development groups by allowing them to use state-of-the-art tools instead of maintaining them.  With Cygnus Support, sites that once were forced to do their own tool support can recover that valuable staff time.  Former users of proprietary software now may choose supported free software, combining the advantages of both worlds.

Free software is faster, more powerful, and more portable than its proprietary counterparts.  It evolves faster because users who want to make improvements are free to do so.  Cygnus tracks these improvements and integrates them into tested, stable versions ready for commercial use, then backs this software with comprehensive support.

With Cygnus Support as your partner, you will have the software and the support you need to meet your business objectives better.  Cygnus is intimately familiar with this software from extensive experience using, debugging, and implementing it.  You get direct access to the most qualified support people: the authors of that software.

We provide ``vintage'' releases---stable versions which have been though extensive use and testing---or up-to-the minute sources, for those who need the very latest version.  Vintage releases undergo at least nine months of intensive use before certification as vintage.

Because all our improvements are also free software, you can distribute them widely within your organization, or to your customers, without extra cost.

     Cygnus Support
     814 University Avenue
     Palo Alto, CA 94301, USA

     +1 415 322 3811

     email: info@cygnus.com
     fax: +1 415 322 3270