Relations
(Genealogy program for a Newton device)
Version 2.3
(Shareware-$20 US; $25 Canadian)
March 1997

Written by Peter Mitchell
copyright 1995,1996 Mitchell System Designs
All Rights Reserved

Now available in English, German and Dutch. Thanks to Armin von Werner, Neu-Isenburg, Germany for the german translation. Thanks to C.R. van der Lee for the Dutch translation.

This release runs on Newton OS2.0 only. If you have Newton OS1.x look for my earlier release of Relations v1.2.

This document, as well as some screen shots and a link to download the latest version, can be accessed on the Web at <http://www.ccinet.ab.ca/pmitchell/Relations2.html>.

Contents

		What is Relations?
		How to Pay
		Contact Addresses
		Conversion from Relations v1.2
		Comments/Bug reports
		Problems
		Distribution
		Future Plans
		Disclaimer
		Release History


What is Relations?

Relations is a genealogy program for Newton devices. Enter and display families with all the relationships shown, or enter unrelated individuals as information is gathered. You can use a Newton device to gather family history information to be loaded, in GEDCOM format, into a desktop genealogy program. Relations can be used by itself, but there is limited reporting capabilities at this point.

This Relations release contains the following:

Relations23e.pkg - The main program where you enter and display your family tree.

RelationsUtility23e.pkg - A program that provides some utility functions as well as the GEDCOM import/export capability.

RelConvert11.pkg - A program to convert Relations data from version 1.2 to 2.3 format. This is only necessary if you have run Relations 1.2 and want to convert to Relations 2.3.

ReadMe-Relations - This file you are reading.

Documentation - Documentation on how the program works and the features that can be used.

ClarisWorks Settings-Relations - A communications settings document for ClarisWorks to use with Relations for import/export of GEDCOM data.

Microphone settings-Relations - A communications settings document for Microphone to use with Relations for import/export of GEDCOM data.

Mac Register Prog for Relations - A folder containing the Register program by Peter Lewis that can be run on a Macintosh to register Relations through the Kagi Shareware registration service.

Newton Register Prog for Reltns - A folder containing the Newton Register program and release documents by Flash Sheridan that can be run on your Newton device to register Relations through the Kagi Shareware registration service.


How to Pay

This version of the program, unregistered, is limited to adding 30 individuals. It can be used without any other restrictions. This should allow for enough use to decide if the program fits your needs and you want to pay the registration fee, or it allows for very basic use if you want to use it but not pay the registration.

If you like the program, and want to remove the limit, please pay the requested fee and I will send you a registration number that will remove this restriction. ($20 US; $25 Canadian) A printed manual will be available. If you would like this, along with a disk containing the most current version, please add the requested amount to cover materials and postage.

Disk, Manual and postage (North America: $5 US/Cdn; International: $8 US/$10 Cdn)

Payments can be sent directly to me by cheque (in US or Canadian funds) to the address listed in the next section, or through Kagi Shareware by cheque or credit card using e-mail or snail mail. To register through Kagi Shareware, follow the instructions for the Newton, Macintosh or PC registration program you decide to use.

Also available is the option to register through Kagi Shareware directly on-line at:
<http://order.kagi.com/?PB&S>


Contact Addresses

E-mail: <PMitchell@kagi.com> or <PMitchell@ccinet.ab.ca>

or

Peter Mitchell
Mitchell System Designs
9526 - 83 St.
Edmonton, Alberta, Canada, T6C 3A1


Conversion from Relations v1.2

To convert to Relations 2.1 first install and run RelConvert11.pkg. This program has a button to use to start the conversion process.

The conversion does the following:

- Deletes the old entry in the directory soup for Newton Connection Kit support.

- Reads the prefs entry for Relations, deletes it from the system soup, and then adds a new entry.

- Reads the old Relations entry with the list of place names and takes each entry from the array list and writes separate entries in a new soup - RelPlaces:MSDA. These entries have a record number, indexed, and the place name. Anywhere in Relations 2.0 that a place name is used, the record number is stored, not the place string. This will reduce the space requirements where a place name is used more than once.

- Reads the old Relations entry with the list of last names and takes each entry from the array list and writes separate entries in a new soup - RelNames:MSDA. This new soup is only used for quick entry of last names.

