www.digitalmars.com         C & C++   DMDScript  

digitalmars.D - Multi-word headings broken in dlang.org

reply "H. S. Teoh via Digitalmars-d" <digitalmars-d puremagic.com> writes:
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.
Feb 16 2015
parent reply Walter Bright <newshound2 digitalmars.com> writes:
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.
Feb 17 2015
parent "H. S. Teoh via Digitalmars-d" <digitalmars-d puremagic.com> writes:
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.
Feb 17 2015