summaryrefslogtreecommitdiff
path: root/docs/user/emacs.txt
diff options
context:
space:
mode:
Diffstat (limited to 'docs/user/emacs.txt')
-rw-r--r--docs/user/emacs.txt27
1 files changed, 21 insertions, 6 deletions
diff --git a/docs/user/emacs.txt b/docs/user/emacs.txt
index a965bc2da..ac88b223a 100644
--- a/docs/user/emacs.txt
+++ b/docs/user/emacs.txt
@@ -263,9 +263,8 @@ C-p`` and ``C-c C-n``).
Shifting Bullet List Levels
===========================
-Due to the nature of reStructuredText_, bullet lists are always
-indented by two characters (unless they are part of a blockquote),
-e.g. ::
+Due to the nature of reStructuredText_, bulleted lists are indented by
+two characters (unless they are part of a blockquote), e.g. ::
- Fruits
@@ -278,11 +277,27 @@ e.g. ::
- Zucchini
- Chick Peas
+Enumerated lists, however, as indented by 3 or more characters ::
+
+ 9. Apples
+
+ Oranges are tasty.
+
+ 10. Oranges
+
+ Oranges are zesty.
+
+
To this effect, when re-organizing bullet lists, it can be useful to
-shift regions of text by indents of two characters. You can use the
-``C-c C-r`` and ``C-c C-l`` to shift the current region. These
+have functions to shift regions of text by appropriate indents, which
+are figured out automatically by emacs.
+
+You can use ``C-c C-r`` and ``C-c C-l`` to shift the current region
+(``rst-shift-region-right`` and ``rst-shift-region-left``). These
bindings are similar to the ones provided by python-mode for editing
-python code and behave similarly.
+python code and behave similarly. They inspect the lines of text
+before the currently selected region to determine what the appropriate
+column positions are.
Major Mode for Editing reStructuredText Documents