PhoneLookup Hack User's Guide

Thank you for using PhoneLookup Hack !


PL-hack icon PL-hack screenshot

This documentation covers PhoneLookup Hack version 2.0
13-NOV-1999


Introduction

The datebook application allows you to look up for a record in the address book (menu Options/Phone Lookup), and to automatically insert the associated data.

For instance, let's select Mr. Neuman's details using the standard Phone Lookup :

Datebook view Lookup view Result

What is inserted isn't configurable : you get the first name, the last name, the phone number and nothing else...

Now look at Mr. Neuman's record in the adress book :

Address view

As you can see, there is a lot of valuable data that could be used by Phone Lookup.

PhoneLookup Hack allows you to define which fields Phone Lookup will return. You can even customize how they will be returned, with line feeds or additional text.

For instance, you may want Phone Lookup to insert the company name, work phone and full address, on multiple lines for legibility (left screenshot), and here's what you get when you do the same lookup as above (right screenshot) :                 

Configuration screen

Result

Doesn't it look better ? Isn't it more convenient ?

Please note that PhoneLookup Hack is shareware. The evaluation period is 30 days long. If you continue to use PhoneLookup Hack after 30 days, you are required to register.

To get the latest version of PhoneLookup Hack, please visit my web page at : http://www.ablivio.com, or download directly the latest plhack.zip at : http://www.ablivio.com/plhack/getit.htm.

[Back to top]


Installing (or removing) PhoneLookup Hack

[Back to top]

First time installation

