The Accidental Rubyist

invalid byte sequence in UTF-8

What is wrong with man pages and –help

leave a comment »

Today most programs have at least 20 command line options, usually much more. A newcomer wishes to run the basic or minimal functionality of a tool/utility without as yet getting into complex usage. However, the “–help” and man pages of ALL programs do not give basic usage.

All options, frequently used ones, as well as rarely used ones, are all clubbed together alphabetically. A new user has to read all these 50 or so options to figure out how to use the program in its most basic way. What are the minimal use cases for a program/tool? What are the values of some of the arguments to be passed?

The mini HOW-TO from gnupgp.org should take me through a cycle, a use case, but I am given all the options. So what is recipient – an email id, a user on my system. A HOW-TO is not a help file or reference manual — it should show me how to do certain operations or cases.
Anyway, back to more playing around.

[Edited in Vim using HTML.vim]
Published using mtsend.py by Scott Yang.

Advertisements

Written by totalrecall

August 24, 2008 at 10:57 am

Posted in Uncategorized

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: