version 0.92

BUGS

@@ -1,22 +1,21 @@
+If you wish to report a bug, and the bug is reproduceable it may be helpful to
+me if you run jpilot -d to run in debug mode, reproduce the error and then
+send me the log file from ~/.jpilot/jpilot.log
+
+----------------------------------------------------------------------
+
+These are the bugs that I know about:
+
 *Priority High:
 
 *Priority Medium:
 
 *Priority Low:
 
  - Things don't work quite right if you've never synced before.
-
- - It seems like the sync doesn't always work with xcopilot.
- If xcopilot hasn't been run in a while and you don't set the date on it, it
- seems to not update the datebase modification times correctly.  On every sync
- it would not bring back the palm database because the modification time
- hadn't changed.  pilot-xfer behaves the same way.
- I set the time on xcopilot and then could not reproduce this problem again.
+ - I'll probably fix this some day.
 
 *Priority Who Cares?:
- - If you click really fast on the buttons to scroll through the months, then
- it will segmentation fault.
- I think I have fixed this though.
 
 *Quirks (not really bugs):
 

CHANGELOG

@@ -1,6 +1,7 @@
 0.90a - 06/23/99
  Initial release.
-0.91 - 
+
+0.91 - 07/03/99
  Fixed some feof() problem that caused datebook to not work on RedHat 6.0
  I rewrote the entire datebook.c file
  Put in code to create and test for writability of ~/.jpilot/
@@ -18,3 +19,20 @@
   4th occurence of that day in the a month, or the last occurence of that day
   in the month.  This is only asked when it cannot be deduced.
   The Palm Pilot will also ask this question.
+ Fixed Mobile not being displayed in address app.
+
+0.92 - 00/00/99
+ Fixed problem reading palm db files with 0 records.
+ Added option for viewing only uncompleted todos.
+ Fixed a GUI problem when adding an address the phone menus didn't update
+  right while selecting addresses on the left pane.
+ Added a window to show the syncing output.
+ Added a full backup button.
+ Added forking of a process to do the sync in the background.
+ Fixed category label in todo, address, and memo apps.
+ Added modify capability in datebook, address, todo, and memo apps.
+ Added the ability to check/uncheck todos.
+ When deleteing repeating appointments it will now ask if you intend to delete
+  just one occurence, or all occurences.
+ Added some tooltips to show how many records are in a DB.
+

INSTALL

@@ -1,17 +1,28 @@
-you need to have gtk1.2 or better (I haven't tried anything older)
+You need to have gtk1.2 or better.
 gtk requires glib.
 you can get these at http://www.gtk.org
 
 pilot link must be installed and working.
 ftp://ryeham.ee.ryerson.ca/pub/PalmOS/
+RedHat users must also have the pilot-link-dev rpm installed for the header
+ files.
 
 jpilot currently uses the PILOTPORT and PILOTRATE environment variables, as
 does pilot-link.
 
 
-edit the first few lines of Makefile
+edit the first few lines of Makefile if neccessary.
 make
 mkdir ~/.jpilot/
-cp jpilotrc ~/.jpilot/
-jpilot
-you may want to sync before you do anything
+cp jpilotrc ~/.jpilot/ (or you can do a cp jpilotrc.blue ~/.jpilot/jpilotrc
+ if you like blue better)
+./jpilot
+Put the executable in /usr/local/bin, or somewhere.
+
+
+Currently, you have to sync before the program will behave correctly.
+JPilot was written in such a way that it should be very safe to sync.
+I have had no reports of data being corrupted, or lost.  There is always
+that possibility though.  As with anything else, backup your data if you
+cannot afford to lose it.  Just make sure your backup software destroy it
+first ;)

Makefile

@@ -2,51 +2,55 @@
 PILOT_DIR=/usr/extra/pilot
 #set CC to your compiler
 CC = gcc
+OPTIONS = -Wunused -Wuninitialized -O3
 #you should be all done
 PILOT_LIB = -L$(PILOT_DIR)/lib -lpisock
 PILOT_INCLUDE = -I$(PILOT_DIR)/include
 
-all: jpilot jpilot-syncd
+all: jpilot
 
 jpilot: jpilot.o datebook.o address.o todo.o memo.o \
 	datebook_gui.o address_gui.o todo_gui.o memo_gui.o \
-	utils.o sync.o
-	$(CC) $(PILOT_LIB) `gtk-config --cflags` `gtk-config --libs` \
-	jpilot.o datebook.o address.o todo.o memo.o utils.o sync.o \
+	utils.o sync.o log.o
+	$(CC) $(OPTIONS) $(PILOT_LIB) `gtk-config --cflags` `gtk-config --libs` \
+	jpilot.o datebook.o address.o todo.o memo.o utils.o sync.o log.o \
 	datebook_gui.o address_gui.o todo_gui.o memo_gui.o -o jpilot
 
