Errata

Satellite Forms, by SoftMagic,

now reads:

Satellite Forms, by Puma Technology

Change:

Users can upgrade to the 3.0 OS (including IR support and 2MB of memory) for
around $100 at the time of this writing. A user unwilling to spend that kind
of money is probably unwilling to buy your software.

to:

Users were able to upgrade to the 3.0 OS (including IR support and 2MB of
memory) for around $100 (although that upgrade is no longer available). A
user who was unwilling to spend that kind of money is probably unwilling to
buy your software.

Err err;

now reads:

Err err = 0;

Err err;

now reads:

Err err = 0;

SysHandleEvent is listed at both the top and bottom of the loop. This
doesn't match the code. The copy at the bottom of the loop has been
removed. In the same figure,

"FnnDispatchEvent"

now reads:

"FrmDispatchEvent".

Halfway down example 4-11, a comment in the right column read:

"Tap on Beep Another Item"

It now reads:

"Tap on Beep More"

are now 14.

which are wrong. They have been changed as follows:

change sysAppLaunchFind to sysAppLaunchCmdFind
change sysAppLaunchGoTo to sysAppLaunchCmdGoTo
change sysAppLaunchNormal to sysAppLaunchCmdNormalLaunch

... pass a string with one space init (" ") instead.

now reads:

... pass an empty string ("") instead.

And,

FrmCustomAlert(MyAlertID, "string", " ", NULL)

now reads:

FrmCustomAlert(MyAlertID, "string", "", NULL)

The statement:

ControlPtr checkbox = FrmGetObjectPtr(frm,
FrmGetObjectIndex(frm, TrueOrFalseCheckbox) );

does not compile in C++ due to a missing cast.

The solution is to change it to:
ControlPtr checkbox = (ControlPtr) FrmGetObjectPtr(frm,
FrmGetObjectIndex(frm, TrueOrFalseCheckbox));

*A null-terminated prefix string which SysStringByIndex
prepends to each of the strings in the list.

*A two-byte count of the number of strings in the list

*The null-terminated strings concatenated together

(SysStringByIndex is in the function-style font.)

The following text used to read:

Use LstSetArrayChoices to pass...

now it reads:

Use LstSetListChoices to pass...

typedef struct StrListType {
char prefixString; // we assume it's empty
char numStringsHiByte; // we assume it's 0
char numStrings; // low byte of the count
char firstString[1]; // more than 1-all concated together
} *StrListPtr;

This sample assumes that the prefix string is empty,
and that there are no more than 255 strings in the
string list. For a sample that has been modified to
correctly handle more general cases, see
http://www.calliopeinc.com/PalmProgramming.

You shouldn't draw in a field until the form has been drawn.

static FieldPtr SetFieldTextFromHandle(Word fieldID, Handle txtH)

has been changed to:

static FieldPtr SetFieldTextFromHandle(Word fieldID, Handle txtH, Boolean
redraw)

and:

FldDrawField(fldP);

has been changed to:

if (redraw)
FldDrawField(fldP);

Same rationale as the change to p. 117.

static FieldPtr SetFieldTextFromStr(Word fieldID, CharPtr strP)

has been changed to:

static FieldPtr SetFieldTextFromStr(Word fieldID, CharPtr strP, Boolean
redraw)

and:

return SetFieldTextFromHandle(fieldID, txtH)

has been changed to:

return SetFieldTextFromHandle(fieldID, txtH, redraw)

and:

static void ClearFieldText(Word fieldID)
{
SetFieldTextFromHandle(fieldID, NULL);
}

has been changed to:

static void ClearFieldText(Word fieldID, Boolean redraw)
{
SetFieldTextFromHandle(fieldID, NULL, redraw);
}

following line:

Boolean result = false;

before the line beginning if (event-.eType == ctlSelectEvent &&

and,
return true; // don't bail out if they cancel the delete dialog

now reads,

result = true; // don't bail out if they cancel the delete dialog

and,
return true;

now reads:

result = true;

and,
return false;

now reads:

result = false;

Same rationale.

SetFieldTextFromStr(CustomerNameField, (CharPtr) theCustomer.name);
SetFieldTextFromStr(CustomerAddressField,
(CharPtr) theCustomer.address);
SetFieldTextFromStr(CustomerCityField, (CharPtr) theCustomer.city);
SetFieldTextFromStr(CustomerPhoneField, (CharPtr) theCustomer.phone);

has been changed to:

SetFieldTextFromStr(CustomerNameField, (CharPtr) theCustomer.name,
true);
SetFieldTextFromStr(CustomerAddressField,
(CharPtr) theCustomer.address, true);
SetFieldTextFromStr(CustomerCityField, (CharPtr) theCustomer.city,
true);
SetFieldTextFromStr(CustomerPhoneField, (CharPtr) theCustomer.phone,
true);

Same:

SetFieldTextFromStr(ItemQuantityField, quantityString);

has been changed to:

SetFieldTextFromStr(ItemQuantityField, quantityString, false);

"dirty"

DmResetRecordStates is dangerous to call
Replace:
If for some reason your code must close a database while you have locked or
busy records, call DmResetRecordStates before calling DmCloseDatabase:

err = DmResetRecordStates(gDB);
err = DmCloseDatabase(gDB);

The Data Manager doesn't do this resetting automatically from
DmCloseDatabase because of the performance penalty. The philosophy is that
you shouldn't penalize the vast majority of applications that have released
and unlocked all their records. Instead, force the minority of applications
to make the extra call and incur the speed penalty in these rare cases.

with:
Thus, make sure that you unlock and release all records before calling
DmCloseDatabase.

There is a call, DmResetRecordStates, which is advertised to reset locked
and busy records. However, in most versions of the OS, it has a bug that
causes a fatal system alert if your code calls it.

The OS does reset the locked and busy records in the rare case where a
system reset occurs while you have a database opens. It calls
DmResetRecordStates to do this resetting, but the bug doesn't manifest
itself when called by the OS in this case.

Instead, the archived bit of the record is set, and ...

now reads:

The deleted bit is set (although the memory chunk is
maintained), and ...

"converted by PilotRez"

now reads:

"converted by PalmRez"

"PalmRez". The 3 occurences to have been changed to read "Rez".

Delete:
#ifdef __GNUC__
CALLBACK_PROLOGUE
#endif

and delete:

#ifdef __GNUC__
CALLBACK_EPILOGUE
#endif

and add two lines, changing:

gHandles[i][j] = MemHandleNew(1);

to:

gHandles[i][j] = MemHandleNew(1);
if (!gHandles[i][j])
return false

MemSet(&event, 0, sizeof(EventType))

now reads:

MemSet(&event, sizeof(EventType), 0)

Buffer can overflow depending on the LAT/LON.

char s[10];

has been changed to:

char s[11];

#define kMinorVersion 0

now it reads:

#define kMinorVersion 1

The following text used to read:

Proving ChangeConduit works

now it reads:

Proving ConfigureConduit works

The following text used to read:

... Bringing this dialog up proves that your
ChangeConduit function gets called.

now it reads:

... Bringing this dialog up proves that your
ConfigureConduit function gets called.

reads:
Use (eDbRead | eDbShowSecret) to read all
records, including private ones. Use (eDbRead
| eDbWrite | eDbShowSecret) to be able to
rite and/or delete records.

(The initial "d" has been changed to "eD" in five instances.)