haiku/docs/user/compatibility.dox
Augustin Cavalier 4cb2c39774 Haiku Book: compatibility: list all authors at the top of the file as per convention.
All of the other .dox files here list authors at the top of the file
in a standard (non-Doxygen) comment, so do the same here.

I've listed the file as copyright 2011, as (according to Git) that's
the last time it was functionally changed. I also added a few people
in as being authors of the file who seem to have made significant
changes to it.
2015-02-11 19:14:20 -05:00

61 lines
2.5 KiB
Plaintext

/*
* Copyright 2011 Haiku, Inc. All rights reserved.
* Distributed under the terms of the MIT License.
*
* Authors:
* Axel Dörfler <axeld@pinc-software.de>
* Niels Sascha Reedijk <niels.reedijk@gmail.com>
* Ingo Weinhold <ingo_weinhold@gmx.de>
* Alex Wilson <yourpalal2@gmail.com>
*/
/*!
\page compatibility Application Level API Incompatibilities with BeOS
Haiku R1 (x86) was designed and is being implemented to be binary and source
compatible with applications written for BeOS R5 (x86) to a large extent, but
not the other way around. In some cases we deliberately broke source
compatibility while at the same time maintaining binary compatibility. Here are
some specific examples:
- The \c "be" header path is gone - it's called \c "os" in Haiku; since it is
always part of the default header search path anyway, you can always just
remove it to let your software compile on both platforms, ie. replace:
\code
#include <be/interface/View.h>
\endcode
with:
\code
#include <interface/View.h>
\endcode
or rather use the preferred method of omitting the first part and use:
\code
#include <View.h>
\endcode
- BeOS contains a deprecated \c add-ons/TrackerAddons.h header, and a
header called \c add-ons/TrackerAddOns.h - Haiku only contains the
latter.
- Likewise, you'll find \c support/byteorder.h and \c support/ByteOrder.h
in BeOS; Haiku only has ByteOrder.h.
- If you have subclassed BString and if you are using its \c _privateData
member, you might notice that it is no longer mentioned in the documentation.
This is because it has been marked as private.
- The undocumented functions defined in Alias.h from the storage kit are not
implemented.
- The private Device Map API (used by OpenTracker) has been replaced by a
different API (Disk Device API).
- The application debugging interface is conceptually similar, but nevertheless
source and binary incompatible.
- The file system API has changed; file systems that worked on BeOS will no
longer work on Haiku.
- Haiku is binary compatible with the Network Kit in BeOS R5 as well as BONE,
ie. the BSD socket API as well as Be's proprietary C++ API.
However, the ioctl() interface is not compatible with BONE (BeOS R5 did not
have such an interface in the first place).
- In several places we also dropped compatibility support for older BeOS
versions (PR2, R3, R4), which BeOS R5 still featured.
- The BArchivable class has been updated, and for some classes, unarchiving
is slightly different.
*/