News for hackers. Stuff that matters.
Re:Ask HN: Anyone using proportional fonts for coding? by CharlesW on Saturday July 29, 2023 @11:57PM (#36927670)
I propose we start the revolution with comment blocks.

https://developer.apple.com/library/archive/documentation/Xc...

Re:Ask HN: Anyone using proportional fonts for coding? by metadat on Sunday July 30, 2023 @12:00AM (#36927687)
What is the colon (:) thing about?

E.g.

    /*:
       Some comment
     */
Is there a legitimate reason for the non-C addition atop a C-syntax?
Re:Ask HN: Anyone using proportional fonts for coding? by thristian on Sunday July 30, 2023 @12:35AM (#36927840)
It seems to be a convention that means "this comment contains Markdown and should be rendered in the generated documentation" as opposed to commenting out unused code or whatever.
Re:Ask HN: Anyone using proportional fonts for coding? by nyolfen on Sunday July 30, 2023 @12:50AM (#36927909)
it's to mark the comments in these blocks to be extracted for formatted documentation generation rather than conventional code comments
Re:Ask HN: Anyone using proportional fonts for coding? by Someone on Monday July 31, 2023 @03:10PM (#36947374)
Weirdly, it doesn’t seem to be DocC (https://developer.apple.com/documentation/docc)