-jpilot.o: jpilot.c datebook.h utils.h utils.o
-	$(CC) $(PILOT_INCLUDE) `gtk-config --cflags` -c jpilot.c
+jpilot.o: jpilot.c utils.h
+	$(CC) $(OPTIONS) $(PILOT_INCLUDE) `gtk-config --cflags` -c jpilot.c
 
 datebook.o: datebook.c datebook.h utils.h
-	$(CC) $(PILOT_INCLUDE) `gtk-config --cflags` -c datebook.c
+	$(CC) $(OPTIONS) $(PILOT_INCLUDE) `gtk-config --cflags` -c datebook.c
 
 address.o: address.c address.h utils.h
-	$(CC) $(PILOT_INCLUDE) `gtk-config --cflags` -c address.c
+	$(CC) $(OPTIONS) $(PILOT_INCLUDE) `gtk-config --cflags` -c address.c
 
 todo.o: todo.c todo.h utils.h
-	$(CC) $(PILOT_INCLUDE) `gtk-config --cflags` -c todo.c
+	$(CC) $(OPTIONS) $(PILOT_INCLUDE) `gtk-config --cflags` -c todo.c
 
 memo.o: memo.c utils.h
-	$(CC) $(PILOT_INCLUDE) `gtk-config --cflags` -c memo.c
+	$(CC) $(OPTIONS) $(PILOT_INCLUDE) `gtk-config --cflags` -c memo.c
 
 datebook_gui.o: datebook_gui.c utils.h
-	$(CC) $(PILOT_INCLUDE) `gtk-config --cflags` -c datebook_gui.c
+	$(CC) $(OPTIONS) $(PILOT_INCLUDE) `gtk-config --cflags` -c datebook_gui.c
 
 address_gui.o: address_gui.c address.o
-	$(CC) $(PILOT_INCLUDE) `gtk-config --cflags` -c address_gui.c
+	$(CC) $(OPTIONS) $(PILOT_INCLUDE) `gtk-config --cflags` -c address_gui.c
 
 todo_gui.o: todo_gui.c todo.o utils.h
-	$(CC) $(PILOT_INCLUDE) `gtk-config --cflags` -c todo_gui.c
+	$(CC) $(OPTIONS) $(PILOT_INCLUDE) `gtk-config --cflags` -c todo_gui.c
 
 memo_gui.o: memo_gui.c utils.h
-	$(CC) $(PILOT_INCLUDE) `gtk-config --cflags` -c memo_gui.c
+	$(CC) $(OPTIONS) $(PILOT_INCLUDE) `gtk-config --cflags` -c memo_gui.c
 
 utils.o: utils.c utils.h
-	$(CC) $(PILOT_INCLUDE) `gtk-config --cflags` -c utils.c
+	$(CC) $(OPTIONS) $(PILOT_INCLUDE) `gtk-config --cflags` -c utils.c
 
 sync.o: sync.c sync.h
-	$(CC) $(PILOT_INCLUDE) `gtk-config --cflags` -c sync.c
+	$(CC) $(OPTIONS) $(PILOT_INCLUDE) `gtk-config --cflags` -c sync.c
+
+log.o: log.c log.h
+	$(CC) $(OPTIONS) $(PILOT_INCLUDE) `gtk-config --cflags` -c log.c
 
 clean: 
 	rm -f *.o *~
@@ -57,26 +61,26 @@ clean:
 # Pilot needs to be pressed.
 #
 jpilot-syncd: jpilot-syncd.o sync.o
-	$(CC) $(PILOT_LIB) `gtk-config --cflags` `gtk-config --libs` \
+	$(CC) $(OPTIONS) $(PILOT_LIB) `gtk-config --cflags` `gtk-config --libs` \
 	jpilot-syncd.o sync.o utils.o -o jpilot-syncd
 
 jpilot-syncd.o: jpilot-syncd.c utils.h utils.o
-	$(CC) $(PILOT_INCLUDE) `gtk-config --cflags` -c jpilot-syncd.c
+	$(CC) $(OPTIONS) $(PILOT_INCLUDE) `gtk-config --cflags` -c jpilot-syncd.c
 
 #
 #Some other stuff
 #
 ttt: ttt.c
-	$(CC) `gtk-config --cflags` `gtk-config --libs` ttt.c -o ttt
+	$(CC) $(OPTIONS) `gtk-config --cflags` `gtk-config --libs` ttt.c -o ttt
 
 dump_datebook: dump_datebook.c 
