docbook updates for adapter