Manuals

These manuals may be included in a hardcopy format in this Cygnus Support Progressive Release, depending on the nature of your support contract. Note: hardcopy versions of the documentation are available as a separate product from Cygnus Support if your contract does not include printed manuals. All documentation is included online with every release; see section Using Online Documentation.

For convenience we have bound them in eight wire-bound volumes.

Cygnus Developer's Kit

Introduction
Release Notes
Install Notes
GNU General Public License

Embedded Systems

Embedded Systems Programming

Using GNU CC

Using GNU CC

Debugging With GDB

Debugging With GDB

Support Libraries

The GNU C++ Iostream Library
The Cygnus C Support Library
The Cygnus C Math Library

Binary Utilities

The GNU C Preprocessor
Using AS, the GNU Assembler
GASP, the GNU Assembler Preprocessor
Using LD, the GNU Linker
The GNU Binary Utilities

GNU Make

GNU Make

Developer's Kit Support

Reporting Problems Using send-pr
Online Documentation
Rebuilding From Source
Comparing and Merging Files (diff and patch)

Source for all documentation is also included.

The manuals are designed for easy online browsing (see section Using Online Documentation). For online use, the accompanying software distribution includes all the printed manuals, and also the following documents:

FLEX: A Fast Lexical Analyzer Generator

Generates lexical analyzers suitable for GNU GCC and other compilers.

Using and Porting GNU CC

Detailed information about what's needed to put gcc on different platforms, or to modify gcc. Also includes all the information from the printed manual Using GNU CC.

BYacc

A discussion of the Berkeley Yacc parser generator.

User's Guide to the GNU C++ Library

Details about the general-purpose GNU C++ library, covered under the GNU Library General Public License.

Texinfo: The GNU Documentation Format

How you can use TeX to print these manuals, and how to write your own manuals in this style.

Cygnus configure

Details on the configuration program used in Cygnus releases.

GNU Coding Standards

A complete discussion of the coding standards used by the GNU project.

On the Sun-3 and Sun-4 (SunOS 4.1 or Solaris 2) platforms, the following manual is also provided online:

GNU gprof

Details on the GNU performance analyzer.

Finally, 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 code for them is also available on the tape.

Conventions

Our manuals use these conventions to help you distinguish commands, filenames, and other program-specific objects from the descriptive text.

Typewriter-text

Indicates text that is a literal example of a piece of a program, such as environmental variable names like EDITOR. It will also indicate keyboard characters you should type, or other literal bits of text from a program, such as filenames or examples.

key-name

Indicates the conventional name for a special key on a keyboard, such as RET or DEL.

generic-name

Stands for another piece of text. For example, in the command description "To delete the file named filename, type rm filename." filename stands for the file you want to delete, no matter what you've named it.