From ef367df50a7f079a12705c1bad511cbdf104264e Mon Sep 17 00:00:00 2001 From: goodger Date: Thu, 17 Jun 2010 20:16:08 +0000 Subject: split out usage section, added info about rst-mode in recent Emacs git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk@6346 929543f6-e4f2-0310-98a6-ba3bd3dd1d04 --- docutils/docs/user/emacs.txt | 37 +++++++++++++++++++++++++++---------- 1 file changed, 27 insertions(+), 10 deletions(-) (limited to 'docutils/docs') diff --git a/docutils/docs/user/emacs.txt b/docutils/docs/user/emacs.txt index 5d6c16066..6a7503f82 100644 --- a/docutils/docs/user/emacs.txt +++ b/docutils/docs/user/emacs.txt @@ -56,23 +56,39 @@ reStructuredText_: ``rst.el``. This document describes the features it provides, and how to setup your emacs to use them and how to invoke them. -``rst.el`` can be found in the ``tools/editors/emacs/`` directory of -the snapshot or repository. `A copy can also be downloaded here. -`__ - Installation ============ -The emacs support is implemented as an Emacs major mode (``rst-mode``) -provided by the ``rst.el`` emacs package. In order to use -``rst-mode``, you need to put the ``rst.el`` in a directory located in -your emacs ``load-path`` (use ``C-h v load-path`` to check), and load -it with:: +Emacs support for reStructuredText is implemented as an Emacs major +mode (``rst-mode``) provided by the ``rst.el`` emacs package. + +For recent versions of Emacs, there's no need to install anything to +get reST support; ``rst-mode`` is already available. So:: + + M-x rst-mode + +will work out of the box. If this works for you, please skip to the +Usage_ section. + +For older versions of Emacs, ``rst.el`` can be found in the +``tools/editors/emacs/`` directory of the Docutils snapshot or +repository. `A copy can also be downloaded here. +`__ + +In order to use ``rst-mode``, you need to put the ``rst.el`` in a +directory located in your emacs ``load-path`` (use ``C-h v load-path`` +to check). + + +Usage +===== + +Load rst-mode with:: (require 'rst) -To enable ``rst-mode``, simple type ``M-x rst-mode``. Alternatively, +To enable ``rst-mode``, simply type ``M-x rst-mode``. Alternatively, you can modify ``auto-mode-alist`` to automatically turn it on whenever you visit reStructuredText_ documents:: @@ -117,6 +133,7 @@ decorations and to build the hierarchy of the document. What we call section decorations or adornments are the underlines or under- and overlines used to mark a section title. + Adjusting a Section Title ------------------------- -- cgit v1.2.1