GNU bug report logs - #35595
subr.el Commentary + Code sections

Previous Next

Full log

View this message in rfc822 format

From: Van L <van <at> scratch.space>
To: npostavs <at> gmail.com
Cc: 35595 <at> debbugs.gnu.org
Subject: bug#35595: subr.el Commentary + Code sections
Date: Wed, 8 May 2019 13:40:23 +1000

> On 8 May 2019, at 05:31, npostavs <at> gmail.com wrote:
> 
>> ;; Beware: while this file has tag `utf-8', before it's compiled, it gets
>> ;; loaded as "raw-text", so non-ASCII chars won't work right during bootstrap.
> 
> Not sure if this really qualifies as "introductory comments that explain
> how the library works."  Also, where it says "has tag `utf-8'" what is
> it referring to?  A coding cookie that was since removed perhaps?

To quote from htdp.org/prologue:

...>8

… comments are intended for human readers. It is a “back channel” of 
communication between the author of the program and
all of its future readers to convey information about the
program.

...>8

*Magic Numbers* …

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.