We need a review of the "string output" interface and a consensus
on the "clean" end-state before starting with the implementation.

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

The new generic part "errors" returned by default
contains the `output_encoding_error_handler` setting,
which may make-or-break encoding ``parts['whole']``.

Allows use of `core.publish_parts()` to get the document as `str`,
post-process it and encode with user configurated encoding and
encoding-error handler.

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

The return value of `io.FileOutput` (and hence of `core.publish_cmdline()`
and `core.publish_file()`) is a `str` instance (except for
binary output document formats) and has always been under Python 3.

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

Reported by Adam Turner.

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

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

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

Use Python 3 terminology: "Unicode string" -> `str` instance.

Document "string I/O" (input/output using `str` or `bytes` instances).

Document input encoding auto-detection.

Specify the behaviour and the "explicit encoding declaration".

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

transforms.txt:
  Update "added by" in "Transforms Listed in Priority Order".

io.py:
  reword docstrings and assertion messages,
  use PEP 257 "Docstring Conventions".

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

API documentation:

- Spell out ampersand (&) as "and".
- Finish description of part "pepnum".
- Add links to LaTeX templates.
- Remove trailing whitespace.

Docstrings:

- Clarify source and output data type for functions using
  "string I/O" (with "string" in the general sense of "`str` or `bytes`").
- Recommend using publish_parts() to get Docutils output as `str`.
- Add "()" to functions so that pydoc HTML rendering generates auto-links.
- Add links to the HTML documentation.

Tests:

- Add test for input/output data types of publish_string().

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

Document future changes regarding front-end tools.

Clarify/update planned changes to the input-encoding handling.

Various smaller fixes. Add links.

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