================
auto_index notes
================

 * The static const boost::array<> 'names' (function-local to
   can_contain_indexterm in auto_index.cpp line 166, should_flatten_node 
   in auto_index.cpp line 194) are initialized in a fashion that creates a
   ton of warnings on clang. Also, the initalized content is all on one line,
   which is unattractive to those viewing the code.
 * boost.program_options is not used for the command line processing; instead,
   manual processing is done.
 * Unrecognised is misspelled at line 559 in auto_index.cpp.
 * Semantics is misspelled at line 43 in tiny_xml.hpp.
 * Occurrence(s) is misspelled at line 20, 28, 298, 308, 312, 396, 400, 406,
   413, 416, 423, 442, 552 and 558 in auto_index.qbk.
 * Attributes is misspelled at line 58 in auto_index.qbk.
 * Appropriate is misspelled at line 70 in auto_index.qbk. 
 * "bjam Jamfile features" at line 81 in auto_index.qbk is vague. Boost.Build
   features is more appropriate (IMO).
 * Recommended is misspelled at line 229 in auto_index.qbk.
 * Restrict is misspelled at line 315 and 526 in auto_index.qbk.
 * Boolean is misspelled at line 461 in auto_index.qbk.
 * A number of lines in the source code are excessively long.
 * Jamfile issues.