🎉 Initial commit

.gitignore

@@ -0,0 +1 @@
+*.prc

BUGS

@@ -0,0 +1,8 @@
+o Now and again the active timers in TikTok appear to "stop". I've
+  found that coming out of and going back into TikTok will start
+  them up again (no time is lost). It looks like the Pilot OS has
+  stopped sending nilEvent events to the application for some reason.
+
+o Sometimes, when using the menu shortcuts, the interface can get into
+  a bit of a mess (this is really only a problem for the timer that is
+  at the bottom).

CREDITS

@@ -0,0 +1,43 @@
+Thanks go to the following people who have mailed bug reports and
+suggestions or have submitted code during the development of TikTok:
+
+o Andrew Robertson <Andrew_Robertson@compuserve.com>
+
+  Alerted me to my terrible abuse of my native language in the tips
+  screen.
+
+o Jim Aspnes <aspnes@cs.yale.edu>
+
+  Submitted a patch to allow countdown timers with alarms. This patch
+  formed the basis of the countdown ability of v1.02. Also gave lots
+  of support and ideas when I was getting stuck with bits and bobs.
+
+o Iain Barclay <isb@pobox.com>
+
+  Help and ideas and was good enough to read and reply to my mail
+  while I was attempting to get my head around various bits of Pilot
+  coding. He also runs the excellent RoadCoders web site (check it
+  out at http://www.roadcoders.com/) and is the author of the (IMHO) 
+  #1 timer application, BugMe!
+
+o J. Y. Mantinband <yosh@netvision.net>
+
+  Thanks for sticking with 1.05 and testing each release above and
+  beyound the call of duty.
+
+o Andrew Ball <aball@icis.on.ca>
+
+  For helping me work out if the menu-death-bug was a problem with the
+  compiler and for patching TikTok to work with 0.5.0. Andy is also
+  the author of the excellent Chronos, if you want a serious stopwatch,
+  clock and countdown timer you should check out Chronos.
+
+o Holger Klawitter <holger@math.uni-muenster.de>
+
+  For the clock display suggestion.
+
+o Kadar Tanuwidjaja <ktan8@dgs.monash.edu.au>
+
+  For a patch that added the "timer memory" and "halting alarms"
+  features.
+

Changes

@@ -0,0 +1,78 @@
+Changes in v1.07
+================
+
+o Fixed a bug in RaiseAlarm() that caused a FE if the timer that was
+  kicking in had an empty description.
+
+o You can now tell TikTok that you want timers to stop counting when
+  they are acting as an alarm and they go off. See the options dialog
+  for the setting (thanks to Kadar Tanuwidjaja <ktan8@dgs.monash.edu.au>
+  for the patch that this change is based on).
+
+o You can now tell TikTok to use a timers last starting time when you
+  tick it on a second time. See the options dialog for the setting
+  (thanks to Kadar Tanuwidjaja <ktan8@dgs.monash.edu.au> for the patch
+  that this change is based on).
+
+Changes in v1.06
+================
+
+o Minor tweaks to the prefs structures to reduce the memory needed to
+  hold the timer details.
+
+o Improved the look of the interface (thanks to J. Y. Mantinband
+  <yosh@netvision.net> for the suggestions).
+
+o Added "zero timer" options to the Clear menu.
+
+o Added a "quick alarms" menu.
+
+o Added an extra config option that lets you tell TikTok that you
+  don't want to be asked silly questions when you say you want to
+  clear/zero all timers.
+
+o Added an optional clock display (thanks to Holger Klawitter
+  <holger@math.uni-muenster.de> for the suggestion).
+
+Changes in v1.05
+================
+
+o PilotMain() now returns sysErrParamErr if the cmd is not known or used
+  by TikTok (source: <syK3zYbo8GA.74@darrin2.massena.com> in
+  pilot.programmer.gcc on news.massena.com).
+
+o Many tweaks to the code to try and kill the menu-death-bug.
+
+o Moved to GCC 0.5.0. It appears that 0.4.0 was the cause of the
+  menu-death-bug.
+
+Changes in v1.04
+================
+
+o Removed the input filter on the time fields. Next time I'll think
+  things thru a lot better before I add something like this. :-)
+
+Changes in v1.03
+================
+
+o Corrected a couple of minor bugs which shouldn't have been user
+  visible but were bad coding.
+
+o When writing in the "time" field, all characters that are not
+  "0-9:." are ignored.
+
+Changes in v1.02
+================
+
+o Corrected a couple of spelling mistakes.
+
+o All time fields are now editable.
+
+o If a user enters a negative value in a time field it is considered to
+  be a countdown timer and will trip an alarm when it hits 0.
+
+o Added options form that allows you to specify if alarms should just
+  be audible or visible as well.
+
+o You can now use the Pilot's up/down keys to start and stop a timer 
+  (both keys work the same, they toggle the currently focused timer).

