1
\input texinfo @c -*-texinfo-*-
3
@setfilename hello.info
4
@settitle Printing a Greeting
12
This file documents the GNU @code{hello} command for printing a
15
Copyright (C) 1992, 1993, 1996, 2002 Free Software Foundation, Inc.
17
Permission is granted to make and distribute verbatim copies of
18
this manual provided the copyright notice and this permission notice
19
are preserved on all copies.
22
Permission is granted to process this file through TeX and print the
23
results, provided the printed document carries copying permission
24
notice identical to this one except for the removal of this paragraph
25
(this paragraph not being relevant to the printed manual).
28
Permission is granted to copy and distribute modified versions of this
29
manual under the conditions for verbatim copying, provided that the entire
30
resulting derived work is distributed under the terms of a permission
31
notice identical to this one.
33
Permission is granted to copy and distribute translations of this manual
34
into another language, under the above conditions for modified versions,
35
except that this permission notice may be stated in a translation approved
41
@dircategory Greeting Printing Program
42
@dircategory Mail Reader
43
@dircategory Programming
46
* Hello, world!: (hello). GNU `Hello, world'.
50
@c INFO-DIR-CATEGORY Greeting Program
51
@c INFO-DIR-CATEGORY Mail Reader
52
@c INFO-DIR-CATEGORY Programming
54
@c START-INFO-DIR-ENTRY
55
@c * Hello, world!: (hello). GNU `Hello, world'.
62
@subtitle The Greeting Printing Program
63
@subtitle Edition @value{EDITION}, for Hello Version @value{VERSION}
64
@subtitle @value{UPDATED}
65
@author by David MacKenzie and the GNU Hello Development Team
68
@vskip 0pt plus 1filll
76
This file documents the the GNU @code{hello} command to print a
81
* Instructions:: How to read this manual.
82
* Copying:: How you can copy and share @code{hello}.
83
* Overview:: Preliminary information.
84
* Sample:: Sample output from @code{hello}.
85
* Invoking hello:: How to run @code{hello}.
86
* Problems:: Reporting bugs.
87
* Concept Index:: Index of concepts.
90
@node Instructions, Copying, , Top
91
@chapter How to Read This Manual
94
@cindex manual, how to read
96
To read this manual, begin at the beginning, reading from left to right
97
and top to bottom, until you get to the end. Then stop. You may pause
98
for a beer anywhere in the middle as well, if you wish. (Please note,
99
however, that The King strongly advises against heavy use of
100
prescription pharmaceuticals, based on his extensive personal and
101
professional experience.)
103
@node Copying, Overview, Instructions, Top
106
@node Overview, Sample, Copying, Top
111
The GNU @code{hello} program produces a familiar, friendly greeting.
112
It allows nonprogrammers to use a classic computer science tool which
113
would otherwise be unavailable to them. Because it is protected by the
114
GNU General Public License, users are free to share and change it.
116
GNU @code{hello} was written by Mike Haertel, David MacKenzie, Jan
117
Brittenson, Charles Hannum, Roland McGrath, Noah Friedman, Karl
118
Eichwalder, and @w{The King}.
120
@node Sample, Invoking hello, Overview, Top
121
@chapter Sample Output
124
Here are some realistic examples of running GNU @code{hello}.
126
This is the output of the command @samp{hello}:
132
This is the output of the command @samp{hello --help}:
135
This is GNU Hello, THE greeting printing program.
136
Usage: hello [OPTION]
137
-h, --help display this help and exit
138
-v, --version display version information and exit
139
-t, --traditional use traditional greeting format
140
-m, --mail print your mail
142
Report bugs to bug-gnu-hello@@gnu.org.
145
This is the output of the command @samp{hello --traditional}:
151
@node Invoking hello, Problems, Sample, Top
152
@chapter Invoking @code{hello}
160
The format for running the @code{hello} program is:
163
hello @var{option} @dots{}
166
@code{hello} supports the following options:
171
Print an informative help message describing the options and then exit.
175
Print the version number of @code{hello} on the standard error output
182
Use the traditional greeting message @samp{hello, world} rather
183
than the more modern @samp{Hello, world!}.
188
@cindex creeping feature
189
@cindex feature, creeping
190
@cindex feeping creature
191
@cindex creature, feeping
192
Print your mail on the standard output.
195
@node Problems, Concept Index, Invoking hello, Top
196
@chapter Reporting Bugs
200
If you find a bug in GNU @code{hello}, please send electronic mail
201
to @email{bug-gnu-hello@@gnu.org}. Include the version
202
number, which you can find by running @w{@samp{hello --version}}. Also
203
include in your message the output that the program produced and the
204
output you expected.@refill
206
If you have other questions, comments or suggestions about GNU
207
@code{hello}, contact @w{The King} via electronic mail to
208
@email{elvis@@graceland.gnu.ai.mit.edu}. @w{The King} will try to help
209
you out, although he may not have time to fix your problems.
211
@node Concept Index, , Problems, Top
212
@unnumbered Concept Index
214
@cindex tail recursion
221
@c hello.texi ends here