PartMaker 1.1                                        Novell, Inc.

What is PartMaker?
PartMaker is an application that will generate source code for a
simple OpenDoc part editor.  It generates all of the source code
needed, including the SOM interface definition language file
(.idl), the IDL make file (somidl.mak), a batch file to compile
the IDL make file (makepart.bat), the header files (.h), the
module definition file (.def) and the main source modules (.cpp). 
PartMaker generates source code defining all methods/procedures
for a complete part editor.  Many of the methods/procedures are
stubs to be defined later by the programmer with the specific
part editor's implementation code.

Using PartMaker.
To use PartMaker, run PartMakr.exe as you would any standard
executable file.  PartMaker will display a dialog that will allow
you to enter values defining your part.  The first value is the
name of your part.  The part name can be anything you want it to
be, however, it should be as descriptive and succinct as possible.
The next value is your company name.  The company name will
identify all parts from your company.  The part name and the
company name will be used for C++ identifiers, so, they must
consist of only alphanumeric characters and underscores.  Do not
use spaces or punctuation marks in either of these names. After
you have properly entered the name of  the part and your company,
click the "Create Part" button.  At this point, another dialog
will display allowing you to select a parent directory for the
part development directory. The directory that you select will
become the parent directory for a newly created directory named
for your part.  All of the source code modules will reside in this
newly created directory.

Building Your Part.
Go to the directory created by PartMaker containing the source
modules for your part. If you will be using a command-line
makefile, create your makefile for the new source code modules. 
Edit makepart.bat and remove the line that says, "Insert your
makefile here."  If you will be using a command-line makefile,
insert, as the last line,  the command to run your makefile.  Type
"makepart" at the command line. Makepart will compile the SOM IDL
file and, if you inserted your makefile command, it will compile
the source modules.  If you will be using an integrated
development environment, enter the development environment, create
a new project using the new source code modules (all .h, .cpp and
.def files), add the SOM library and the OpenDoc libraries to the
project, add the necessary "include" paths and then build the
part.

Running Your Part.
Register your part with the system by running the file,
"ODReg32.exe."  At this point you should be able to run the
OpenDoc shell and use your part.
