mirror of
https://gitlab.freedesktop.org/cairo/cairo.git
synced 2025-12-20 17:30:07 +01:00
5926257770
Quick summary of changes:
- Move list of cairo source files out of src/Makefile.am and into
src/Sources.mk,
- Generate files src/Config.mk and src/Config.mk.win32 that choose
the right set of source files and headers based on configured
backends and features. This drastically simplifies building
using other build systems. The src/Makefile.win32 file needs
to be updated to reflect these changes.
- Add README files to various directories,
- Add toplevel HACKING file.
37 lines
867 B
Text
37 lines
867 B
Text
Cairo Reference Documentation
|
|
=============================
|
|
|
|
The API documentation is generated using gtk-doc.
|
|
|
|
|
|
Building
|
|
--------
|
|
|
|
The documentation is not built by default. To build it you need to
|
|
configure with gtk-doc enabled (--enable-gtk-doc), and run:
|
|
|
|
make doc
|
|
|
|
|
|
Adding New API
|
|
--------------
|
|
|
|
When adding new symbols and macros to the public API, modify
|
|
cairo-section.txt and add new symbols to the right place.
|
|
|
|
When adding whole new features, you also need to modify cairo-docs.xml
|
|
and add a new file under tmpl/. Beware that the files are tmpl/ are
|
|
both manually edited AND modified by gtk-doc, gathering documentation
|
|
stub from source files.
|
|
|
|
|
|
Tests
|
|
-----
|
|
|
|
There are some tests in this directory, ensuring proper documentation
|
|
syntax as well as checking that all public symbols are fully documented.
|
|
|
|
After adding any new API, just run:
|
|
|
|
make check
|
|
|