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.
constCreateFileMapError = error{
/// MaximumSize is greater than the system-defined maximum for sections, or/// greater than the specified file and the section is not writable.SectionOversize,
/// A file descriptor refers to a non-regular file. Or a file mapping was requested,/// but the file descriptor is not open for reading. Or `MAP.SHARED` was requested/// and `PROT_WRITE` is set, but the file descriptor is not open in `RDWR` mode./// Or `PROT_WRITE` is set, but the file is append-only.AccessDenied,
/// The `prot` argument asks for `PROT_EXEC` but the mapped area belongs to a file on/// a filesystem that was mounted no-exec.PermissionDenied,
FileBusy,
LockedMemoryLimitExceeded,
OperationUnsupported,
ProcessFdQuotaExceeded,
SystemFdQuotaExceeded,
OutOfMemory,
MappingAlreadyExists,
Unseekable,
LockViolation,
} || Io.Cancelable || Io.UnexpectedError