Dawn
E-Mail address manager for Windows 95 
http://www.voicenet.com/~zakharin/software/Dawn4b1win.html
If you are reading this file offline, you can get a version with working 
hyperlinks at the above address.



Version 4.0 beta 1, April 15-20 1998
0. Table of contents   
    0. Table of contents 
    1. What this program does 
    2. Origins of this program 
    3. How to use this program
        3.1. Requirements 
        3.2. Installation 
        3.3. Starting the program 
        3.4. What to do after starting the program
            3.4.1. Converting addresses
                3.4.1.1. Regular Convert 
                3.4.1.2. Netscape to PIM 
                3.4.1.3. Extraction 
            3.4.2. The edit mode 
            3.4.3. Menus
                3.4.3.1. File Menu 
                3.4.3.2. Edit Menu 
                3.4.3.3. View Menu 
                3.4.3.4. Help Menu 
            3.4.4. Quitting the program 
        3.5. How to get the converted file into Netscape, Internet Explorer, or 
        Juno
            3.5.1 - 3.5.9. Steps to the above 
        3.6. How to get Netscape, MSIE, and Juno addressbook addresses into Dawn 
        
        3.7. Preferences - Sorry, no preferences at present 
        3.8. Sorting addresses 
    4. What's New 
    5. Known problems, bugs, and limitations
        5.1. Error Messages 
    6. Upcoming features 
    7. Other services by me
        7.1. QLML 
        7.2. Programs by me 
    8. Terms of this software 
1. What This Program Does: 
This program acts as a universal translator (no trademark infringement intended) 
between various programs and their addressbooks in particular. This version is 
even equipped with a last resort extraction feature. It can also sort adresses 
by E-Mail address or by Nickname. In short, it's an E-Mail address manager 
This version of Dawn, 4.0, that is, is designed to work with Netscape 
Communicator version 4.x, Netscape Navigator 3.x in Windows 95 and possibly NT, 
Microsft Internet Explorer 4.x (and possibly lower), Juno (any version to my 
knowledge), and most hendheld PIM's that have access to a PC. 
2. Origins of this program: 
The idea for this program was conceived in winter of 1996. The first beta of 
Nacwonaf, as it was then called, came out in March. 1.0 never found its way to 
the final version. The idea of calling it Dawn came with growth of this program. 
Now that this program will not just be for Netscape and not just convert 
addresses, it needed a new name. I have this E-Mail address manager named Dawn 
E. Underwood. Perfect, I thought! With his permission, Dawn 3.0 was born. With 
the development of 4.0, Dawn UNIX also began its existance.
3. How to Use This Program 
I tried to make usage of this program as easy as possible. Nevertheless, I 
recommend you read these notes. 
3.1. System Requirements 
    Windows 95 (may work in NT as well) 
    Whatever the requirements are for any browser and/or mail software you plan 
    to use 
    Netscape Communicator 4.x (nonbeta) or Navigator 3.x and or MS Internet 
    Explorer 4.x (may work with other versions as well) and or Juno 
    Around 5.8 MB additional disk space to download (the actual file is only 
    1.62 MB) 
    VB40032.DLL and MSVBVM50.DLL (see blow for their location) for full install 
    Around 200 K to upgrade 
    Around 10 MB disk space to install 
    No additional space to install the upgrade 
