Please follow the 1-space indentation in the documentation files. I think the style of mentioning all the problems in a note before the actual description is a bit backwards.
The layout of the section should be: - This is what it does. - Here are some comparisons with other methods. - For this or that reason, it's deprecated. -- Peter Eisentraut http://www.2ndQuadrant.com/ PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services