FAQ

@@ -0,0 +1,41 @@
+TikTok FAQ:
+
+1. Is there any chance of adding feature X?
+
+   Possibly. Mail me with your suggestion and I'll consider it. I can't
+   guarantee that I'll add it, but, if I like it, if it can be done and
+   if I can do it and it makes sense for TikTok I'll probably add it.
+
+   Failing that, you have the source code.... :-)
+
+2. Can I register TikTok?
+
+   No, TikTok is free software, read the file COPYING for full details.
+   However, if you do feel the need to send someone some money why not
+   consider making a donation to the Free Software Foundation? Pop over
+   to http://www.fsf.org/ to find out about them.
+
+3. Can I modify and distribute my own version of TikTok?
+
+   Read the file COPYING for a full answer to this question.
+
+4. Alarms appear to kick in up to 60 seconds late!
+
+   This is a known "problem" with the Pilot. If your Pilot is turned
+   on an alarm should fire right on time. However, if your Pilot is
+   turned off an alarm can kick in up to 60 seconds late. From what
+   I've seen most software that uses alarms suffers from this. I'm
+   afraid there is nothing I can do about this, it appears to be the
+   way the Pilot works.
+
+5. Why can't I time things down to 100th of a second?
+
+   Because TikTok is not designed to do that. It's designed to be
+   a simple, pretty accurate, stopwatch utility. I'd not advise that
+   you time any critical event. I wrote TikTok to time things where
+   a couple of seconds here and there don't matter (that's not to say
+   that TikTok is that sloppy).
+
+   If you want a stopwatch that can go down to 100th of a second I'd
+   suggest you take a look at Chronos (check your local Pilot software
+   library for full details).

Makefile

@@ -0,0 +1,55 @@
+SHELL = bash
+OBJS = tiktok.o
+
+CC = m68k-palmos-coff-gcc
+
+CSFLAGS = -O2 -S
+CFLAGS = -O2 -g
+
+PILRC = pilrc
+TXT2BITM = txt2bitm
+OBJRES = m68k-palmos-coff-obj-res
+BUILDPRC = build-prc
+
+ICONTEXT = 'TikTok'
+APPID = DAP2
+
+all: tiktok.prc
+
+.S.o:
+	$(CC) $(TARGETFLAGS) -c $<
+
+.c.s:
+	$(CC) $(CSFLAGS) $<
+
+tiktok.prc: code0000.tiktok.bin code0001.tiktok.bin data0000.tiktok.bin bin.res
+	$(BUILDPRC) tiktok.prc $(ICONTEXT) $(APPID) code0001.tiktok.grc code0000.tiktok.grc data0000.tiktok.grc *.bin pref0000.tiktok.grc
+
+code0000.tiktok.bin: tiktok
+	$(OBJRES) tiktok
+
+code0001.tiktok.bin: code0000.tiktok.bin
+
+data0000.tiktok.bin: code0000.tiktok.bin
+
+bin.res: tiktok.rcp
+	$(PILRC) tiktok.rcp .
+	$(TXT2BITM) tiktok.pbitm
+	touch bin.res
+
+tiktok: $(OBJS)
+	$(CC) $(CFLAGS) $(OBJS) -o tiktok
+
+cleanish:
+	rm -rf *.[oa] tiktok *.bin bin.res *~ *.grc *.BAK *.bak *.log
+
+clean: cleanish
+	rm -rf *.prc
+
+dist: all cleanish
+	rm -f ../tiktok.zip
+	( cd ../; zip tiktok "tiktok/*" "tiktok/doc/*" )
+
+devdist: all cleanish
+	rm -f ../tiktok.zip
+	( cd ../; zip -r tiktok "tiktok/*" )

