File: intro.texi

package info (click to toggle)
pm3 1.1.13-11
  • links: PTS
  • area: main
  • in suites: potato
  • size: 174,164 kB
  • ctags: 133,819
  • sloc: ansic: 982,617; modula3: 548,483; cpp: 57,119; exp: 21,673; sh: 17,053; lisp: 13,693; makefile: 13,492; asm: 11,795; yacc: 8,575; sed: 1,100; objc: 476; csh: 254; awk: 223; pascal: 95; fortran: 5
file content (919 lines) | stat: -rw-r--r-- 28,199 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
\input texinfo

@setfilename intro.info
@settitle Introduction

@ifinfo
@format
START-INFO-DIR-ENTRY
* intro: (intro.info).         An Introduction to Cygnus Releases
END-INFO-DIR-ENTRY
@end format
@end ifinfo

@finalout
@setchapternewpage on

@c uncomment one of the following:

@set cdk
@c @set emacs
@c @set dejagnu
@clear debug

@ifset cdk
@set RELEASE Developer's Kit
@end ifset
@ifset emacs
@set RELEASE Emacs
@end ifset
@ifset dejagnu
@set RELEASE DejaGnu
@end ifset

@ifset debug
@set RELEASE DEBUGMODE
@set cdk
@set emacs
@set dejagnu
@end ifset

@titlepage
@title Introduction
@subtitle Cygnus Support @value{RELEASE}

@sp 5

@c altref is a Cygnus Support texiplus.tex hack -- comment out instances
@c of @altref for standard Texinfo

@altref

@format
@ref{Release,,Cygnus Support @value{RELEASE}}.
@ref{Manuals,,Manuals}.
@ref{Info,,Using Online Documentation}.
@ref{Support,,Your Support Contract}.
@ref{Bugs,,Reporting Trouble}.
@ref{Copying,,Free Software}.
@ref{AboutCygnus,,About Cygnus Support}.
@ref{Cygnus-FSF,,Cygnus Support and the FSF}.
@end format

@c toggle back references
@altref

@author Cygnus Support
@page

@vskip 0pt plus 1filll
Copyright @copyright{} 1991, 1992, 1993, 1994, 1995 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
@top Introduction

This manual introduces the Cygnus Support Progressive @value{RELEASE}
distribution.  For details, see the nodes below.

@menu
* Release::         Cygnus Support @value{RELEASE}
* Manuals::         Manuals
* Copying::         Free Software
* AboutCygnus::     About Cygnus Support
* Cygnus-FSF::      Cygnus Support and the FSF
* Support::         Your Support Contract
* Info::            Using Online Documentation
* Bugs::            Reporting Trouble
@end menu
@end ifinfo

@node Release
@unnumbered Cygnus Support @value{RELEASE}

This @value{RELEASE} release puts at your disposal, in a single
coordinated and tested release, some of the best software development
tools available.
@ifset cdk
These tools are 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}).
@end ifset

Cygnus Support has ported @sc{gnu} tools to over sixty different
platforms.  As part of our service, we integrate all our tools to ensure
that they all work together.  Our developers use a regression testing
method that checks not only for problems with a single tool, but across
all the tools.  We check for problems that a change in one program may
cause in another.  We don't ship your @value{RELEASE} release until we
know it works.

@ifset cdk
The @value{RELEASE} contains these development tools and utilities:@*
@emph{(Not all tools are available for all platforms and operating
systems.  @xref{Introduction,,Overview,relnotes,Release Notes}, for
specific information on your system.)}

@subheading Compilers and Development Tools
@table @code
@item gcc
C compiler

@item g++
C++ compiler

@item gdb
Debugger

@item as
Assembler

@item gasp
Assembler Preprocessor

@item ld
Linker
@end table

@c ---
@subheading Libraries
@table @code
@item libg++
C++ class library

@item libio
C++ @code{iostreams} library

@item libc
@sc{ansi} C runtime library (@emph{only available for cross-development
toolkits})

@item libm
C mathematical subroutine library (@emph{only available for
cross-development toolkits})
@end table

@c ---
@subheading General Utilities
@table @code
@item byacc
Parser generator

@item flex
Fast lexical analyzer generator

@item make
Compilation control program

@item diff
@itemx diff3
@itemx sdiff
Compare text files

