document __init__ (fix #8923)
Merge pull request #9240 from stevengj/init_doc

document __init__