Contents

\YAAF\YAAFLib       - The YAAF Library

\YAAF\ToolSrc       - The source kits for rcompile and 
                      the YAAF Constructor
\YAAF\SampleSrc     - Sample source applications

\YAAF\Tools         - Compiled versions of RCompile,
                      the YAAF Constructor and XTextEdit
                      for Windows 95/98/NT.
\YAAF\Other Platforms
                    - Versions of YAAF for the Macintosh
                      and Linux.

--------
Licensing note:

There are four separate source kits which are inside the
YAAF distribution. These four source kits are distributed
under different licensing agreements, all designed to
maximize your ability to use the YAAF Library to write
public or proprietary applications, while keeping the
YAAF Library itself under the GNU License.

The YAAF Library itself is licensed under the GNU
Library General Public License. Please refer to the
on-line documentation for more information. The short
of it is that you may <link> the YAAF Library into
a proprietary application, but you may not derive your
application from the YAAF Library source files without
being encoumbered by the GNU LGPL.

The YAAF Constructor and RCompile are both licensed
under the GNU GPL. You may freely redistribute the
software or modify it, but all derivations from these
two applications are also covered under the GNU GPL.

The sample program XTextEdit (or xt) is released into
the public domain. You may freely use all or parts of
the XTextEdit application in your own applications
without restriction. It's hoped that the XTextEdit
application will serve as a launching point for your own
application development efforts.


Please feel free to redistribute this source kit and
make modifications--just be sure to observe the appropriate
license agreements. And if you do make changes to the
source kit, I'd appreciate it if you'd drop me a line
so I can incorporate your changes into the base source kit.
(You don't have to; it'd just be nice.)

The YAAF home page: http://www.pandawave.com/yaaf/

--------

Building the YAAF Library

1. Copy the YAAF directory to it's final location on your
   hard disk.
2. Open VC++
3. Set the directory paths to point to the YAAF directory.
   
   From VC++, select 'Options' under the Tool menu.
   Select the 'Directories' tab.
   Select Platform 'Win32'.
   Select Show directories for 'Include files'.
   Add the YAAF header directory to the list. (If you
   copied the YAAF directory to D:\YAAF, then add
   D:\YAAF\YAAFLib\Headers to the list.)

   Select Show directories for 'Library files'.
   Add the YAAF library directory to the list. (In the
   above example, add D:\YAAF\YAAFLib\Libs to the list.)

4. Select 'Rebuild All.'

Note that the YAAF project file will automatically copy
the YAAF.LIB and YAAFD.LIB files to the Libs directory.

--------

Once you have made the adjustments above, you can easily
build the other tools by opening their respective
workshop files.

Please note that the 'Struct Alignment' option for the
C++ compiler must be set to the same value for the
YAAF library as it is for programs you build with YAAF.
By default this is '2 bytes.'

To change this in the Microsoft Developer Studio:
   Select 'Settings' under the 'Project' menu.
   Select the C/C++ tab
   Select Category "Code Generation".
   Set "Struct member alignment" to 2 Bytes.

As the default is 8 bytes, you must repeat the above
steps for all the settings in your application.