@item patch
Installs source fixes

@item cmp
Compares files byte-by-byte

@item send-pr
Sends structured problem reports to Cygnus

@item install-sid
Customizes @code{send-pr} for your site

@item gprof
Performance analyzer (@emph{only available for Sun 4 systems running
SunOS 4 or Solaris 2})

@item gcov
Coverage analyzer
@end table

@c ---
@subheading Binary Utilities
@table @code
@item c++filt
C++ symbol name deciphering utility

@item nm
Lists object file symbol tables

@item objdump
Displays object file information

@item size
Lists section and total sizes

@item ar
Manages object code archives

@item ranlib
Generates archive index

@item strip
Discards symbols

@item objcopy
Copies and translates object files
@end table

@c ---
@subheading Text Utilities
@table @asis
@item Texinfo (requires @TeX{})
@itemx @code{texindex}
@itemx @code{texi2dvi}
Documentation formatting tools

@item @code{makeinfo}
@itemx @code{info}
Online documentation tools
@end table
@end ifset
@c end cdk

@ifset emacs
Your @value{RELEASE} distribution contains these tools and utilities:

@subheading Emacs 19
Includes @sc{lisp} extensions for @code{mh}, @code{gnus},
@w{@code{ange-ftp}}, and text-editing modes for C, Texinfo, and
@code{nroff}, as well as many other packages and modes.

@subheading General Utilities
@table @code
@item ispell
Multi-language spelling checker.

@item diff
@itemx diff3
@itemx sdiff
Compare text files

@item patch
Installs source fixes

@item cmp
Compares files byte-by-byte

@item send-pr
Sends structured problem reports to Cygnus

@item install-sid
Customizes @code{send-pr} for your site
@end table

@subheading Text Utilities
@table @asis
@item Texinfo (requires @TeX{})
@itemx @code{texindex}
@itemx @code{texi2dvi}
Documentation formatting tools

@item @code{makeinfo}
@itemx @code{info}
Online documentation tools
@end table
@end ifset
@c end emacs

@ifset dejagnu
Your @value{RELEASE} distribution contains these tools and utilities:

@subheading Testing Tools and Framework
@table @asis
@item DejaGnu
Testing tools and framework for DejaGnu, based on Tcl and @code{expect}

@item Tcl
Tool Command Language, by John Ousterhout

@item @code{expect}
Interactive scripting language by Don Libes
@end table

@subheading General Utilities
@table @code
@item diff
@itemx diff3
@itemx sdiff
Compare text files

@item patch
Installs source fixes

@item cmp
Compares files byte-by-byte

@item send-pr
Sends structured problem reports to Cygnus

@item install-sid
Customizes @code{send-pr} for your site
@end table

@subheading Text Utilities
@table @asis
@item Texinfo (requires @TeX{})
@itemx @code{texindex}
@itemx @code{texi2dvi}
Documentation formatting tools

@item @code{makeinfo}
@itemx @code{info}
Online documentation tools
@end table
@end ifset
@c end dejagnu

@node Manuals
@unnumbered Manuals

