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.


T

-- 
Computers aren't intelligent; they only think they are.

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.

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.