]> pd.if.org Git - pdclib.old/blob - platform/example/Readme.txt
Add manpage for setlocale
[pdclib.old] / platform / example / Readme.txt
1 $Id$
2
3 "Example" Platform Overlay
4 ==========================
5
6 This is an example platform overlay, as described in the main Readme.txt of
7 this archive. For ease of development, it applies (and tests) correctly on the
8 machine of the author; no other guarantees can be given.
9 It should give you a good idea of what is REQUIRED to make a copy of PDCLib
10 work. There is a lot more you could do, and even some things you SHOULD do, in
11 order to experience anything but abysmal performance:
12
13 - Read / write operations on binary streams, and even on text streams for
14   machines that do not do any text conversion, can be made much more efficient
15   by using some sort of page buffer instead of the linear buffer implemented
16   here. It requires some special and platform-dependent manipulations, though,
17   which is why it is not done by default.
18
19 - Anything relating to floating point logic is written in generic C. While
20   this is (hopefully) highly portable and should get you started on your
21   platform of choice, it is also highly inefficient and should be replaced by
22   inline assembly. Just make sure that your assembly keeps all the promises
23   the C library makes.
24