diff --git a/example/crc32/crc32.cc b/example/crc32/crc32.cc index e9e17965..5d63c99a 100644 --- a/example/crc32/crc32.cc +++ b/example/crc32/crc32.cc @@ -12,6 +12,8 @@ // See the License for the specific language governing permissions and // limitations under the License. +// ---------------- + /* crc32 prints the CRC-32 checksum (using the IEEE polynomial) of stdin. It is similar to the standard /usr/bin/crc32 program, except that this example diff --git a/example/gifplayer/gifplayer.c b/example/gifplayer/gifplayer.c index 42ab767e..ed2fa022 100644 --- a/example/gifplayer/gifplayer.c +++ b/example/gifplayer/gifplayer.c @@ -12,6 +12,8 @@ // See the License for the specific language governing permissions and // limitations under the License. +// ---------------- + /* gifplayer prints an ASCII representation of the GIF image read from stdin. To play Eadweard Muybridge's iconic galloping horse animation, run: diff --git a/example/library/library.c b/example/library/library.c index 29fbd264..cb32e499 100644 --- a/example/library/library.c +++ b/example/library/library.c @@ -12,6 +12,8 @@ // See the License for the specific language governing permissions and // limitations under the License. +// ---------------- + /* library exercises the software libraries built by `wuffs genlib`. diff --git a/example/zcat/zcat.c b/example/zcat/zcat.c index f8b01a3d..2296b30e 100644 --- a/example/zcat/zcat.c +++ b/example/zcat/zcat.c @@ -12,6 +12,8 @@ // See the License for the specific language governing permissions and // limitations under the License. +// ---------------- + /* zcat decodes gzip'ed data to stdout. It is similar to the standard /bin/zcat program, except that this example program only reads from stdin. On Linux, it diff --git a/fuzz/c/std/gif_fuzzer.c b/fuzz/c/std/gif_fuzzer.c index e1e7adfa..abb5cc07 100644 --- a/fuzz/c/std/gif_fuzzer.c +++ b/fuzz/c/std/gif_fuzzer.c @@ -12,6 +12,8 @@ // See the License for the specific language governing permissions and // limitations under the License. +// ---------------- + // Silence the nested slash-star warning for the next comment's command line. #pragma clang diagnostic push #pragma clang diagnostic ignored "-Wcomment" diff --git a/fuzz/c/std/zlib_fuzzer.c b/fuzz/c/std/zlib_fuzzer.c index 49f58a19..50bab3dc 100644 --- a/fuzz/c/std/zlib_fuzzer.c +++ b/fuzz/c/std/zlib_fuzzer.c @@ -12,6 +12,8 @@ // See the License for the specific language governing permissions and // limitations under the License. +// ---------------- + // Silence the nested slash-star warning for the next comment's command line. #pragma clang diagnostic push #pragma clang diagnostic ignored "-Wcomment" diff --git a/script/adler32-standalone.c b/script/adler32-standalone.c index 712d8c9e..29de1c07 100644 --- a/script/adler32-standalone.c +++ b/script/adler32-standalone.c @@ -12,6 +12,8 @@ // See the License for the specific language governing permissions and // limitations under the License. +// ---------------- + // This file contains a hand-written C implementation of the Adler32 hash // function, based on the code generated by the Wuffs std/zlib implementation. // Its purpose is to benchmark different compilers, or different versions of diff --git a/script/bench-c-deflate-fragmentation.c b/script/bench-c-deflate-fragmentation.c index 99ab4dae..94b400e2 100644 --- a/script/bench-c-deflate-fragmentation.c +++ b/script/bench-c-deflate-fragmentation.c @@ -12,6 +12,8 @@ // See the License for the specific language governing permissions and // limitations under the License. +// ---------------- + // This file contains a hand-written C benchmark of different strategies for // decoding PNG data. // diff --git a/script/bench-rust-gif-dot-rs/src/main.rs b/script/bench-rust-gif-dot-rs/src/main.rs index cb56c817..2eef3c11 100644 --- a/script/bench-rust-gif-dot-rs/src/main.rs +++ b/script/bench-rust-gif-dot-rs/src/main.rs @@ -12,6 +12,8 @@ // See the License for the specific language governing permissions and // limitations under the License. +// ---------------- + // This program exercises the Rust GIF decoder at // https://github.com/Geal/gif.rs // diff --git a/script/bench-rust-gif/src/main.rs b/script/bench-rust-gif/src/main.rs index b49e4c00..ec6bfb26 100644 --- a/script/bench-rust-gif/src/main.rs +++ b/script/bench-rust-gif/src/main.rs @@ -12,6 +12,8 @@ // See the License for the specific language governing permissions and // limitations under the License. +// ---------------- + // This program exercises the Rust GIF decoder at // https://github.com/PistonDevelopers/image-gif // diff --git a/script/wuffs-deflate-decoder-decode-huffman.c b/script/wuffs-deflate-decoder-decode-huffman.c index 7868a005..397376c4 100644 --- a/script/wuffs-deflate-decoder-decode-huffman.c +++ b/script/wuffs-deflate-decoder-decode-huffman.c @@ -12,6 +12,8 @@ // See the License for the specific language governing permissions and // limitations under the License. +// ---------------- + // This file contains a hand-written C implementation of // release/c/wuffs-unsupported-snapshot.c's generated // wuffs_deflate__decoder__decode_huffman_fast function. @@ -23,9 +25,9 @@ // To repeat, substituting in this C implementation is NOT SAFE, and may result // in buffer overflows. This code exists only to aid optimization of the (safe) // std/deflate/*.wuffs code and the Wuffs compiler's code generation. -// + // ---------------- -// + // Having said that, to generate the benchmark numbers with this hand-written C // implementation, edit release/c/wuffs-unsupported-snapshot.c and find the // lines that say diff --git a/test/c/mimiclib/deflate-gzip-zlib.c b/test/c/mimiclib/deflate-gzip-zlib.c index 635eb1eb..6392bdff 100644 --- a/test/c/mimiclib/deflate-gzip-zlib.c +++ b/test/c/mimiclib/deflate-gzip-zlib.c @@ -12,6 +12,8 @@ // See the License for the specific language governing permissions and // limitations under the License. +// ---------------- + // Uncomment this line to test and bench miniz instead of zlib-the-library. // #define WUFFS_MIMICLIB_USE_MINIZ_INSTEAD_OF_ZLIB 1 diff --git a/test/c/std/adler32.c b/test/c/std/adler32.c index 2b085b7a..884a10a4 100644 --- a/test/c/std/adler32.c +++ b/test/c/std/adler32.c @@ -12,6 +12,8 @@ // See the License for the specific language governing permissions and // limitations under the License. +// ---------------- + /* This test program is typically run indirectly, by the "wuffs test" or "wuffs bench" commands. These commands take an optional "-mimic" flag to check that diff --git a/test/c/std/crc32.c b/test/c/std/crc32.c index 5ea1d3cb..118de3bc 100644 --- a/test/c/std/crc32.c +++ b/test/c/std/crc32.c @@ -12,6 +12,8 @@ // See the License for the specific language governing permissions and // limitations under the License. +// ---------------- + /* This test program is typically run indirectly, by the "wuffs test" or "wuffs bench" commands. These commands take an optional "-mimic" flag to check that diff --git a/test/c/std/deflate.c b/test/c/std/deflate.c index 3f340c26..1c9de167 100644 --- a/test/c/std/deflate.c +++ b/test/c/std/deflate.c @@ -12,6 +12,8 @@ // See the License for the specific language governing permissions and // limitations under the License. +// ---------------- + /* This test program is typically run indirectly, by the "wuffs test" or "wuffs bench" commands. These commands take an optional "-mimic" flag to check that diff --git a/test/c/std/gif.c b/test/c/std/gif.c index 6e047598..27d26991 100644 --- a/test/c/std/gif.c +++ b/test/c/std/gif.c @@ -12,6 +12,8 @@ // See the License for the specific language governing permissions and // limitations under the License. +// ---------------- + /* This test program is typically run indirectly, by the "wuffs test" or "wuffs bench" commands. These commands take an optional "-mimic" flag to check that diff --git a/test/c/std/gzip.c b/test/c/std/gzip.c index 9dfbca74..43964cd5 100644 --- a/test/c/std/gzip.c +++ b/test/c/std/gzip.c @@ -12,6 +12,8 @@ // See the License for the specific language governing permissions and // limitations under the License. +// ---------------- + /* This test program is typically run indirectly, by the "wuffs test" or "wuffs bench" commands. These commands take an optional "-mimic" flag to check that diff --git a/test/c/std/lzw.c b/test/c/std/lzw.c index 9d18ffd4..ad7c7626 100644 --- a/test/c/std/lzw.c +++ b/test/c/std/lzw.c @@ -12,6 +12,8 @@ // See the License for the specific language governing permissions and // limitations under the License. +// ---------------- + /* This test program is typically run indirectly, by the "wuffs test" or "wuffs bench" commands. These commands take an optional "-mimic" flag to check that diff --git a/test/c/std/zlib.c b/test/c/std/zlib.c index 252a4fea..93cc833b 100644 --- a/test/c/std/zlib.c +++ b/test/c/std/zlib.c @@ -12,6 +12,8 @@ // See the License for the specific language governing permissions and // limitations under the License. +// ---------------- + /* This test program is typically run indirectly, by the "wuffs test" or "wuffs bench" commands. These commands take an optional "-mimic" flag to check that