BePDF release 0.6
based on xpdf 0.80
Hubert Figuière <hub@frbug.org>
January 23th 1999

$Id: README.beos,v 1.7 1999/03/27 01:30:28 hub Exp $

ABSTRACT

This document supplement the file README specially for the BeOS version.

WHAT IS BePDF

BePDF is a free PDF viewer for BeOS. This version is a port of xpdf that was written
for the X-Window system. It uses the 0.80 portable engine unmodified and add wrappers 
around it to make it a BeOS native program. It is designed to run as good as it can 
on BeOS.

This version is currently a version in development and is not  as functionnal as the 
X-Window version. What would you expect from a 2 days coding program ?

SETUP

This program requires BeOS R4 (PowerPC or Intel).

You can set is as preferred handler for file of type application/pdf.

Openning a big PDF file from a CD-ROM can take a while. Please be patient.

Window zooming is smart. It will zoom the window to the document size of to the screen size, 
whatever is the smallest.


KNOWN LIMITATIONS

*Bezier curve are not drawn properly in all cases. This is because they sometimes use
the Even and Odd rule to file Bezier in PDF. BeOS does not support it yet. I have either
to wait for this mode to be supported or to do this myself.
*It does not recognize the encoding used for non ASCII. It defaults to ISO-8859-1, but for
files like BeOS documentation, Macintosh Roman encoding is better. Choose whatever
suits the best. Note also that ligature like 'fi' produce squares. There are a lot in the BeOS 
user's guide.
*Font mapping is really basic.
*Cross references are not handled yet
*Printing is badly supported (ie experimental)
*Multiple window mode seems to have trouble...
*Some documents with weird encodings may be displayed correctly and may be unreadable.
*Does not support the news PDF 1.3 introduced by the upcoming Acrobat 4. Currently this
cause BePDF to crash badly.
*lot of other things

SOURCE CODE

Full source code is available under GPL Licensing.
Master site is <http://www.frbug.org/pdf/>

FEEDBACK & SUPPORT

If you have trouble using this or if you find crashes, feel free to contact me at:
	<hub@frbug.org>
You can also send me patches for bug fixes and improvement. Use diff -u from an official 
source tree (don't forget to tell me which one it is).

CREDITS

Engine and original documentation :  copyright 1996-1998 Derek B. Noonburg.
BeOS interface : copyright 1998 Hubert Figuière.
Thanks to :
-Derek B. Noonburg for xpdf
-Benoït Triquet for original work on a BeOS version
-Mathias Agopian for hints.
-Icons by Jonas Sundström

CHANGES

release 0.5, Nov 1st 1998
-BeOS Master Awards release.

release 0.5.1, January 26th 1999
-[FEATURE] Added icon for PDF documents
-[BUG] fixed bug with page number not properlly displayed
-Internal code reorganization
-Renamed to BePDF
-[FEATURE] Added Bézier curves suport for vector graphics.
-[FEATURE] Jumped to 0.80 engine
-Now under GPL License (see file COPYING)

release 0.6
-[FEATURE] Bitmap image are now displayed
-[FEATURE] Scrollbars are now handled correctly (this was NOT done, hence it is
a feature and not a bug).
-[FEATURE] Added direct page access thru the BTextControl
-[FEATURE] Added zooming support thru a menu
-[FEATURE] Added total page number
-[FEATURE] A nicer icon for the application has been added (thanks Jonas for 
providing it).
-[FEATURE] We now can navigate with Page Up/Down and Space/backspace keys like in
less, Netscape, etc.
-[FEATURE] Basic printing support. This is really a hack. Don't use it.
-Window now only displays the file name instead of the full path
-[BUG] fixed bug where BShape were not filled in the right place: Documentation
was unclear. Vector graphics should be drawn better but not the best way (see KNOWN
LIMITATION section above).
-[BUG] bezier curve where not stroke the right way. Used the same algorithm as
for BeOutputDev::fill ()
-[BUG] links border should be drawn in the right place now.
-[BUG] now compiled to use Gzip instead of compress. This later is not in BeOS and
previous engine version required a script to be installed.
-[BUG] fixed a bug where the page was not completly drawn until next update 
(BView::Sync() is worth the effort)
-[BUG] clipping region are now handled properly. Caveat: this is SLOW.
-[BUG] removed unused popuo at the left bottom of window
