|
From: <mn...@us...> - 2007-05-04 22:37:51
|
Author: mnodine
Date: 2007-05-05 00:37:05 +0200 (Sat, 05 May 2007)
New Revision: 5066
Added:
trunk/prest/ChangeLog
Removed:
trunk/prest/ReleaseNotes.txt
Log:
Renamed to ChangeLog for better CPAN indexing
Copied: trunk/prest/ChangeLog (from rev 5064, trunk/prest/ReleaseNotes.txt)
===================================================================
--- trunk/prest/ReleaseNotes.txt 2007-05-03 21:29:47 UTC (rev 5064)
+++ trunk/prest/ChangeLog 2007-05-04 22:37:05 UTC (rev 5066)
@@ -0,0 +1,327 @@
+.. -*-rst-*-
+
+Release Notes
+===============
+
+.. contents::
+
+Release 0.3.29
+--------------
+* Renamed ReleaseNotes.txt to ChangeLog so that it will appear as a
+ special file on CPAN.
+* Made one more effort to fix the indexing of version numbers.
+
+Release 0.3.28
+--------------
+* Create lib/Text/Restructured.pm from lib/Text/Restructured.pm.PL so
+ we can insert the version number in to allow CPAN to index it
+ correctly.
+* Fixed a problem with creating regular-expression expects for tests.
+
+Release 0.3.27
+--------------
+Fixed problem with CPAN indexing of versions.
+
+Release 0.3.26
+--------------
+* Completely reworked the regression test structure so as not to be
+ dependent upon GNU make.
+
+Writers 'dom' and 'xml':
+
+* Fixed a bug with attribute strings that contain double quotes.
+
+
+Release 0.3.25
+--------------
+* Fixed a problem with Makefile.PL.
+
+ReStructuredText parsing:
+
+* Don't write messages to STDERR for errors in directives in test
+ data.
+
+Writer 'html':
+
+* Fixed a problem with quote markes in "alt" image text.
+* Added "-W body-only" flag.
+
+Release 0.3.24
+--------------
+* Fixed problems with running with -T.
+* Fixed Makefile.
+
+Release 0.3.23
+--------------
+* Fixed the help to parse as reStructuredText.
+* Execute evals in Text::Restructured::Writer::Eval instead of Eval_::.
+* Initialize some of the opt variables to avoid warnings if not driven
+ by prest.
+
+ReStructuredText parsing:
+
+* Added "-D image-exts" flag so that each writer doesn't have to
+ support the functionality separately.
+
+Writer 'html':
+
+* Added "-W enum-list-prefixes" flag.
+* Documentation deprecates "-W image-exts".
+
+Writer 'latex':
+
+* Be more lenient about including graphics for files that aren't in
+ the current directory.
+* Fixed the processing of raw DOM elements to ignore those not
+ intended for latex.
+* Added a newline before admonitions so they're processed in vertical
+ mode.
+
+Writer 'toc':
+
+* Added "-W parent-role" flag.
+
+
+
+Release 0.3.22
+--------------
+
+Release 0.3.21
+--------------
+
+Updated the ``toc`` writer to have expanded abilities with the ``-W
+file-suffix`` option.
+
+Fixed the Makefile.PL so that hopefully at least some platforms will
+pass regression tests.
+
+Added release notes to the prest documentation.
+
+Release 0.3.20
+--------------
+
+Made the ``html``, ``toc``, and ``xref`` writers compatible with
+non-breaking spaces in Perl 5.8.0 implementation of Unicode. (Unicode
+implementation was fixed in Perl 5.8.6.)
+
+All ``-D`` or ``-W`` option names can use either hyphens ("-") or
+underscores ("_") for word separators; internally everything uses
+underscores.
+
+reStructuredText parsing:
+
+* Added hyphens to the following ``-D`` options: ``entry-attr``,
+ ``include-ext``, ``include-path``, ``nest-inline``, ``perl-path``,
+ ``row-attr``, ``table-attr``.
+* Added the following ``-D`` options: ``file-insertion-enabled``,
+ ``ignore-include-errs``, ``raw-enabled``.
+* Fixed a bug where explicit targets were not permitted within an
+ embedded url (e.g., '``reference <#explicit-target>``').
+* Don't consider targets defined on the same source/line number to be
+ duplicate targets (can happen with multiply-included files).
+* Fixed the checking for inconsistent title levels to be more robust.
+* Keep an ``@INCLUDES`` array to keep track of the include stack. This
+ variable can be accessed in a ``perl``/``if`` directive.
+* Fixed a bug where large grid tables could result in a deep
+ recursion error.
+
+reStructuredText transforms:
+
+* Added the ``-D docinfo-levels`` option.
+* Changed the documentation to show the ``-D`` options with hyphens ("-")
+ instead of underscores ("_") separting words.
+* The ``sectnum`` directive now processes starting from its containing
+ section, rather than from the top of the DOM tree.
+
+Directive '``raw``':
+
+* Added a ``:head:`` option.
+
+Directive '``if``':
+
+* Export the ``$SOURCE``, ``$LINE``, and ``@INCLUDES`` for use in Perl
+ code.
+
+Directive '``perl``':
+
+* Implemented ``:file:`` option.
+* Exported ``@INCLUDES``.
+
+Directive '``sectnum``':
+
+* Added a ``:prefix-title:`` option.
+
+Writer '``html``':
+
+* Inserted hyphen in the ``-W body-attr`` option.
+* Updated for adding hyphens to the following ``-D`` options:
+ ``table-attr``, ``entry-attr``, ``row-attr``.
+* Added ``-W image-exts`` option.
+* Added support for ``:head:`` option of ``raw`` DOM.
+* Fixed a bug with targets.
+* Fixed a potential undefined variable warning for footnote references.
+
+Writer '``index``':
+
+* Changed documentation for ``-W`` options to use hyphens ("-") instead of
+ underscores ("_") between words.
+* Implemented ``-W output-header`` and ``-W title-underline`` options.
+* Changed implementation to use a ``compound`` directive instead of a
+ ``raw`` directive to set the class for the generated contents.
+* Removed a potential undefined variable warning for indirect targets.
+
+Writer '``toc``':
+
+* Updated documentation to show ``-W`` options with hyphens ("-") instead of
+ underscores ("_") to separate words.
+* Restructured for simplicity.
+* Changed the way non-breaking spaces are removed from generated DOM
+ objects since the auto-numbering may have things other than numbers
+ in it.
+
+Writer '``xref``':
+
+* Added the following ``-W`` options: ``appendix``, ``chapter``,
+ ``section``, ``xref-sections``, ``xref-targets``.
+* Restructured the code for simplification.
+
+Release 0.3.19
+--------------
+Added support for ascii-mathml role and directive to produce mathml
+markup. The mathml markup is only supported in the ``dom`` and ``html``
+writers for now.
+
+Release 0.3.18
+--------------
+
+Went through code coverage reports and updated the tests to bring the
+line and condition coverage up to 100% (except the soon-to-be-outdated
+``latex`` writer). This analysis resulted in the following fixes:
+
+Prest application:
+
+* Fixed a bug where help prints out multiple times if there are
+ duplicate writers.
+* Relocated all the code for parsing and interpreting writer schemas
+ to ``Text::Restructured::Writer``.
+* Fixed the version number not to end with a period.
+* Don't use ``FindBin`` to append the directory in which the script is
+ found to its ``@INC`` path.
+* Don't convert digits in ``-W`` options to underscores.
+* Removed code for parsing DOM files to ``Text::Restructured::DOM::Parse``.
+* Insert blank line in usage before "Descriptions of Plug-in
+ Directives" and "Descriptions of Writers".
+
+reStructuredText parsing:
+
+* Stricter option checking in most directives.
+* Removed package globals and incorporated into a parser object.
+* Initialize ``ANONYMOUS_TARGETS`` in init.
+* Fixed the handling of inline literals in definition lists.
+* Put a system message in the document rather than dying if a plug-in
+ directive fails to compile.
+* Simplified the code by removing tests whose conditions were
+ invariant.
+* Fixed an infinite loop that could come up in processing nested
+ inline markup.
+* Fixed an infinite loop that could come up if a line block started
+ with two or more blank lines.
+* Fixed the removal of inline markup characters from normalized names.
+* Have ``include`` directive do nothing if the file is empty, as opposed
+ to returning an empty paragraph.
+* Added checks for the ``:prefix:`` and ``:suffix:`` options to the
+ ``role`` directive to be sure they're formatted correctly.
+* Return a system message if the title in a table-type directive is
+ not a single paragraph.
+* Merged the code for ``csv-table`` and ``list-table`` directives to the
+ extent possible.
+* Fixed the ``:class:`` option for ``target-notes``.
+
+reStructuredText transforms:
+
+* Simplified code by removing branches whose conditions were
+ invariant.
+* Return a system message if evaluating transform code results in an
+ error.
+* Process ``:class:`` option for ``target-notes`` directive.
+* Allow ``decorations`` transform to put in link to prest documentation if
+ DOCURL is specified.
+
+Directive '``code_block``':
+
+* Added ``-D code-block-states-file`` option.
+* Do line numbering whether or not states can be run if
+ ``:numbered:``.
+
+Directive '``system``':
+
+* Return a ``PCDATA`` DOM if in a substitution definition context (instead
+ of appending it).
+* Don't add a null paragraph if the text is empty.
+
+Writer '``dom``':
+
+* Updated to use ``$writer`` argument to access ``ProcessDOMPhase``.
+
+Writer '``html``':
+
+* Changed the semantics of ``-W embed-stylesheet`` and ``-W stylesheet``.
+* Added ``-W stylesheet2`` option to specify a secondary embedded stylesheet.
+* Changed default of ``-W field-limit`` to 14 from 15.
+* Reworked so all the writer's annotations are in DOM's ``{_html}`` member.
+* Reworked so that DOM's ``{attr}`` member is read-only; HTML attributes
+ are all copied to ``{_html}{attr}`` member.
+* Factored out much of the attribute handling into a ``GetAttr`` routine.
+* Fixed output of literals embedded in literals.
+
+Writer '``index``':
+
+* Restructured code for simplification
+* Pass the a writer argument into ``QuoteStart``.
+* Fixed processing of ``-W short-titles``.
+* Added handler for interpreted roles.
+
+Writer '``toc``':
+
+* Simplified code for ``generated``.
+
+Writer '``xref``':
+
+* Simplified code for substitution definitions.
+
+Release 0.3.17
+--------------
+Did not exist.
+
+Release 0.3.16
+--------------
+Updated manifest to add files that will allow the regression to pass
+on machines with differing locales.
+
+Release 0.3.15
+--------------
+Added test files to fix problems when different locales use different
+text for system error messages.
+
+Prest application:
+
+* Fixed problem that caused bare subroutines in writers to be compiled
+ more than once.
+* Removed the path out of the subroutine names created when compiling
+ writer routines.
+* Fixed the ``#line`` directives for writer subroutines so that better
+ error messages/coverage results are obtained.
+
+Made writers more efficient by renaming package subroutines to ``BEGIN``
+so that they will always be called exactly once.
+
+Writer '``html``':
+
+* Incorporated changes in docutils ``html`` writer:
+
+ * No longer change double-quotes to "``"``".
+ * No longer put a newline after a ``<pre>``.
+
+Release 0.3.14
+--------------
+First release that was indexable on CPAN.
Deleted: trunk/prest/ReleaseNotes.txt
|