README for Claris_to_BeMail v1.0.1 21 Jan 1999

Bug addressed, feature added

Version 1.0.1 fixes a crashing bug I encountered which caused confusion when a message contained something that might look like the beginning of a line in the header, but wasn't.  Specifically, I had written a message to a friend in which I discussed a problem I'd had parsing a "From:" header line in another e-mail application I was working on.  Claris_to_BeMail now ensures that a key word occurs at the beginning of a line before treating it as a component of a message's header.  (It will still be fooled by a message that contains, for instance, "Subject:" at the beginning of a line in the message body, but I don't know how to determine the size of a message header without first finding all of the lines in the header, so I don't have a fix for this problem.)

Version 1.0.1 also adds the feature of checking the type of each file selected for conversion; anything other than an incoming (application/x-MacOS-FCIM) or outgoing (application/x-MacOS-FCOM) Claris Emailer file is ignored.

Claris_to_BeMail v1.0 11 Jan 1999

Claris_to_BeMail, when run on a Macintosh, can read Claris E-Mailer Lite e-mail files from an HFS partition and convert them to BeMail e-mail files on a BeFS partition.

Claris_to_BeMail is intended only for use on a Power Macintosh with the Mac OS (using an HFS partition) and BeOS Release 3.2 both installed.

Installation / Removal:  Not really, you can just run it from anywhere. / It doesn't save any preferences, so there's no trick to removing it, either.

Running Claris_to_BeMail:
1) Mount your Mac OS HFS partition that contains your Claris folders.  (My Mac disk is named "S900", so my Claris folders are at "/S900/Internet Connection Kit/Internet Applications/Claris EMailer Folder/Claris Emailer Files/Filing Cabinet/Personal Folders").  Yours will probably be on a similar path, but your disk's name may very well be different.  If it is, you may want to change line 380 of App.cpp to have the name of your Mac disk rather than "S900" in it, and then remake the Claris_to_BeMail binary.

2) Start Claris_to_BeMail either by double-clicking on it or by dragging one or more Claris e-mail files onto its icon and dropping it/them.

If you double-clicked the icon, the program will open a BFilePanel window titled "Choose Claris E-Mail Message To Convert to BeMail File".  Its initial directory will be your Claris "Personal Folders" folder if your Mac disk name is "S900" or you have changed line 380 of App.cpp to have the name of your Mac disk in it.  Otherwise, its initial directory will be /boot/home, and you will have to navigate to the folder that contains the Claris e-mail file(s) that you want to be converted to BeMail files.  Select one or more files, then click on the "OPEN" button.  Claris_to_BeMail will then hide this window.

Next Claris_to_BeMail will open a BFilePanel window titled "Choose Destination Directory".  Its initial directory will be /boot/home/mail.  You may very likely then want to use "New Folder" under the "File" menu to create a new folder to hold the e-mail files that are about to be converted.  Note that this BFilePanel uses a BRefFilter that restricts your choices only to directories.  Because its "node_flavor" is B_DIRECTORY_NODE (See the Be Book on BFilePanel for more detail), when you click "OPEN" with a directory selected, it doesn't open the directory -- instead it passes an entry_ref for the directory to the program.  If you actually want to select a directory and then open it to see what's inside, you'll have to double-click the directory's icon.

If you choose the "CANCEL" button on either BFilePanel window, or just close either BFilePanel window without selecting anything, Claris_to_BeMail will stop without doing any conversions.

Enclosures:
I had forgotten about this, but I've had Claris set to decode all enclosures for the last couple of years, so I wrote Claris_to_BeMail to find any enclosures for a message in my Downloads folder and re-encode them (Base64) and incorporate them in the corresponding BeMail file.

Also, I've written Claris_to_BeMail to distinguish only enclosed .zip files, and treated everything else that might be enclosed in a message as text/plain.

If your Claris set-up is different or you've got some .tgz files enclosed in Claris messages, and you need Claris_to_BeMail to work differently, either contact me at jrashmun@halcyon.com, and I'll try to accomodate you, or, better yet, make the changes yourself and send me your new version.

License:
This program is freeware, but I would appreciate hearing from anyone who uses it.  Write to jrashmun@halcyon.com
