Rename LIBS to FLAGS, fix readme and update API

Also give a brief remark about karuibar only supporting one file
descriptor per module.