News for hackers. Stuff that matters.

A comment on Deutsche Bank makes source code publicly available for the first time. Parent comment

Re:Deutsche Bank makes source code publicly available for th... by jackewiehose on Sunday October 08, 2017 @09:10PM (#15430971)
Embedding XML inside a C-comment (as a standard) is just fucked up. Do you have correct syntax highlighting with that? (I don't. But even if emacs would understand this, it's still wrong)
[ Parent | on HN ]
Re:Deutsche Bank makes source code publicly available for th... by _dcwr on Thursday October 12, 2017 @12:39PM (#15459235)
C++ with Doxygen and Java with Javadoc are much saner formats for this purpose.

What's even worse is that Visual Studio 2015 just vomits out that the XML is malformed when I have C++ headers with Doxygen style comments in them. It detects the three slashes and tries to apply C# XML docs parsing to them and that of course fails. Meanwhile NetBeans can handle them no problem and display parsed docs in pop ups.

[ Parent | on HN ]
Re:Deutsche Bank makes source code publicly available for th... by MichaelGG on Sunday October 08, 2017 @10:31PM (#15431214)
Yeah, it's a mess. F# got it right, use triple slash to provide a summary. C# should have at least gotten that, instead of forcing so much XML all the time.
[ Parent | on HN ]