X-Git-Url: https://pd.if.org/git/?a=blobdiff_plain;f=platform%2Fposix%2FReadme.txt;fp=platform%2Fposix%2FReadme.txt;h=5ec24bd601b548f876b83cf858c28596e871f43e;hb=a18343e497615802f47e0f6876b5bed73af674e0;hp=0000000000000000000000000000000000000000;hpb=b76c255d42904c10ce65f884429b4bf2f9b4f4a4;p=pdclib

diff --git a/platform/posix/Readme.txt b/platform/posix/Readme.txt
new file mode 100644
index 0000000..5ec24bd
--- /dev/null
+++ b/platform/posix/Readme.txt
@@ -0,0 +1,24 @@
+$Id$
+
+"Example" Platform Overlay
+==========================
+
+This is an example platform overlay, as described in the main Readme.txt of
+this archive. For ease of development, it applies (and tests) correctly on the
+machine of the author; no other guarantees can be given.
+It should give you a good idea of what is REQUIRED to make a copy of PDCLib
+work. There is a lot more you could do, and even some things you SHOULD do, in
+order to experience anything but abysmal performance:
+
+- Read / write operations on binary streams, and even on text streams for
+  machines that do not do any text conversion, can be made much more efficient
+  by using some sort of page buffer instead of the linear buffer implemented
+  here. It requires some special and platform-dependent manipulations, though,
+  which is why it is not done by default.
+
+- Anything relating to floating point logic is written in generic C. While
+  this is (hopefully) highly portable and should get you started on your
+  platform of choice, it is also highly inefficient and should be replaced by
+  inline assembly. Just make sure that your assembly keeps all the promises
+  the C library makes.
+