This page is a work-in-progress description of how to get Wikit running on a PocketPC (using the Tk interface).

Why would you want to do this?  Well I like it because it means that I no longer have to use a notebook (i.e. pen and paper) at all.  I take all my notes in Wikit, either on the PocketPC or laptop, and synchronise the two databases (a script to be provided later :-)).

The description below assumes some familiarity with Tcl...

My suggested steps are:

   * Get Wikit running on one of the more conventional platforms first, e.g. Windows.  See [Wikit] and http://www.equi4.com/wikit.

   * Get Tcl 8.4.4 running on the PocketPC.  See [Windows/CE] and [iPAQ].

   * Install [MetaKit] (Mk4Tcl) as a package on the [PocketPC].  Thanks to [jcw] this can be downloaded from [http://www.equi4.com/pub/mk/mk-2.4.9.2-wince/Mk4tcl.dll].

   * Unpack the source code from wikit.kit and copy it to the PocketPC.  See [TclKit], [Starkit], [http://www.equi4.com/starkit/] and [http://www.equi4.com/188].

   * Replace gui.tcl in the wikit library with [gui.tcl for Wikit on PocketPC].

   * Modify main.tcl to not use Starkit or VFS, and set auto_path appropriately (see below).

This is from memory, so I will be looking for some verification once this page has sufficient detail.

I think this is enough to get it working now.  All feedback appreciated.

'''Known Issues:'''

   * wikit.tkd always seems to be created in the root directory (\).  I haven't looked into this yet.
   * The screen dimensions are based on an iPAQ 5450 and hardcoded in gui.tcl.
   * There are a number of limitations with the PocketPC Tcl port, see [Known bugs in CE ports].
   * When scrolling, Tcl seems to display a blank selected area occasionally.  I assume this is a problem with the PocketPC port, but haven't been able to narrow the conditions down sufficiently.

Many thanks to:

   * Jeffrey Hobbs for making the 8.4.4 port available on the PocketPC.
   * Jean-Claude Wippler for making Mk4tcl available on the PocketPC.
   * Everyone who contributed to Tcl, MetaKit and Wikit.

[AKG]
----
Modified main.tcl (modify auto_path to point to the actual directory):

 lappend auto_path /Tcl/samples/wikitce/lib
 
 if 0 {
     namespace eval tkcon {}
     set tkcon::PRIV(showOnStartup) 0
     ## set tkcon::PRIV(root) ./tkcon.cfg
     set tkcon::OPT(exec) ""
     source tkcon.tcl
 
     #tkcon show
     bind . <Control-c> {
         if {[winfo exists .tkcon] && 
 	[winfo ismapped .tkcon]} {
 	    tkcon hide
         } else {
 	    tkcon show
 	    wm geometry . 230x200+0+5
 	    wm geometry .tkcon 44x18+0+0
         }
     }
 }
 
 package require Mk4tcl
 package require app-wikit
----
This looks great!!!! Just waiting on the rest of the instructions. [MPJ]

[AKG] Hopefully there is enough to get going now.  Still plenty of room for improvement :-).