-	$(CC) $(PILOT_LIB) $(PILOT_INCLUDE) dump_datebook.c -o dump_datebook
+	$(CC) $(OPTIONS) $(PILOT_LIB) $(PILOT_INCLUDE) dump_datebook.c -o dump_datebook
 
 dump_address: dump_address.c 
-	$(CC) $(PILOT_LIB) $(PILOT_INCLUDE) utils.o dump_address.c -o dump_address
+	$(CC) $(OPTIONS) $(PILOT_LIB) $(PILOT_INCLUDE) utils.o dump_address.c -o dump_address
 
 dump_todo: dump_todo.c 
-	$(CC) $(PILOT_LIB) $(PILOT_INCLUDE) utils.o dump_todo.c -o dump_todo
+	$(CC) $(OPTIONS) $(PILOT_LIB) $(PILOT_INCLUDE) utils.o dump_todo.c -o dump_todo
 
 install-datebook: install-datebook.c 
-	$(CC) $(INCLUDES) $(PILOT_LIB) install-datebook.c -o install-datebook
+	$(CC) $(OPTIONS) $(INCLUDES) $(PILOT_LIB) install-datebook.c -o install-datebook

README

@@ -5,17 +5,22 @@ It is very useable, but still has many planned updates to make it better.
 
 If you like it feel to send me donations ;)
 I collect coins from anywhere, anytime also.
-email me and I'll send you my address.
-
-If you use this program send me an email and let me know.  I'd like to know
+At least send me an email and let me know you are using it.  I'd like to know
 how many people this is useful to.
 
+Judd Montgomery
+P.O. Box 665
+Sunbury, OH 43074
+
+
 jpilot reads the PILOTPORT environment variable to get the port to sync on.
-If this is not set, then it defaults to /dev/pilot.
+If this is not set, then it defaults to /dev/pilot.  It also reads PILOTRATE
+to get the serial port rate.
 
 jpilot-syncd is a syncing daemon for jpilot.  It just sits and waits for the
 Sync button to be pressed on the Palm pilot and then it syncs it.  This is
-just an optional program.  It is not necessary.
+just an optional program.  It is not necessary.  I removed this in 0.92,
+I'll probably put it back.
 
 COLORS:
 
@@ -24,10 +29,16 @@ screens.  If you create your own cool jpilotrc files feel free to send them
 back to me and if I like it, I'll include it in the release.  I'll probably
 make a few selectable with a pull-down menu.
 
-MODIFYING RECORDS:
+HOME:
+
+jpilot uses the HOME environment variable to make it easy to allow multiple
+pilots to be synced under the same user.  Just set HOME to the directory
+you want jpilot to use.
+
+OOPS, REVERTING:
 
-Even though you can't modify records at the moment, the GUI is set up to
-make it easy to do.  Just click the add line in the left screen, then select
-the record that you would like to modify, and it will come up.  Make the
-changes and add it.  Then you can delete the old one.  This is what modify
-will eventually do for you.
+You can always make the databases revert back to the last time that the
+pilot was synced.  All you have to do is "rm ~/.jpilot/*.pc".
+Deleted records will come back, etc.  Nothing is permanent until the
+sync/backup.  You can do this if you make a mistake, or just to play around 
+with jpilot and then delete the changed records without syncing them.

TODO

@@ -1,23 +1,15 @@
-These are some of the things on my list todo, not neccesarily in this order:
+These are some of the things on my list todo, mostly, but not neccesarily
+in this order:
 
-
-* fix category label in todo, adress, and memo apps
-* fix return codes, they are a mess.
+* Add in search functions
+* Printing
+* Make preferences and rc files to remember settings.
 * Use autoconf to generate a configure script since they are so cool.
-* Add in file locking, right now if you run 2 jpilots as the same user
-  then you may have DB file problems. (who cares?)
+* Put in a menubar if needed.
 * Put up a graph showing the days schedual.
-* Make the datebook ask if an event is supposed to be in the 4th week,
-  or if last week of the month.
 * Hide, or Show private records.
-* Let records be modified instead of just removed, or added.
 * Do a fast sync, user choice of fast, or slow.
   (A slow sync allows another PC to do the archiving)
-* Make the slow sync faster.
-* Archive "to be archived" records?
-* allow multiple pilots to sync in separate directories??
-* Add in search functions
-* Printing
-* Make the output go into a window instead of stdout.
-* Put in gtk hints.
-* Put in a menubar if needed.
+* Add in file locking, right now if you run 2 jpilots as the same user
+  then you may have DB file problems. (who cares?)
+* fix return codes, and clean up the code, it is a little messy.