peoplepages(1)

NAME
     peoplepages -  PeoplePages, the IRIX Interactive Desktop Phone & Address
     Book

SYNOPSIS
     /usr/sbin/peoplepages [-nofork] [-nogallery] [-defaultBookList booklist]
     [book...]

DESCRIPTION
     peoplepages provides phonebook-like database capabilities for InPersonTM
     and other communication tools.  The database is comprised of a number of
     books. Complete information about people & places you need to contact can
     be stored in these books.  peoplepages displays a list of the available
     books. You click on the desired book to select it.

     peoplepages' main window displays a list of entries from the current
     book.  Each entry has a draggable icon which can be dropped on InPerson,
     MediaMailTM & other communication tools to initiate communication with
     that person.

     Double-clicking the icon opens an Information Card for that person
     showing all the information that has been entered into the book.  Much
     information can be stored about a person including a list of locations
     where they may be contacted. Each location has a addresses for each type
     of communication media. When someone publishes an entry, they will
     designate one location as their primary location, the place to try first.

     peoplepages supports a personal book as well as a number of public books.
     A personal book is private.  It is yours & yours alone.  You can do
     anything you want with it.  Nobody else will see it since it is created
     with mode 0700.  When you run peoplepages for the first time, it asks if
     you want to create a personal book.

     You can browse public books freely, as can anyone else.  You can change
     only your own entry in a public book.

     When peoplepages starts up, it automatically locates available public
     books by sending out a query to its database server ppagesd(1M).  Each
     ppagesd that receives the query replies with the logical name and
     location of its book.  peoplepages uses automount(1M) to access the book
     via NFS.  Book locations may also be supplied as command-line arguments
     in the form of the full path name of the location of the database
     directory.  To disable the query for public books, use the
     -defaultBookList ``'' option or specify the X resource *defaultBookList
     with no value (see below).

     ppagesd also receives messages from users running InPerson and creates
     skeleton entries for them in one of the public books specified by your
     system administrator.

     Shortly after you start peoplepages, it searches the public books to see
     if you have published an entry for yourself.  If it doesn't find one, or
     if it finds only the skeleton entry created by ppagesd, peoplepages will
     ask you to publish a full entry.

PERSONAL BOOK
     Your personal book is created in the directory .PeoplePagesPersonal in
     your home directory.  You can customize both the name and the cover of
     your personal book as shown on the book-selection button at the top of
     the main window.  The name goes into the file .label in the database
     directory.  Two cover images in either .xpm (X Pixmap) or .rgb (standard
     SGI) format are required.  One is displayed when the book is closed, the
     other when it is opened for reading.  They go in the files .cover-closed
     and .cover-open in the database directory.  The images should be 44 x 32
     pixels.  Xpm format is recommended because it allows you to tag the
     predominant background color of the pixmap.  Having this information
     allows peoplepages to make a better visual presentation of your images.
     To tag the background add " s background" at the end of the line
     specifying the predominant background color.  For example the line

          % c #848484

     becomes

          % c #848484 s background


RESOURCES
     The default X11 resources file /usr/lib/X11/app-defaults/PeoplePages
     contains a few resources that can be customized at the beginning of the
     file.  You can edit this file as root to make changes for all users on
     the system. If you want your private customizations, create or edit the
     file to $HOME/.desktop-`hostname`/PeoplePages to add the following
     resources with your desired values.

     PeoplePages*defaultBookList
          This resource specifies a list of book pathnames (separated with
          colons) to be used instead of the public books. If the list is
          empty, then only your personal book is displayed.  For example:

               PeoplePages*defaultBookList:  /var/ppages/sales:/var/ppages/support

          will display just those 2 books under /var/ppages.

     PeoplePages*galleryView
          This resource controls whether peoplepages displays images or icons
          for entries with pictures.  If set false, accessing public
          (networked) books is sped up.  The default is true.

     PeoplePages*wwwBrowser
          This resource specifies the pathname of a WWW browser to be invoked
          from the ``View'' button on the information card.  The default is
          ``netscape''.

FILES
     $HOME/.PeoplePagesPersonal

SEE ALSO
     ppagesd(1M), inperson(1), MediaMail(1)

NOTE
     The NFS optional software must be installed and configured.  The
     automount(1M) /hosts map must be configured to access public books and it
     must be able to resolve the PeoplePages server's hostname.  Write access
     to the public books directories is needed if users are permitted to
     change their entries using peoplepages.