README

@@ -0,0 +1,47 @@
+Welcome to TikTok.
+
+TikTok is designed to be a simple, no nonsense, timer utility. Using
+it is dead simple. Tick on a tickbox to start a timer, edit it's
+description to tell you what it is you are timing. Simple! There are a
+couple of other features, tap on the (I) icon for full help.
+
+The application ID 'DAP2' is registered with USR. If you intend to
+make changes and release your own free version based on this code
+please make sure you change the application ID.
+
+Please note that I'm releasing TikTok as free software, licensed under
+the GPL. Be sure to read the file COPYING for full details.
+
+If you have any feedback or comments (or bugs) please feel free to
+mail them to tiktok@hagbard.demon.co.uk (please use this address
+instead of my personal address as this helps me in sorting my mail and
+it will result in you getting a better response). Before you do mail
+me with any questions and/or bugs, please read the FAQ file first,
+your question may already have been answered.
+
+Also, if you would like to join in on discussions about TikTok with
+other TikTok users you may want to join the tiktok-users mailing
+list. To join the list send a message to:
+
+	majordomo@hagbard.demon.co.uk
+
+and in the body of the message (NOTE, that's the body of the message,
+NOT the subject) type:
+
+	subscribe tiktok-users
+
+The list gets pretty much 0 traffic, but I do use it to announce new
+versions and the like. So, don't worry, it won't flood your mailbox.
+
+The latest version of TikTok will always be available from:
+
+        http://www.acemake.com/hagbard/
+or
+        http://www.hagbard.demon.co.uk/
+
+If you are upgrading from an earlier version of TikTok you can find
+out what has changed by reading the Changes file.
+
+Have fun.
+Dave Pearson <davep@hagbard.demon.co.uk>
+(TikTok feedback to tiktok@hagbard.demon.co.uk please)

TODO

@@ -0,0 +1,21 @@
+Here are some of the things, in no special order, that I intend to get
+round to doing at some time in the near future.
+
+o Flexible config per timer.
+
+o Nicer looking interface?
+
+o A better icon (any artists out there want to do one?).
+
+o Make the quick alarms menu configurable.
+
+o Add some patches for extra features that I've been sent (apologies to
+  those who have, I'm a little short on time at the moment).
+
+o Documentation.
+
+o Documentation.
+
+o Documentation.
+
+o <YourSuggestionHere>

runme040.bat

@@ -0,0 +1,5 @@
+  @Echo Off
+  Set Path=C:\WINDOWS\COMMAND;C:\DAVE\BIN;C:\BATCH;C:\GENERAL\UTIL;C:\WINDOWS;C:\4DOS;C:\DAVE\SCRIPTS;D:\EMACS\EMACS-20.2\BIN
+  PATH=d:\cygnus\H-i386-cygwin32\bin;%PATH%
+  Set GCC_EXEC_PREFIX=//d/cygnus/H-i386-cygwin32/lib/gcc-lib/
+  echo Environment now set

runme050.bat

@@ -0,0 +1,5 @@
+  @Echo Off
+  Set Path=C:\WINDOWS\COMMAND;C:\DAVE\BIN;C:\BATCH;C:\GENERAL\UTIL;C:\WINDOWS;C:\4DOS;C:\DAVE\SCRIPTS;D:\EMACS\EMACS-20.2\BIN
+  PATH=d:\ppgcc\bin;%PATH%
+  Set GCC_EXEC_PREFIX=//d/ppgcc/lib/gcc-lib/
+  echo Environment now set