Document y_lib.c
Document y_logging.c and mark some old stuff for removal.
Improve the y_logging.c documentation.