libporty - about this document
The document of libporty is split into two layers:
- A generic layer which gives an overview about a field without going
too much into the details. Documents of this layer describes how the
user should approach problems using libporty, what are the rationale
behind some of the design decisions, why parts of libporty are
split and groupped as they are. Thus, this layer is useful
for questions about a specific problem like
"what calls porty offer for solving this", or "how libporty
handles this sort of problems".
- A detailed description of each call, in form of manual pages. These
manual pages do not reveal all (or sometimes any) of the generic
ideas, only tell how a specific call works. This layer assumes the
reader is already familiar with the generic layer and is interested
in the actual function arguments and detailed behaviour of the calls.
Direct links from libporty table of contents point
to generic documentation. Chapter 1 is a collection of documents explaining
the infrastructure and gives an overview on the purpose and design of
libporty. Chapter 2 describes the purpose and design of each package. Links
from chapter 2 are pointing to the manual pages.