« back to all changes in this revision
Viewing changes to doc/hello.info
- browse files at revision 3
- compare with another revision
- download diff
- download tarball
- view history from revision 3
- Committer: Bazaar Package Importer
- Author(s): Santiago Vila
- Date: 2004-01-05 16:42:30 UTC
- mfrom: (1.1.1 upstream)
- Revision ID: james.westby@ubuntu.com-20040105164230-ze0yqbimyx4sx1gs
Tags: 2.1.1-4
Updated config.guess and config.sub for GNU/K*BSD.
added
removed
doc/hello.info
1
Dies ist hello.info, hergestellt von Makeinfo Version 4.2 aus
2
hello.texi.
3
4
This file documents the GNU `hello' command for printing a greeting
5
message.
6
7
Copyright (C) 1992, 1993, 1996, 2002 Free Software Foundation, Inc.
8
9
Permission is granted to make and distribute verbatim copies of this
10
manual provided the copyright notice and this permission notice are
11
preserved on all copies.
12
13
Permission is granted to copy and distribute modified versions of
14
this manual under the conditions for verbatim copying, provided that
15
the entire resulting derived work is distributed under the terms of a
16
permission notice identical to this one.
17
18
Permission is granted to copy and distribute translations of this
19
manual into another language, under the above conditions for modified
20
versions, except that this permission notice may be stated in a
21
translation approved by the Foundation.
22
INFO-DIR-SECTION Greeting Printing Program
23
INFO-DIR-SECTION Mail Reader
24
INFO-DIR-SECTION Programming
25
START-INFO-DIR-ENTRY
26
* Hello, world!: (hello). GNU `Hello, world'.
27
END-INFO-DIR-ENTRY
28
29
30
File: hello.info, Node: Top, Up: (dir)
31
32
This file documents the the GNU `hello' command to print a greeting
33
message.
34
35
* Menu:
36
37
* Instructions:: How to read this manual.
38
* Copying:: How you can copy and share `hello'.
39
* Overview:: Preliminary information.
40
* Sample:: Sample output from `hello'.
41
* Invoking hello:: How to run `hello'.
42
* Problems:: Reporting bugs.
43
* Concept Index:: Index of concepts.
44
45
46
File: hello.info, Node: Instructions, Next: Copying, Up: Top
47
48
How to Read This Manual
49
***********************
50
51
To read this manual, begin at the beginning, reading from left to
52
right and top to bottom, until you get to the end. Then stop. You may
53
pause for a beer anywhere in the middle as well, if you wish. (Please
54
note, however, that The King strongly advises against heavy use of
55
prescription pharmaceuticals, based on his extensive personal and
56
professional experience.)
57
58
59
File: hello.info, Node: Copying, Next: Overview, Prev: Instructions, Up: Top
60
61
GNU GENERAL PUBLIC LICENSE
62
**************************
63
64
Version 2, June 1991
65
Copyright (C) 1989, 1991 Free Software Foundation, Inc.
66
59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
67
68
Everyone is permitted to copy and distribute verbatim copies
69
of this license document, but changing it is not allowed.
70
71
Preamble
72
========
73
74
The licenses for most software are designed to take away your
75
freedom to share and change it. By contrast, the GNU General Public
76
License is intended to guarantee your freedom to share and change free
77
software--to make sure the software is free for all its users. This
78
General Public License applies to most of the Free Software
79
Foundation's software and to any other program whose authors commit to
80
using it. (Some other Free Software Foundation software is covered by
81
the GNU Library General Public License instead.) You can apply it to
82
your programs, too.
83
84
When we speak of free software, we are referring to freedom, not
85
price. Our General Public Licenses are designed to make sure that you
86
have the freedom to distribute copies of free software (and charge for
87
this service if you wish), that you receive source code or can get it
88
if you want it, that you can change the software or use pieces of it in
89
new free programs; and that you know you can do these things.
90
91
To protect your rights, we need to make restrictions that forbid
92
anyone to deny you these rights or to ask you to surrender the rights.
93
These restrictions translate to certain responsibilities for you if you
94
distribute copies of the software, or if you modify it.
95
96
For example, if you distribute copies of such a program, whether
97
gratis or for a fee, you must give the recipients all the rights that
98
you have. You must make sure that they, too, receive or can get the
99
source code. And you must show them these terms so they know their
100
rights.
101
102
We protect your rights with two steps: (1) copyright the software,
103
and (2) offer you this license which gives you legal permission to copy,
104
distribute and/or modify the software.
105
106
Also, for each author's protection and ours, we want to make certain
107
that everyone understands that there is no warranty for this free
108
software. If the software is modified by someone else and passed on, we
109
want its recipients to know that what they have is not the original, so
110
that any problems introduced by others will not reflect on the original
111
authors' reputations.
112
113
Finally, any free program is threatened constantly by software
114
patents. We wish to avoid the danger that redistributors of a free
115
program will individually obtain patent licenses, in effect making the
116
program proprietary. To prevent this, we have made it clear that any
117
patent must be licensed for everyone's free use or not licensed at all.
118
119
The precise terms and conditions for copying, distribution and
120
modification follow.
121
122
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
123
0. This License applies to any program or other work which contains a
124
notice placed by the copyright holder saying it may be distributed
125
under the terms of this General Public License. The "Program,"
126
below, refers to any such program or work, and a "work based on
127
the Program" means either the Program or any derivative work under
128
copyright law: that is to say, a work containing the Program or a
129
portion of it, either verbatim or with modifications and/or
130
translated into another language. (Hereinafter, translation is
131
included without limitation in the term "modification.") Each
132
licensee is addressed as "you."
133
134
Activities other than copying, distribution and modification are
135
not covered by this License; they are outside its scope. The act
136
of running the Program is not restricted, and the output from the
137
Program is covered only if its contents constitute a work based on
138
the Program (independent of having been made by running the
139
Program). Whether that is true depends on what the Program does.
140
141
1. You may copy and distribute verbatim copies of the Program's
142
source code as you receive it, in any medium, provided that you
143
conspicuously and appropriately publish on each copy an appropriate
144
copyright notice and disclaimer of warranty; keep intact all the
145
notices that refer to this License and to the absence of any
146
warranty; and give any other recipients of the Program a copy of
147
this License along with the Program.
148
149
You may charge a fee for the physical act of transferring a copy,
150
and you may at your option offer warranty protection in exchange
151
for a fee.
152
153
2. You may modify your copy or copies of the Program or any portion
154
of it, thus forming a work based on the Program, and copy and
155
distribute such modifications or work under the terms of Section 1
156
above, provided that you also meet all of these conditions:
157
158
a. You must cause the modified files to carry prominent notices
159
stating that you changed the files and the date of any change.
160
161
b. You must cause any work that you distribute or publish, that
162
in whole or in part contains or is derived from the Program
163
or any part thereof, to be licensed as a whole at no charge
164
to all third parties under the terms of this License.
165
166
c. If the modified program normally reads commands interactively
167
when run, you must cause it, when started running for such
168
interactive use in the most ordinary way, to print or display
169
an announcement including an appropriate copyright notice and
170
a notice that there is no warranty (or else, saying that you
171
provide a warranty) and that users may redistribute the
172
program under these conditions, and telling the user how to
173
view a copy of this License. (Exception: if the Program
174
itself is interactive but does not normally print such an
175
announcement, your work based on the Program is not required
176
to print an announcement.)
177
178
These requirements apply to the modified work as a whole. If
179
identifiable sections of that work are not derived from the
180
Program, and can be reasonably considered independent and separate
181
works in themselves, then this License, and its terms, do not
182
apply to those sections when you distribute them as separate
183
works. But when you distribute the same sections as part of a
184
whole which is a work based on the Program, the distribution of
185
the whole must be on the terms of this License, whose permissions
186
for other licensees extend to the entire whole, and thus to each
187
and every part regardless of who wrote it.
188
189
Thus, it is not the intent of this section to claim rights or
190
contest your rights to work written entirely by you; rather, the
191
intent is to exercise the right to control the distribution of
192
derivative or collective works based on the Program.
193
194
In addition, mere aggregation of another work not based on the
195
Program with the Program (or with a work based on the Program) on
196
a volume of a storage or distribution medium does not bring the
197
other work under the scope of this License.
198
199
3. You may copy and distribute the Program (or a work based on it,
200
under Section 2) in object code or executable form under the terms
201
of Sections 1 and 2 above provided that you also do one of the
202
following:
203
204
a. Accompany it with the complete corresponding machine-readable
205
source code, which must be distributed under the terms of
206
Sections 1 and 2 above on a medium customarily used for
207
software interchange; or,
208
209
b. Accompany it with a written offer, valid for at least three
210
years, to give any third party, for a charge no more than your
211
cost of physically performing source distribution, a complete
212
machine-readable copy of the corresponding source code, to be
213
distributed under the terms of Sections 1 and 2 above on a
214
medium customarily used for software interchange; or,
215
216
c. Accompany it with the information you received as to the offer
217
to distribute corresponding source code. (This alternative is
218
allowed only for noncommercial distribution and only if you
219
received the program in object code or executable form with
220
such an offer, in accord with Subsection b above.)
221
222
The source code for a work means the preferred form of the work for
223
making modifications to it. For an executable work, complete
224
source code means all the source code for all modules it contains,
225
plus any associated interface definition files, plus the scripts
226
used to control compilation and installation of the executable.
227
However, as a special exception, the source code distributed need
228
not include anything that is normally distributed (in either
229
source or binary form) with the major components (compiler,
230
kernel, and so on) of the operating system on which the executable
231
runs, unless that component itself accompanies the executable.
232
233
If distribution of executable or object code is made by offering
234
access to copy from a designated place, then offering equivalent
235
access to copy the source code from the same place counts as
236
distribution of the source code, even though third parties are not
237
compelled to copy the source along with the object code.
238
239
4. You may not copy, modify, sublicense, or distribute the Program
240
except as expressly provided under this License. Any attempt
241
otherwise to copy, modify, sublicense or distribute the Program is
242
void, and will automatically terminate your rights under this
243
License. However, parties who have received copies, or rights,
244
from you under this License will not have their licenses
245
terminated so long as such parties remain in full compliance.
246
247
5. You are not required to accept this License, since you have not
248
signed it. However, nothing else grants you permission to modify
249
or distribute the Program or its derivative works. These actions
250
are prohibited by law if you do not accept this License.
251
Therefore, by modifying or distributing the Program (or any work
252
based on the Program), you indicate your acceptance of this
253
License to do so, and all its terms and conditions for copying,
254
distributing or modifying the Program or works based on it.
255
256
6. Each time you redistribute the Program (or any work based on the
257
Program), the recipient automatically receives a license from the
258
original licensor to copy, distribute or modify the Program
259
subject to these terms and conditions. You may not impose any
260
further restrictions on the recipients' exercise of the rights
261
granted herein. You are not responsible for enforcing compliance
262
by third parties to this License.
263
264
7. If, as a consequence of a court judgment or allegation of patent
265
infringement or for any other reason (not limited to patent
266
issues), conditions are imposed on you (whether by court order,
267
agreement or otherwise) that contradict the conditions of this
268
License, they do not excuse you from the conditions of this
269
License. If you cannot distribute so as to satisfy simultaneously
270
your obligations under this License and any other pertinent
271
obligations, then as a consequence you may not distribute the
272
Program at all. For example, if a patent license would not permit
273
royalty-free redistribution of the Program by all those who
274
receive copies directly or indirectly through you, then the only
275
way you could satisfy both it and this License would be to refrain
276
entirely from distribution of the Program.
277
278
If any portion of this section is held invalid or unenforceable
279
under any particular circumstance, the balance of the section is
280
intended to apply and the section as a whole is intended to apply
281
in other circumstances.
282
283
It is not the purpose of this section to induce you to infringe any
284
patents or other property right claims or to contest validity of
285
any such claims; this section has the sole purpose of protecting
286
the integrity of the free software distribution system, which is
287
implemented by public license practices. Many people have made
288
generous contributions to the wide range of software distributed
289
through that system in reliance on consistent application of that
290
system; it is up to the author/donor to decide if he or she is
291
willing to distribute software through any other system and a
292
licensee cannot impose that choice.
293
294
This section is intended to make thoroughly clear what is believed
295
to be a consequence of the rest of this License.
296
297
8. If the distribution and/or use of the Program is restricted in
298
certain countries either by patents or by copyrighted interfaces,
299
the original copyright holder who places the Program under this
300
License may add an explicit geographical distribution limitation
301
excluding those countries, so that distribution is permitted only
302
in or among countries not thus excluded. In such case, this
303
License incorporates the limitation as if written in the body of
304
this License.
305
306
9. The Free Software Foundation may publish revised and/or new
307
versions of the General Public License from time to time. Such
308
new versions will be similar in spirit to the present version, but
309
may differ in detail to address new problems or concerns.
310
311
Each version is given a distinguishing version number. If the
312
Program specifies a version number of this License which applies
313
to it and "any later version," you have the option of following
314
the terms and conditions either of that version or of any later
315
version published by the Free Software Foundation. If the Program
316
does not specify a version number of this License, you may choose
317
any version ever published by the Free Software Foundation.
318
319
10. If you wish to incorporate parts of the Program into other free
320
programs whose distribution conditions are different, write to the
321
author to ask for permission. For software which is copyrighted
322
by the Free Software Foundation, write to the Free Software
323
Foundation; we sometimes make exceptions for this. Our decision
324
will be guided by the two goals of preserving the free status of
325
all derivatives of our free software and of promoting the sharing
326
and reuse of software generally.
327
328
NO WARRANTY
329
330
11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO
331
WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE
332
LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
333
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT
334
WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT
335
NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
336
FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE
337
QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
338
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
339
SERVICING, REPAIR OR CORRECTION.
340
341
12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
342
WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY
343
MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE
344
LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
345
INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR
346
INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
347
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU
348
OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY
349
OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN
350
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
351
352
END OF TERMS AND CONDITIONS
353
354
How to Apply These Terms to Your New Programs
355
=============================================
356
357
If you develop a new program, and you want it to be of the greatest
358
possible use to the public, the best way to achieve this is to make it
359
free software which everyone can redistribute and change under these
360
terms.
361
362
To do so, attach the following notices to the program. It is safest
363
to attach them to the start of each source file to most effectively
364
convey the exclusion of warranty; and each file should have at least
365
the "copyright" line and a pointer to where the full notice is found.
366
367
ONE LINE TO GIVE THE PROGRAM'S NAME AND AN IDEA OF WHAT IT DOES.
368
Copyright (C) 19YY NAME OF AUTHOR
369
370
This program is free software; you can redistribute it and/or
371
modify it under the terms of the GNU General Public License
372
as published by the Free Software Foundation; either version 2
373
of the License, or (at your option) any later version.
374
375
This program is distributed in the hope that it will be useful,
376
but WITHOUT ANY WARRANTY; without even the implied warranty of
377
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
378
GNU General Public License for more details.
379
380
You should have received a copy of the GNU General Public License along
381
with this program; if not, write to the Free Software Foundation, Inc.,
382
59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
383
384
Also add information on how to contact you by electronic and paper
385
mail.
386
387
If the program is interactive, make it output a short notice like
388
this when it starts in an interactive mode:
389
390
Gnomovision version 69, Copyright (C) 20YY NAME OF AUTHOR
391
Gnomovision comes with ABSOLUTELY NO WARRANTY; for details
392
type `show w'. This is free software, and you are welcome
393
to redistribute it under certain conditions; type `show c'
394
for details.
395
396
The hypothetical commands `show w' and `show c' should show the
397
appropriate parts of the General Public License. Of course, the
398
commands you use may be called something other than `show w' and `show
399
c'; they could even be mouse-clicks or menu items--whatever suits your
400
program.
401
402
You should also get your employer (if you work as a programmer) or
403
your school, if any, to sign a "copyright disclaimer" for the program,
404
if necessary. Here is a sample; alter the names:
405
406
Yoyodyne, Inc., hereby disclaims all copyright
407
interest in the program `Gnomovision'
408
(which makes passes at compilers) written
409
by James Hacker.
410
411
SIGNATURE OF TY COON, 1 April 1989
412
Ty Coon, President of Vice
413
414
This General Public License does not permit incorporating your
415
program into proprietary programs. If your program is a subroutine
416
library, you may consider it more useful to permit linking proprietary
417
applications with the library. If this is what you want to do, use the
418
GNU Library General Public License instead of this License.
419
420
421
File: hello.info, Node: Overview, Next: Sample, Prev: Copying, Up: Top
422
423
Overview
424
********
425
426
The GNU `hello' program produces a familiar, friendly greeting. It
427
allows nonprogrammers to use a classic computer science tool which
428
would otherwise be unavailable to them. Because it is protected by the
429
GNU General Public License, users are free to share and change it.
430
431
GNU `hello' was written by Mike Haertel, David MacKenzie, Jan
432
Brittenson, Charles Hannum, Roland McGrath, Noah Friedman, Karl
433
Eichwalder, and The King.
434
435
436
File: hello.info, Node: Sample, Next: Invoking hello, Prev: Overview, Up: Top
437
438
Sample Output
439
*************
440
441
Here are some realistic examples of running GNU `hello'.
442
443
This is the output of the command `hello':
444
445
Hello, world!
446
447
This is the output of the command `hello --help':
448
449
This is GNU Hello, THE greeting printing program.
450
Usage: hello [OPTION]
451
-h, --help display this help and exit
452
-v, --version display version information and exit
453
-t, --traditional use traditional greeting format
454
-m, --mail print your mail
455
456
Report bugs to bug-gnu-hello@gnu.org.
457
458
This is the output of the command `hello --traditional':
459
460
hello, world
461
462
463
File: hello.info, Node: Invoking hello, Next: Problems, Prev: Sample, Up: Top
464
465
Invoking `hello'
466
****************
467
468
The format for running the `hello' program is:
469
470
hello OPTION ...
471
472
`hello' supports the following options:
473
474
`--help'
475
`-h'
476
Print an informative help message describing the options and then
477
exit.
478
479
`--version'
480
`-v'
481
Print the version number of `hello' on the standard error output
482
and then exit.
483
484
`--traditional'
485
`-t'
486
Use the traditional greeting message `hello, world' rather than
487
the more modern `Hello, world!'.
488
489
`--mail'
490
`-m'
491
Print your mail on the standard output.
492
493
494
File: hello.info, Node: Problems, Next: Concept Index, Prev: Invoking hello, Up: Top
495
496
Reporting Bugs
497
**************
498
499
If you find a bug in GNU `hello', please send electronic mail to
500
<bug-gnu-hello@gnu.org>. Include the version number, which you can
501
find by running `hello --version'. Also include in your message the
502
output that the program produced and the output you expected.
503
504
If you have other questions, comments or suggestions about GNU
505
`hello', contact The King via electronic mail to
506
<elvis@graceland.gnu.ai.mit.edu>. The King will try to help you out,
507
although he may not have time to fix your problems.
508
509
510
File: hello.info, Node: Concept Index, Prev: Problems, Up: Top
511
512
Concept Index
513
*************
514
515
* Menu:
516
517
* bugs: Problems.
518
* creature, feeping: Invoking hello.
519
* creeping feature: Invoking hello.
520
* feature, creeping: Invoking hello.
521
* feeping creature: Invoking hello.
522
* getting help: Invoking hello.
523
* greetings: Overview.
524
* help: Invoking hello.
525
* how to read: Instructions.
526
* invoking: Invoking hello.
527
* mail: Invoking hello.
528
* manual, how to read: Instructions.
529
* modern: Invoking hello.
530
* options: Invoking hello.
531
* overview: Overview.
532
* problems: Problems.
533
* reading: Instructions.
534
* sample: Sample.
535
* tail recursion: Concept Index.
536
* traditional: Invoking hello.
537
* usage: Invoking hello.
538
* version: Invoking hello.
539
540
541
542
Tag Table:
543
Node: Top1078
544
Node: Instructions1489
545
Node: Copying1977
546
Node: Overview21169
547
Node: Sample21700
548
Node: Invoking hello22428
549
Node: Problems23060
550
Node: Concept Index23689
551
552
End Tag Table
Loggerhead is a web-based interface for Breezy
Version: 2.0.1