ADOBEª ACROBATª PLUG-INS SDK README

¥ INSTALLATION
¥ VIEWING TIPS
¥ PRINTING TIPS
¥ SEARCH/INDEXING ISSUES
¥ PLUG-INS NOTES
¥ SUPPORTED COMPILERS
¥ DISTRIBUTING THE ACROBAT READERS
¥ DISTILLERª/PDFMARK ISSUES
¥ SOFTWARE REGISTERED FOR YOU - NO NEED TO REGISTER
¥ ACROBAT 2.0 COMPATIBILITY ISSUES


We encourage you to use the HOMECARD.PDF file to navigate 
around this CD. This file contains cross-document links as 
well as other features that have been designed to offer you 
an interrelated view of the development categories. 
Through this guide, obvious and less obvious groupings have 
been provided for you. You may also use the search function 
to locate items of particular interest.

INSTALLATION

All documentation has been provided in the Portable 
Document File Format (PDF). To view these documents you 
will need to first install one of the versions of Acrobat 
Reader, Exchange or Exchange LE provided on this disk.

The Acrobat Software installer automatically installs a pre-
defined serial number, so you don't have to. One note - when 
installing the DOS 1.0 Reader, make sure you are outside of 
Windows. If you are inside Windows, launching from a DOS 
shell, you may be prompted for a serial number, as the pre-
installation is not recognized here.

The installer also automatically adds the TechDoc and
OtherDoc indexes on the CD.  On the Macintosh, it does not
automatically add the Exchange Help Index.  The Windows
installer does add the Exchange Help Index. If you have
previously installed Exchange or Exchange LE on a Mac,
the former Acrobat Search Preferences will be 
retained.

If you install more than one Acrobat viewer
(Exchange, Exchange LE, or Reader), the most recently
installed viewer will be launched when you double-click
on a PDF file.

VIEWING TIPS

You will notice that the zoom view on the technical 
documents has been set to 120%. We felt this was most 
appropriate for readability. In the future we will continue 
to examine on-line document viewing.

PRINTING TIPS

When printing the PDF files  please use the "shrink to fit" 
option in the Print dialog box to avoid clipping the edges of 
the documents which may contain footers or page numbers.

Also when printing PDF files, you may want to create a NOTES 
file for the PDF (usually a technote) and print it out. We may 
place notes on individual technotes which include additional 
late-breaking information.

SEARCH/INDEXING ISSUES

There is currently no Macintosh¨ version of the Acrobatª 
Catalog application. Macintosh users must currently have
access to hardware that can run Microsoft Windowsª in order
to build an index.

If you would like quicker response times when using the 
search capability, copy the TECHDOCS and OTHERDOCS 
indices folders to your hard disk. Then remove the indices 
from the Acrobat Search plug-ins index list.

We suggest you create an index of your documents on your
CD or product release so that users with Acrobat Exchange
and Search can take advantage of the index, even if you 
are only bundling the Acrobat Reader program.

PLUG-INS NOTES

Make sure to look at the Caveats section for the plug-ins 
located in the SAMPLES.PDF file for important information 
about possible conflicts. 

SUPPORTED COMPILERS

- Windowsª Visual C++ 1.5
- Windowsª Visual Basic 3.0
- Macintosh¨ Think C 6.0
- Macintosh¨ AppleScriptª 1.1

There may be problems compiling some of the Macintosh
plug-ins with Think C 7.0.  Contact Acrobat Developer
Support if you have problems.

DISTRIBUTING THE READERS

You may freely re-distribute the Adobe Acrobat 2.0 Readers 
for Macintosh and Windows. If you would like to re-
distribute the Adobe Acrobat 1.0 Readers for DOS and UNIXª, 
please refer to the READTERM.PDF file located in the DOS 
and UNIX directories under the Products directory. You will 
also find the license agreement for these readers in the 
OTHERDOCS directory. There is no fee required for 
re-distribution.

SOFTWARE PRE-REGISTERED FOR YOU

