[BB]

BlackBook v1.00c for OS/2

by Viêt-Tâm Luu


User's Guide


Copyright © 1996 Viêt-Tâm Luu.

This document may be freely distributed, but it may not
be modified (with the exception of conversion to other
formats) without the expressed consent of the author.


This document was created for viewing with IBM WebExplorer 1.03 or later. It will still be readable using other HTML viewers, but some parts may appear missing or formatted incorrectly.

Appendix A: About BlackBook

Build Notes and Remarks

BlackBook is written in C++ using IBM's Visual Builder tool. Source code consists of about 20 C++ files, totalling about about 3300 lines of hand-written code, along with about 9000 lines of code generated by Visual Builder. It is implemented using IBM's OpenClass class library (hence the rather bloated size of BlackBook.exe). The executable is compiled using IBM VisualAge C++ 3.0 (fix level 304) for OS/2.

Despite the tremendous amount of extra functionality that OpenClass offers, it is way too bloated and buggy for my liking. I might eventually re-write BlackBook in C or with a proprietary ``thin wrapper'' class library to improve performance and reliability. Eventually.

BlackBook Notify is written in C, and consists of one C source file with about 1200 lines of hand-written code. The executable is compiled using IBM VisualAge C++ 3.0 (fix level 304) for OS/2.

BlackBook Installation is written in C, and consists of one C source file with about 900 lines of hand-written code. The executable is compiled using IBM VisualAge C++ 3.0 (fix level 304) for OS/2.

Source files were edited using EPM 6.03b for OS/2 and Watcom vi for OS/2. Bitmaps and icons were drawn using the standard OS/2 Icon Editor.

BlackBook was written over a period of about two and a half months, starting in May 1996. From this, the author estimates that this project has taken between two and three hundred hours of work (after hours and on weekends).

The author would like to thank the following individuals:


Known Bugs and Limitations

If you think you've found a bug: Can you reproduce it (i.e. can you cause the error to occur more than once)? Is it not in the ``Known Bugs'' list (above)? Is it not fixed in the latest version of BlackBook (go to the BlackBook Home Page for the latest information and updates)? Is it not otherwise documented? Are you using the program within what could be considered ``normal'' parameters?

If you answered ``yes'' to all the above questions, or if you think you may have information that could shed more light upon the nature and cause of the bug, then please let the author know about it via E-mail, and he will be glad to look into the problem.

Check out the BlackBook Home Page for more information, as well as a troubleshooting tips and frequently-asked questions.


Revision History

BlackBook v1.00

BlackBook v1.00c

BlackBook Birthday Notification v1.00b

BlackBook v1.00c


[Contents | Chapter 1 | Chapter 2 | Chapter 3 | Chapter 4 | Chapter 5 | Appendix A | Appendix B | Appendix C]