[Docutils-checkins] SF.net SVN: docutils:[9446] trunk/docutils

SourceForge Headquarters 1320 Columbia Street Suite 310 San Diego, CA 92101 +1 (858) 422-6466

Revision: 9446
          http://sourceforge.net/p/docutils/code/9446
Author:   milde
Date:     2023-09-05 23:03:38 +0000 (Tue, 05 Sep 2023)
Log Message:
-----------
Documentation update.

Sort HISTORY entries alphabetically.
Patch number for Georgian language support.

Add Georgian to the list of supported natural laguages.

Modified Paths:
--------------
    trunk/docutils/HISTORY.txt
    trunk/docutils/README.txt
    trunk/docutils/RELEASE-NOTES.txt
    trunk/docutils/docs/dev/release.txt
    trunk/docutils/docs/dev/repository.txt
    trunk/docutils/setup.py

Modified: trunk/docutils/HISTORY.txt
===================================================================

--- trunk/docutils/HISTORY.txt	2023-08-23 13:00:10 UTC (rev 9445)
+++ trunk/docutils/HISTORY.txt	2023-09-05 23:03:38 UTC (rev 9446)
@@ -35,6 +35,14 @@
   .. _UTF-8 mode: https://docs.python.org/3/library/os.html#utf8-mode
   .. _input encoding: docs/api/publisher.html#encodings
 