- Reads each individual and family entry and writes a new one in the new Relations 2.0 soup. All record numbers are left as is. New soup name is Relations:MSDA

- Deletes the old Relations soup.

- One other new soup will be created when needed. It is RelSources:MSDA and will hold source entries.


Comments/Bug reports

I'd like to hear from you if you have any comments, suggestions or bug reports. You can contact me by e-mail or snail mail through one of the addresses listed above.

This program is still in its early stages of development. I know there is a lot more that can be added and this will be directed in the most by the feedback I receive from users.


Problems

When linking to an existing individual there is no checking done to see if the link makes sense. For example, if you tap on a blank mother box for an individual, tap on link, and then choose someone that is actually the individuals child, there will not be a warning.

In Relations Utility, when creating an export file, the option to export only marked records is not implemented. If you choose this option no records will be added to the export file. It will only contain some header information. I will get this option added soon in a future release.

Note that not all fields from a GEDCOM file will be imported. The fields not used in Relations will be ignored.


Distribution

This application is Shareware. You may use and distribute copies of this application as long as this documentation is included as is, the application is not altered in any way, and you don't charge for it.


Future Plans

I am looking at changing the way reference/source notes are added to offer more flexibility in where they can be used.

I will look at other printing options as well as some new fields.

I will be finishing the option to mark records for export.

I will add a way to sort the children displayed for an individual.

And I will look at all requests that I receive, although I will not guarantee that all of these will be implemented.


Disclaimer

This application comes as is with no warranty, use at your own risk.


Release History

v2.3 (March 1997)
Added a dutch language version
Added the ability to move Relations data between storage card and internal
Changed so the word "unknown" was not displayed for the last name
Made some small changes for the MP 2000

v2.2 (November 1996)
Added a german language version
Added the surname to the list of names in the other spouses box
Added an option to display and optionally delete names from the Names list
Added an option to display the Places list
Made some changes that reduce the heap used after closing Relations
Added an option for Overview on the Show button
Added alpha tabs for quick movement in the overview screen
Fixed a bug that caused an error message instead of info message when 30 record limit met
Removed an unused option from the preferences screen
Fixed bug in Relations Utility that occurred when deleting an import/export file on card
Removed display of registration number in the about screen
Added credits info in about box for german translation

v2.1 (October 1996)
A complete rewrite for Newton OS2.0

v1.2 (February 1996)
01/25/96	Added option to Relations Utility to remove all individual and family records.
01/25/96	Added import/export of GEDCOM file format to Relations Utility program.
01/27/96	Fixed -48204 error on startup. Caused if there was a family record but no individual records.
02/01/96	Removed the requirement that both parents had to be entered before allowing a child to be added.
02/03/96	Fixed bug in display of children/spouse names that caused name to wrap to second line. (problem on 1.x)

v1.1 (December 1995)
11/18/95	Changed so the sex of a new individual defaults according to entry being made.
11/24/95	Fixed bug so that the child will now display if only a mother or father is added. (The child was the Individual when the mother or father box was tapped.)
11/24/95	Fixed a bug that appeared if the children list was scrolled and one of the children was selected and the new children list was empty or only one or two entries.
11/25/95	Added support for local and global find.
11/25/95	Fixed so that if a record is not found a message will be displayed and the first person on file will be displayed instead.
11/30/95	Added an "Initializing Relations..." message at startup.
11/30/95	Added a de-install option to remove Relations data and system entries.
12/01/95	Added removal of pointers to an individual when they are deleted.
12/06/95	Added ability to fix/change mother and father record pointers in Relations Utility package.

Tested on an MP 120 with OS2.0 without any problems.

v1.0b2 (November 1995)
Added a default entry button
Added name/place "choosers" for quick entry of values matching previous entries
Added Options button to review name/place lists
Changed labels on appropriate fields to open name/place "choosers"
This release also includes a small package named RelationsUpd.pkg. Use this package to create the name and place lists
if you have used a previous version of Relations. This package will add two records to your Relations file that contain
all last names entered and all places entered which can be used to speed new entries.

v1.0b (October 1995)
Initial release