[Issue 15460] Ddoc: merge the opening comment "<!-- Generated by Ddoc from filename.dd -->" into the default definition of DDOC

via Digitalmars-d-bugs digitalmars-d-bugs at puremagic.com
Fri Dec 18 09:51:31 PST 2015


https://issues.dlang.org/show_bug.cgi?id=15460

--- Comment #7 from Adam D. Ruppe <destructionator at gmail.com> ---
The auto tester cares about the exact bytes ddoc puts out?!?! Looks like it is
failing because there's a space... but I didn't change the spaces... must be
the change of new lines. This is ridiculous. Spaces don't even affect HTML.

I fear going through and improving the default macros because of these over
specific tests. If I change a default macro to include a class name, the auto
tester is going to fail it!

See, this is the big lie about low hanging fruit. A minor, obviously trivial
change (just moving a useless comment!), means spending hours fighting with the
tester too. If it was easy to use and catching legitimate bugs, I'd be OK with
it... but it isn't easy to use (the Starting as a contributor page doesn't even
*mention* dmd tests, and what it says about the Phobos one reveals yet another
dmd makefile bug) and this isn't catching actual bugs. It is whining about
spaces in HTML... which are ignored in HTML.




Friction like this just kills my momentum and spends time that I could have
spent doing actually valuable stuff on chasing down an irrelevant whitespace
"problem" that apparently appeared out of nowhere. (Seriously, look at the
diff. The spaces were already there. Why is it only now complaining about it?
But the tester failed before and is passing now so apparently it makes a
difference. Illogical.)

--


More information about the Digitalmars-d-bugs mailing list