/
HISTORY.txt
2562 lines (1930 loc) · 93.4 KB
/
HISTORY.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
.. -*- coding: utf-8 -*-
==================
Docutils History
==================
:Author: David Goodger; open to all Docutils developers
:Contact: goodger@python.org
:Date: $Date: 2010-02-05 15:16:25 +0100 (Fre, 05 Feb 2010) $
:Revision: $Revision: 6225 $
:Web site: http://docutils.sourceforge.net/
:Copyright: This document has been placed in the public domain.
.. contents::
Changes Since 0.6
=================
* General:
- (partially) Fix reporting for problems in included files.
* docutils/io.py
- FileInput opens files as text files with universal newline support
(mode "rU", configurable with the new optional argument "mode").
* docutils/utils.py
- Fix [ 2923723 ] let decode_path() tolerate path == None
* docutils/writers/latex2e/__init__.py
- Use `transforms.writer_aux.Admonitions` to "normalize" special
admonitions.
- Use the ``\url`` command for URLs (breaks long URLs instead of
writing into the margin).
- Preserve runs of spaces in `inline literals`__.
- Deprecate ``figure_footnotes`` setting.
- Rename ``use_latex_footnotes`` setting to `docutils_footnotes`__.
- New ``latex_preamble`` setting.
- Use PDF standard fonts (Times/Helvetica/Courier) as default.
- Fix hyperlink targets (labels) for images, figures, and tables.
__ docs/ref/restructuredtext.html#inline-literals
__ docs/user/config.html#docutils-footnotes
* docutils/writers/manpage.py
- Fix: supported attribute (thanks to peter2108).
- Remove trailing blanks in code (keep in sync with mercurial version).
- Titles level 1, that is ``.SH``, always uppercase.
- Apply patch from mg: literal text should be bold in man-pages.
* docutils/nodes.py
- Fix: encoding ``'ascii'`` must be lowercase to prevent problems for
turkish locale.
Release 0.6 (2009-10-11)
========================
* General:
- Docutils is now compatible with Python versions from 2.3 up to 2.6
and convertible to 3.1 code.
+ Node.__nonzero__ returns True instead of 1.
+ use os.walk instead os.path.walk.
+ minimize "types" module where possible.
+ Backwards-compatible changes to remove python2.6 -3 deprecation warnings
+ Text nodes now subclass unicode rather than UserString
(which is gone in python 3.0).
+ 3.0 compatibility module docutils._compat
+ Drop 2.2 compatibility workarounds.
+ Drop extras/optparse.py and extras/textwrap.py
(stdlib modules since 2.3).
- OpenOffice export: ODT writer moved from sandbox to Doctutils core.
- Unix man page export: manpage writer moved from sandbox to Doctutils
core.
- Apply [ 1719345 ] Galician translation
- Apply [ 1905741 ] Polish translation
- Apply [ 1878977 ] make_id(): deaccent characters.
- Apply [ 2029251 ] return nonzero when tests fail.
- Fix [ 1692788 ] allow UTF-8 in style sheets.
- Fix [ 2781629 ] support non-ASCII chars in file names.
- Apply [ 2845002 ] let ``--no-raw`` disable raw *roles* too.
- Fix [ 2831643 ] by renaming DirectiveError.message to DirectiveError.msg
- Fix [ 2821266 ] --strict option works now like --halt=info.
- Fix [ 2788716 ] DirectiveError now correctly reports source and line.
- Fix [ 1627229 ] hyperlink references in substitutions.
- The "newlatex" writer is orphaned.
* reStructuredText:
- Documented Unicode characters allowed as inline markup openers,
closers, and delimiters.
- Allow units for all length specifications.
- Allow percent sign in "scale" argument of "figure" and "image" directives.
- Bugfix: The "figalign" argument of a figure now works as intended
(aligning the figure, not its contents).
- Align images with class "align-[right|center|left]"
(allows setting the alignment of an image in a figure).
* docutils/nodes.py:
- Added ``Element.__contains__`` method, for the in-operator.
* docutils/parsers/rst/states.py:
- Apply [ 1994493 ] Patch to support all kinds of quotes in inline markup.
- Added support for Unicode inline markup delimiters "‐ ‑ ‒ – —" and
" " (non-breaking space), and "¡ ¿" openers.
* docutils/parsers/directives/misc.py:
- Added ``start-line`` and ``end-line`` options to "include"
directive to select a range of lines.
- Hard tabs in literal inclusions are replaced by spaces. This is
configurable via the new ``tab-width`` option of the "include" directive
(a negative tab-width prevents tab expansion).
* docutils/utils.py:
- Add ``get_stylesheet_list`` function.
- Apply [ 2834836 ] print info at halt
* docutils/transforms/universal.py:
- Raise default priority of StripClasses to exclude stripped classes from
the ToC.
* docutils/writers/html4css1/__init__.py:
- ``--stylesheet`` and ``--stylesheet-path`` options support a comma
separated list of stylesheets.
- Address [ 1938891 ] Inline literal text creates "pre" span only when
needed to prevent inter-word line wraps.
- Use `translate` method instead of repeated `replace` calls.
- Fix [ 1757105 ] New ``table-style`` option. Added to standard table
classes to allow CSS styling that does not interfere with other
table-using constructs (field lists, citations, ...).
* docutils/writers/newlatex2e/__init__.py:
- Apply [ 1612821 ] Double quotes in literal text in Italian/German
* docutils/writers/latex2e/__init__.py (see also
`<docs/user/docutils-05-compat.sty.html>`__) :
- Add ``--embed-stylesheet`` option.
- Apply [ 1474017 ] image vertical alignment is reversed.
- Apply [ 2051599 ] multi-page tables in latex writer (from pabigot).
- Change: has_key for dictionaries (not Nodes) to in-operator.
- Merge adjacent citations into one latex cite command.
- Failsave implementation of custom roles. LaTeX compilation now ignores
unknown classes instead of aborting with an error.
- Support custom roles based on standard roles.
- LaTeX packages can be used as ``--stylesheet`` arguments without
restriction. (A style sheet is now referenced with the ``\usepackage``
command, if it ends with ``.sty`` or has no extension.)
- Add ``bp`` to lenghts without unit (prevents LaTex errors).
- Correctly write length unit ``pt`` as ``bp`` in LaTeX.
- Do not convert ``px`` to ``pt`` (``px`` is supported by pdfTeX since
2005-02-04 as a configurable length unit).
- Do not use fontenc, nor the obsolete 'ae' and 'aeguill' packages
if font-encoding is set to ''. LaTeX defaults to OT1 then.
- Set sub- and superscript role argument in text mode not as math.
Use a custom role based on sub-/superscript if you want italic shape.
- Shorter preamble and less dependencies: Load packages and define macros
only if required in the document.
- Use the name prefix ``DU`` for all Docutils specific LaTeX macros.
- New custom environments and commands with optional "classes" argument.
- Simpler LaTeX encoding, e.g. "\%" instead of "{\%}".
- Better conformance to Docutils specifications with ``--use-latex-toc``.
Support for LaTeX generated ToC also with unnumbered sections.
- If 'sectnum_xform' is False, the 'sectnum' directive triggers
section numbering by LaTeX.
- Use default font in admonitions and sidebar.
- Align of image in a figure defaults to 'center'.
- Bugfix: Newlines around targets and references prevent run-together
paragraphs.
- Fix internal hyperlinks.
- Use class defaults for page margins ('typearea' now optional).
- Float placement made configurable, default changed to "here definitely".
- Typeset generic topic as "quote block with title".
- Use template (file and configuration option).
- In the default template, load cmap.sty (fix text extraction in PDF) and
fixltx2e.sty (LaTeX patches, \textsubscript).
- Render doctest blocks as literal blocks (fixes [ 1586058 ]).
- Use `translate` instead of repeated `replace` calls for text encoding.
- Hyperlinked footnotes and support for symbol footnotes and
``--footnote-references=brackets`` with ``--use-latex-footnotes``.
- Complete pairs of binary options
(``--figure-footnotes, --figure-citations, --link-stylesheet``,
``--use-docutils-toc, --use-docutils-docinfo, --topic-abstract``)
- New defaults:
- font-encoding: "T1" (formerly implicitely set by 'ae').
- use-latex-toc: true (ToC with page numbers).
- use-latex-footnotes: true (no mixup with figures).
* docutils/writers/manpage.py
- Do not print version at document end, this is done by the viewer.
- Do not print date at document end, this is done by the viewer.
- Fix storage of docinfo fields for none standard fields.
* docutils/tools/rst2man.py
Release 0.5 (2008-06-25)
========================
* docutils/languages/he.py: Added to project: Hebrew mappings by
Meir Kriheli.
* docutils/parsers/rst/languages/he.py: Added to project: Hebrew
mappings by Meir Kriheli.
* docutils/frontend.py:
- Configuration files are now assumed and required to be
UTF-8-encoded.
- Paths of applied configuration files are now recorded in the
runtime setting ``_config_files`` (accessible via
``--dump-settings``).
- Added ``--strip-elements-with-class`` and ``--strip-class``
options (``strip_elements_with_classes`` and ``strip_classes``
settings).
* docutils/io.py:
- Added code to determine the input encoding from data: encoding
declarations or the presence of byte order marks (UTF-8 & UTF-16).
- Added support for IronPython 1.0.
* docutils/nodes.py:
- Added ``document.__getstate__`` method, for pickling.
* docutils/parsers/rst/states.py:
- Allow ``+`` and ``:`` in reference names.
- Unquoted targets beginning with an underscore (``.. __target:
URI``) are no longer accepted.
- Added support for multiple attributions in a physical block quote
(indented text block), dividing it into multiple logical block
quotes.
- Added support for unicode bullets in bullet lists: "•", "‣", and
"⁃".
- Added support for new object-oriented directive interface,
retaining compatibility to the old functional interface.
- Added support for throwing ``DirectiveError``'s from within
directive code.
* docutils/parsers/rst/__init__.py:
- Added ``Directive`` base class.
- Added ``DirectiveError`` base class.
- Fixed ``file_insertion_enabled`` & ``raw_enabled`` setting
definitions.
* docutils/parsers/directives/:
- Refactored all reStructuredText directives to use the new
object-oriented directive interface. Errors are now (mostly)
thrown using the new ``DirectiveError`` class.
* docutils/parsers/directives/misc.py:
- Added ``start-after`` and ``end-before`` options to ``include``
directive; thanks to Stefan Rank.
* docutils/transforms/universal.py:
- Added ``StripClassesAndElements`` transform to remove from the
document tree all elements with classes in
``settings.strip_elements_with_classes`` and all "classes"
attribute values in ``self.document.settings.strip_classes``.
* docutils/transforms/writer_aux.py:
- Added ``Admonitions`` transform to transform specific admonitions
(like ``note``, ``warning``, etc.) into generic admonitions with a
localized title.
* docutils/writers/html4css1/__init__.py:
- Moved template functionality from the PEP/HTML writer here.
- Expanded the fragments available in the ``parts`` attribute.
- Moved ``id`` attributes from titles to surrounding ``div``
elements.
- Dropped all ``name`` attributes of ``a`` elements (``id`` is
universally supported now).
- ``template.txt`` is now opened in text mode instead of binary mode
(to ensure Windows compatibility).
- ``a`` elements now have an "internal" or "external" class,
depending on reference type.
* docutils/writers/html4css1/template.txt: Added to project.
* docutils/writers/pep_html/:
- Moved template functionality to the HTML writer.
* docutils/writers/s5_html/__init__.py:
- Added ``view_mode`` & ``hidden_controls`` settings
(``--view-mode`` & ``--hidden-controls/--visible-controls``
options).
* docutils/writers/latex2e/__init__.py:
- Add ``--literal-block-env``
- Fix: escaping ``%`` in href urls.
- Move usepackage hyperref after stylesheet inclusion.
- Fix: scrartcl does not have chapter but scrreprt.
- Add newline after ``\end{verbatim}``.
- Merge smaller differences from latex2e_adaptive_preamble.
- Add ``use-part-section``.
- Put leavevmode before longtable to avoid having it moved before sub/pargraph.
- Using leavemode option_list no longer needs to check if parent
is a definition list.
- Append ``\leavemode`` to definition list terms.
- No longer write visit\_/depart_definition_list_item comments to
output.
- Table column width with 3 decimal places.
- Add table stubs support (boldfont).
- Add assemble_parts to writer.
- Add simply support for nested tables.
- Fix verbatim in tables if use-verbatim-when-possible.
- Use section commands down to subparagraph.
- Put ensuremath around some latin1 chars.
- Set ``usepackage[utf8x]{inputenc}`` for utf-8.
- New option ``--use-bibtex=style,db1,db2``.
- New option ``--reference-label`` to allow usage of LaTeX ref for
labels in section references.
- Add a label after every section to support sectionnumbers as reference
labels.
- Fix: bug# 1605376 rst2latex: bad options group list
- Remove inactive code for use_optionlist_for_option_list.
- Remove latex comments from option_list output.
- Fix: bug# 1612270 double qoutes in italian literal.
- Fix: output ``hypertarget{ node.get(refid) }{}`` from visit_target.
- Add option --use-latex-abstract.
- Image width unit ``px`` is translated to ``pt``.
- Add image height support.
- Fix: image width ``70%`` is converted ``0.700\linewidth``.
bug #1457388
- Fix: Do not escape underscores in citation reference labels if
use-latex-citations is set.
- Use centering instead of center for figure contents, to avoid vertical
space.
- Recognize table class: borderless, nolines, booktabs, standard.
- Fix: Renaming contents section does not work with latex writer; SF
bug #1487405.
- Applied patch for custom roles with classes from Edward Loper.
- Fixed bug that caused crashes with more than 256 lists.
* docutils/writers/pep_html/__init__.py:
- Changed to support new python.org website structure and
pep2pyramid.py.
* docs/howto/security.txt: "Deploying Docutils Securely", added to
project.
* tools/buildhtml.py:
-- Added ``ignore`` setting to exclude a list of shell patterns
(default: ``.svn:CVS``).
* tools/editors/emacs/rst.el:
- Changed license to "GPL".
- Added ``rst-straighten-decorations`` function.
- The ``compile`` module is now always loaded.
- Added ``rst-toggle-line-block`` function.
- Headings consisting only of non-ASCII characters are now
recognized by ``rst-toc`` and ``rst-adjust``.
- Added font-lock support for multi-line comments where the first
comment line is empty.
- Added ``(require 'font-lock)``.
* setup.py:
- Provide descriptive error message if distutils is missing.
Release 0.4 (2006-01-09)
========================
* General:
- Updated the project policies for trunk/branch development &
version numbering.
* docutils/__init__.py:
- Added ``__version_details__`` attribute to describe code source
(repository/snapshot/release).
- Replaced ``default_transforms`` attribute of TransformSpec with
``get_transforms()`` method.
* docutils/core.py:
- Added ``publish_doctree`` and ``publish_from_doctree`` convenience
functions, for document tree extraction and reprocessing.
* docutils/io.py:
- Added ``DocTreeInput`` class, for reprocessing existing documents.
- Added support for non-Unicode (e.g. binary) writer output.
* docutils/nodes.py:
- Re-introduced ``Targetable.indirect_reference_name``, for
MoinMoin/reST compatibility (removed in r3124/r3129).
- Added ``serial_escape`` function; escapes string values that are
elements of a list, for serialization. Modified Docutils-XML
writing (``Element._dom_node``) and pseudo-XML writing
(``Element.starttag``) to use ``serial_escape``.
- Added ``Node.deepcopy()`` method.
- Removed the internal lists ``document.substitution_refs``,
``document.anonymous_refs``, and ``document.anonymous_targets``.
- Added a "container" element.
- Fixed bug where values of list-valued attributes of elements
originating from custom interpreted text roles (i.e., with custom
classes) were being shared between element instances. Reported by
Shmuel Zeigerman.
* docutils/statemachine.py:
- Added trailing whitespace stripping to ``string2lines()``.
- Added ``StringList.pad_double_width()`` & ``.replace()`` for East
Asian double-width character support.
* docutils/utils.py:
- Added ``east_asian_column_width()`` for double-width character
support.
* docutils/languages/ja.py: Added to project: Japanese mappings by
Hisashi Morita.
* docutils/languages/zh_cn.py: Added to project: Simplified Chinese
mappings by Panjunyong.
* docutils/parsers/null.py: Added to project; a do-nothing parser.
* docutils/parsers/rst/__init__.py:
- Added validator to tab_width setting, with test. Closes SF bug
#1212515, report from Wu Wei.
* docutils/parsers/rst/states.py:
- Fixed bug with escaped colons indicating a literal block.
- Fixed bug with enumerated lists (SF#1254145).
- Backslash-escaped colons inside of field names are now allowed.
- Targets (implicit and explicit), anonymous hyperlink references
and auto-numbered footnote references inside of substitution
definitions are now disallowed.
- Fixed bug: list items with blank first lines.
- Fixed bug: block quote attributions with indented second lines.
- Added East Asian double-width character support (Python 2.4 only).
* docutils/parsers/rst/tableparser.py:
- Added East Asian double-width character support (Python 2.4 only).
* docutils/parsers/rst/directives/body.py:
- Added the "container" directive.
* docutils/parsers/rst/directives/misc.py:
- Added the "default-role", "title", and "date" directives.
- Added standard data file syntax to the "include" directive.
- Added support for "class" directive content.
* docutils/parsers/rst/directives/images.py:
- Added ``indirect_reference_name`` support for images with a target
option.
- Added support for image width and height units.
- Fixed bug with image "target" options.
* docutils/parsers/rst/directives/references.py:
- Added "class" attribute to "target-notes" directive, for
footnote_reference classes.
* docutils/parsers/rst/include/: Directory added to project; contains
standard data files for the "include" directive. Initial contents:
character entity substitution definition sets, and a set of
definitions for S5/HTML presentations.
* docutils/parsers/rst/languages/ja.py: Added to project: Japanese
mappings by David Goodger.
* docutils/parsers/rst/languages/zh_cn.py: Added to project:
Simplified Chinese mappings by Panjunyong.
* docutils/readers/__init__.py:
- Added universal.Decorations and universal.ExposeInternals
transforms as default transforms for all readers.
- Added ``ReReader`` base class for readers that reread an existing
document tree.
* docutils/readers/doctree.py: Added to project; a reader for existing
document trees.
* docutils/transforms/frontmatter.py:
- Fixed the DocInfo transform to handle SVN-style expansion of the
"Date" keyword.
- In ``DocInfo.extract_authors``, treat the contents of "authors"
fields uniformly.
* docutils/transforms/misc.py:
- Added misc.Transitions transform, extracted from
universal.FinalChecks.
* docutils/transforms/references.py:
- Added references.DanglingReferences transform, extracted from
universal.FinalChecks.
- Fixed bug with doubly-indirect substitutions.
- Added footnote_reference classes attribute to "TargetNotes".
- Fixed bug with circular substitution definitions that put Docutils
into an infinite loop.
* docutils/transforms/universal.py:
- Added universal.ExposeInternals transform, extracted from
universal.FinalChecks.
- Removed universal.FinalChecks transform (logic has been moved to
several new transforms).
- Fixed bug with the "expose_internals" setting and Text nodes
(exposed by the "rawsource" internal attribute).
- Added the universal.StripComments transform, implementation of the
"strip_comments" setting.
* docutils/transforms/writer_aux.py: Added to project; auxiliary
transforms for writers.
- Added ``Compound`` transform, which flattens compound paragraphs.
* docutils/writers/: Several writer modules (html4css1.py) were
converted into packages. Support modules and data files have been
moved into the packages. The stylesheets for the HTML writers are
now installed along with the code, the code knows where to find
them, and the default is to use them (actually, to embed them).
Some adjustments to configuration files may be necessary. The
easiest way to obtain the new default behavior is to remove all
settings whose name includes "stylesheet".
* docutils/writers/__init__.py:
- Added universal.Messages and universal.FilterMessages transforms
as default transforms for all writers.
- Added ``UnfilteredWriter`` base class for writers that pass the
document tree on unchanged.
* docutils/writers/docutils_xml.py:
- Made ``xmlcharrefreplace`` the default output encoding error
handler.
* docutils/writers/html4css1/:
- Added support for image width and height units.
- Made ``xmlcharrefreplace`` the default output encoding error
handler.
- Made ``--embed-stylesheet`` the default rather than
``--link-stylesheet``.
- Moved "id" attribute from container (section etc.) to title's <a>
tag, to be on the same tag as "name".
(!!! To be reverted in Docutils 0.5.)
- Added vertical space between fields of field lists.
- Added ``--compact-field-lists`` option to remove vertical space in
simple field lists.
- Made cloaking of email addresses with ``--cloak-email-addresses``
less obtrusive.
- Fixed support for centered images.
- Added support for class="compact" & class="open" lists.
* docutils/writers/latex2e/:
- Underscores in citekeys are no longer escaped.
* docutils/writers/newlatex2e/unicode_map.py: Added to project;
mapping of Unicode characters to LaTeX equivalents.
* docutils/writers/s5_html/: Package added to project; writer for
S5/HTML slide shows.
* docs/dev/distributing.txt: Added to project; guide for distributors
(package maintainers).
* docs/dev/hacking.txt: Added to project; guide for developers.
* docs/ref/doctree.txt:
- Updated for plural attributes "classes", "ids", "names",
"dupnames".
- Added the "container" element.
* docs/ref/docutils.dtd:
- Updated for plural attributes "classes", "ids", "names",
"dupnames".
* docs/user/emacs.txt: Added to project; a document about Emacs
support for reStructuredText and Docutils.
* docs/user/links.txt: Added to project; lists of Docutils-related
links.
* docs/user/mailing-lists.txt: Added to project; information about
Docutils-related mailing lists and how to access them.
* docs/user/slide-shows.txt: Added to project; example of and docs for
the S5/HTML writer (``rst2s5.py`` front end).
* docs/ref/rst/definitions.txt: "reStructuredText Standard Definition
Files", added to project.
* test/coverage.sh: Added to project; test coverage script.
* test/DocutilsTestSupport.py:
- Added support for specifying runtime settings at the suite level.
* test/test_functional.py:
- Added the ``clear_output_directory`` function.
- Added support for ``_test_more`` functions in functional test
config files.
* tools/rst2s5.py: Added to project; front end for the S5/HTML writer.
* tools/rstpep2html.py: Renamed from pep.py.
* tools/dev/create_unimap.py: Added to project; script to create the
docutils/writers/unimap_latex.py mapping file.
* tools/dev/profile_docutils.py: Added to project; profiler script.
* tools/dev/unicode2rstsubs.py: Moved from tools/unicode2rstsubs.py.
* tools/editors/emacs/restructuredtext.el,
tools/editors/emacs/rst-html.el, tools/editors/emacs/rst-mode.el:
Removed from project; the functionality is now contained in rst.el.
* tools/editors/emacs/rst.el: Added to project. Added many features
and fixed many bugs. See docs/user/emacs.txt for details.
* tools/stylesheets: Removed from project. Stylesheets have been
renamed and moved into writer packages.
Release 0.3.9 (2005-05-26)
==========================
* General:
- Eliminated and replaced all uses of the old string attributes
``id``, ``name``, ``dupname`` and ``class`` with references to the
new list attributes ``ids``, ``names``, ``dupnames`` and
``classes`` throughout the whole source tree.
* docutils/core.py:
- Enabled ``--dump-*`` options when ``--traceback`` specified,
allowing for easier debugging.
- In ``Publisher.publish()``, expanded the generic top-level
exception catching.
* docutils/examples.py:
- Added ``internals`` function for exploration.
* docutils/io.py:
- Fixed ``Input.decode`` method to apply heuristics only if no
encoding is explicitly given, and to provide better reporting of
decoding errors.
- The ``Input.decode`` method now removes byte order marks (BOMs)
from input streams.
* docutils/nodes.py:
- ``image`` element class changed to subclass of Element, not
TextElement (it's an empty element, and cannot contain text).
- Added ``attr_defaults`` dictionary for default attribute values.
- Added empty list as default value for the following attributes:
``ids``, ``names``, ``dupnames``, ``classes``, and ``backrefs``.
- Added ``document.decoration`` attribute,
``document.get_decoration`` method, and ``decoration.get_header``
& ``.get_footer`` methods.
- Added ``Element.update_basic_atts()`` and ``Element.substitute()``
methods.
* docutils/utils.py:
- Removed ``docutils.utils.Reporter.categories``,
``docutils.utils.ConditionSet``, and all references to them, to
simplify error reporting.
* docutils/languages/nl.py: Added to project; Dutch mappings by
Martijn Pieters.
* docutils/parsers/rst/__init__.py:
- Added settings: ``file_insertion_enabled`` & ``raw_enabled``.
* docutils/parsers/rst/states.py:
- Added check for escaped at-mark to prevent email address recognition.
- Fixed option lists to allow spaces inside ``<angle-bracketed option
arguments>``.
- Allowed whitespace in paths and URLs.
- Added auto-enumerated list items.
- Fixed bug that assumed ``.. _`` and ``.. |`` were invariably
followed by text.
- Added support for table stub columns.
* docutils/parsers/rst/directives/__init__.py:
- Allowed whitespace in paths (``path`` function).
- Added ``uri`` directive option conversion function.
* docutils/parsers/rst/directives/body.py:
- Fixed illegal context bug with "topic" directive (allowed within
sidebars; not within body elements).
* docutils/parsers/rst/directives/images.py:
- Allowed whitespace (stripped) in "image" & "figure" directive URLs.
- Added support for the ``file_insertion_enabled`` setting in the
"figure" directive (disables "figwidth" option).
- "image" directive: added checks for valid values of "align" option,
depending on context. "figure" directive: added specialized
"align" option and attribute on "figure" element.
- Made ":figwidth: image" option of "figure" directive work again.
- Fixed bug with reference names containing uppercase letters
(e.g. ``Name_``) in "target" option of "image" directive.
* docutils/parsers/rst/directives/misc.py:
- Fixed "include" and "raw" directives to catch text decoding
errors.
- Allowed whitespace in "include" & "raw" directive paths.
- Added support for ``file_insertion_enabled`` & ``raw_enabled``
settings in "include" & "raw" directives.
* docutils/parsers/rst/directives/parts.py:
- Added "header" & "footer" directives.
- Fixed illegal context bug with "contents" directive (topics
allowed within sidebars; not within body elements).
* docutils/parsers/rst/directives/tables.py:
- Added "list-table" directive.
- Caught empty CSV table bug.
- Added support for the ``file_insertion_enabled`` setting in the
"csv-table" directive.
- Added ``stub-columns`` option to "csv-table" and "list-table"
directives.
* docutils/parsers/rst/languages/nl.py: Added to project; Dutch
mappings by Martijn Pieters.
* docutils/readers/standalone.py:
- Added ``--section-subtitles`` and ``--no-section-subtitles``
options to activate or deactivate the SectSubTitle transform.
* docutils/transforms/frontmatter.py:
- Added SectSubTitle transform to promote titles of lone
subsections to subtitles.
* docutils/transforms/references.py:
- Fixed mislocated internal targets bug, by propagating internal
targets to the next node, making use of the newly added support
for multiple names and IDs.
- Fixed duplicate footnote label bug.
- Replaced ``ChainedTargets`` with more generic ``PropagateTargets``
transform.
* docutils/writers/html4css1.py:
- Fixed unencoded stylesheet reference bug (characters like "&" in
stylesheet references).
- ``target`` nodes now appear as ``span`` tags (instead of ``a``
tags).
- Added support for multiple IDs per node by creating empty ``span``
tags.
- Added the ``field_name_limit`` & ``option_limit`` settings &
support.
- Added support for table stub columns.
- Added support for the ``align`` attribute on ``figure`` elements.
- Added the ``cloak_email_addresses`` setting & support.
- Added ``html_prolog``, ``html_head``, ``html_body``,
``html_title``, & ``html_subtitle`` to parts dictionary exposed by
``docutils.core.publish_parts``.
- Added support for section subtitles.
* docutils/writers/latex2e.py:
- Fixed tables starting with more than one multirow cell.
- Improved --use-latex-docinfo so that organization/contact/address
fields are lumped with the last author field and appear on the
titlepage.
- Made sure the titlepage is always shown with --use-latex-docinfo,
even if the document has no title.
- Made sure that latex doesn't fill in today's date if no date field
was given.
- Added support for section subtitles.
* docutils/writers/newlatex2e.py: Added to project; a new LaTeX writer
(under development).
* docutils/writers/null.py: Added to project; a do-nothing Writer.
* docs/api/publisher.txt:
- Added "``publish_parts`` Details" section.
* docutils/dev/repository.txt: Added to project; information about the
Docutils Subversion repository.
* docs/ref/docutils.dtd:
- Added a ``stub`` attribute to the ``colspec`` element via the
``tbl.colspec.att`` parameter entity.
- Allowed topic elements within sidebars
- Added an ``align`` attribute to the ``figure`` element.
* tools/rst2newlatex.py: Added to project; front end for the new LaTeX
writer.
Release 0.3.7 (2004-12-24)
==========================
* docutils/frontend.py:
- Added options: --input-encoding-error-handler,
--record-dependencies, --leave-footnote-reference-space,
--strict-visitor.
- Added command-line and config file support for "overrides" setting
parameter.
* docutils/io.py:
- Added support for input encoding error handler.
* docutils/nodes.py:
- Added dispatch_visit and dispatch_departure methods to
NodeVisitor; useful as a hook for Visitors.
- Changed structure of ``line_block``; added ``line``.
- Added ``compound`` node class.
- Added a mechanism for Visitors to transitionally ignore new node
classes.
* docutils/utils.py:
- Moved ``escape2null`` and ``unescape`` functions from
docutils/parsers/rst/states.py.
* docutils/parsers/rst/roles.py:
- Added "raw" role.
- Changed role function API: the "text" parameter now takes
null-escaped interpreted text content.
* docutils/parsers/rst/states.py:
- Fixed bug where a "role" directive in a nested parse would crash
the parser; the state machine's "language" attribute was not being
copied over.
- Added support for line block syntax.
- Fixed directive parsing bug: argument-less directives didn't
notice that arguments were present.
- Removed error checking for transitions.
- Added support for multiple classifiers in definition list items.
- Moved ``escape2null`` and ``unescape`` functions to docutils/utils.py.
- Changed role function API: the "text" parameter now takes
null-escaped interpreted text content.
- Empty sections and documents are allowed now.
* docutils/parsers/rst/directives/__init__.py:
- Added ``encoding`` directive option conversion function.
- Allow multiple class names in class_option conversion function.
* docutils/parsers/rst/directives/body.py:
- Converted the line-block directive to use the new structure.
- Extracted the old line-block functionality to the ``block``
function (still used).
- Added ``compound`` directive (thanks to Lea Wiemann).
* docutils/parsers/rst/directives/misc.py:
- Added "encoding" option to "include" and "raw" directives.
- Added "trim", "ltrim", and "rtrim" options to "unicode" directive.
- Allow multiple class names in the "class" directive.
* docutils/parsers/rst/directives/parts.py:
- Directive "sectnum" now accepts "prefix", "suffix", and "start"
options. Thanks to Lele Gaifax.
* docutils/parsers/rst/directives/tables.py:
- Added "encoding" directive to "csv-table" directive.
- Added workaround for lack of Unicode support in csv.py, for
non-ASCII CSV input.
* docutils/transforms/misc.py:
- Fixed bug when multiple "class" directives are applied to a single
element.
- Enabled multiple format names for "raw" directive.
* docutils/transforms/references.py:
- Added support for trimming whitespace from beside substitution
references.
* docutils/transforms/universal.py:
- FinalChecks now checks for illegal transitions and moves
transitions between sections.
* docutils/writers/html4css1.py:
- HTMLTranslator.encode now converts U+00A0 to " ".
- "stylesheet" and "stylesheet_path" settings are now mutually
exclusive.
- Added support for the new line_block/line structure.
- --footnote-references now overrides
--trim-footnote-reference-space, if applicable.
- Added support for ``compound`` elements.
- Enabled multiple format names for "raw" directive.
- ``<p>`` tags of a paragraph which is the only visible child of the
document node are no longer stripped.
- Moved paragraph-compacting logic (for stripping ``<p>`` tags) to
new method ``should_be_compact_paragraph()``.
- Added class="docutils" to ``dl``, ``hr``, ``table`` and ``tt``
elements.
- "raw" elements are now surrounded by ``span`` or ``div`` tags in
the output if they have their ``class`` attribute set.
- The whole document is now surrounded by a ``<div
class="document">`` element.
- Body-level images are now wrapped by their own ``<div>`` elements,
with image classes copied to the wrapper, and for images which
have the ``:align:`` option set, the surrounding ``<div>`` now
receives a class attribute (like ``class="align-left"``).
* docutils/writers/latex2e.py:
- no newline after depart_term.
- Added translations for some Unicode quotes.
- Added option "font-encoding", made package AE the default.
- "stylesheet" and "stylesheet_path" settings are now mutually
exclusive.
- --footnote-references now overrides
--trim-footnote-reference-space, if applicable.
- The footnote label style now matches the footnote reference style
("brackets" or "superscript").
- Added support for ``compound`` elements.
- Enabled multiple format names for "raw" directive.
* docs/ref/docutils.dtd:
- Changed structure of the ``line_block`` element; added ``line``.
- Added ``compound`` element.
- Added "ltrim" and "rtrim" attributes to
``substitution_definition`` element.
- Enabled multiple format names for ``raw`` element.
- Enabled multiple classifiers in ``definition_list_item`` elements.
* docs/ref/rst/directives.txt