minor rst syntax fix and addin some comments.