people: People''s addresses and phone numbers and etc.

Features:
	- auto dialing
	- multiple phone numbers
	- send fax
	- send email
	- create envelope
	- goto home page
	- ping, vnc, etc. hostname
	- find map

Usage: people <options> <item>

Options: 
	-v	Show all entries in database.
	-t <type>   <type> is a list of attribute types to match.
	-c <class>  A "," separated list of classes to match.
	-f <file>	Use <file> as people database

	-V,-vcard Print a vcard to stdout
	-mime	Mime multipart for vcard
	-ps	Create a tiny printable version of the database.
		(you preview/print while in gv(1))
		Also use -ps ncol:font for enscript args of number
		of columns and font. If font=<n> => Courier<n>
		default: -ps 4:Courier4

	-l	Print all info to stdout (2), multiline. Also -L
	-ls	Print names and primary phone number to stdout (1 line output)
	-la	Print names and primary phone number and primary
		address to stdout (3). Both are 1 line per item.
	-stdout	Print primary phone number to stdout instead of dialing it.
	-name   Print name to stdout when number is clicked.

	-palm	Dump addresses as in Palm OS CSV format.
	-addr1	Dump primary addresses 1 per line : separated.
	-addrs	Dump a primaryddresses in equal sized stanzas
	-H <n>	Set stanza height to <n> (default: 6)

	-plus	Phone numbers are put out in +1234567890 notation.
	-scrub	Scrub a number (trim out cruft and adjust areacode)
	-fax	Show primary fax numbers only. Useful with -stdout to get
		a users reply.
	-A	Launch a A-Z table
	-ypf	Use full name in YP searching.
	-geometry <geom>  Set geometry.

	-add <n> Add an entry with number <n> (use "1" for new)
	-add_timeout <n>  times out after <n> secs
	-e <str> Edit name matching <str>

	-d 	Debug
	-wish <file> 	Dump wish code to <file>

	-self_dump	dump a self contained program (run with -self)
	-self	use a self contained version of the database

Notes:
	Requires: perl, wish.
	Programs that may be called:
		xterm, xwit, ping, enscript, vi, ls, tail, kill, dirname,
		basename, wc, hostname,
	Homebrew programs that may be called:
		autodial, url, map, map2, yp_people, mail5, faxcover, efax,
		envelope, xvi, ran_geom, vcard, tktty

	Stanzas are separated by: -----

	See also vcard (for people -> vcard -> netscape pab translation)

Database format:

@AREA_CODE: 603
#
# Format:
# <attributes>:<NAME>; TAG=val; ...;
# Lines may be spread out over multi lines as long as they don't match
# <attributes>:.
#
# If a <NAME> begins with SERVICE or MEDICAL they are grouped together
# in the rolodex list. This should have been done by attributes...
#
# Lines basically start with ":" optionally preceded by some attributes.
# attributes are labeled by a single letter followed optionally by numbers.
# For example xmas cards would be "x:" See list below.
#
# TEL[:label]=nnn-nnn-nnnn[xnnn];
# FAX[:label]=nnn-nnn-nnnn[xnnn];
# ADR[:label]=POB,EXTENDED,STREET,CITY,STATE,ZIP,COUNTRY;
# or
# ADR[:label]=POB,EXTENDED,STREET,LOCALITY,REGION,POSTALCODE,COUNTRY;
# URL[:label]=<url>;
# EMAIL[:label]=<mailto>;
# BDAY[:label]=<nnnn/nn/nn[,nn:nn:nn]>;
# SSN[:label]=<nnnnnnnnnn>;
# HOSTNAME[:label]=<fqhn>
# NOTE[:label]=...
#
# Directives start lines with @ and are currently:
#
# default area code for dialing (used for trimming for "local" calls).
# @AREACODE: <nnn>
#
# A long string to attach to a block of people. E.g. "Volleyball team"
# @CLASS:<string>
#  <entries>
# @CLASS:   shuts off class.
#
# Can apply a attribute block via:
# @ATTRIB:<string>
#  <entries>
# @ATTRIB:  shuts off attribute.
#
##########################################################
# Notes:
# Currently used attributes: 
#       v       only use the entry when in verbose mode.
#       x       xmas card to {fullname}
#       X       xmas card to "The {lastname}s"   
#       X1      xmas card to "The {lastname}"    (plural names, e.g. Peters)
#       X2      xmas card to "The {lastname}'s"  (' for odd names)
##########################################################
#