Man pages have been around since before I was born (circa 1971, actually). The people who will take an interest in this post are most likely familiar with the 'man' documentation format for most UNIX commands. While little has changed in the form and function of the man page – besides spawning some offshoots like GNU's info – the options for reading them in a more pleasant GUI environment have grown more diverse. Mac OS X users have a few options beyond typing 'man xyz' into the Terminal or using man pages on the web...

There are Cocoa applications like Man Viewer, Man Handler and ManOpen which allow you to search for and browse man pages in a way more familiar to OS X users. They all perform text searches within an opened page, Man Handler having the most Leopard-friendly results. To the best of my knowledge, only ManOpen allows for Apropos searches which allow you to find man pages based on their subject matter. I also like the ability to open several man pages simultaneously, which ManOpen and Man Handler provide but Man Viewer does not. Rather, Man Viewer provides a single-window interface, which has its upsides as well.

Most of the Cocoa viewers do not handle hypertext links within the man pages (ManOpen provides related links). For a fluid solution in that area, there's Bwana or Sogudi (the Safari 3 version of Sogudi is currently a beta), tools that integrate with Safari to allow the opening of man pages right in the browser with code highlighting and links to related pages. While Bwana is an application, Sogudi is an InputManager which allows and both allow you to type man:mdfind in the url field to load a pretty (man2html) version of mdfind's man page (with Bwana, you can also use 'open man:mdfind' from the command line) . And with both you get a tabbed interface and great search features to boot. If you've already got Safari open for other purposes, it's a great way to make use of the browser. By the same token, it's a lot of app to load if you just want to remember an ls switch.

Another option – which may be great in some instances and fairly worthless in others – is Man2PDF. Basically, it produces a well-formatted PDF of the selected man page. Perfect for printing and viewing with Preview, but not the best choice for quick consultation.

Were I asked to pick a winner, and Safari was already running, I'd say Sogudi wins for good looks (inherited, in part, from Safari) and great usability. ManOpen wins in the standalone category with its Apropos search and hypertext links.

Of course, a vanilla man command wins for easy accessibility where you need it most.

There are two kinds of Mac folk: them that finds this "Terminal" thing strangely fascinating, and them what considers it the worst kind of wicked magic, not to be trifled with. Here at TUAW we've got all kinds, and for anyone who might be curious about the power and possibilities of the command line, we're going to provide some weekly quick tips and suggestions for introductory use. Always keep in mind, though, that the damage you can do from Terminal is effectively unlimited, especially with administrative access. Best to play around in a 'dummy' account until you have your sea legs.

Even before we start, an explanation of the title: 'man pages' are the BSD UNIX manuals, already tucked away on your Mac. You can type "man command" in Terminal for a detailed (not to say overwhelming) rundown on any command-line tool. As we've mentioned before, an excellent intro to Terminal in Tiger can be found over at the O'Reilly Mac Dev Center. We also posted about Unix for the Beginning Mage, an amusing beginner's guide to the plumbing under Mac OS X.

Our fine feathered friend today is 'ls' -- the UNIX directory list command. Read on for more...