3.2. Installation 
This section describes how to install Dawn. An upgrade from Dawn 3.0 (nonbeta) 
or later is also available. To upgrade older versions, uninstall and install 
fresh. Warning: beginning with version 4.0 beta 1 Dawn does not come bundled 
with the essential Visual Basic runtime files which many people already have. 
This decreases the size of the archive file to the lowest it has been since Dawn 
was Nacwonaf 2.0. The files are freely available from various locations. See 
above and below for more information.
3.2.1. Downloading 
3.2.1.1. Downloading for fresh installations
Download the 1669K dawn4b1.zip from my web site or from a mirror location of 
your choice. (Mirror locations will be listed here as they appear). Then, go on 
to the next steps. If an error such as "Cannot find vb40032.dll" or "vbvm50.dll" 
occurs, you will need to download one or both of these files, available at many 
software sites and at Microsoft (Locations will be listed here). Try to 
install/run it again. 
3.2.1.2 Upgrading 
Download the 57K file dawn4b1u.zip. 
3.2.2. Uncompressing 
Uncompress the zip file into a temporary folder (not windows\temp, create one). 
3.2.3. Installing 
Run setup.exe. Follow the onscreen instructions. 
3.3. Starting the program 
To start the program, run the dawn.exe file either from its folder or the start 
menu's programs menu. 
3.4. What to do after starting the program 
This section describes sorting, saving files, etc. 
3.4.1. Converting addresses 
3.4.1.1. Regular Convert
You can open a file in text format, Netscape (3.x or 4.x), Internet Explorer 
format, or Juno format. It will look the same on your screen. Then you can save 
the file in any of these formats once again. In the meantime, you can sort, 
edit, and perform other actions. Alternatively, you may copy and paste. If you 
wish to learn more about converting, read the menu descriptions below. 
3.4.1.2. Handheld PIMs
You can also do a one-way convert from a Netscape 4.x format addressbook to a 
text file format read by most handheld PIMs conserving all the data (including 
addresses, phone numbers, etc). Follow the steps below for getting Netscape 
addressbooks into dawn. Then, in Dawn, select "Netscape to PIM" from the file 
menu and type in or choose the appropriate names there. Clikck Convert.
For Internet Explorer, such a utility is not necessary since if you follow the 
steps of getting IE4 files into Dawn below, you already have a valid PIM file.
3.4.1.3. Extraction
If you have a regular file that has some addresses that you want to extract, you 
can do that. Use the Extract menu item in the file menu rather than Open. 
Alternatively, for UNIX compatibility, you can rename your file so that the last 
four letters of its name are ".xtr" then open it in Dawn. Dawn will search 
through the file for "@" characters and assume that the text around them is 
E-Mail addresses. Since Dawn has no way of knowing what the name or nickname is, 
Dawn assigns the address as the nickname as well. You can now save the file into 
any format and work with it as usual. If you wish to learn more about 
extraction, read the menu descriptions below. 
3.4.2. Edit Mode 
Unfortunately, in Dawn's present interface, you cannot delete, edit, or cut text 
(yet). Therefore, you might need the Edit Mode. The Edit Mode is basically the 
old text mode for handling text. When you enter it (click Edit | Edit Mode), the 
fancy interface disappears, and you are left with a textbox containing E-Mail 
addresses and NickNames one per line. Here you can edit them in any way you 
want, addresses or nicknames. When you're done, you can exit Edit Mode by 
clicking the same menu item (now bearing a checkmark) again. If after any action 
performed in Edit Mode you see weird text, exit Edit Mode and reenter it. That 
should solve the problem. Note: Edit mode cannot work with an address list 
larger than 32000 characters in size. The rest of dawn is thought not to have 
any size restriction, so for extremely large lists, do any editing in a word 
processor and then paste or open it not using edit mode. Dawn will warn you when 
entering Edit Mode if the text is too large, but if you are already in edit mode 
while increasing the contents to above the limit, unpredictable things may 
happen (out of memory error/quit being the most widespread). 
3.4.3. Menus 
3.4.3.1. File menu 
    Open - Displays a textfile, Netscape file, an Internet Explorer file, or a 
    Juno file onscreen. Format will be autodetected by the extention of the 
    file. If the extention is other than htm(l), ldif, txt, nv, or xtr, it'll 
    let you choose. 
    Save - Saves. Select the right type in the Save-As box and either type in 
    the right extension, or leave the extention off. It will save in the format 
    you select. Note: It will ask you even if the file remains unchanged. Also, 
    it will always bring up a save-as box. It doesn't remember the name of the 
    file. 
    Extract - Extracts addresses from any file fit for extraction. This includes 
    Netscape files and any text or html files. Since this function searches for 
    the "@" symbol and all adjacent text, beware of any text adjacent to the 
    addresses such as periods and commas. spaces, <> characters, and some others 
    will be correctly considered delimiters. You should open the Edit Mode and 
    delete any such characters if you see them. The disadvantage to this method 
    is that nicknames will be lost, so I recommend using a predefined method if 
    possible. 
    Netscape to PIM - loads the Dawn module that lets you convert full 
    addressbooks from Netscape to handheld PIMs. See below. 
    Exit - exits, asking you if to save. 
