#!/bin/csh -f
# manb
# ------------------------------------------------------------------------------
# Shell script to show help on a shell built-in command, like cd or dirs.
# ------------------------------------------------------------------------------
# Usage:  See Usage section below or run with no arguments to see usage.
# Assumptions:
# Effects:
#       - Echos help to standard out via the less command.
# Notes:
# Implementation Notes:
# Portability Issues:
# Revision History:
#   $Log$
# ------------------------------------------------------------------------------

if ($#argv < 1) then
   echo "Usage: $0:t built-in shell command to show help for"
   exit 1
endif

info $SHELL:t | less +/"$*"
# Note: "$*", not $*:q or $1:q because we want all of the params as one big
#       quoted string to make it easier for the user to search for a phrase.
# Get detailed help (info, not just man) on current shell, and pipe it all 
# through less to flatten the tree of info nodes and paginate it, to make it 
# easier to navigate for those who don't know the Emacs-oriented info system
# or the organization of info nodes for the topic of the current shell.