Step 1
Upload plhack.prc on your Palm device, using the regular HotSync process.
[If HackMaster isn't installed yet on your machine, upload HackMaster.prc as well.]

HotSync icon

Step 2
Launch HackMaster.

The list of all HackMaster extensions available on your machine appears, including "PhoneLookup Hack".
If there is a lot of extensions on your machine, you may have to scroll down the list.

HackMaster icon

PhoneLookup Hack is disabled

Step 3
Check the box beside "PhoneLookup Hack" to activate it.

You're finished !

PhoneLookup Hack is enabled

[Back to top]

How to upgrade an existing PhoneLookup installation

Step 1
Launch HackMaster.

The list of all HackMaster extensions available on your machine appears, including "PhoneLookup Hack".
If there is a lot of extensions on your machine, you may have to scroll down the list.

HackMaster icon

PhoneLookup Hack is enabled

Step 2
Uncheck the box beside "PhoneLookup Hack", to disable the hack.

PhoneLookup Hack is disabled

Step 3
Upload plhack.prc file on your Palm device, using the regular HotSync process.

HotSync icon

Step 4
Launch HackMaster.

The list of all HackMaster extensions available on your machine appears, including "PhoneLookup Hack".
If there is a lot of extensions on your machine, you may have to scroll down the list.

HackMaster icon

PhoneLookup Hack is disabled

Step 5
Tap on the "?" beside "PhoneLookuk Hack", to verify that you know have the newer version of the hack (on the screenshot, this is version 1.00).
Tap on "Ok".

About box

Step 6
Check the box beside "PhoneLookup Hack" to activate it.

You're finished !

PhoneLookup Hack is enabled

[Back to top]

You want to get rid of PhoneLookup Hack

Well, you're the boss. :-)

[Back to top]


Using PhoneLookup Hack

[Back to top]

Overview

Basically, PhoneLookup Hack allows you to define your own format string to describe how you want the Phone Lookup command to return data from the address book.

To access the format definition form, please proceed as follows :

Step 1
Launch HackMaster.

The list of all HackMaster extensions available on your machine appears, including "PhoneLookup Hack".
If there is a lot of extensions on your machine, you may have to scroll down the list.

HackMaster icon

PhoneLookup Hack is enabled

Step 2
Tap on the "+" sign beside "PhoneLookup Hack".
You get to the format definition form.

Configuration screen

Now, you can use any of the markers listed below to compose your own format string. You can also insert additional characters, such as line feeds, if you want the Phone Lookup output to be more legible.

[Back to "Using PhoneLookup Hack"]

[Back to top]

How to define your own format string

Available markers are :

Apart from ^listname and ^listphones, which are special macros defined below, each marker directly matches a field of an address book record.

^listname acts as follows :

^listphone :

[Back to "Using PhoneLookup Hack"]

[Back to top]

Examples

[Back to "Using PhoneLookup Hack"]

[Back to top]


Your comments are welcome !

Feel free to send me your comments, suggestions, criticisms and every other kind of feedback at feedback@ablivio.com. I make a point of replying to all messages I receive.

It will help me to make PhoneLookup Hack better and more useful, by answering more closely your needs.

[Back to top]


What is shareware ?

PhoneLookup Hack is shareware. That means that you can download, use and completely free test the program for 30 days. You may also distribute and copy unregistered versions of PhoneLookup Hack to others as long as the files in the original PLHACK.ZIP archive is not tampered and no fee is charged. If you find the program useful and you continue to use it, you are obligated to register.

The whole shareware concept is based on honesty. The registration fee you pay allow me to support and continue to develop PhoneLookup Hack in the future.

When you register PhoneLookup Hack, you will get the most recent registered version of the program, without any shareware nags, or delay screens.

Definitions :

SUPPORT THE SHAREWARE CONCEPT : PAY YOUR SHAREWARES !

[Back to top]


How to register for PhoneLookup Hack ?

Registration entitles you to all future corrective updates of PhoneLookup Hack and to special rates (possibly free) for evolutive updates.

When you register, you get a registration code. You merely have to enter it in PhoneLookup Hack, using menu "Info/Register". Then, if you select "Info/About...", you'll be able to check that your copy of PhoneLookup Hack is registered to you.

Note : Once you've entered the registration code, the "Register" menu item is not removed from menu "Info". I did this because removing it would require additional "cosmetic" code, hence a larger app.

Cheaper ! Direct registration

The registration fee can be paid directly to me using the following currencies and rates :

US Dollars ($) 8 USD
Francs Français 50 FRF
Francs Belges 300 BEF
Deutsche Mark 12 DEM
GB Pounds 5 GBP

Just mail me your registration fee (no checks, nor other currencies than above, thanks !) :

Denis Faivre, 99 avenue Marx Dormoy, 59000 Lille, France.

Note : Don't forget to include :

This information is needed to generate your registration code and send it to you by e-mail.

If you don't remember your user name, just launch the HotSync app on your Palm device. On Pilots and PalmPilots, you'll get a message saying "Welcome, <USER NAME>. Last HotSync...". On Palm IIIs, your user name is displayed on the right of Hotsync app's title bar.

Your address will be kept confidential. It won't be given or sold to anyone.

Faster ! Credit card registration (phone, fax, on-line)

Credit card registrations will be processed by PilotGear.

Through PalmGear, PhoneLookup Hack registration fee is $9.95 (USD), to cover their commission.

On-line registration : http://www2.viaweb.com/pilotgearsw/denisfaivre.html
Phone : 1-800-741-9070 or 1-817-640-6558.
Fax : 1-817-640-6614.

Palm Gear H.Q.
2500 East Randol Mill Road, Suite 117
Arlington, TX 76011
USA.

[Back to top]


License and Legal Information for PhoneLookup Hack

NOTICE: THIS IS A CONTRACT. BY INSTALLING AND USING THIS SOFTWARE, YOU ARE AGREEING TO BE BOUND BY ALL THE TERMS AND CONDITIONS OF THIS AGREEMENT. PLEASE READ CAREFULLY BEFORE PROCEEDING. IF YOU DO NOT AGREE TO THESE TERMS, PROMPTLY DESTROY ALL COPIES OF THE SOFTWARE IN YOUR POSSESSION.

EVALUATION LICENSE

Denis Faivre ("the Author") grants you a non-exclusive license to use PhoneLookup Hack ("the Software") free of charge for a period of 30 days ("the Trial Period") for the purpose of evaluating whether to purchase a license for continued use of the Software.

At the end of the Trial Period, if you do not purchase a license, you must destroy all copies of the Software and Documentation. If you wish to purchase a license, contact the Author at info@ablivio.com or http://www.ablivio.com .

GRANT

On payment of applicable license fees, the Author will grant to you a non-exclusive license to use the Software and Documentation as laid forth below.

SCOPE OF GRANT

You may:

You may not:

DISTRIBUTION

Copies of unregistered versions of the software may be distributed for evaluation purposes only in accordance with the following terms :

Distribution is permitted only for the whole unregistered software package without any modifications. All accompanying files must be included. You are specifically prohibited from charging or requesting donations for any such copies without prior written permission.

WARRANTY DISCLAIMER

THE SOFTWARE IS PROVIDED "AS IS," AND WITHOUT ANY WARRANTY, EXPRESS OR IMPLIED, AS TO NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE.

COPYRIGHT AND TITLE

Title, ownership rights, and intellectual property rights in the Software are owned by the Author and protected by U.S. copyright law and international treaty.

The structure, organization and code of the software are valuable trade secrets of the Author.

Recipient will not disclose, publish, or distribute the Software except as permitted above, and agrees to take reasonable precautions to prevent any unauthorized use, disclosure, publication, or distribution. Proprietary rights notices on the Software shall be preserved on all copies made, and the Software shall not be modified, reverse engineered, or decompiled for any purpose, or translated into another computer language.

GOVERNING LAW

This agreement shall be interpreted, construed and governed in accordance with the french laws.

Copyright (c) 1998 Ablivio - Denis Faivre. All Rights Reserved.

[Back to top]


About HackMaster

HackMaster is shareware. It's a really useful tool that keeps us from the mess of non-standard hacks. Since the registration fee is really low ($5 or so), I encourage you to register.

Here is the licensing information from Daggerware :

Ah, finance. If you are a commercial company and you would like to write and sell your own Hacks using this protocol, you are free and clear to do so, and in fact I encourage you to adopt this standard to prevent extension conflicts. However, the HackMaster program itself is copyrighted shareware, and thus cannot be freely distributed with the extensions you sell. It's not fair for you to get the profit for giving customers my program, now is it ? Anyway, if you do want to distribute copies of HackMaster with other software you have written, we'll have to arrange some sort of license. Specifics vary on a case-by-case basis, but generally I would expect a licensing fee per copy of 25 cents or one percent of the cost of the product, whichever is less. This entitles you to distribute copies of HackMaster, but does not mean that your customers are automatically registered users with all the rights and privileges thereof (like technical support, email updates, etc.) Anyway, just email me at mistered@1stresource.com and we'll talk specifics if this applies to you. If, on the other hand, you are a shareware/freeware author and want to distribute copies of HackMaster with your Hacks, go right ahead. Just be somewhat obvious in mentioning the fact that HackMaster is indeed shareware are should be registered with DaggerWare; the appropriate URL is in the program itself.

[Back to top]