Re: Refactoring in rst.el

[Paul Eggert]

Stefan Merten wrote:

> Which raises the question what the API of `rst.el` is.

When in doubt, document the change in the ChangeLog.

> I remember
> that in Emacs you started using a double dash in identifiers to mark
> them private.

Yes. The part in front of the double-dash is the module name.

> If so, I'd probably like to mark internal functions this way. That
> would be a good idea IMHO.

Yes, that's a reasonable change. It'd be a change to the API, and should be 
documented in the ChangeLog and in any other documentation to the package.

After that happens, it's a good idea to document even changes to the internal 
API, for benefit of those maintaining the code in question.