Upon registering for the Acrobat Developers Program, 
which includes the SDK, you were registered to receive 
updates to the Acrobat SDK as well as the Acrobat 
Software. Although there is an alert window in the 
software installer reminding you to register your product, 
you will not need to do this. You are pre-registered.

DISTILLERª/PDFMARK ISSUES

If you have a document containing PDFMARK information 
that supports Acrobat 2.0 features, and you are using 
Macintosh, Windows, or UNIX Distiller 1.0, it will
report a PostScriptª error.

ACROBAT 2.0 COMPATIBILITY ISSUES
ACROBAT VIEWER API'S
    
1) Problem (Mac and Win): Using the plug-ins API call
AVDocPrintPages or an IAC method that calls this method
will result in a dialog box that says Printing Pages X
of Y. 
     
Workaround: There is no way to prevent this printing
dialog box from coming up.
  
2) Problem (Win only): Not all of the OLE 2.0 files were
installed with the Acrobat viewer. The files missing are
bundled with the SDK in the \SOURCE\IAC\WIN\SDK directory.
     
Workaround: See the readme file in that location for
details on correctly installing and registering all OLE
files and methods.

3) Problem (Win only): Developers using the Acrobat OLE
command OpenInWindow should restrict their use to just
using the Hand Tool. In particular, the MenuItemExecute
OLE command will not function correctly when using
OpenInWindow.

Workaround: Use the PD level OLE call Draw instead.
This will not give you all the functionality of
OpenInWindow.

4) Problem (Win only): Developers creating their own
custom file system should not use the Acrobat OLE method
OpenInWindow. OpenInWindow automatically uses the default
file system.

Workaround: Use the PD level OLE call Draw instead.
This will not give you all the functionality of
OpenInWindow.

5) Problem (Win only): Developers using the Acrobat OLE
command Close will encounter a GPF if the document has been
dirtied, a noSave of FALSE was passed to the Close method,
and the user hits the Cancel button rather than yes or no.

Workaround: If possible, set the Close methodÕs noSave to
TRUE.  This closes the document without checking if it
is dirty.

6) Problem (Win only): Acrobat 2.0 for Windows does not
support the OLE 2.0 method OleCreateFromTemplate.

Workaround: In the Lotus Notes example code, there is a
demonstration of OleLoad to load an OLE object instead
of OleCreateFromTemplate. 

7) Problem (Mac only): The Apple event for creating
thumbnails does not work correctly.

Workaround: Call the Apple event ÒexecuteÓ on the menu
item ÒCreateAllThumbsÓ instead.
   
8) Problem (Mac only): The Apple event
kAEDrawPageToWindow will not draw correctly to an
offscreen GWorld. Symptoms of this are that graphics
and line art will be drawn into the GWorld correctly, but
text will appear all in the lefthand corner. The API method
PDPageDrawContentsToWindow does draw correctly to
an offscreen GWorld.
     
Workaround: Do not draw into an offscreen GWorld with
the Apple event kAEDrawIntoWindow.

ACROBAT PDFWRITER

1) Problem (Win only): The PDFINPUT structure members
PDFINPUT.username and PDFINPUT.creator are ignored by
PDFWriter 2.0 when using the PDFFILENAME printer escape.
This is a problem with PDFWriter 2.0.

Workaround: None.

ACROBAT DISTILLER

1) Problem (Win only): Using the /o option to specify a
destination file results in a PDF file with an extension
of ".PDF" from Acrobat Distiller 2.0 regardless of what
extension was specified.  Using the /o option to specify
a list of PostScript language files does not work with
Acrobat 2.0 Distiller.  Both of these problems will be
fixed in a future release of Distiller.

Workaround: None.

ACROBAT SDK

1) Problem (Win only): When using the VBView2 sample
application to open a .PDF file and selecting
Document Info, you will be presented with a dialog
box asking you to save.  If you hit CANCEL, it will
generate a GPF.

Workaround: None.