diff options
| -rw-r--r-- | install.texinfo | 295 |
1 files changed, 295 insertions, 0 deletions
diff --git a/install.texinfo b/install.texinfo new file mode 100644 index 0000000..40531e8 --- /dev/null +++ b/install.texinfo @@ -0,0 +1,295 @@ +\input cyginfo +@c WARNING!!! +@c THESE INSTALL NOTES ARE NOT YET GENERAL-PURPOSE +@c SINCE THERE IS NO ESTABLISHED INSTALLATION PROCEDURE FOR CYGNUS +@c RELEASES FROM THE DEVELOPMENT DIRECTORIES. +@c THESE NOTES MUST BE EDITED BY HAND FOR EACH RELEASE. +@c $Id$ +@setfilename README.info +@iftex +@c We don't actually want a titlepage; HEADINGSon is usually called by +@c @end titlepage to turn on footers and headers. +@HEADINGSon +@setchapternewpage off +@finalout +@end iftex +@c +@c WARNING: NONSTANDARD USAGE we need \tensf for print, without +@c upsetting info. We weren't using @b in this note, so I redefine it: +@tex +\global\def\b#1{{\tensf #1}} +\global\def\date{November 1991} +\global\def\manvers{release m88k--11--91} +\parindent=0pt +@end tex + +@node Top, Contents, (dir), (dir) +@unnumbered Installation and Release Notes + + +@table @strong +@item Cygnus Support M88K Developer's Kit +@item release m88k--11--91 +@iftex +@item @date +@item {} +@item Contents +@display +@altref +@ref{Contents,,Release Contents}. +@ref{Platforms,,Supported Platforms}. +@ref{Installing,,Installation From Tape}. +@ref{Removing,,Removing the Developer's Kit}. +@ref{Cygnus-FSF,,Cygnus and FSF Releases}. +@ref{Cygnus-Support,,Cygnus Support}. +@altref +@end display +@end iftex +@end table + +@menu +* Contents:: Release Contents +* Platforms:: Supported Platforms +* Disk:: Disk Space +* Installing:: Installation From Tape +* Removing:: Removing the Developer's Kit +* Bugs:: Where to report bugs +* Cygnus-FSF:: Cygnus and FSF Releases +* Cygnus-Support:: Cygnus Support +@end menu + +This note is about the Cygnus M88K Developer's Kit: what's in it and how to +install it. + +@node Contents, Platforms, Top, Top +@unnumberedsec 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: + +@itemize @bullet +@item +@sc{gnu emacs} (v18.57), the extensible text editor +@item +@sc{gcc} (v1.95.02), the @sc{gnu} C compiler +@item +@sc{g++} (v1.95.02), the @sc{gnu} C++ compiler +@item +@sc{gdb} (v4.2.2), the @sc{gnu} debugger +@end itemize + +@node Platforms, Disk, Contents, Top +@unnumberedsec Supported Platforms +@table @strong +@item 88open BCS +Release m88k--11--91 of the Cygnus Developer's Kit is supported on any +system running an 88open compliant operating system. + +@item Other Platforms +The Developer's Kit is likely to work when compiled for other machines, +but no other platforms are currently +@iftex +(@date) +@end iftex +supported by Cygnus as part of Release m88k--11--91. @refill +@end table +@node Disk, Installing, Platforms, Top +@unnumberedsec 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 @file{/usr/cygnus}; if you have +space available, but not in the same file system as @file{/usr}, you can +create @file{/usr/cygnus} as a symbolic link to the file system where +you do have the space available. + +@node Installing, Removing, Disk, Top +@unnumberedsec Installation From Tape + +@iftex +This note shows computer output in @code{typewriter font}. User input +is indicated by a @b{sans-serif font}. Comments appear in @i{italic +font}. +@end iftex +In all examples, the system name is assumed to be ``@code{eg};'' we show the +system prompt as @samp{eg$}. + +@menu +* Tape-Reading:: Reading the Tape +* Running:: Running the Programs +@end menu + +@node Tape-Reading, Running, Installing, Installing +@unnumberedsubsec 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: +@lisp +@cartouche +eg$ @b{mkdir /usr/cygnus} @i{only if /usr/cygnus did not exist} +eg$ @b{cd /usr/cygnus} +eg$ @b{tar xfv /dev/TAPE} +@end cartouche +@end lisp + +This will create subdirectories @file{bin}, @file{lib}, and @file{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 +@code{tar} command: +@lisp +@cartouche +eg$ @b{tar xfv /dev/TAPE} +@end cartouche +@end lisp + +@page +@node Running, , Tape-Reading, Installing +@unnumberedsubsec Running the Programs +@c [FIXME-future:] orig includes fixincluded files... "bogus +@c but easiest". In some future release, CUST MUST RUN fixincludes ONCE PER OS! +@c [FIXME] how to select cross vs native compiler? +Any users who wish to run the Cygnus development tools will need to make +sure the @code{PATH} environment variable will find them. For example, +the following should go in a Bourne shell initialization file: +@lisp +@cartouche +@b{PATH=/usr/cygnus/bin:$PATH} +@end cartouche +@end lisp + +To use the Cygnus man pages on line, you'll need to install them in your +system's @file{/usr/catman/u_man/man1} directory. For example, you can +copy them like this: +@lisp +@cartouche +eg$ @b{cp /usr/cygnus/man/man1/* /usr/catman/u@t{_}man/man1} +@end cartouche +@end lisp + +@node Removing, Bugs, Installing, Top +@unnumberedsec Removing the Developer's Kit +To remove this release of the Developer's Kit from your system +(if, eventually, you no longer want it): +@enumerate +@item +remove the man pages for this release from your system's +@file{/usr/catman/u_man/man1} directory, if you had chosen to install +them there. For example, in a Bourne-compatible shell, +@lisp +@cartouche +eg$ @b{cd /usr/cygnus/man/man1} +eg$ @b{for m in *; do} +eg> @b{rm /usr/catman/u@t{_}man/man1/$m} +eg> @b{done} +@end cartouche +@end lisp +@item +delete the directory @file{/usr/cygnus} and all its contents. +@end enumerate + +@node Bugs, Cygnus-FSF, Removing, Top +@unnumberedsec 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 +@samp{bugs@@cygnus.com}; for other contact methods, +@pxref{Cygnus-Support,,Cygnus Support}. @strong{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. @strong{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. + +@page +@node Cygnus-FSF, Cygnus-Support, Bugs, Top +@unnumberedsec 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: + +@itemize @bullet +@item +Commercial support is available. Cygnus adds value to FSF releases in +large measure by offering outstanding support services. +@item +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. +@item +Documentation. Cygnus has revised and added to available FSF +documentation to give you better descriptions of all the software tools. +@item +Coordination. The tools in your Developer's Kit are certified to work +together; you need not worry about one tool being ahead of another. +@end itemize + +@tex +@page +@end tex +@node Cygnus-Support, , Cygnus-FSF, Top +@unnumberedsec 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 @emph{use} +state-of-the-art tools instead of @emph{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. + +@display +Cygnus Support +814 University Avenue +Palo Alto, CA 94301, USA + ++1 415 322 3811 + +email: @code{info@@cygnus.com} +fax: +1 415 322 3270 +@end display + +@bye |