(c) 1996 Lotus Development Corporation.  All rights reserved.
This software is subject to the Lotus Notes C++ API Software Development
Kit Agreement (in the apilicns.txt file in the notescpp directory of
this toolkit), Restricted Rights for U.S. government users, and
applicable export regulations.


PROGRAM
-------
richtext - Notes C++ API sample program to manipulate the contents of
a Rich Text item.


ENVIRONMENTS
------------

Sample makefiles are provided for the following environments:

	Windows NT (32-bit) (including DEC Alpha)
	Windows 95 (32-bit)
	IBM VisualAge C++ for Win32
	OS/2 (32-bit)
	HP HP-UX
	SUN Solaris 2
	IBM AIX
	X86 Solaris 2

The following environments rely on the Integrated Development Environment
(IDE), and do not require makefiles:

	Windows (16-bit) using Borland C++
	MacOS (7.x) Power PC


FILES
-----
richtext.cpp - Main program.

mswin32.mak  - Make file for Windows NT (32-bit) (including DEC Alpha) and 
               Windows 95 (32-bit) using Microsoft Visual C++.

richtext.def - Module definition (.def) file for 16-bit Borland C++ for Windows.

ibmwin32.mak - Make file for Windows NT (32-bit) and Windows 95 (32-bit) using
               IBM VisualAge C++ for Windows.

os2_32.mak   - Make file for OS/2 (32-bit).

hp.mak       - Make file for HP-UX.               

sol_2x.mak   - Make file for SUN Solaris 2.

sol_x86.mak  - Make file for X86 Solaris 2.

aix.mak      - Make file for IBM AIX.

readme.txt   - This file. Specifies what is needed to use this example.


RUNNING richtext
----------------
This sample program is designed to work with the sample database 
richtext.nsf, in the notescpp\notedata directory.  This database should
be copied to your Notes data directory.  On platforms other than 
Macintosh, the user must supply command-line parameters to specify the 
file pathname and, optionally, server for the database.  On the Macintosh, 
the user is prompted for the file pathname and server name.

- Under Windows 16-bit: choose File Run from the Program Manager menu, 
  type in the full path and filename of this program, the Notes pathname
  of the database, and optionally the name of the server, and
  press <Enter>.

- Under OS/2 , Windows NT, Windows 95 and UNIX (Solaris, AIX, or HP-UX):
  type 'richtext' at the system command prompt, followed by the Notes
  pathname of the database, and optionally the name of the server.

- Under Macintosh: double click on the program icon.  The program will
  prompt for the database pathname and optional server name.

For example, the sample database richtext.nsf may be copied to the
user's Notes data directory.  The command line for richtext is:

	richtext richtext

The program will modify the uncategorized notes in the specified
database.


EXAMINING THE NOTES DATABASE TO CHECK THE RESULT:
------------------------------------------------

To see if richtext worked correctly:

      Use Notes to open richtext.nsf

      Open one of the notes.

	  The rich text should contain three strings delimited by "**",
	  identifying themselves as insertions made by the program.
