Add a small backwards compatibility script for rst2odt_prepstyles.py.

This way, users can adapt to the new command before the
"tools/*.py" scripts are no longer installed in Docutils 0.21.

git-svn-id: https://svn.code.sf.net/p/docutils/code/trunk@9387 929543f6-e4f2-0310-98a6-ba3bd3dd1d04

1 files changed, 14 insertions, 12 deletions

diff --git a/docutils/docs/user/odt.txt b/docutils/docs/user/odt.txt
index 19ba63a69..ec7ea0e55 100644
--- a/docutils/docs/user/odt.txt
+++ b/docutils/docs/user/odt.txt
@@ -657,14 +657,13 @@ Why custom stylesheets
 
 Here are a few reasons and ideas:
 
-- The page size is stored in the style sheet.  The default page
-  size is ``Letter``.  You can change the page size (for example,
+- The `page size`_ is stored in the style sheet.  The default page
+  size is ``US Letter``.  You can change the page size (for example,
   to ``A4``) in your custom stylesheet by opening it in
   ``oowriter``, then clicking on menu: ``Format/Page...``, then
   clicking on the ``Page`` tab.
 
 
-
 Defining and using custom style names
 -------------------------------------
 
@@ -1064,12 +1063,12 @@ They cause ``oowriter`` to croak.
 Page size
 ---------
 
-The default page size, in documents generated by ``odtwriter`` is
-``Letter``.  You can change this (for example to ``A4``) by using a
+The default page size, in documents generated by the ODT writer is
+"US Letter".  You can change this (for example to ``A4``) by using a
 custom stylesheet.  See `Defining and using a custom stylesheet`_
 for instructions on how to do this.
 
-On machines which support ``paperconf``, ``odtwriter`` can insert
+On machines which support ``paperconf``, the ODT writer can insert
 the default page size for your locale.  In order for this to work,
 the following conditions must be met:
 
@@ -1077,13 +1076,16 @@ the following conditions must be met:
    ``odtwriter`` uses ``paperconf -s`` to obtain the paper size.
    See ``man paperconf`` for more information.
 
-2. The default page height and width must be removed from the
-   ``styles.odt`` used to generate the document.  A Python script
-   ``rst2odt_prepstyles.py`` is distributed with ``odtwriter`` and
-   is installed in the ``bin`` directory.  You can remove the page
-   height and width with something like the following::
+2. The page height and width settings must be absent from the stylesheet
+   used to generate the document.
+   
+   You can use the Python script ``prepstyles.py`` distributed with
+   Docutils to remove the page height and width settings from a
+   stylesheet file ``STYLES.odt`` with ::
 
-       $ rst2odt_prepstyles.py styles.odt
+       $ python3 -m docutils.writers.odf_odt.prepstyles STYLES.odt
+   
+   (the command changed in Docutils 0.20.1).
 
 .. warning:: If you edit your stylesheet in ``oowriter`` and then
     save it, ``oowriter`` automatically inserts a page height and