[Portland] Summarize current plan?

[Kevin Krammer]

On Sunday 12 March 2006 18:53, Bryce Harrington wrote:

> Hiya,
>
> Here is a short README to try to address the above points.  If this
> looks ok, could someone add it to CVS?

Thanks a lot, looks good. My application for a CVS account is still pending, 
so Lubos or someone else will have to commit it, preferably not before Lubos 
has commented on it :)

> == README ==
>

[snip introduction, IMHO perfect]

> Usage
> =====
> There are two ways an ISV can employ DAPI:  Bundling it with your app,
> or linking to a separately installed copy (such as provided with the
> user's Linux distro).  Currently (March 2006), no distros ship DAPI, so
> you will probably want to consider bundling it along with your app.

My understanding is that the library part is meant to be bundled, I'd even say 
statically linked.

The bunding/assume pre-installed issue is from my point of view a topic for 
the daemon.
Since the desktop daemons will have tight dependencies on the respective 
desktop API, it might be advisable to just bundle a generic daemon.

Something that might be too technical for this kind of overview document is 
that the library is not required per se. Since it is generated from a simple 
description format an ISV could generate their client side implementation 
using their own tool if they think that the default implementation is too 
different from the stuff their developers are used to.

For example, if Codeweavers felt they rather implement the API in Win32 Code 
and only do the on the wire communication through wineserver that would be 
possible.

> The doc/ directory contains a description of the implemented calls.

Better directly name the API.txt file. The format can be changed if it is too 
ambiguous/weird/hard to understand.
We'd require some feedback on that though.

Cheers,
Kevin

-- 
Kevin Krammer <kevin.krammer at gmx.at>
Qt/KDE Developer, Debian User
Moderator: www.mrunix.de (German), www.qtcentre.org
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 191 bytes
Desc: not available
Url : http://lists.freedesktop.org/archives/portland/attachments/20060312/15b727b6/attachment.pgp