[patch] Various improvements to TOC macro for 0.11

[osimons]

Enclosed is a patch that:

• Accepts wildcard (ike 'Trac*') as input for pagename (will close #480).
• Respects notitle argument also for titleindex only making it a list of the page names.
• For empty pages and titleindex, it will add all pages instead of just the current page (a much more useful title index...)
• Changes default heading to 'Page Index' if it is a titleindex being rendered (and it is not replaced by another heading as argument, or noheading is passed).
• Properly highlights the current page if it exists in a title index list.
• Does some updates to resolve the various FIXME: and TODO: items in the code.
• Updates documentation to reflect these changes, and also removes a piece information that has not been true for some time.

As far as I can tell, these changes are all very gentle with regards to existing uses of the macro - I don't think they will be affected negatively.

[osimons]

Patch for r2460 - various improvements to TOC macro.

[osimons]

Oops. Typo in title. Updated.

[osimons]

Patch updated for new resource / context APIs + supporting new fine-grained security + reviewed all code again.

[osimons]

(In [2801]) TocMacro: Various improvements + support for latest 0.11dev with context refactoring + fine-grained permissions.

For details see #1784 - some highlights:

• Wildcard support on page names
• titleindex for no pages will return all pages
• and, see ticket for more...

[osimons]

Commit done. Ticket closed.