install-texi.in

早期freebsd实现

\input texinfo
@c
@c search for "UPDATE!" for items that will need examination on future
@c releases
@c
@c This file may require a nonstandard texinfo.tex to format; if you
@c need it, please contact Cygnus Support (email [e-mail])
@setfilename README.info
@c
@c This file describes how to install a Cygnus Progressive Release.
@c
@c Copyright (C) 1991, 1992 Cygnus Support
@c This text may be freely distributed under the terms of the GNU
@c General Public License.
@c
@c $Id: install-texi.in,v 1.2 1992/11/30 09:32:41 zoo Exp $
@c         CONFIG: One of these hosts should be set, the others clear:
@clear HOSTsun4
@clear HOSTsun3
@clear HOSTdecstation
@clear HOSTrs6000
@clear HOSTiris
@clear HOSThppa
@clear HOSThp300
@clear HOSTsolaris2
@c         CONFIG: In addition, XCOMP should be set for discussion of
@c                cross-compilation facilities 
@set XCOMP
@c
@c
@iftex
@c The include file "texiplus.tex" is in the texinfo/cygnus dir, and
@c implements Cygnus modifications to the texinfo manual style.
@input texiplus
@c The include file "smpklug.texi" is a kluge to deal with local
@c document production issues at Cygnus; it's safe to comment out this
@c line if you don't have (or don't want) the file.
@input smpklug.texi
@smallbook
@cropmarks
@setchapternewpage on
@finalout
@end iftex
@settitle ||RELEASEDIR||--||RELNO|| Installation
@tex
% override-override: the following \font lines are redundant if you're
% using an unmodified FSF texinfo.  
\globaldefs=1
\font\texttt=cmtt10 scaled \magstephalf\let\tentt=\texttt
\font\textsl=cmsl10 scaled \magstephalf\let\tensl=\textsl
\font\textsf=cmss10 scaled \magstephalf\let\tensf=\textsf
\globaldefs=0
%end override-override
% WARNING: NONSTANDARD USAGE we need \tensf for print, without
% upsetting info.  We weren't using @b in this note, so I redefine it:
%
\global\def\b#1{{\tensf #1}}
\global\parindent=0pt
@end tex
@titlepage
@title Installation Notes
@sp 3
@table @strong
@item Cygnus Support Developer's Kit
@item Progressive Release ||RELEASEDIR||--||RELNO|| for ||HOST||
@item {}
@item Contents
@end table
@c TOGGLE XREF DISPLAY TO AVOID SQUARE BRACKETS OR QUOTES:
@c (Cygnus "texiplus.tex" hack.  If you want standard texinfo remove
@c or comment-out instances of @altref).
@altref
@format
@ref{Brief,,Installing in Brief}
@ref{Contents,,Release Contents}.
@ref{Platforms,,Supported Platforms}.

