16.4. Online Help

16.4. Online Help Mac OS X comes with over 1,200 Unix programs like the ones described in this chapter. How are you supposed to learn what they all do? Fortunately, almost every Unix program comes with a help file. It may not appear within an elegant
Nội dung trích xuất từ tài liệu:
16.4. Online Help16.4. Online HelpMac OS X comes with over 1,200 Unix programs like the ones described in this chapter.How are you supposed to learn what they all do?Fortunately, almost every Unix program comes with a help file. It may not appear withinan elegant, gradient-gray Leopard window—in fact, its pretty darned plain— but it offersmuch more material than the regular Mac Help Center.These user-manual pages, or manpages, hold descriptions of virtually every commandand program available. Mac OS X, in fact, comes with manpages on almost 9,000topics—over 30,000 printed pages worth.Alas, manpages rarely have the clarity of writing or the learner-focused approach in theMac Help Center. Theyre generally terse, just-the-facts descriptions. In fact, youllprobably find yourself needing to reread certain sections again and again. Theinformation they contain, however, is invaluable to new and experienced Unix fans alike,and the effort spent mining them is usually worthwhile.16.4.1. Using manTo access the manpage for a given command, type man followed by the name of thecommand youre researching. For example, to view the manpage for the ls command,enter: man ls.Tip: The -k option flag lets you search by keyword. For example, man -k appletalkproduces a list of all manpages that refer to AppleTalk, whereupon you can pick one ofthe names in the list and man that page name.Now the manual appears, one screen at a time, as shown in Figure 16-7. Figure 16-7. To move on to the next man screen, press the Space bar. To go back, press the up arrow key or the B key. To close the manual and return to a prompt,press Q. You can also search for a certain phrase by typing a / (to produce the find what? prompt); thereafter, type n to find the next occurrence.A typical manpage begins with these sections: • Name. The name and a brief definition of the command. • Synopsis. Presents the syntax of the command, including all possible options and arguments, in a concise formula. For example, the synopsis for du (disk usage) is as follows: du [-H | -L | -P] [-I mask] [-a | -s | -d depth] [- ] [-h | -k] [-x] [file …]. That line shows all the flags available for the du command and how to use them. Brackets ([ ]) surround the optional arguments. (All of the arguments for du are optional.) Vertical bars called pipes (|) indicate that you can use only one item (of the group separated by pipes) at a time. For example, when choosing options to use with du, you can use either -H, -L, or -P—not two or all three at once. The word file in the synopsis means type a pathname here. The ellipsis (…) following it indicates that youre allowed to type more than one pathname. • Description. Explains in more detail what the command does and how it works. Often, the description includes the complete list of that commands option flags.For more information on using man, view its own manpage by entering—what else?—man man.Tip: The free program ManOpen, available for download at www.missingmanuals.com,is a Cocoa manual pages reader that provides a nice looking, easier-to-control window forreading manpages.Or why not just use Dashboard? Download the *NIX Manual widget(from this books Missing CD page at www.missingmanuals.com, for example). Itprovides an equally attractive interface to the manpages.16.4.2. Other Online HelpSometimes Terminal shoves a little bit of user manual right under your nose—when itthinks youre having trouble. For example, if you use the mkdir command withoutspecifying a pathname, mkdir interrupts the proceedings by displaying its own synopsisas a friendly reminder (subtext: Um, this is how youre supposed to use me), like this:usage: mkdir [-pv] [-m mode] directory…