[Docutils-users] New version of rst.el

[Stefan M. <sm...@oe...>]

Hi Emacs users!

I committed a new version of `rst.el`_ to r6713. This version contains
major internal refactorings most of which are not visible for the
user. There is quite some test coverage meanwhile so refactoring
should introduce no new errors.

.. _rst.el: svn://svn.berlios.de/docutils/trunk/docutils/tools/editors/emacs/rst.el

These are the user visible changes hoping I didn't forget any:

Key bindings changed
====================

According to Emacs standards the old key bindings left no room for new
commands. I decided to rebind most keys to have two keys after the
leading C-c so there is room for new commands. Another point is to use
key bindings which are well known from other Emacs modes and therefore
cause less hassle to the experienced Emacser. When in reStructuredText
mode try C-c C-h for the new bindings.

Old bindings are deprecated. Most of them still work but give a
warning informing about the new key binding.

I know that this measure may cause pain. However, it was necessary to
make further development possible.

Font-locking
============

Section manipulation and font-locking share the same idea of the
section adornment hierarchy and recognize section adornment better.
Thus font-locking and section adornment is more consistent and
correct.

`jit-lock-mode` is now on by default. On slow machines this may cause
a slow down close to huge blocks of comments or literal text. I'm in
contact with the Emacs maintainer about this problem but it is a
general problem in `jit-lock-mode`. I'm interested in problem reports.
If it doesn't work properly for too many I'll change that again.

New list insertion command
==========================

Based on code from Wei-Wei Guo there is now `rst-insert-list` (C-c C-l
C-i) inserting a list item matching the current list.

Shift region command changed
============================

`rst-shift-region` now works like `indent-rigidly`. I.e. you can give
a positive or negative argument to control direction and amount of
reStructuredText indendation points you want to change indendation of
the region by. There is only one key binding (C-c C-r TAB).

`rst-shift-region` does not fill any more - this should be left to the
user. Variable `rst-shift-fill-region` is removed therefore.
`rst-shift-region` doesn't drop the region.

`rst-indent-width` has been renamed from `rst-shift-basic-offset` and
is customizable.

Ideas
=====

There is a `file for ideas`_. Suggestions for further improvement are
welcome.

.. _file for ideas: svn://svn.berlios.de/docutils/trunk/docutils/tools/editors/emacs/IDEAS.rst

Minor changes
=============

`rst-preferred-decorations` has been renamed to
`rst-preferred-adornments`. An `define-obsolete-variable-alias` is in
place so this should do no harm. `rst-preferred-decorations` has a
proper customization type.

Compilation commands use and remove temporary files fixing bug
#2912890.

Removed compatibility code for Emacs before V22.

`paragraph-separate` is set explicitly and `paragraph-start` is more
valid.

Bug #2972588 fixed as a side effect of refactorings.


						Grüße

						Stefan