summaryrefslogtreecommitdiff
path: root/sandbox/blais/movesec/README.txt
blob: 04e4e44aaef29f9dfb09634890d61b1ae0bcc49a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
================
docutils-movesec
================

:Author: Martin Blais
:Contact: blais@furius.ca
:Date: $Date$


A script that can raise or lower (shift) the levels of the underline characters
defining the sections of a file.

From an email on the list::

  > > i want to contribute my movesec script that rotates the section
  > > markers.  i use it every now and then and i'm finding it useful and
  > > stable enough that i think other should be able to enjoy it too.
  >
  > "Rotates"?

  yes, it raises or lowers the "levels" of the underline characters of a
  file.  it shifts them either up or down (in level), and introduces a
  new underline character for the new level.

  this is useful when you're reorganizing the sections of part of a
  file, for example.  you could use this on a section of a file only
  using shell-command-on-region in emacs (i still need to write a hook
  to do that).


.. important::  

   You can now do that within emacs using rest-adjust with an active region, see
   restructuredtext.el for details.