[Docutils-develop] reST include update

[Dethe E. <de...@en...>]

Hi folks,

Sorry for the delay.  In the past few weeks we've completed the 
acquisition of my company by a larger company, started to merge the two 
(which has involved changing all computer systems, among other things), 
my mom has immigrated to Canada and we've gotten her settled in, my 
daughter started first grade, and my wife had a multiple-of-five 
birthday.

However, I have finally gotten my sandbox build on SourceForge and in 
it is a copy of parsers/rst/directives/__init__.py which I believe 
approximates the parse_directive function that we've discussed here.  
Please feel free to look at it and suggest improvements and point out 
problems.

Next I'm going to reimplement the include and raw directives using the 
new function.  I'll then add examples to the HOWTO, along with Aahz's 
corrections (thanks, Aahz!).

--Dethe