ShadowLink

Copyright Ó 2002 Ling Nero. All Rights Reserved. ShadowLink is freeware, licensed under the GNU GPL.

Send bug reports or to RnLNero@yahoo.com. For source code go to www.geocities.com/rnlnero/

What is ShadowLink

How to Use

Caveats

Troubleshooting

Version History

WHAT IS IT

ShadowLink is a HackMaster extension specifically designed to work with the origin stamp written by ShadowPlan. There are two versions: shadlinkOS30.prc is for handheld devices running PalmOS 3.0 and up; shadlink.prc is for handheld devices running PalmOS 3.1 and up. I created two versions because certain functions, if made to work for PalmOS 3.0, increase the code size to 9K. The version that works only with PalmOS 3.1 and up is only 3K. So unless you have PalmOS 3.0, install the regular version and keep the size slim.

If you have Shadow 2.2.2 or up, you can enable 'Support ShadowLinkHack' under 'Append origin to ToDo note'. When this option is enabled, Shadow writes the record uniqueID to the origin stamp. With the uniqueID, ShadowLink can jump to the specific record. If the option is disabled or you have a pre 2.2.2 version of Shadow, then ShadowLink will jump to the list but place you at the first item.

Shadow 2.6 has a robust conduit that, unfortunately, breaks the origin stamp uniqueID after a sync. In such cases, ShadowLink will jump to the list at the first item. You can fix the origin stamps by re-saving the list. The easier way to do that is to tap Detail, OK, and exit the list.

 

HOW TO USE

- Install shadlink.prc to handheld.

- Activate ShadowLink by checking its checkbox in X-Master or whichever hack manager you use.

- The default way to Shadow Jump is to double-tap. If you want to use a single tap, configure ShadowLink through the hack manager.

- In Shadow Plan, enable 'Append origin to ToDo note' in Link Options

- If available, enable 'Support ShadowLink' under 'Append origin to ToDo note'

- If you have origin info enabled previously, you may choose to refresh your list by opening it and saving it. The quickiest way to do this is to open the list, pick an item, tap Detail, OK, and exit the list.

- To jump to the corresponding Shadow entry from a ToDo having the origin info, go into the ToDo note and, depending on your ShadowLink configuration, double-tap or single-tap the word '[Shadow:'

 

CAVEATS

- Do not use ']]]' as part of your list name. It is part of the Shadow origin stamp and ShadowLink keys off of it. You can use a single ']' or a double ']]', just not three or more ']' in a row.

- Do not use '>' in your list name

- ShadowLink does not support lists on expansion cards

- ShadowLink does not support ShadowPlan on an expansion card. This is a limitation of the PalmOS but some combination of handheld/PalmOS/launcher/VFS manager(e.g. PiDirectII) might allow ShadowLink to work.

- Because Shadow caches your work in RAM, new items will not (immediately) have the correct uniqueID in the origin stamp for ShadowLink to jump directly to the item. This is the case if you see '(0)' after '[[[Shadow:' in the origin info. In such cases ShadowLink will jump to the list but place you at the first item. You can refresh the correct uniqueID by saving the list, and thus force Shadow to write new items to the database, before establishing any ToDo links, or by saving the list twice, once to flush the new items to database, second to update the origin info with the valid info. Establishing ToDo links on existing items will not have this problem. If the '(0)' id becomes too prevalent, perhaps Jeff can move the order of things to always flush new items before writing the origin info.

- Since you can link multiple Shadow items to the same ToDo, the origin info will point to the last item that was modified, and thus ShadowLink will jump to that item.

- If you rename a list, you have to open & save to update the origin info. Otherwise the origin info still has the old list name and ShadowLink will not find the list to jump.

- If you delete the item in Shadow but leave the ToDo intact, even though the origin info looks good, ShadowLink will not jump.

- If your list is long, Shadow will most likely position the hi-lighted item off screen. After Shadow jumping, pressing the up scroll button will likely show the hi-lighted item. Expanding the list by '/K' might also bring the hi-lighted item into view. This is not a bug with ShadowLink.

 

TROUBLESHOOTING

- Is ShadowLink enabled in the hack manager (eg X-Master)?

- Is 'Append origin' & 'support ShadowLinkHack' enabled in Shadow?

- Is the unique id '(0)' in the origin info? If yes, open & save the list to refresh the origin info.

- Has the corresponding Shadow item been deleted? If the Shadow item is deleted, ShadowLink will not jump.

- If you have other hacks which also use double or single-tap, the order of enabling the hacks might help. Try disabling ShadowLink and those hacks and re-enabling ShadowLink first, then the other hacks.

VERSION HISTORY

Ver 1.2 (June 30th, 2002)
- Sped up code a wee bit
- Removed 'Reset ShadowLink' -- no longer needed

Ver 1.1 (June 12th, 2002)
- Fixed a bug where ShadowPlan is on an expansion card

Ver 1.0 (June 10th, 2002)
- first public release