Subject: Re: bug#35595: subr.el Commentary + Code sections

From: [email-masked]
Date: Tue, 07 May 2019 15:31:05 -0400

retitle 35595 subr.el Commentary + Code sections
quit

Van L <[email-masked]> writes:

> +++ b/lisp/subr.el
> @@ -22,9 +22,12 @@
>  ;; You should have received a copy of the GNU General Public License
>  ;; along with GNU Emacs.  If not, see <https://www.gnu.org/licenses/>.
>  
> +;;; Commentary:
> +
>  ;; 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?
  
> +;;; Code:
>  
>  ;; declare-function's args use &rest, not &optional, for compatibility
>  ;; with byte-compile-macroexpand-declare-function.