3.4.3.2. Edit Menu 
    Copy everything as text - copies everything in the window to ClipBoard as 
    plain text 
    Copy Selection Unchanged - does what a copy command in other programs does. 
    Copies what you have selected in the window. Only works in Edit Mode. 
    Copy everything as Netscape 4.xx - Copies everything as Netscape 4.0+ format 
    
    Copy everything as Netscape 3.x - Similar to the above, only using Netscape 
    3.0+ (html) format. 
    Copy everything as Juno - Similar to the above, only using Juno format. 
    Paste clipboard content - does what a paste command in other programs does. 
    Pastes clipboard text into the window. Only works in Edit Mode. 
    Clear and Paste ASCII - Removes all the text in the window and pastes from 
    the clipboard assuming ASCII format. 
    Clear and Paste Netscape 4.xx format - Removes all text in the window, 
    pastes a Netscape addressbook file, and displays it on the screen. 
    Clear and Paste Netscape 3.x format - Similar to the above, only using 
    Netscape 3.0+ (html) format. 
    Clear and paste Juno format - Similar to the above, only using Juno format. 
    Edit Mode - Enter or exit the Edit Mode - see Edit Mode above. 
    Delete selection - Deletes what you selected. Only works in Edit Mode. 
    Clear - clears all text in the window. Only works in Edit Mode. 
3.4.3.3 View - Sorting Options 
    Sort by NickNames - Puts addresses in alphabetical order by Nicknames 
    Sort by E-Mail Addresses - Alphabetizes by E-Mail address 
3.4.3.4. Help Menu 
All the menu items here work as expected except the "Help" and "Other Products" 
items. 
Note: There is an easter egg in all help menu items.
3.4.4. Quitting the program 
You can exit Dawn like any other Windows program. However, an exit menu item in 
the file menu is provided. 
3.5. How to get the converted file into Netscape, Internet Explorer, or Juno
If you are using Juno, you have to save in the Juno format. If you have 
Netscape, you have two options. Netscape 3.x format and 4.xx format which is 
also the IE4 format. If you have Netscape communicator 4.xx, you may use either 
format, although the one especially for Netscape 4 is more reliable. (It's also 
older and more tested) 
3.5.1. That done and over with, you have several ways to accomplish this task. 
You may chose File|Save or Edit|Copy as (insert your program here) 
3.5.2. If you did "Copy as . . ." in the Edit menu, you need to paste it into an 
editor and save it. Otherwise, skip this step. 
3.5.3. If you are using Juno, find out which user directory is yours (if there 
is only one, you are User0000) and move the file you saved into (Juno 
Directory)\User(Your number)\addrbook.nv otherwise open Netscape Communicator 
4.x or Navigator 3.x or MS Internet Explorer's Outlook Express.
3.5.4. If you are using Juno skip to step 3.5.9. Otherwise select "Address Book" 
from the Communicator menu in 4.x or from the Window menu in 3.x. or from the 
Tools menu in Outlook Express
3.5.5. Select "Import" from the File menu 
3.5.6. If using Outlook Express, select "Address Book" from the submenu. 
Otherwise, skip this step.
3.5.7. If using Outlook Express, select "LDIF" from the list and click "ok". 
Otherwise, skip this step.
3.5.8. Choose the ldif (Netscape 4.x and Explorer 4.x) or html (Netscape 3.x or 
4.x) file name you saved the coverted address book under and click "ok" 
3.5.9. Open your program as usual and enjoy! 
3.6. Getting Netscape, Internet Explorer, and Juno addressbooks to open in Dawn 
3.6.1. Netscape
You need to open the addressbook in Netscape and click File | Save As and save 
it as any .ldif (for Netscape 4.x) or .html (for Netscape 3.x) file you want. 
Then you can open the file in Dawn. Or you can open it in a word processor, copy 
it, and paste "Netscape 4.x" or "3.x" format (in the Edit Menu) as appropriate. 
3.6.2 Internet Explorer
Run Outlook Express and open the addressbook (from the tools menu or the button 
bar). Choose File|Export|AddressBook and choose "Text File" from the dialog box 
that appears. Click the Export button and type in the name of the file or click 
Browse and select it from a list. Important: The file needs to have a .csv 
extension! Then you can open the file in Dawn. Pasting as Internet Explorer is 
not implemented yet.
3.6.3 Juno
Determine which user you are in Juno (if there is only one, you are User0000). 
Run Dawn and open the file (Juno Directory)\User(Your number)\addrbook.nv Or you 
can open it in a word processor, copy it, and paste "Juno" format (in the Edit 
Menu)
3.7. Preferences 
The only preferences there are Netscape to PIM and even those don't do anything 
at present.
3.8. Sorting addresses 
You may sort addresses either by Nickname or by address. Just click on the 
appropriate button or select the appropriate item in the View menu. 
4. What's New 
4.1. What's new since Dawn 3.1
    Added Juno support 
    Added extraction support 
    UNIX version 
    Fixed quite a few bugs 
