Submit Hint Search The Forums LinksStatsPollsHeadlinesRSS
14,000 hints and counting!


man page? | 29 comments | Create New Account
Click here to return to the 'man page?' hint
The following comments are owned by whoever posted them. This site is not responsible for what they say.
man page?
Authored by: macubergeek on Jun 13, '03 11:29:11AM

Hmmm
installer didn't seem to install a man page so I made one from scratch using the online web man page:
------------------------------------------------------------------
.Dd June 12, 2003
.Dt CONTACTS 1
.Os
.Sh NAME
.Nm contacts
.Nd list directory contents
.Sh SYNOPSIS
.Nm
.Op Fl contacts [-hHsnml] [-f format] [search]
.Op Ar file ...
.Sh DESCRIPTION
The utility contacts affords easy access to information in the Address-Book database from the shell.
.Pp
The utility contacts accepts the following flags:
.Bl -tag -width indent
.It Fl h
displays help/usage
.It Fl H
uppresses headers from being displayed
.It Fl s
sorts the list before displaying it
.It Fl m
show the person marked as "me"
.It Fl n
displays note below each record (by default only one line is
shown, to see entire note include the -l option)
.It Fl l
loose formatting - doesn't truncate the record values to align columns
.It Fl f
accepts a format string (see below)
.Pp
The format string can contain the following tokens:
.It %n
name (first and last name or company name)
.It %fn
first name
.It %ln
last name
.It %p
phone (order of preference: home, work, mobile, main, pager,
fax, other)
.It %hp
home phone
.It %wp
work phone
.It %mp
mobile phone
.It %Mp
main phone
.It %pp
pager phone
.It %fp
fax phone
.It %op
other phone
.It %e
email (order of preference: home, work, other)
.It %he
home email
.It %we
work email
.It %oe
other email
.It %t
title
.It %c
company
.It %g
group
.It %w
webpage/homepage
.It %b
birthday
.It %i
instant messanger name (order of preference: aim, yahoo, jabber,icq, msn)
.It %ai
AOL Instant Messenger (AIM)
.It %yi
Yahoo IM
.It %ji
Jabber IM
.It %ii
ICQ IM
.It %mi
MSN IM
.It %N
displays the note on a line by itself under the person's record. This token should usually be placed at the end of the formatter. The contacts utility exits 0 on success, 1 if no one is found in the search, 2 for usage problem, and >0 if any other error occurs.
.Sh EXAMPLES
.Pp
EXAMPLES
The command:
$ contacts
displays all contacts.
.Pp
The command:
$ contacts -h
displays the usage.
.Pp
The command:
$ contacts fred
displays all persons with the name "fred" somewhere in their name.
.Pp
The command:
$ contacts -m
displays person marked as me.
.Pp
The command:
$ contacts -mH
displays person marked as me with no header.
.Pp
The command:
$ contacts -mH -f '%e'
displays the-person-marked-as-me's email address with no header.
.Pp
The command:
$ contacts -f '%n %hp %wp %mp'
displays everyone's name and home phone, work phone, and mobile phone.
.Pp
The command:
$ contacts -f '%ln %fn %hp'
displays everyone's last name, first name, and home phone.
.Pp
.Sh BUGS
BUGS
.Pp
contacts only searches the first name, last name, email, company name, and AIM name in the AddressBook, whereas the AddressBook application's behavior appears to search everything in the record.
.Pp
The format string only recognizes its own tokens i.e. "blah %n" won't print "blah fred smith" instead it will just print "fred smith". Similarly, "%fn%ln" won't print "fredsmith"; it'll print "fred smith" instead.



[ Reply to This | # ]
man page?
Authored by: fxt on Jun 13, '03 11:51:53AM

the man page installed just fine for me.
check your manpath?

fxt



[ Reply to This | # ]
re: man page?
Authored by: huzzam on Jun 17, '03 06:56:43PM

seems to get put in /usr/local/man, rather than /usr/local/share/man, where other local man pages tend to end up. check there.

peter



[ Reply to This | # ]