GNU bug report logs - #14655
24.3; (looking-at comment-start-skip) in newcomment.el

Previous Next

Full log

Message #13 received at 14655 <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: Glenn Morris <rgm <at> gnu.org>, Thorsten Jolitz <tjolitz <at> googlemail.com>
Cc: 14655 <at> debbugs.gnu.org
Subject: RE: bug#14655: 24.3; (looking-at comment-start-skip) in newcomment.el
Date: Tue, 18 Jun 2013 11:30:11 -0700 (PDT)

> From the commentary of newcomment.el:
> 
> ;; Prior to calling any `comment-*' function, you should ensure that
> ;; `comment-normalize-vars' is first called to set up the appropriate
> ;; variables; except for the `comment-*' commands, which call
> ;; `comment-normalize-vars' automatically as a subroutine.

Yes.  I'm not sure what the "solution" is, but this seems to be a
common gotcha.  Yes, someone coding with functions from the library
should presumably read the file Commentary.  Still, we can perhaps do
better, to try to get this info across.

Mentioning it in doc string might help.  But perhaps there is a better
idea.

Previous Next

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