@ref{Installing,,Installing the Developer's Kit}.
@ref{local-install,,Installing in @file{||INSTALLdir||/cygnus} with a local tape drive}.
@ref{cross-install,,Installing in @file{||INSTALLdir||/cygnus} with another machine's tape drive}.
@ref{Examples,,Installation Examples}.
@ref{Install-Options,,Installation Options}

@ref{Why-fixincludes,,Why Convert System Header Files?}
@ref{Links,,Links for Easy Access and Updating}
@ref{Paths,,Changing the Paths}
@ref{Trouble,,Some Things that Might go Wrong}
@ref{Removing,,Removing the Developer's Kit}.
@end format
@c TOGGLE XREF DISPLAY BACK, TO RESTORE MARKERS AROUND SECNAMES:

@altref
@author Cygnus Support @hfill hotline: [phone]
@page

@tex
\xdef\Rmanvers{{\it Installation Notes (Progressive Developer's Kit)}} % *NOT* for use in headers, footers
{\parskip=0pt \hfill Cygnus Support\par \hfill \Rmanvers\par \hfill
\TeX{}info \texinfoversion\par }
\global\def\manvers{||RELEASEDIR|| ||RELNO|| for ||HOST||}
@end tex

@vskip 0pt plus 1filll
Copyright @copyright{} 1991, 1992 Cygnus Support

Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
are preserved on all copies.

Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided also that
the entire resulting derived work is distributed under the terms of a
permission notice identical to this one.

Permission is granted to copy and distribute translations of this manual
into another language, under the above conditions for modified versions.

@end titlepage

@ifinfo
@node Top, Brief, (dir), (dir)

This file is about the Cygnus Developer's Kit: what's in it, how to
install it, and how to reconfigure it.

@menu
* Brief::                       Installing in Brief
* Contents::                    Release Contents
* Requirements::                System Requirements
* Installing::                  Installing the Developer's Kit
* Examples::                    Installation Examples
* Install-Options::             Installation Options
* Links::                       Links for Easy Access and Updating
* Running::                     Running the Programs
* Paths::                       Changing the Paths
* Trouble::                     Some Things that Might go Wrong
* Removing::                    Removing Parts of the Developer's Kit
@end menu

@end ifinfo

@node Brief, Contents, Top, Top
@unnumberedsubsubsec Installing in Brief
@strong{You can run the brief installation procedure if:}
@itemize @bullet
@item 
You have a ||TAPEdflt|| release tape (see tape label), and
@item
Your ||HOST|| has its own ||TAPEdflt|| tape drive (@code{||DEVdflt||}), and
@item
You're willing to use the installation directory @file{||INSTALLdir||/cygnus}, and
@item
You have at least ||DF|| MB available in @code{||INSTALLdir||} (try @samp{df ||INSTALLdir||})
@end itemize
Otherwise, see @ref{Installing,,Installing the
Developer's Kit}.

@strong{Steps for Brief Install:}

@enumerate
@item 
Make sure you can write in @samp{||INSTALLdir||/cygnus}, by typing:

@example
eg$ @b{su root}
password:           @i{(enter root password)}
# @b{mkdir ||INSTALLdir||/cygnus}        @i{(ignore ``File exists'' error if any)}
# @b{chmod 777 ||INSTALLdir||/cygnus}
# @b{exit}              @i{(root access not needed beyond this)}
@end example

@item
Load the ||RELEASEDIR||--||RELNO|| tape into your tape drive.

@item
Get the @code{Install} script from the tape:

@example
eg$ @b{cd /tmp}
eg$ @b{tar xfv ||DEVdflt|| Install}
@end example

@item
Run the @code{Install} script:

@example
eg$ @b{./Install}
@end example

@code{Install} displays messages about its activity, ending with

@example
Done.
@end example

@item
Build symbolic links to make execution paths easy:

@example
eg$ @b{cd ||INSTALLdir||/cygnus}
eg$ @b{ln -s ||RELEASEDIR||-||RELNO|| ||RELEASEDIR||}
eg$ @b{su root}       @i{(may need root access to put link in ||INSTALLdir||)}
password:
# @b{ln -s ||INSTALLdir||/cygnus/||RELEASEDIR||/H-||HOSTstr|| ||INSTALLdir||/||RELEASEDIR||}
# @b{exit}            @i{(give up root access as soon as possible)}
@end example

@item
Use your Cygnus customer-ID (see cover letter) to tag your copy of our
problem-report form:

@example
eg$ @b{||INSTALLdir||/||RELEASEDIR||/bin/install@t{_}cid @var{ID}}
@end example

@item
Remove public write access from @file{||INSTALLdir||/cygnus}.  See your System
Administrator for the correct permissions at your site.
@end enumerate

You're done!  Anyone who puts @samp{||INSTALLdir||/||RELEASEDIR||/bin} in her or his
@code{PATH} can use the Developer's Kit.

@node Contents, Requirements, Brief, Top
@unnumbered Release Contents

This Developer's Kit is a Cygnus Support @dfn{Progressive Release}: the
programs in it are recent versions, which have been tested and certified
both individually and as a coordinated suite of tools.
The kit includes both source and binaries for the following tools:

@c UPDATE! Anything new shoveled in?

@c ifclear doesn't seem to nest well.  For that reason, and due to lack
@c of "else" to ifclear, and due to lack of expressions in ifset/ifclear
@c arguments, "DoFullTable" used in this contorted fashion:

@set DoFullTable

@ifset HOSTrs6000
@clear DoFullTable
@end ifset

@ifset HOSTdecstation
@clear DoFullTable
@end ifset

@ifset HOSTiris
@clear DoFullTable
@end ifset

@ifset HOSThppa
@clear DoFullTable
@end ifset

@ifset HOSThp300
@clear DoFullTable
@end ifset

@ifset HOSTsolaris2
@clear DoFullTable
@end ifset

@table @t
@item gcc
C compiler

@item g++
C++ compiler

@item libc
C subroutine library

@item libm
C mathematical subroutine library

@item gas
assembler
@ifclear DoFullTable
@emph{For cross-development configurations only.}
@end ifclear

@item gdb
debugger

@item gprof
Performance analyzer

@item byacc
Parser generator

@item flex
Fast lexical analyzer generator

@item ld
@ifclear DoFullTable
@emph{For cross-development configurations only.}
@end ifclear
linker

@item make
compilation control program

@item libg++.a
C++ class library

@item ar
@ifclear DoFullTable
@emph{For cross-development configurations only.}
@end ifclear
Manages object code archives

@item nm
@ifclear DoFullTable
@emph{For cross-development configurations only.}
@end ifclear
Lists object file symbol tables

@item objdump
@ifclear DoFullTable
@emph{For cross-development configurations only.}
@end ifclear
Displays object file information

@item ranlib
@ifclear DoFullTable
@emph{For cross-development configurations only.}
@end ifclear
Generates archive index

@item size
@ifclear DoFullTable
@emph{For cross-development configurations only.}
@end ifclear
Lists section and total sizes

@item strip
@ifclear DoFullTable
@emph{For cross-development configurations only.}
@end ifclear
Discards symbols

@item makeinfo
@itemx info
Documentation tools

@item texinfo.tex
@itemx texindex
Documentation printing tools

@item send_pr
Script to send structured problem reports to Cygnus

@item diff
Compares source files

@item patch
Installs source fixes
@end table

@menu
* Platforms::                   Supported Platforms
@end menu

@page
@c this hard break is due only to lack of @group outside @example; on
@c some configs, the section heading fits but nothing else does, which