1.. -*- coding: utf-8 -*- 2 3======================== 4 Docutils Release Notes 5======================== 6 7:Contact: grubert@users.sourceforge.net 8:Maintainer: docutils-develop@lists.sourceforge.net 9:Date: $Date: 2021-04-17 14:41:26 +0200 (Sa, 17. Apr 2021) $ 10:Revision: $Revision: 8705 $ 11:Web site: https://docutils.sourceforge.io/ 12:Copyright: This document has been placed in the public domain. 13 14 15This document summarizes the major changes in recent and upcoming releases. 16For a more detailed list of changes, please see the Docutils `HISTORY`_. 17 18.. contents:: 19 20Future changes 21============== 22 23* `latex` writer: The default for the configuration setting 24 `legacy_class_functions`_ will change to "False". Adapt stylesheets 25 modifying ``\DUadmonition`` and/or ``\DUtitle`` or set to "True". 26 27* `html5` writer: 28 29 - Use semantic tags <aside> for footnote text, citations, for topics 30 (except abstract), admonitions, and system messages, and <nav> for 31 the Table of Contents. 32 33 - Use <summary> and <details> tags for term and definition of a 34 definition list with class value "details". 35 36 - Write footnote brackets and field term colons to HTML, so that 37 they are present also without CSS and when copying text. 38 Hide with CSS if required. 39 40 - Move attribution behind the blockquote to comply with 41 https://html.spec.whatwg.org/#the-blockquote-element. 42 43* `htm4css1` writer: Support the embed_images_ option. 44 45* `s5_html` writer: Remove the IE PNG Fix by Angus Turnbull. IE has 46 native PNG support since version 7. 47 48* Make <meta> a standard Docutils doctree node. 49 50 The `meta directive`__ will insert <meta> instead of pending nodes. 51 Writers may ignore some or all <meta> elements if they are not 52 supported by the output format. 53 54 The ``transforms/components.Filter`` class will become obsolete by 55 this change and may be removed in future. 56 57 __ docs/ref/rst/directives.html#meta 58 59* ``Node.traverse()`` will return an iterator instead of a list. 60 61* Remove ``utils.unique_combinations`` 62 (obsoleted by ``itertools.combinations``). 63 64* Eventually remove the "rawsource" attribute and argument from nodes.Text: 65 we store the null-escaped text in Text nodes since 0.16 so there is no 66 additional information in the rawsource. 67 68* If the id_prefix_ setting is non-empty, leading number and hyphen characters 69 will not be stripped from a `reference name`_ during `identifier 70 normalization`_. This may change generated `identifier keys`. 71 72 Example: with ``--id-prefix="DU-"``, a section with title "34. May" 73 currently gets the identifier key ``DU-may`` and after the change the 74 identifier key ``DU-34-may``. 75 76* The default value for auto_id_prefix_ will change to "%". This means 77 auto-generated IDs will use the tag name as prefix. Set auto_id_prefix_ to 78 "id" if you want unchanged auto-IDs or to "%" if you want the new 79 feature already in 0.17. 80 81* The default HTML writer "html" with frontend ``rst2html.py`` may change 82 from "html4css1" to "html5". 83 84 Use ``get_writer_by_name('html')`` or the rst2html.py_ front end, if you 85 want the output to be up-to-date automatically. 86 87 Use the "html4" writer or ``rst2html4.py``, if you depend on 88 stability of the generated HTML code, e.g. because you use a custom 89 style sheet or post-processing that may break otherwise. 90 91.. _id_prefix: docs/user/config.html#id-prefix 92.. _auto_id_prefix: docs/user/config.html#auto-id-prefix 93.. _rst2html.py: docs/user/tools.html#rst2html-py 94.. _reference name: docs/ref/rst/restructuredtext.html#reference-names 95.. _identifier normalization: 96 docs/ref/rst/directives.html#identifier-normalization 97 98 99Release 0.17.1 (2021-04-16) 100=========================== 101 102(Release 0.17.1b.dev) 103 104* Bug fixes (for details see the Docutils `HISTORY`_). 105 106Release 0.17 (2021-04-03) 107========================= 108 109* Numerous bug fixes and improvements 110 (for details see the Docutils `HISTORY`_). 111 112* Installing with ``setup.py`` now requires setuptools_. 113 Alternatively, install with pip_. 114 115* The generic command line front end tool docutils-cli.py_ allows 116 the free selection of reader, parser, and writer components. 117 118* Support Arabic language. 119 120* New, **experimental** wrapper to integrate the `recommonmark`__ 121 Markdown parser for use with Docutils. 122 Currently only tested with recommonmark version 0.4.0. 123 124 __ https://pypi.org/project/recommonmark/ 125 126* HTML5 writer: 127 128 - New option embed_images_. 129 130 - Use semantic tags (for details see the Docutils `HISTORY`_). 131 132 - Change the `initial_header_level`_ setting's default to "2", as browsers 133 use the `same style for <h1> and <h2> when nested in a section`__. 134 135 - New optional style ``responsive.css``, adapts to different screen 136 sizes. 137 138 - Move non-essential styling from ``minimal.css`` to ``plain.css`` 139 rsp. ``responsive.css``. 140 141 - Show code line numbers as pseudo-elements so they are skipped when 142 copying the code block from the page. 143 144 .. _initial_header_level: docs/user/config.html#initial-header-level 145 __ https://stackoverflow.com/questions/39547412/same-font-size-for-h1-and-h2-in-article 146 .. _embed_images: docs/user/config.html#embed-images 147 148* LaTeX writer: 149 150 - New configuration setting `legacy_class_functions`_. 151 152 - The special value "auto" for the `graphicx_option`_ setting 153 is no longer supported (it never worked for xetex/luatex). 154 155 - `Styling commands`__ using the legacy ``\docutilsrole`` prefix are 156 now ignored. Use ``\DUrole``. 157 158 __ docs/user/latex.html#classes 159 160 - Most helper commands and element definitions are now defined in the 161 LaTeX package `docutils.sty`_ and only inserted in the document 162 preamble if the stylesheet__ setting does not lists "docutils". 163 164 __ docs/user/config.html#stylesheet-latex-writers 165 166 - Remove legacy LaTeX stylesheet ``docutils-05-compat.sty``. 167 168.. _setuptools: https://pypi.org/project/setuptools/ 169.. _pip: https://pypi.org/project/pip/ 170.. _docutils-cli.py: docs/user/tools.html#docutils-cli-py 171.. _legacy_class_functions: docs/user/config.html#legacy-class-functions 172.. _graphicx_option: docs/user/config.html#graphicx-option 173.. _docutils.sty: https://ctan.org/pkg/docutils 174 175 176Release 0.16 (2020-01-12) 177========================= 178 179.. Note:: 180 181 Docutils 0.15.x is the last version supporting Python 2.6, 3.3 and 3.4. 182 183 Docutils 0.16.x supports Python 2.7 and Python >= 3.5 natively, 184 without the use of the ``2to3`` tool. 185 186* reStructuredText: 187 188 - Keep `backslash escapes`__ in the document tree. This allows, e.g., 189 escaping of author-separators in `bibliographic fields`__. 190 191 __ http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#escaping-mechanism 192 __ docs/ref/rst/restructuredtext.html#bibliographic-fields 193 194* LaTeX writer: 195 196 - Informal titles of type "rubric" default to bold-italic and left aligned. 197 - Deprecate ``\docutilsrole`` prefix for styling commands: 198 use ``\DUrole`` instead. 199 - Fix topic subtitle. 200 - Add "latex writers" to the `config_section_dependencies`. 201 - Ignore classes for `rubric` elements 202 (class wrapper interferes with LaTeX formatting). 203 204* tools/buildhtml.py 205 206 - New option "--html-writer" allows to select "html__" (default), 207 "html4" or "html5". 208 209 __ html: docs/user/html.html#html 210 211* docutils/io.py 212 213 - Remove the `handle_io_errors` option from io.FileInput/Output. 214 215* docutils/nodes.py 216 217 - If `auto_id_prefix`_ ends with "%", this is replaced with the tag name. 218 219 .. _auto_id_prefix: docs/user/config.html#auto-id-prefix 220 221* Various bugfixes and improvements (see HISTORY_). 222 223 224Release 0.15 (2019-07-20) 225========================= 226 227.. Note:: 228 229 Docutils 0.14.x is the last version supporting Python 2.4, 2.5, 230 3.1, and 3.2. 231 232 Docutils 0.15.x is compatible with Python versions 2.6, 2.7 and 3.3 to 3.5 233 (cf. `Python 3 compatibility`_). 234 235* reStructuredText: 236 237 - Allow embedded colons in field list field names (before, tokens like 238 ``:this:example:`` were considered ordinary text). 239 240 - Fixed a bug with the "trim" options of the "unicode" directive. 241 242* languages: Added Korean localisation (ko). 243 244 245Release 0.14 (2017-08-03) 246========================= 247 248* docutils/docs/ref/docutils.dtd: 249 250 - Enable validation of Docutils XML documents against the DTD: 251 252* docutils/parsers/rst/: 253 254 - Added functionality: escaped whitespace in URI contexts. 255 - Consistent handling of all whitespace characters in inline markup 256 recognition. (May break documents that relied on some whitespace 257 characters (NBSP, ...) *not* to be recognized as whitespace.) 258 259* docutils/utils/smartquotes.py: 260 261 - Update quote definitions for et, fi, fr, ro, sv, tr, uk. 262 - Add quote definitions for hr, hsb, hu, lv, sh, sl, sr. 263 - Differentiate apostrophe from closing single quote (if possible). 264 - Add command line interface for stand-alone use (requires 2.7). 265 266* docutils/writers/_html_base: 267 268 - Provide default title in metadata. 269 - The MathJax CDN shut down on April 30, 2017. For security reasons, we 270 don't use a third party public installation as default but warn 271 if `math-output` is set to MathJax without specifying a URL. 272 See math-output_ for details. 273 274* docutils/writers/html4css1: 275 276 - Respect automatic table column sizing. 277 278* docutils/writers/latex2e/__init__.py 279 280 - Handle class arguments for block-level elements by wrapping them 281 in a "DUclass" environment. This replaces the special handling for 282 "epigraph" and "topic" elements. 283 284* docutils/writers/odf_odt: 285 286 - Language option sets ODF document's default language 287 - Image width, scale, ... set image size in generated ODF. 288 289* tools/ 290 291 - New front-end ``rst2html4.py``. 292 293 294Release 0.13.1 (2016-12-09) 295=========================== 296 297* docutils/writers/html5_polyglot 298 299 - New HTML writer generating `HTML 5`_. 300 301 .. _HTML 5: http://www.w3.org/TR/html5/ 302 303* tools/ 304 305 - New front-end ``rst2html5.py``. 306 307* languages: persian/farsi (fa) and latvian (la) mappings. 308 309* change default base url for :rfc: to http://tools.ietf.org/html/ 310 311* tables accept widths, a list and align 312 313* latex2e: Fix admonition width, remove deprecated options, 314 better tablewidth auto, ... 315 316* rst.el: The problem with ``electric-indent-mode`` has been fixed. 317 318 319Release 0.12 (2014-07-06) 320========================= 321 322Small changes only, release current state 323 324 325Release 0.11 (2013-07-22) 326========================= 327 328* General 329 330 - Apply [ 2714873 ] Fix for the overwritting of document attributes. 331 - Support embedded aliases within hyperlink references. 332 - Fix [ 228 ] try local import of docutils components (reader, writer, parser, 333 language module) before global search. 334 335* docutils/parsers/rst/directives/tables.py 336 337 - Fix [ 210 ] Python 3.3 checks CVS syntax only if "strict" is True. 338 339* docutils/writers/html4css1/__init__.py 340 - Fix [ 3600051 ] for tables in a list, table cells are not compacted. 341 - New setting `stylesheet_dirs` (see above). 342 343 Now, it is easy to add a custom stylesheet to Docutils' default 344 stylesheet with, e.g., ``--stylesheet_path='html4css1.css, mystyle.css'`` 345 346 Changed behaviour of the default settings: 347 if there is a file ``html4css1.css`` in the working directory of the 348 process at launch, it is used instead of the one provided by Docutils 349 in the writer source directory. 350 351 - New default for math-output_: ``HTML math.css``. 352 - Avoid repeated class declarations in html4css1 writer 353 (modified version of patch [ 104 ]). 354 355 .. _math-output: docs/user/config.html#math-output 356 357* docutils/writers/latex2e/__init__.py 358 359 - Drop the simple algorithm replacing straight double quotes with 360 English typographic ones. 361 Activate the SmartQuotes_ transform if you want this feature. 362 - New setting `stylesheet_dirs`: Comma-separated list of directories 363 where stylesheets are found. Used by `stylesheet_path` when expanding 364 relative path arguments. 365 366 .. _SmartQuotes: docs/user/config.html#smart-quotes 367 368* docutils/writers/manpage.py 369 370 - Fix [3607063] handle lines starting with a period. 371 - Fix option separating comma was bold (thanks to Bill Morris). 372 373Release 0.10 (2012-12-16) 374========================= 375 376.. Note:: 377 378 Docutils 0.9.x is the last version supporting Python 2.3. 379 380 Docutils 0.10 is compatible with Python versions from 2.4 to 3.2 381 (cf. `Python 3 compatibility`_). 382 383* General: 384 385 - SmartQuotes transform for typographic quotes and dashes. 386 387 - ``docutils/math``, ``docutils/error_reporting.py``, and 388 ``docutils/urischemes.py`` moved to the utils package. 389 Code importing these modules needs to adapt, e.g.:: 390 391 try: 392 import docutils.math as math 393 except ImportError: 394 import docutils.utils.math as math 395 396 - enhanced math and error handling. 397 398* docutils/io.py 399 400 - FileInput/FileOutput: no system-exit on IOError. 401 The `handle_io_errors` option is ignored. 402 403* docutils/writers/html4css1/__init__.py 404 405 - Use ``<code>`` tag for inline "code", 406 do not drop nested inline nodes (syntax highlight tokens). 407 - Customizable MathJax URL (based on patch by Dmitry Shachnev). 408 - No line break after opening inline math tag. 409 410* docutils/writers/latex2e/__init__.py, docutils/writers/xetex/__init__.py 411 412 - Fix section numbering by LaTeX. 413 414* docutils/writers/s5_html/__init__.py 415 416 - Fix [ 3556388 ] Mathjax does not work with rst2s5. 417 418 419Release 0.9.1 (2012-06-17) 420========================== 421 422* General: 423 424 Several fixes for Python 3 usage. 425 426* docutils/setup.py 427 428 - Fix [ 3527842 ]. Under Python 3, converted tests and tools were 429 installed in the PYTHONPATH. Converted tests are now 430 stored in ``docutils/test3/``, tools no longer need conversion. 431 432 If you installed one of Docutils versions 0.7 ... 0.9 with 433 ``setup.py install`` under Python 3, remove the spurious 434 ``test/`` and ``tools/`` directories in the site library root. 435 436 437Release 0.9 (2012-05-02) 438========================= 439 440* General: 441 442 - reStructuredText "code" role and directive with syntax highlighting 443 by Pygments_. 444 - "code" option of the "include" directive. 445 446 .. _Pygments: http://pygments.org/ 447 448 - Fix [ 3402314 ] allow non-ASCII whitespace, punctuation 449 characters and "international" quotes around inline markup. 450 451 - Fix handling of missing stylesheets. 452 453* setup.py 454 455 - Fix [ 2971827 ] and [ 3442827 ] 456 extras/roman.py moved to docutils/utils/roman.py 457 458* docutils/utils.py -> docutils/utils/__init__.py 459 460 - docutils.utils is now a package (providing a place for sub-modules) 461 462* docutils/writers/html4css1/__init__.py 463 464 - change default for `math-output` setting to MathJax 465 466* docutils/writers/latex2e/__init__.py 467 468 - Support the `abbreviation` and `acronym` standard roles. 469 - Record only files required to generate the LaTeX source as dependencies. 470 - Use ``\setcounter{secnumdepth}{0}`` instead of ``*``-versions 471 when suppressing LaTeX section numbering. 472 473 474Release 0.8.1 (2011-08-30) 475========================== 476 477* General: 478 479 - Fix [ 3364658 ] (Change last file with Apache license to BSD-2-Clause) 480 and [ 3395920 ] (correct copyright info for rst.el). 481 482* docutils/writers/latex2e/__init__.py 483 484 - Clean up Babel language setting. Restores Sphinx compatibility. 485 486 487Release 0.8 (2011-07-07) 488======================== 489 490* COPYING: 491 492 - Some additions to the Docutils core are released under the 2-Clause BSD 493 license. 494 495* General: 496 497 - Handle language codes according to `BCP 47`_. 498 - If the specified langauage is not supported by Docutils, 499 warn and fall back to English. 500 - Math support: reStructuredText "math" role and directive, 501 ``math`` and ``math_block`` doctree elements. 502 - Orphaned "python" reader and "newlatex2e" writer moved to the sandbox. 503 504 .. _BCP 47: http://www.rfc-editor.org/rfc/bcp/bcp47.txt 505 506* reStructuredText: 507 508 - most directives now support a "name" option that attaches a 509 reference name. So you can write :: 510 511 .. figure:: image.png 512 :name: figure name 513 514 as a short form of :: 515 516 .. _figure name: 517 518 .. figure:: image.png 519 520Internationalization: 521 522* Added lithuanian mappings. 523 524Components: 525 526* HTML writer: 527 528 - New setting "math-output" with support for HTML, MathML, and LaTeX. 529 530* LaTeX2e writer: 531 532 - Convert image URI to a local file path. 533 - Apply [ 3148141 ] fix multicolumn support when a colspanning cell 534 has more than one paragraph (Wolfgang Scherer). 535 536* XeTeX writer: 537 538 - New writer generating LaTeX code for compiling with ``xelatex``. 539 540 XeTeX uses unicode and modern font technologies. 541 542* and fixes and enhancements here and there. 543 544 545Release 0.7 (2010-07-07) 546======================== 547 548Components: 549 550* HTML writer: 551 552 - Support SVG and SWF images (thanks to Stefan Rank). 553 - Generate valid XHTML for centered images with targets. 554 Use CSS classes instead of "align" tags for image alignment. 555 556* LaTeX2e writer: 557 558 - Use the ``\url`` command for URLs (breaks long URLs instead of writing 559 into the margin). 560 - Preserve runs of spaces in 'inline literals'. 561 - Deprecate ``figure_footnotes`` setting. 562 - Rename ``use_latex_footnotes`` setting to `docutils_footnotes`__. 563 - New ``latex_preamble`` setting. 564 - Use PDF standard fonts (Times/Helvetica/Courier) as default. 565 - `hyperref` package called with ``unicode`` option (see the 566 `hyperref config tips`__ for how to override). 567 - Drop the special `output_encoding`__ default ("latin-1"). 568 The Docutils wide default (usually "UTF-8") is used instead. 569 570__ docs/user/config.html#docutils-footnotes 571__ docs/user/latex.html#hyperlinks 572__ docs/user/latex.html#output-encoding 573 574* manpage writer: 575 576 - Titles level 1, that is ``.SH``, always uppercase. 577 - Apply patch from mg: literal text should be bold in man-pages. 578 579General: 580 581* io.FileInput opens files as text files with universal newline support 582 (mode "rU", configurable with the new optional argument "mode"). 583 584* setup.py: 585 586 - Python 3 support: copy test/ and tools/ to the build-dir 587 and convert Python sources with 2to3. 588 589 590Release 0.6 (2009-10-11) 591======================== 592 593.. Note:: 594 595 Docutils 0.5 is the last version supporting Python 2.2. 596 597 Docutils 0.6 is compatible with Python versions from 2.3 up to 2.6 598 and convertible to 3.1 code. 599 600.. note:: 601 602 The "newlatex" writer is orphaned. 603 604 The recommended way to generate PDF output is to use either the 605 LaTeX2e writer or one of the alternatives listed at 606 http://docutils.sourceforge.net/docs/user/links.html#pdf. 607 608* reStructuredText: 609 610 - Allow length units for all length specifications. 611 - Allow percent sign in "scale" argument of "figure" and "image" directives. 612 - Bugfix: The "figalign" argument of a figure now works as intended 613 (aligning the figure not its contents). 614 - Align images with class "align-[right|center|left]" 615 (allows setting the alignment of an image in a figure). 616 - Hard tabs in literal inclusions are replaced by spaces. This is 617 configurable via the new "tab-width" option of the "include" directive 618 (a negative tab-width prevents tab expansion). 619 620* HTML writer: 621 622 - ``--stylesheet`` and ``--stylesheet-path`` options now support a comma 623 separated list of stylesheets. 624 625* LaTeX2e writer: 626 627 - New defaults: 628 - font-encoding: "T1" (formerly implicitely set by 'ae'). 629 - use-latex-toc: true (ToC with page numbers). 630 - use-latex-footnotes: true (no mixup with figures). 631 - Float placement defaults to "here definitely" (configurable). 632 - Align of image in a figure defaults to 'center'. 633 - Use class defaults for page margins ('typearea' now optional). 634 - Support LaTeX packages as ``--stylesheet`` arguments. 635 - Use ``bp`` for lengths without unit or unit ``pt``, 636 do not convert ``px`` to ``pt``. 637 - Do not use 'ae' and 'aeguill' packages if font-encoding is set to ''. 638 - Set sub- and superscript role argument as text not math. 639 - Support custom roles based on standard roles. 640 - Load packages and define macros only if required in the document. 641 - All Docutils specific LaTeX macros are prefixed with ``DU``. 642 - Better conformance to Docutils specifications with "use_latex_toc". 643 - If 'sectnum_xform' is False, the 'sectnum' directive triggers 644 section numbering by LaTeX. 645 - Use default font in admonitions and sidebar. 646 - Typeset generic topic as "quote with title". 647 - Use template (file and configuration option). 648 - Render doctest blocks as literal blocks (indented). 649 650* ODT writer: 651 652 - moved from sandbox to Doctutils core. 653 654* manpage writer: 655 656 - moved from sandbox to Doctutils core. 657 658 659Release 0.5 (2008-06-25) 660======================== 661 662Components: 663 664* HTML writer. 665 666 - Dropped all ``name`` attributes of ``a`` elements (``id`` is 667 universally supported now). 668 669* LaTeX2e writer: 670 671 - Better bibTeX citation support. 672 - Add ``--literal-block-env`` 673 674* PEP writer: 675 676 - Changed to support new python.org website structure and 677 pep2pyramid.py. 678 679reStructuredText: 680 681* Changed the directive API to a new object-oriented system. 682 (Compatibility for the old, functional-style directive interface is 683 retained.) See the updated `Creating reStructuredText Directives`__ 684 how-to. 685 686 __ docs/howto/rst-directives.html 687 688* Allow ``+`` and ``:`` in reference names requested for citations. 689 690Documentation: 691 692* Added `Deploying Docutils Securely`__ 693 694 __ docs/howto/security.txt 695 696Internationalization: 697 698* Added hebrew mappings. 699 700General: 701 702* Configuration files are now assumed and required to be 703 UTF-8-encoded. 704 705* Added docutils/writers/html4css1/template.txt. 706 707* Enhance emacs support. 708 709 710Release 0.4 (2006-01-09) 711======================== 712 713.. Note:: 714 715 Docutils 0.4.x is the last version that will support Python 2.1. 716 Docutils 0.5 will *not* be compatible with Python 2.1; Python 2.2 717 or later will be required. 718 719 Docutils 0.4.x is the last version that will make compromises in 720 its HTML output for Netscape Navigator 4. Docutils 0.5 will 721 require more up-to-date browsers (the exact definition is to be 722 determined). 723 724Components: 725 726* Added an `S5/HTML writer`__ and the rst2s5.py__ front end: 727 multi-platform, multi-browser HTML slide shows. 728 729 __ docs/user/slide-shows.html 730 __ docs/user/tools.html#rst2s5-py 731 732* The newlatex2e writer is nearing completion. 733 734* Added a DocTree reader, ``publish_doctree`` and 735 ``publish_from_doctree`` convenience functions, for document tree 736 extraction and reprocessing. 737 738reStructuredText: 739 740* Added directives: "container__" (generic block-level container), 741 "default-role__" (role used for \`backtick\` syntax), "title__" 742 (document title metadata), and "date__" (generate the current local 743 date, for substitution definitions). 744 745 __ docs/ref/rst/directives.html#container 746 __ docs/ref/rst/directives.html#default-role 747 __ docs/ref/rst/directives.html#title 748 __ docs/ref/rst/directives.html#date 749 750* Length units are now supported for image__ sizes. 751 752 __ docs/ref/rst/directives.html#image 753 754* Added `standard definition files`__ for special characters etc. 755 756 __ docs/ref/rst/definitions.html 757 758Internationalization: 759 760* Added Japanese and Simplified Chinese language mappings, and support 761 for double-width CJK-characters in tables and section titles. 762 763Documentation: 764 765* Added a `guide for distributors`__ (package maintainers) and a 766 `guide for developers`__. 767 768 __ docs/dev/distributing.html 769 __ docs/dev/hacking.html 770 771General: 772 773* Added significant `Emacs support for reST`__. 774 775 __ docs/user/emacs.html 776 777* Added a `--strip-comments`__ option. 778 779 __ docs/user/config.html#strip-comments 780 781* `--embed-stylesheet`__ is now the default for the HTML writer 782 (rather than --link-stylesheet). 783 784 __ docs/user/config.html#embed-stylesheet 785 786 787Release 0.3.9 (2005-05-26) 788========================== 789 790* Added "file_insertion_enabled__" and "raw_enabled__" settings. 791 792 __ docs/user/config.html#file-insertion-enabled 793 __ docs/user/config.html#raw-enabled 794 795* Added `auto-enumerated lists`__. 796 797 __ docs/ref/rst/restructuredtext.html#enumerated-lists 798 799* Added `"header" and "footer"`__ directives. 800 801 __ docs/ref/rst/directives.html#document-header-footer 802 803* Added "list-table__" directive. 804 805 __ docs/ref/rst/directives.html#list-table 806 807* Added support for `section subtitles`__. 808 809 __ docs/user/config.html#sectsubtitle-xform 810 811* Added "field_name_limit__" and "option_limit__" settings to HTML writer. 812 813 __ docs/user/config.html#field-name-limit 814 __ docs/user/config.html#option-limit 815 816* Added "cloak_email_addresses__" setting to HTML writer. 817 818 __ docs/user/config.html#cloak-email-addresses 819 820* UTF-8 BOMs are now removed from the input stream. 821 822 823Release 0.3.7 (2004-12-24) 824========================== 825 826* A special "`line block`__" syntax has been added. (Also see the 827 `quick reference`__.) 828 829 __ docs/ref/rst/restructuredtext.html#line-blocks 830 __ docs/user/rst/quickref.html#line-blocks 831 832* Empty sections are now allowed. 833 834* A "raw__" role has been added. 835 836 __ docs/ref/rst/roles.html#raw 837 838* The LaTeX writer now escapes consecutive dashes (like "--" or "---") 839 so that they are no longer transformed by LaTeX to en or em dashes. 840 (Please see the FAQ__ for how to represent such dashes.) 841 842 __ FAQ.html#how-can-i-represent-esoteric-characters-e-g-character-entities-in-a-document 843 844* A `dependency recorder`__ has been added. 845 846 __ docs/user/config.html#record-dependencies 847 848* A directive has been added for `compound paragraphs`__. 849 850 __ docs/ref/rst/directives.html#compound-paragraph 851 852 853Release 0.3.5 (2004-07-29) 854========================== 855 856* Improved, extended and reorganized the documentation__. 857 858 __ docs/index.html 859 860* Added "csv-table__" directive. 861 862 __ docs/ref/rst/directives.html#csv-table 863 864.. _HISTORY: HISTORY.html 865.. _Python 3 compatibility: README.html#python-3-compatibility 866