This is more of a doc generation suggestion.  I think it would be good if of doc generator had some infromation about the line number where the code begins. This would help enable furture IDE's to use the documentation as a basics for the IDE layout.
 
I know I've said this before, but It would be cool if the docgen could produce code in an uml format.
 
PS - Robert M. Münch tool produces quite nice output, and I'd recommend it for this "Code documentation attachement". Also it mite be an idea for the D Journal if documents are to be produced to some standard (although it may mean extra reformating work). It handles code segments especially well (by picking up tabs).