Documentation cleanup for clang-c: * Add parameter names to various \param commands; * Ensure that \brief summaries are followed by blank lines where needed to   prevent subsequent text being merged into the summary; * Mark code examples with \code...\endcode so that they're appropriately   formatted by Doxygen. * Add qualification for links to field of structs (specifically callbacks); * Escape #, @ and < as needed to avoid them being interpreted by Doxygen; * Remove incorrect uses of "\see name", preferring #name; * Fix a glitchy "\param Returns..." to be "\returns"; * Fix parameter names given to \param, typos and otherwise.
Documentation cleanup for clang-c:
* Add parameter names to various \param commands;
* Ensure that \brief summaries are followed by blank lines where needed to
  prevent subsequent text being merged into the summary;
* Mark code examples with \code...\endcode so that they're appropriately
  formatted by Doxygen.
* Add qualification for links to field of structs (specifically callbacks);
* Escape #, @ and < as needed to avoid them being interpreted by Doxygen;
* Remove incorrect uses of "\see name", preferring #name;
* Fix a glitchy "\param Returns..." to be "\returns";
* Fix parameter names given to \param, typos and otherwise.



git-svn-id: ffe668792ed300d6c2daa1f6eba2e0aa28d7ec6c@158489 91177308-0d34-0410-b5e6-96231b3b80d8

llvm-mirror/clang,apple/swift-clang,llvm-mirror/clang,llvm-mirror/clang,apple/swift-clang,apple/swift-clang,llvm-mirror/clang,llvm-mirror/clang,apple/swift-clang,apple/swift-clang,apple/swift-clang,llvm-mirror/clang,apple/swift-clang,llvm-mirror/clang,llvm-mirror/clang,llvm-mirror/clang,apple/swift-clang,llvm-mirror/clang,apple/swift-clang,apple/swift-clang