These manuals may be included in a hardcopy format in this Cygnus
Support Progressive Release, depending on the nature of your support
contract.  @emph{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 @ref{Info,,Using Online Documentation}.

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

@table @emph
@item Cygnus Developer's Kit
@itemize @bullet
@item Introduction
@item Release Notes
@item Install Notes
@item @sc{gnu} General Public License
@end itemize

@item Embedded Systems
@itemize @bullet
@item Embedded Systems Programming
@end itemize

@item Using GNU CC
@itemize @bullet
@item Using @sc{gnu} CC
@end itemize

@item Debugging With GDB
@itemize @bullet
@item Debugging With @sc{gdb}
@end itemize

@item Support Libraries
@itemize @bullet
@item The @sc{gnu} C++ Iostream Library
@item The Cygnus C Support Library
@item The Cygnus C Math Library
@end itemize

@item Binary Utilities
@itemize @bullet
@item The @sc{gnu} C Preprocessor
@item Using @sc{as}, the @sc{gnu} Assembler
@item @sc{gasp}, the @sc{gnu} Assembler Preprocessor
@item Using @sc{ld}, the @sc{gnu} Linker
@item The @sc{gnu} Binary Utilities
@end itemize

@item GNU Make
@itemize @bullet
@item @sc{gnu} Make
@end itemize

@item Developer's Kit Support
@itemize @bullet
@item Reporting Problems Using @code{send-pr}
@item Online Documentation
@item Rebuilding From Source
@item Comparing and Merging Files (@code{diff} and @code{patch})
@end itemize

@end table

@ignore
@tex
\vskip \baselineskip \halign{\it #\hfil&\quad\it #\hfil\cr \bf Volume I
& \bf Volume II \strut\cr \noalign{\hrule} \cr 
Introduction               & The GNU C++ Iostream Library \cr
Installation Notes         & The Cygnus C Support Library \cr
Release Notes              & The Cygnus C Math Library \cr
Rebuilding From Source     & Using as \cr
Reporting Problems         & The C Preprocessor \cr
GNU Online Documentation   & Using ld \cr
Using GNU CC               & The GNU Binary Utilities \cr
Debugging with GDB         & Comparing and Merging Files: diff, \cr
GNU General Public License & \ \ \ \ diff3, sdiff, cmp, and patch \cr
                           & GNU Make: A Program for Directing \cr
                           & \ \ \ \ Recompilation\cr \cr }
@end tex
@end ignore

@c end cdk

@ifset emacs
@table @cite
@item Introduction
@itemx Release Notes   
@itemx Installation Notes
@itemx Online Manuals
@itemx Reporting Problems
@itemx Diff/Patch
@itemx Ispell
@itemx GNU Emacs Manual
@itemx License
@end table
@end ifset
@c end emacs

@ifset dejagnu
@table @cite
@item Introduction
@itemx Installation Notes
@itemx Online Manuals
@itemx Reporting Problems
@itemx Diff/Patch
@itemx The DejaGnu Testing Framwork
@itemx License
@end table
@end ifset
@c end dejagnu

@noindent
Source for all documentation is also included.

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

@table @cite
@ifset cdk
@item FLEX: A Fast Lexical Analyzer Generator
Generates lexical analyzers suitable for @sc{gnu} @sc{gcc} and other
compilers.

@item Using and Porting GNU CC
Detailed information about what's needed to put @code{gcc} on different
platforms, or to modify @code{gcc}.  Also includes all the information
from the printed manual @cite{Using GNU CC}.

@item BYacc
A discussion of the Berkeley Yacc parser generator.

@item User's Guide to the GNU C++ Library
Details about the general-purpose @sc{gnu} C++ library, covered under
the @sc{gnu} Library General Public License.
@end ifset

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

@item Cygnus configure
Details on the configuration program used in Cygnus releases.

@item GNU Coding Standards
A complete discussion of the coding standards used by the @sc{gnu} project.
@end table

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

@table @cite
@item GNU gprof
Details on the @sc{gnu} performance analyzer.
@end table
@end ifset

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

@subheading Conventions

Our manuals use these conventions to help you distinguish commands,
filenames, and other program-specific objects from the descriptive text.
 
@table @asis
@item @code{Typewriter-text}
Indicates text that is a literal example of a piece of a program, such
as environmental variable names like @code{EDITOR}. It will also
indicate keyboard characters you should type, or other literal bits of
text from a program, such as filenames or examples.

@item @key{key-name}
Indicates the conventional name for a special key on a keyboard, such as
@key{RET} or @key{DEL}.

@item @var{generic-name}
Stands for another piece of text. For example, in the command
description ``To delete the file named @var{filename}, type @code{rm
@var{filename}}.''  @var{filename} stands for the file you want to
delete, no matter what you've named it.
@end table 
 
@node Info
@unnumbered Using Online Documentation

You can browse through the online documentation using either @sc{gnu}
Emacs or the documentation browser program @code{info} included in the
@value{RELEASE} distribution.  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 ``@dfn{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 this @value{RELEASE} 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
 
(You may need to check that @code{info} is in your shell path after you
install the @value{RELEASE} release. If you have problems running
@code{info}, please contact your systems administrator.)

To learn how to use @code{info}, type the command @samp{h} for a
programmed instruction sequence, or @kbd{@key{CTL}-h} for a short
summary of commands.  If at any time you are ready to stop using
@code{info}, type @samp{q}.

@xref{Top,,The Info Program, info, GNU Online Documentation}, for
detailed discussion of the @code{info} program.

@ifset cdk
@subheading Cygnus Support Online Library

All of the manuals in our printed documentation set
(@pxref{Manuals,,Manuals}) are also available via the Cygnus Support
Information Gallery, our World-Wide Web server, available at

@smallexample
http://www.cygnus.com/
@end smallexample

Contact Cygnus Support for information on connecting via the World-Wide
Web.

As with all @sc{gnu} software, the @sc{html} source for our documents is
available (or you can convert them yourself using publicly available
utilities) if you wish to put them into an internal Web server for use
at your facility.  Contact Cygnus Support for details, and please report
any problems to the Cygnus documentation department at
@code{doc@@cygnus.com}.

@table @emph
@item Free Software Report
The Free Software Report is a Cygnus publication dedicated to the
business of supporting free software.

@table @asis
@item Volume 1, Number 1: @emph{``Free Software? Yes, Free Software''} 
@item Volume 2, Number 1: @emph{``Free Software And The Law''}
@item Volume 2, Number 2: @emph{``Free Software Business Models''}
@item Volume 2, Number 3: @emph{``Free Software: An Agent For Open Systems''}
@item Volume 3, Number 1: @emph{``Testing, Testing, 1-2-3''}
@end table

@item Inside Cygnus Engineering
@emph{Inside Cygnus Engineering} is a newsletter describing recent and
upcoming activities in the Cygnus Support engineering division. We now
have a complete archive of previous issues of @emph{Inside Cygnus
Engineering}.

@item Technical Reports
Cygnus Support technical reports, written by Cygnus engineers.

@table @emph
@item Security Issues in Embedded Networking
@item Simple Garbage Collection in G++
@item The GNU Instruction Scheduler
@item Runtime Type Support in C and C++
@end table
@end table
@end ifset
@c end cdk

@node Support
@unnumbered Your Support Contract

@sc{gnu} development tools provide a powerful, integrated applications
development environment. Cygnus Support is one of the primary develpment
centers for @sc{gnu} tools; your support contract links you directly
with the developers.  With this release, Cygnus Support has provided the
latest fully-tested release of the @sc{gnu} tools, preconfigured for
your supported system.

@subheading Updates to your progressive release
 
@ifset cdk
Every quarter
@end ifset
@ifclear cdk
Periodically
@end ifclear
during the period of your support contract, Cygnus Support
provides an updated toolchain, complete with the latest enhancements and
improvements.  The updates also include bug fixes and updated
documentation. Most customers receive these updates automatically; if
you wish to get automatic updating, please call our support hotline at
@w{+1 415 903 1401}.

You also receive a monthly newsletter, @cite{Inside Cygnus Engineering,}
which keeps you informed about release dates, improvements, new
supported platforms, and new products.  We often request information
about your needs via surveys in this newsletter.
 
@subheading Contacting Cygnus Support
 
You can reach Cygnus Support by email, phone, or fax.  To submit problem
reports, 
 
@ifinfo
@smallexample
Cygnus Support
toll free: +1 800 CYGNUS-1
main line: +1 415 903 1400
hotline:   +1 415 903 1401
email:   support@@cygnus.com

HEADQUARTERS                                    EAST COAST
1937 Landings Drive                 48 Grove St., Ste. 105
Mountain View, CA 94043 USA       Somerville, MA 02144 USA
+1 415 903 1400                            +1 617 629 3000
+1 415 903 0122 fax                    fax +1 617 629 3010
@end smallexample
@end ifinfo

@sp 1

@tex
\halign{\rm #\hfill&\rm\qquad\qquad\hfill #\cr
\bf Cygnus Support\cr
toll free: $+$1 800 CYGNUS-1\cr
main line: $+$1 415 903 1400\cr
hotline: $+$1 415 903 1401\cr
email: @code{support@@cygnus.com}\cr
\cr
\it Headquarters              &\it East Coast\cr
1937 Landings Drive           &        48 Grove St., Ste. 105\cr
Mountain View, CA 94043 USA   &        Somerville, MA 02144 USA\cr
\cr
$+$1 415 903 1400               &            $+$1 617 629 3000\cr
$+$1 415 903 0122 fax           &        fax $+$1 617 629 3010\cr}
@end tex
 
Faxes are answered 8 am--5pm, Monday through Friday.
 
@subheading Future Needs
 
The availability of source code enables anyone to enhance the @sc{gnu}
tools.  While Cygnus is doing the greatest amount of ongoing
development, many other users around the world are also contributing
enhancements and improvments.  Cygnus integration and regression testing
ensures that enhancements made elsewhere can work with Cygnus'
developments.  As your needs evolve, so do the capabilities of the
@sc{gnu} tools and the support services available from Cygnus Support.

@node Bugs
@unnumbered Reporting Trouble

We've tried to make the programs in this release of the Cygnus Support
@value{RELEASE} as trouble-free as possible.  If you do encounter
problems, however, we'd like to diagnose and fix the problem as quickly
as possible.  You can help us do that by using the script @code{send-pr}
to send us your problem reports (@sc{pr}s). @code{send-pr} comes with
this release, and is easily configured to send reports back to Cygnus.

@code{send-pr} invokes an editor on a problem report form (after trying
to fill in some fields with reasonable default values).  After you exit
the editor, @code{send-pr} sends the filled out form to the Problem
Report Management System (@sc{prms}) at Cygnus Support.  You can use the
environment variable @code{EDITOR} to specify which editor to use (the
default is @code{vi}). Emacs users will find @sc{prms} especially easy
to use.

For more information on @code{send-pr}, see @ref{Top, , Overview,
send-pr, Reporting Problems}.

@subheading Filling out a problem report

Problem reports are structured so that a database program can manage
them. When you fill out the form, please remember the following
guidelines:

@itemize @bullet
@item
Each @sc{pr} needs a valid @dfn{customer-id} and @dfn{category}.

@item
Describe only one problem per @sc{pr}.

@item
For follow-up mail, use the same subject line as the one in the
automatic acknowledgment. It shows the category, the @sc{pr} number and
the original synopsis line.  This causes your mail to automatically be
filed with the original bug report. Your followup comments will be sent
to all the people who are working on the bug.

@item 
Please try to make the subject or synopsis line as informative as
possible.  For misbehaving software, you might use a sentence of the
form @samp{Encrypted rlogin hangs if you send interrupt} or @samp{g++:
calling wrong overloaded function.}

@item
You don't need to delete the comment lines while editing the @sc{pr}
form; this is done by @code{send-pr}.  Put your information before or
after the comments.
@end itemize

Consult the @ref{Helpful Hints,,Examples and guidelines for effective
PRs,send-pr,Reporting Problems}, for more discussion on this topic.

@node Copying
@unnumbered Free Software

If you find our @value{RELEASE} distribution useful, please feel free to
give or sell copies of the software and documentation to anyone you
like.

In this release, we've assembled the most current editions of these
software development tools, tested them, made sure they work well
together, and made them easy to install. The installation tape comes
with binaries already compiled for your system, and we've made them easy
to reconfigure and recompile from source.

These tools are free software; they are part of the @sc{gnu} project,
produced by the Free Software Foundation (@sc{fsf}).  ``@sc{gnu}'' is
the name of the @sc{fsf}'s evolving operating system (in speech, the
`@sc{g}' is sounded).  Cygnus Support collaborates with the @sc{fsf} in
developing these tools. (For more information on the relationship
between Cygnus Support and the @sc{fsf}, please see
@ref{Cygnus-FSF,,Cygnus Support and the FSF}.)

Cygnus Support exists to help our clients exploit their freedom in
using, adapting, or enhancing this software.  Cygnus products are
@dfn{free software}, protected by the @sc{gnu} General Public License
(@dfn{@sc{gpl}}).  The @sc{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 have
access to the source code), and the freedom to distribute further
copies.  Traditional software companies use copyrights to limit your
freedoms; the @sc{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,
or the file @file{COPYING} in the top level of the source code
distribution.

@node AboutCygnus
@unnumbered About Cygnus Support

Cygnus Support, founded in 1989, provides commercial support for free
software.  @emph{Why free software?} Free software is fast, powerful,
and more portable than its proprietary counterparts.  It evolves faster
because users who want to make improvements are free to do so.

Cygnus Support has become the leading development organization of the
@sc{gnu} tools, contributing more than 50% of ongoing development. In
addition to in-house development, Cygnus leverages the increasing
cumulative pool of functionality available as public domain software on
the Internet, creating a virtual community of developers. Building upon
and contributing to this effort, Cygnus raises the level of
functionality available to the entire industry.

The problem with free software has always been that your company's
programmers and engineers must spend time maintaining the tools as
well as using them, which ties up company resources. Cygnus frees up
those resources by supplying products and services, which allows you to
use state-of-the-art tools without the problems of maintenance. You can
now choose to use free software and get the advantages of powerful and
prompt support, combining the best of both.

Our team of experienced engineers include the leading architects for
@sc{g++, gdb, gas,} and @sc{bfd.} We use one of the most comprehensive
bug-reporting and tracking software in the business, @sc{prms}.

Because all our improvements are also free software, you can distribute
them widely within your organization, or to your customers, without
extra cost. No unwieldy licenses to manage, and no worries about buying
extra copies.

Cygnus makes sure that our customers' problems get solved the right way.
No grungy little programs, no klugey fixes that don't generalize, no
work-arounds that end up being features instead of temporary situations.

@ifinfo
@smallexample
Cygnus Support
toll free: +1 800 CYGNUS-1
main line: +1 415 903 1400
hotline:   +1 415 903 1401
email:   support@@cygnus.com

HEADQUARTERS                                    EAST COAST
1937 Landings Drive                 48 Grove St., Ste. 105
Mountain View, CA 94043 USA       Somerville, MA 02144 USA
+1 415 903 1400                            +1 617 629 3000
+1 415 903 0122 fax                    fax +1 617 629 3010
@end smallexample
@end ifinfo

@tex
\halign{\rm #\hfill&\rm\qquad\qquad\hfill #\cr
\bf Cygnus Support\cr
toll free: $+$1 800 CYGNUS-1\cr
main line: $+$1 415 903 1400\cr
hotline: $+$1 415 903 1401\cr
email: @code{support@@cygnus.com}\cr
\cr
\it Headquarters              &\it East Coast\cr
1937 Landings Drive           &        48 Grove St., Ste. 105\cr
Mountain View, CA 94043 USA   &        Somerville, MA 02144 USA\cr
\cr
$+$1 415 903 1400               &            $+$1 617 629 3000\cr
$+$1 415 903 0122 fax           &        fax $+$1 617 629 3010\cr}
@end tex

@node Cygnus-FSF
@unnumbered Cygnus Support and the FSF

Cygnus Support and the Free Software Foundation cooperate on major
projects, such as the port of the @sc{gnu} development tools to Solaris
2.  We look forward to continuing such cooperation in the future.

Cygnus maintains many programs and libraries @emph{for} the @sc{fsf}:
@sc{g++}, @sc{gdb}, @sc{gas}, the linker, @sc{gprof}, the binary
utilities, @sc{libg++}, and the Binary File Descriptor libraries.  In
addition, Cygnus and the @sc{fsf} share sources for other programs on a
regular basis.

Both Cygnus and the @sc{fsf} agree that free software is the best way to
meet the industry's technical needs.  However, Cygnus and the @sc{fsf}
have different missions.  Cygnus, as a for-profit company, concentrates
on meeting its customers' needs.  The @sc{fsf} concentrates on meeting
the internal needs of the @sc{gnu} project.

Therefore, Cygnus may not accept into our source tree certain @sc{fsf}
changes until they are reworked into a form acceptable for our
customers' needs---for example, changes that reduce performance or
reliability on the software platforms we support.  Conversely, the
@sc{fsf} may not accept changes from Cygnus that improve support for
only a limited group of users (Cygnus customers).

Also, Cygnus sometimes supports non-@sc{fsf} code.  Our C subroutine
library is an example.  The @sc{fsf}'s version carries licensing
restrictions which are impractical for customers who write code for
embedded systems; as a result, we developed our own subroutine library,
@sc{libc}.  The Cygnus C subroutine library, although also freely
redistributable, does not carry the licensing restrictions that would
inconvenience these customers.

Finally, although the @sc{fsf} makes every effort to provide
high-quality releases, its development requirements take priority.  The
@sc{fsf} regards software testing as the user community's contribution
to the @sc{gnu} project.  Cygnus releases go through a quality assurance
cycle which is in large part driven by our knowledge of customer
requirements.

@bye