diff options
Diffstat (limited to 'doc/c/overview.rst')
| -rw-r--r-- | doc/c/overview.rst | 22 |
1 files changed, 22 insertions, 0 deletions
diff --git a/doc/c/overview.rst b/doc/c/overview.rst new file mode 100644 index 00000000..95862368 --- /dev/null +++ b/doc/c/overview.rst @@ -0,0 +1,22 @@ +######## +Overview +######## + +.. default-domain:: c +.. highlight:: c + +The API revolves around two main types: the :doc:`api/reader`, +which reads text and fires callbacks, +and the :doc:`api/writer`, +which writes text when driven by corresponding functions. +Both work in a streaming fashion but still support pretty-printing, +so the pair can be used to pretty-print, translate, +or otherwise process arbitrarily large documents very quickly. +The context of a stream is tracked by the :doc:`api/env`, +which stores the current base URI and set of namespace prefixes. + +The complete API is declared in ``serd.h``: + +.. code-block:: c + + #include <serd/serd.h> |