This is an example of documentation generated by ZigDoc, an alternative to Zig's built-in Auto Doc feature. See also examples in other modes/formats. The project being documented here (as the example) is the Zig library itself.
fnrebase(r: *Reader, capacity: usize) void {
constd: *Decompress = @alignCast(@fieldParentPtr("reader", r));
// `capacity` must fit in the buffer along with the required sliding windowassert(capacity <= r.buffer.len - d.window_len);
// According to the vtable contract, this function will only be called if the free space in the
// buffer cannot already fit `capacity` bytes
assert(r.end + capacity > r.buffer.len);
constdiscard_n = @min(r.seek, r.end - d.window_len);
constkeep = r.buffer[discard_n..r.end];
@memmove(r.buffer[0..keep.len], keep);
r.end = keep.len;
r.seek -= discard_n;
}