intro.texi

早期freebsd实现

\input texinfo
@c $Id: intro.texi,v 1.3 1992/11/30 09:40:44 zoo Exp $
@setfilename intro.info
@settitle Introduction

@ifinfo
@format
START-INFO-DIR-ENTRY
* Intro: (intro).		The Cygnus Support Developer's Kit
END-INFO-DIR-ENTRY
@end format
@end ifinfo

@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
@finalout
@c We don't actually want a titlepage; HEADINGSon is usually called by
@c @end titlepage to turn on footers and headers.
@setchapternewpage odd
@HEADINGSon
@end iftex

@node Top, Copying, (dir), (dir)
@unnumbered Introduction

This Developer's Kit puts at your disposal, in a single coordinated
and tested release, some of the best software development tools
available:

@table @t
@item gcc
C compiler

@item g++
C++ compiler

@item gdb
Debugger

@item make
Automates building and installing your programs

@item gprof
Performance analyzer

@item byacc
Parser generator

@item flex
Fast lexical analyzer generator

@item libg++.a
Class library for C++

@item send_pr
Script to send structured problem reports to Cygnus

@item diff
Compares source files

@item patch
Installs source fixes

@item info
@itemx makeinfo
Online documentation tools

@item texinfo.tex
@itemx texindex
Documentation printing tools
@end table

The Developer's Kit is available for @dfn{native} development (where the
same kind of system can run both the tools and the code you develop with
them) and for @dfn{cross-development} (where one system, the @dfn{host},
runs the tools to develop software for another system, the @dfn{target}).

On cross-development configurations, and on some native configurations,
the following are also included (to see if they are available on your
host, @pxref{Contents, Release Contents, Release Contents, README.info,
Installation Notes}).

@table @t
@item gas
Assembler

@item ld
Linker

@item ar
Manages object code archives

@item nm
Lists object file symbol tables

@item objdump
Displays object file information

@item ranlib
Generates archive index

@item size
Lists section and total sizes

@item strip
Discards symbols
@end table

On cross-development configurations only, two C subroutine libraries are
included: 

@table @t
@item libc.a
C support library

@item libm.a
C mathematical subroutine library
@end table

These tools are free software; most of them are from the GNU project,
produced by the Free Software Foundation (FSF).  ``GNU'' is the name of
the FSF's evolving system (in speech, the `G' is sounded).  Cygnus
Support collaborates with the FSF in developing these tools.  In this,
our @dfn{Progressive} product, we've assembled the most recent forms of
the development tools, tested them, made sure they work well together,
made them easy to install---the installation tape comes with binaries
already compiled for your system---and made them easy to reconfigure and
recompile from source.

Cygnus Support exists to help our clients exploit their freedom in
using, adapting, or enhancing this software.  @xref{Cygnus,,About Cygnus
Support}, for more information.

@page
@menu
* Copying::			Free Software
* Manuals::			Manuals
* Info::			Using Online Documentation
* Bugs::			Reporting Trouble
* Cygnus::			About Cygnus Support
@end menu

@node Copying, Manuals, Top, Top
@section Free Software
If you find our Developer's Kit useful, please feel free to give or sell
copies of the software and documentation to anyone you like.

Cygnus products are @dfn{free software}, protected by the @sc{gnu} General
Public License (GPL).  The GPL gives you the freedom to copy or adapt any
program it licenses---but every person getting a copy also gets with it the
freedom to modify that copy (which means that they must get access to
the source code), and the freedom to distribute further copies.  Typical
software companies use copyrights to limit your freedoms; the GPL is
designed to preserve your freedoms.

Fundamentally, the General Public License is a license which grants you
these freedoms, and only imposes restrictions to ensure that no one can
take these freedoms away from anyone else.

For full details, see the @strong{LICENSE} section in this manual
set.

@page
@node Manuals, Info, Copying, Top
@section Manuals
@noindent
These printed manuals are included in your Cygnus Progressive Release:
@display

@cite{Using the @sc{gnu} C Compiler}

@cite{The C Preprocessor}

@cite{The Cygnus C Support Library}

@cite{The Cygnus C Math Library}

@cite{GDB: The @sc{gnu} Source-Level Debugger}

@cite{Using @code{as}: The @sc{gnu} Assembler}

@cite{The @sc{gnu} Binary Utilities}

@cite{@code{gld}, the @sc{gnu} Linker}

@cite{@sc{gnu} Make: A Program for Directing Recompilation}

@cite{User's Guide to the @sc{GNU} C++ Class Library}

@end display

The manuals are designed for easy online browsing (@pxref{Info,,Online
Documentation}).  For online use, the accompanying software distribution
tape includes all the printed manuals, and also the following documents:

@table @emph
@item FLEX: A Fast Lexical Analyzer Generator
Generates lexical analyzers suitable for GCC and other compilers.

@item Info: Documentation Browsing System
Full details on the @code{info} browser.

@item Texinfo: The @sc{gnu} Documentation Format
How you can use @TeX{} to print these manuals, and how to write your own
manuals in this style.

@item Using and Porting @sc{gnu cc}
Detailed information about what's needed to put @sc{gnu cc} on different
platforms, or to modify @sc{gnu cc}.  Also includes all the
information in the printed manual @cite{Using the @sc{gnu} C Compiler}.
@end table

@noindent
Finally, @code{man} pages are included for all the programs in the release.

You have the freedom to copy the manuals, like the software they cover;
each manual's copyright statement includes the necessary permissions.
The manuals themselves are also free software, and the source for them
is also available on the tape.

@node Info, Bugs, Manuals, Top
@section Using Online Documentation

You can browse through the online documentation using either @sc{gnu} Emacs,
or the program @code{info} included on the accompanying tape.
Online, the manuals are organized into @dfn{nodes}, which correspond to
the chapters and sections of a printed book.  You can follow them in
sequence, if you wish, just like in the printed book---but there are
also other choices.  The documents have menus that let you go quickly to
the node that has the information you need.  @code{info} has ``hot''
references; if one section refers to another, you can tell @code{info}
to take you immediately to that other section---and you can get back
again easily to take up your reading where you left off.  Naturally, you
can also search for particular words or phrases.

The best way to get started with the online documentation system is to
run the browser @code{info}.  After the Progressive Release is installed on
your system, you can get into @code{info} by just typing its name---no
options or arguments are necessary---at your shell's prompt (shown as
@samp{eg%} here):
@example
eg% info
@end example

@noindent
@code{info} will display its first screen, a menu of the documentation
available, and will await your input.  Typing the single letter