4.2. What's new since Dawn 3.0
    Added IE4 support 
    Added PIM support 
    Minor bug fixes 
5. Known issues, problems, bugs, limitations, and workarounds 
You are welcome to report bugs by E-Mail at zakharin@voicenet.com 
Bugs in 3.1: 
    Sometimes text in or out of Edit mode may not be correct
        Enter and exit Edit Mode and everything will be fixed 
    There is still a limit of 32000 characters on Edit Mode operations
        Edit files in word processors, don't use Edit Mode for large files 
    Some Edit Mode limit exceeding errors are not handled correctly
        Make sure you don't exceed the limit while in Edit Mode 
    The help messages are brief and unhelpful.
        Read this file carefully. You'll find just about everything here. 
    You must have an extra separator at the end of your list of addresses. 
5.1. Error messages 
There are seven trapped error messages that can pop up in Dawn. These will not 
cause Dawn to quit. If the reason for a message is not found below, refer to the 
bug report address above. 
    Error type #USR&001 - text nonexistent. This message now should rarely 
    appear because empty strings are handled much better in this version. 
    However, you may still get this message when you are performing operations 
    when you have no data. 
    Error type #USR&002 - The file does not appear to be of the known format.  
    You are trying to open a file where the content does not match your 
    extention, or, for non standard extentions, the content does not match the 
    format you have selected. 
    Error type #USR&003 - Too much text. You are attempting to enter edit mode 
    with a list of addresses exceeding 32000 characters, or, while in edit mode, 
    perform an operation in edit mode increasing the amount of text above the 
    limit. See above. 
    Error type #52, #53, #68, #75, or #76 - Bad filename. You are attempting to 
    use the name of a nonexistent file (as an input file) or folder or drive, or 
    there's something wrong with the name you typed in (for example you didn't 
    type anything in at all). For any of these errors, you will have a chance to 
    select another file in a dialog box. If you click Cancel there, Error #52 
    will occur and the cycle will be repeated. No data loss will occur. 
There may be cases of  untrapped errors which cause the program to quit, or 
worse yet, to hang. If that happens, refer to the bug-report address above. The 
best way to get rid of Dawn when it's hanged is to press ctrl-alt-delete and 
crash close it. Perform this several times until "This program is not 
responding" appears. Press OK and it will close. 
6. Upcoming features 
The Dawn 4.0 is now well under way as you can see. Here we have a good sampling 
of the new features with Juno support and address extraction. A parallel effort 
for a C-based cross-platform release is also underway. In fact, Dawn 4.0 beta 1 
for UNIX has been released. Both these efforts will proceed at a somewhat 
parallel pace with more formats supported, the return of more choice in text 
mode (remember the flop of Dawn 3.0?), and more bugs fixed as well as interface 
improvements in the shortterm. In the longterm, possibly before Dawn 4 final, 
you can expect better online help and direct interaction with Netscape and 
Internet Explorer.
7. Other services by me 
For more information, E-Mail zakharin@voicenet.com or visit my homepage at 
http://www.voicenet.com/~zakharin 
7.1. QLML 
The Quantum Leap Mailing List is a mailing list dedicated to bringing you 
information about Quantum Leap the TV show. Visit my homepage to find out more.
7.2. Programs by me 
8. Terms of this software 
This program is still free, but I would appreciate it if you would send 
something to me, like a comment, at zakharin@voicenet.com. Copyright 1996 - 1998 
Boris Zakharin all rights reserved. 
End Of File. 
