My biggest annoyance with ddoc generated files is that when pasting code samples (eg: The Example sample from http://dlang.org/phobos/std_algorithm.html), newline characters disappear, resulting in one giant line.
For example this is part of the html for the generated example box: sort!(greater)(a); <span class="d_comment">// predicate as alias </span>sort!(<span class="d_string">"a > b"</span>)(a); <span class="d_comment">// predicate as string Any plan in adding a <BR> at the end of each line in ddoc generation or something similar, so that pasting will preserve newlines?