mirror of
https://github.com/ddidderr/wuffs.git
synced 2026-11-18 08:32:11 +01:00
The gen/c/* files are not checked in, due to the .gitignore file In Wuffs version 0.1, they were checked in, and programs were expected to #include them directly. Another goal was for them to be self-contained, without any #include lines to other Wuffs files, so that they would be easy to build, without having to configure an -I dir to a C compiler. They therefore inlined what would otherwise be an #include. For example, the generated std/gif.h code would inline the contents of the std/lzw.h file. The genrelease program would have to de-duplicate these inlines in order to produce a clean, monolithic release/c/* file. In Wuffs version 0.2 (the latest version), programs don't #include gen/c/*. Instead, they #include the monolithic release/c/*. Avoiding the need to configure an -I directory isn't as important as it used to be. This change removes that inlining, using the simpler #include line, and the genrelease program is then simpler because it doesn't need to de-duplicate.
Wuffs ships as a "single file C library", also known as a "header file library".
To use Wuffs in your C/C++ project, you just need to copy one file from this
directory, or otherwise integrate that one file into your build system.
Typically, pick the latest version (but not the unsupported snapshot), with a
filename like wuffs-vMAJOR.MINOR.h for version MAJOR.MINOR.
To use that single file as a "foo.c"-like implementation, instead of a
"foo.h"-like header, #define WUFFS_IMPLEMENTATION before #include'ing or
compiling it.