Multi-word headings broken in dlang.org

H. S. Teoh via Digitalmars-d digitalmars-d at puremagic.com
Tue Feb 17 14:24:13 PST 2015


On Tue, Feb 17, 2015 at 12:00:26PM -0800, Walter Bright via Digitalmars-d wrote:
> On 2/16/2015 7:51 PM, H. S. Teoh via Digitalmars-d wrote:
> >Something recently broke in the dlang.org repo; now multi-word
> >headings are not properly rendered in HTML. See, for example:
> >
> >	http://dlang.org/phobos-prerelease/std_string#.translate
> >
> >The heading "SeeAlso" appears as a single word, whereas it should be
> >two words "See Also". This doesn't appear to be a bug in the source
> >code itself, because running dmd -D on the source file directly does
> >not produce this effect (the correct two-word heading is produced).
> >Rather, it seems to be an artifact of some kind of post-processing
> >script in the dlang.org repo (or perhaps in the Phobos makefile) that
> >also introduces anchor tags around the heading.
> >
> >This needs to be fixed ASAP, as it looks *really* ugly.
> 
> That's why there is "See_Also". I agree that looks awkward, so
> sometimes use "References" instead.

The source code *does* use See_Also. The problem is that Andrei's macros
substituted that with SeeAlso. :-P  But no worries, it's all fixed now.


T

-- 
The trouble with TCP jokes is that it's like hearing the same joke over and over.


More information about the Digitalmars-d mailing list