Fix link format for changes in PR 4940 (std.numeric.gcd)

[wilzbach]

Fixup for #4940, which was merged prematurely :/

[andralex]

I don't see this necessary.

[CyberShadow]

This patch is wrong, you need to add the protocol if you change the macro away from HTTP/HTTPS.

[andralex]

I don't mean to antagonize but please let's let this go. Thanks.

[andralex]

Actually I might be missing something - was there a problem with the way links were previously generated?

[wilzbach]

Ah damn - I just read the PR mail on my phone and didn't realize that the change was already part of the PR.
-> sorry for the noise ;/

(there's the bigger discussion of deprecating HTTP/HTTPS in favor of LINK2, but that's another day)

[andralex]

@wilzbach an epic discussion is occurring right now on irc

[CyberShadow]

@wilzbach @aG0aep6G Andrei and I had a quick debate on IRC about HTTP/HTTPS vs. LINK2 & co. and one strong argument in favor of HTTP/HTTPS is DDoc's special handling handling of : (i.e. when the URL starts at the beginning of the line). When text is rewrapped in the editor this can put the URL at the beginning of the line, which spontaneously breaks links.

An idea we came to is to change DMD's DDoc parsing to treat : specially (as section header terminator) only when it's followed by whitespace (incl. a newline). Breakage should be minimal. With this change, moving away from HTTP/HTTPS macros would become more feasible. This can also make writing inline CSS less painful.

[MartinNowak]

The perils of having reinvented source code documentation format... ;)

[aG0aep6G]

@wilzbach @aG0aep6G Andrei and I had a quick debate on IRC about HTTP/HTTPS vs. LINK2 & co. and one strong argument in favor of HTTP/HTTPS is DDoc's special handling handling of : (i.e. when the URL starts at the beginning of the line). When text is rewrapped in the editor this can put the URL at the beginning of the line, which spontaneously breaks links.

I'm aware of that argument. I think it's rather weak, because HTTP/HTTPS still fail when the comment is indented somehow, which is common.

An idea we came to is to change DMD's DDoc parsing to treat : specially (as section header terminator) only when it's followed by whitespace (incl. a newline).

Old news ;) Sounds good to me, obviously.

[andralex]

FWIW I don't indent documentation.

[andralex]

@MartinNowak which one are you referring to at the time ddoc was introduced?

[aG0aep6G]

FWIW I don't indent documentation.

Yes, you do:

phobos/std/experimental/checkedint.d

Lines 195 to 197 in 85fcd4a

	/**
	The type of the integral subject to checking.
	*/