Include documentation updates

All, After reviewing the to-do items I saw that the include() documentation needed to be updated. I took a stab at simplifying the first few paragraphs which mostly involved removing verbose text and simplifying. Since the change is fairly significant I wanted to solicit feedback from the group instead of simply committing it. If I don't hear any suggestions I'll assume that it works and I'll commit it.

Attachment: [application/octet-stream] include.xml.diff