The following sections describe the conventions used in this handbook.
We introduce each main concept, then break it down into task-oriented sections. Each section shows the best command to use for a task, explains what it does, and the syntax (the way to put the command line together). The syntax is given like this:
Commands appear in boldface type (in this example, rm). You should type the command exactly as it appears in the example. The variable parts (here, filename) will appear in italic type; you must supply your own value. To enter this command, you would type rm followed by a space and the name of the file that you want to remove, then press the [RETURN] key. (Your keyboard may have a key labeled [ENTER], or an arrow with a right-angle shaft, instead of a [RETURN] key.) Throughout this book, the term enter means to type a command and press [RETURN] to run it.
Examples show what should happen as you enter a command. Some examples assume that you've created certain files. If you haven't, you may not get the results shown.
We use typewriter-style characters for examples. Items you type to
try the example are
boldface. System messages and responses
Here's an example:
dateTue Nov 4 13:39:24 EST 1997 %
The character "%" is the shell (system) prompt. To do this example, you would type date and then press [RETURN]. The date command responds "Tue Nov 4 13:39:24 EST 1997" and then returns you to the prompt.
We've included a problem checklist in some sections. You may skip these parts and go back to them if you have a problem.
Many sections have exercises to reinforce the text you've read. Follow the exercises, but don't be afraid to experiment on your own.
The exercises have two columns: the left-hand column tells you what to do and the right-hand column tells you how to do it. For example, a line in the exercise near the end of Chapter 1, Getting Started , shows:
|Get today's date||Enter |
After you try the commands, you'll have a better idea of the ones you want to learn more about. You can then look them up in your system's UNIX documentation or use one of the other references listed in Appendix A.
We update each book periodically. This allows us to incorporate changes suggested to us by our readers. We'd like new users to benefit from your experience as well as ours.
If you have a suggestion, or solve a significant problem that our handbook does not cover, please write to or call us at the following address and let us know about it (include information about your UNIX environment and the computer you use):
O'Reilly & Associates, Inc.
101 Morris Street
Sebastopol, CA 95472
1-800-998-9938 (in US or Canada)
If you have access to electronic mail (Chapter 3, Your UNIX Account ), you may email your comments to:
You'll have our thanks, along with thanks from future readers of this handbook.