*   hooks to SYNOPSIS and docs
