[COFF] Code/comment Ratios Style

Larry McVoy lm at mcvoy.com
Mon Jul 21 12:06:38 AEST 2025


On Sun, Jul 20, 2025 at 08:30:45PM -0400, Douglas McIlroy wrote:
> I just posted the most heavily commented code I have ever written.
> It's a radical (mis?)application of m4, which is about as inscrutable
> as any language short of APL. The ratio of comments to code is more
> than 3:1.
> It's at www.cs.dartmouth.edu/~doug/barem4.m4. 3:1 may be
> overkill, but I think 2:1 would not be unreasonable.
> 
> Doug

Whenever I see something like this, it reminds me of one of my engineers
who said you couldn't make BK produce json out put.

Hold my beer.

http://mcvoy.com/lm/bkdocs/dspec-changes-json-v.txt

It's a lot less miserable than the m4 (and I'm a fan of m4).


More information about the COFF mailing list