+* docutils/languages/, docutils/parsers/rst/languages/
+
+  - Mark/Fix mistranslated localizations of the "admonition" directive
+    name. In Docutils, "admonition" is used as a generic term for
+    "advice"/"advisory"/"remark", not a reprimand.
+
+  - Add support for Georgian language (patch #204 by Temuri Doghonadze).
+
 * docutils/nodes.py
 
   - Remove compatibility hacks `nodes.reprunicode` and `nodes.ensure_str()`.
@@ -47,12 +55,6 @@
   - Move `parsers.rst.directives.Table.process_header_option()` to
     `parsers.rst.directives.CSVTable`.
 
-* docutils/parsers/rst/languages/
-
-  Mark/Fix mistranslated localizations of the "admonition" directive name.
-  In Docutils, "admonition" is used as a generic term for
-  "advice"/"advisory"/"remark", not a reprimand.
-
 * docutils/utils/roman.py
 
   - Update to version `1.4 <https://pypi.org/project/roman/4.1/>`__.
@@ -62,6 +64,11 @@
 
   - Fix placement of hyperlink target (label) for tables (bug #440).
 
+* docutils/writers/manpage.py
+
+  - Apply literal block patch #205. Use ``.EE`` and ``.EX`` macros.
+    Thanks to G. Branden Robinson (I assume).
+
 * docutils/writers/odf_odt/__init__.py
 
   - Use context manager for image reading operations.
@@ -88,16 +95,7 @@
 
   - Warn, if image scaling fails because the image file cannot be read.
 
-* docutils/writers/manpage.py
 
-  - Apply literal block patch #205. Use ``.EE`` and ``.EX`` macros.
-    Thanks to G. Branden Robinson (I assume).
-
-* Add language support for georgian language (thanks to Temuri Doghonadze)
-
-  - docutils/languages/ka.py
-  - docutils/parsers/rst/languages/ka.py
-
 Release 0.20.1 (2023-05-17)
 ===========================
 
@@ -1109,8 +1107,8 @@
 
 * docutils/writers/odf_odt/__init__.py
 
-  - Command line setting `language`_ now sets the default language
-    of the generated ODF document.
+  - Command line setting `language`_ now sets the default language of the
+  generated ODF document.
   - The use of image directive options :width: (%), :scale:, etc now
     set the width/height/size of images in the generated ODF
     documents.

Modified: trunk/docutils/README.txt
===================================================================
--- trunk/docutils/README.txt	2023-08-23 13:00:10 UTC (rev 9445)
+++ trunk/docutils/README.txt	2023-09-05 23:03:38 UTC (rev 9446)
@@ -133,8 +133,9 @@
 
          pip install -e .  # editable install
          pip install .     # regular install
-         python setup.py   # regular install with setuptools
 
+     or do a `"manual" install`_.
+
   4. Optional steps:
 
      * `Running the test suite`_
@@ -162,6 +163,7 @@
 .. _"editable" install:
     https://pip.pypa.io/en/stable/topics/local-project-installs/
     #editable-installs
+.. _"manual" install: docs/dev/repository.html#manual-install
 
 
 GNU/Linux, BSDs, Unix, Mac OS X, etc.

Modified: trunk/docutils/RELEASE-NOTES.txt
===================================================================
--- trunk/docutils/RELEASE-NOTES.txt	2023-08-23 13:00:10 UTC (rev 9445)
+++ trunk/docutils/RELEASE-NOTES.txt	2023-09-05 23:03:38 UTC (rev 9446)
@@ -102,9 +102,9 @@
 
     .. _reference-label: docs/user/config.html#reference-label
 
-
 * "null" writer: output will change to the empty string in Docutils 0.22.
 
+
 Misc
 ----
 
@@ -134,11 +134,12 @@
 * Remove mistranslated localizations of the "admonition" directive name in
   Docutils 0.22 or later.
 
-  Use the English term (or specific admonitions) instead of
-  "aanmaning" (nl), "admonition" (fr), "ammonizione" (it),
-  "ermahnung" (de), "exhortación" (es), "formaning" (da), "sciigo" (eo),
-  "upomnienie" (pl), "vermaning" (af), to avoid errors in future
-  conversions.
+  Use the English term, matching translations introduced in Docutils 0.21,
+  or specific admonitions instead of "aanmaning" (nl),
+  "admonition" (fr), "ammonizione" (it), "ermahnung" (de),
+  "exhortación" (es), "formaning" (da), "sciigo" (eo),
+  "upomnienie" (pl), "vermaning" (af),
+  to avoid errors in future conversions.
 
 .. _front end tools: docs/user/tools.html
 .. _input_encoding: docs/user/config.html#input-encoding
@@ -197,10 +198,15 @@
 * Use the same CSV format for the ``:header:`` option and the main data
   of the "csv-table_" directive.
 
-* Remove the compatibility hacks `nodes.reprunicode` and `nodes.ensure_str()`.
+* Removed objects:
 
-* Remove file ``install.py``. See README.txt__ for alternatives.
+  - `nodes.reprunicode` and `nodes.ensure_str()`
+    (not required with Python 3),
+    `utils.Reporter.set_conditions()` (obsolete)
+    `core.Publisher.setup_option_parser()` (internal, obsolete)
 
+  - File ``install.py``. See README.txt__ for alternatives.
+
 .. _csv-table: docs/ref/rst/directives.html#csv-table
 __ README.html#installation
 

Modified: trunk/docutils/docs/dev/release.txt
===================================================================
--- trunk/docutils/docs/dev/release.txt	2023-08-23 13:00:10 UTC (rev 9445)
+++ trunk/docutils/docs/dev/release.txt	2023-09-05 23:03:38 UTC (rev 9446)
@@ -51,8 +51,8 @@
 
 * Generate wheel and source-distribution::
 
-    python3 setup.py sdist
-    python3 setup.py bdist_wheel
+    python3 -m pip install build
+    python3 -m build .
 
 * check sdist for html-files in docutils.egg-info.
 * Upload wheel and source to test.pypi::

Modified: trunk/docutils/docs/dev/repository.txt
===================================================================
--- trunk/docutils/docs/dev/repository.txt	2023-08-23 13:00:10 UTC (rev 9445)
+++ trunk/docutils/docs/dev/repository.txt	2023-09-05 23:03:38 UTC (rev 9446)
@@ -147,6 +147,8 @@
 
    __ https://pip.pypa.io/en/stable/topics/local-project-installs/
       #editable-installs
+      
+   .. _manual install:
 
 2. Install "manually".
 
@@ -189,10 +191,8 @@
          ln -s ~/projects/docutils/docutils/tools/docutils-cli.py \
                /usr/local/bin/docutils
 
-3. Do a regular install. Repeat after any change. ::
+3. Do a regular install. Repeat after any change.
 
-       ./setup.py install
-
    .. CAUTION::
 
       This method is **not** recommended for day-to-day development!

Modified: trunk/docutils/setup.py
===================================================================
--- trunk/docutils/setup.py	2023-08-23 13:00:10 UTC (rev 9445)
+++ trunk/docutils/setup.py	2023-09-05 23:03:38 UTC (rev 9446)
@@ -117,6 +117,7 @@
         'Natural Language :: Finnish',
         'Natural Language :: French',
         'Natural Language :: Galician',
+        'Natural Language :: Georgian',
         'Natural Language :: German',
         'Natural Language :: Hebrew',
         'Natural Language :: Italian',

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.



