General guidelines:

===================

- If there's a *_a() macro that wraps an API, use the macro if

possible. These use countof() to add bounds safety.

- If there's a *_T() macro that wraps an API, use the macro if

possible. These use _Generic() to add type safety.

Prefer *_a() macros over *_T() macros.

- If there's an upper-case macro that wraps a function, use the macro

if possible. These use macro magic to add safety.

Prefer *_T() macros over upper-case macros.

Specific guidelines:

====================

Under lib/io/ we provide a set of APIs to do IO.

In this section, we provide a broad overview.

fgets/ - Read lines

fgets_a()

Like fgets(3), but takes an array.

syslog.h - System log

SYSLOG()

Like syslog(3), but uses the C locale if necessary.