documented the mysterious entry point
refactor for clarity