.ds Fx \fIQfax\fP.TH QFAX.PHONEBOOK 1 "1 March, 1996".SH NAMEqfax.phonebook \- \*(Fx phonebook database format.SH DESCRIPTION.B qfaxuses a simple "phonebook database" to help keep track ofinformation about people you send faxes to.  In itspresent form it's pretty naive, but as interest dictates,this may change in future versions.Every user of.B qfaxor.B qsendcan have her own "personal phonebook" (.B ~/.fax), which contains information about people and companiesshe faxes to.  This phonebook is the first place.B qfaxand.B qsendwill look to find the recipient.There must at least exist a "master phonebook" somewhere onthe system (.B fax.db), which contains information about recipients you feel theentire set of users should be able to access.  This databaseis only accessed if a search of the sender's personal phonebookfails..SH "PHONEBOOK FORMAT"The formats of both the personal and master phonebooks areidentical, and are such that they can be edited and added tousing your favourite text editor.Each entry has the following format:.sp.RS +.2i.ta 1.0i.nf <company-alias> <company-full-name> <company-voice-phone-number> <company-fax-phone-number> <contact-person-1-alias> <contact-person-1-full-name> <contact-person-2-alias> <contact-person-2-full-name> ...etc... <contact-person-n-alias> <contact-person-n-full-name> +.fi.RE.spAs an example, you might have an entry like this in your.B fax.dbfile:.sp.RS +.2i.ta 1.0i.nfacme  Acme Industries1 999 555 12121 999 555 1234wile  Wile E. Coyote, Presidentbeep  Roadrunner, Vice President+.fi.RE.spIn this way, users could send email to "wile@acme.fax" in orderto automatically generate a cover page and fax message for"Wile E. Coyote, President" at "Acme Industries" and have theproper fax number (1 999 555 1234) dialed..SH "PHONE NUMBER FORMAT"The most universal way to make everyone on both sides of theAtlantic happy is to make NO assumptions about phone numberformats.  What this means is that you should use whateverdialstring you need in order to dial the recipient, including"1", "011", area code, country code, city code, whatever.Likewise, if a number is local to you, do NOT include anyextra digits before the local number.  Only include thosedigits you need to dial..B qfaxand.B qsendwill ignore any non-digit characters in this dialstring beforehanding it to the modem, so if the number is "1 999 555 1212",you could also phrase it as "1 (999) 555 1212", or"+1.999.555.1212", and so on.  Only the digits matter, so in allof these cases the string "19995551212" would get sent to themodem..SH FILES.sp.RS +.2i.ta 1.0i.nf/usr/local/bin/qfax    Qfax binary/usr/local/bin/qsend   Qsend binary/conf/fax/fax.db       Qfax master phonebook~/.fax                 Qfax user phonebook.fi.RE.sp.SH "SEE ALSO".IR qfax(1),.IR qsend(1).SH BUGSThe formatting structure of the phonebook is rather rigid, suchthat while tabs and spaces are valid whitespace characters,newlines must appear in the specific places indicated.The phonebooks are not sorted at all, as they're produced byhand.  Search time will eventually get out of hand as the numberof entries becomes large.The text format of the phonebooks is not secure, so anyone canaccess this information.  In future versions this could bemodestly encrypted.