Re: Docbook 5.x

Список

Период

Сортировка

От	Jürgen Purtz
Тема	Re: Docbook 5.x
Дата	2 июля 2016 г. 13:14:13
Msg-id	57779402.1080306@purtz.de обсуждение исходный текст
Ответ на	Re: Docbook 5.x (Peter Eisentraut)
Список	pgsql-docs

Дерево обсуждения

Docbook 5.x (Jürgen Purtz, 20 апреля 2016 г., 17:30:45 )
Re: Docbook 5.x (Simon Riggs, 20 апреля 2016 г., 21:41:31 )
Re: Docbook 5.x (Jürgen Purtz, 21 апреля 2016 г., 16:34:41 )
Re: Docbook 5.x (Jürgen Purtz, 03 мая 2016 г., 22:19:49 )
Re: Docbook 5.x (Alexander Law, 21 апреля 2016 г., 23:34:50 )
Re: Docbook 5.x (Alvaro Herrera, 03 мая 2016 г., 22:34:51 )
Re: Docbook 5.x ("Joshua D. Drake", 03 мая 2016 г., 22:59:07 )
Re: Docbook 5.x (Tom Lane, 03 мая 2016 г., 23:55:19 )
Re: Docbook 5.x (Tom Lane, 04 мая 2016 г., 00:05:14 )
Re: Docbook 5.x (Oleg Bartunov, 03 мая 2016 г., 23:13:45 )
Re: Docbook 5.x (Peter Eisentraut, 04 мая 2016 г., 03:44:09 )
Re: Docbook 5.x (Alexander Law, 05 мая 2016 г., 07:46:08 )
Re: Docbook 5.x (Peter Eisentraut, 03 июня 2016 г., 22:31:39 )
Re: Docbook 5.x (Alexander Law, 04 июня 2016 г., 17:28:51 )
Re: Docbook 5.x (Peter Eisentraut, 06 июня 2016 г., 15:28:47 )
Re: Docbook 5.x (Alexander Law, 06 июня 2016 г., 20:49:46 )
Re: Docbook 5.x (Peter Eisentraut, 06 июня 2016 г., 22:56:07 )
Re: Docbook 5.x (Peter Eisentraut, 18 августа 2016 г., 20:56:57 )
Re: Docbook 5.x (Alexander Law, 19 августа 2016 г., 16:14:10 )
Re: Docbook 5.x (Peter Eisentraut, 22 августа 2016 г., 21:06:57 )
Re: Docbook 5.x (Alexander Law, 23 августа 2016 г., 17:23:27 )
Re: Docbook 5.x (Peter Eisentraut, 24 августа 2016 г., 18:12:41 )
Re: Docbook 5.x (Alexander Law, 14 сентября 2016 г., 14:18:32 )
Re: Docbook 5.x (Jürgen Purtz, 14 сентября 2016 г., 16:04:00 )
Re: Docbook 5.x (Alexander Law, 14 сентября 2016 г., 16:47:10 )
Re: Docbook 5.x (Alvaro Herrera, 14 сентября 2016 г., 18:31:08 )
Re: Docbook 5.x (Alexander Law, 14 сентября 2016 г., 18:46:27 )
Re: Docbook 5.x (Tom Lane, 14 сентября 2016 г., 18:52:39 )
Re: Docbook 5.x (Alvaro Herrera, 14 сентября 2016 г., 19:41:20 )
Re: Docbook 5.x (Alexander Law, 14 сентября 2016 г., 19:56:39 )
Re: Docbook 5.x (Alexander Law, 04 октября 2016 г., 18:45:13 )
Re: Docbook 5.x (Jürgen Purtz, 19 октября 2016 г., 12:09:42 )
Re: Docbook 5.x (Peter Eisentraut, 08 ноября 2016 г., 16:24:58 )
Re: Docbook 5.x (Tom Lane, 08 ноября 2016 г., 18:02:38 )
Re: Docbook 5.x (Peter Eisentraut, 08 ноября 2016 г., 19:35:03 )
Re: Docbook 5.x (Alexander Law, 09 ноября 2016 г., 13:00:27 )
Re: Docbook 5.x (Alexander Law, 16 ноября 2016 г., 14:30:40 )
Re: Docbook 5.x (Jürgen Purtz, 16 ноября 2016 г., 17:38:02 )
Re: [DOCS] Docbook 5.x (Alexander Law, 28 февраля 2017 г., 14:55:28 )
Re: [DOCS] Docbook 5.x (Jürgen Purtz, 28 февраля 2017 г., 15:50:55 )
Re: [DOCS] Docbook 5.x (Peter Eisentraut, 11 марта 2017 г., 08:06:00 )
Re: [DOCS] Docbook 5.x (Peter Eisentraut, 06 сентября 2017 г., 21:54:47 )
Re: [DOCS] Docbook 5.x (Alexander Lakhin, 08 сентября 2017 г., 18:30:00 )
Re: [DOCS] Docbook 5.x (Thomas Munro, 11 сентября 2017 г., 04:59:40 )
Re: [DOCS] Docbook 5.x (Peter Eisentraut, 15 сентября 2017 г., 20:32:45 )
Re: [DOCS] Docbook 5.x (Jürgen Purtz, 16 сентября 2017 г., 00:54:57 )
Re: [DOCS] Docbook 5.x (Peter Eisentraut, 18 сентября 2017 г., 19:57:02 )
Re: [DOCS] Docbook 5.x (Alexander Lakhin, 18 сентября 2017 г., 20:38:27 )
Re: [DOCS] Docbook 5.x (Peter Eisentraut, 20 сентября 2017 г., 02:05:35 )
Re: [DOCS] Docbook 5.x (Alexander Lakhin, 20 сентября 2017 г., 19:00:00 )
Re: [DOCS] Docbook 5.x (Peter Eisentraut, 27 сентября 2017 г., 21:38:31 )
Re: [DOCS] Docbook 5.x (Alexander Lakhin, 27 сентября 2017 г., 22:11:29 )
Re: [DOCS] Docbook 5.x (Alexander Lakhin, 28 сентября 2017 г., 01:51:28 )
Re: Docbook 5.x (Peter Eisentraut, 05 апреля 2017 г., 08:33:15 )
Re: Docbook 5.x (Jürgen Purtz, 04 мая 2016 г., 17:44:41 )
Re: Docbook 5.x (Tom Lane, 04 мая 2016 г., 17:51:21 )
Re: Docbook 5.x (Jürgen Purtz, 04 мая 2016 г., 18:30:24 )
Re: Docbook 5.x (Jürgen Purtz, 12 мая 2016 г., 22:46:18 )
Re: Docbook 5.x (Alvaro Herrera, 12 мая 2016 г., 23:00:05 )
Re: Docbook 5.x (Alexander Law, 04 мая 2016 г., 18:09:04 )
Re: Docbook 5.x (Alvaro Herrera, 04 мая 2016 г., 18:22:08 )
Re: Docbook 5.x (Alexander Law, 04 мая 2016 г., 18:34:58 )
Re: Docbook 5.x (Jürgen Purtz, 04 мая 2016 г., 19:52:46 )
Re: Docbook 5.x (Alvaro Herrera, 04 мая 2016 г., 20:12:15 )
Re: Docbook 5.x (Jürgen Purtz, 04 мая 2016 г., 21:06:30 )
Re: Docbook 5.x (Alvaro Herrera, 04 мая 2016 г., 21:21:01 )
Re: Docbook 5.x (Alexander Law, 04 мая 2016 г., 21:00:22 )
Re: Docbook 5.x (Peter Eisentraut, 05 мая 2016 г., 04:09:39 )
Re: Docbook 5.x (Alexander Law, 05 мая 2016 г., 07:55:07 )
Re: Docbook 5.x (Jürgen Purtz, 13 мая 2016 г., 10:38:12 )
Re: Docbook 5.x (Peter Eisentraut, 13 мая 2016 г., 21:01:28 )
Re: Docbook 5.x (Alexander Law, 14 мая 2016 г., 09:35:05 )
Re: Docbook 5.x (Jürgen Purtz, 22 мая 2016 г., 22:48:20 )
Re: Docbook 5.x (Peter Eisentraut, 31 мая 2016 г., 20:46:55 )
Re: Docbook 5.x (Jürgen Purtz, 19 июня 2016 г., 23:22:48 )
Re: Docbook 5.x (Alexander Law, 27 июня 2016 г., 16:21:23 )
Re: Docbook 5.x (Jürgen Purtz, 02 июля 2016 г., 13:14:13 )
Re: Docbook 5.x (Alvaro Herrera, 04 мая 2016 г., 18:21:55 )
Re: Docbook 5.x (Tom Lane, 04 мая 2016 г., 18:31:56 )
Re: Docbook 5.x (Jürgen Purtz, 04 мая 2016 г., 21:11:50 )
Re: [DOCS] Docbook 5.x (Alexander Lakhin, 16 ноября 2017 г., 12:00:28 )
Re: [DOCS] Docbook 5.x (Peter Eisentraut, 18 ноября 2017 г., 23:24:38 )
Re: [DOCS] Docbook 5.x (Peter Eisentraut, 23 ноября 2017 г., 20:53:35 )
Re: [DOCS] Docbook 5.x (Alexander Lakhin, 25 ноября 2017 г., 11:50:30 )
Re: [DOCS] Docbook 5.x (Peter Eisentraut, 28 ноября 2017 г., 22:02:14 )
Re: [DOCS] Docbook 5.x (Alexander Lakhin, 28 ноября 2017 г., 22:55:11 )

On 05.05.2016 03:09, Peter Eisentraut wrote:

I think the process should be something like this:

- Apply your XSLT performance patch. The patch should be submitted to the next commit fest.

- Wait a while to make sure everyone is happy with the performance. Keep tweaking if necessary.

- Port all DSSSL customizations to XSLT. Manually evaluate output for quality.

- Switch to XSLT build for official HTML documentation. [milestone 1]

- Convert sources to XML. (There could be substeps here.) [milestone 2]

- Then consider upgrading to DocBook 5. [milestone 3]

During the step from DocBook 4 to DocBook 5 [M3] we will face the problem that there are incompatibilities in the DocBook structure. Our source is affected by:

It's no longer possible to use <option> and <optional> in a recursive fashion.
The content model of <literal>, <function>, <command> and similar elements has changed.

In my opinion the first issue is not acceptable and the second one may need some DocBook redesign as well as manual changes in our source code. The DocBook TC has accepted this concerns and works on a solution. But as they are in the last phase of bringing 5.1 to an official OASIS standard, we probably have to wait (a long time) until 5.2. You can follow the discussion here: https://lists.oasis-open.org/archives/docbook/201606/msg00007.html and in a direct mail from Bob Stayton:

-----
Hi,
I'm investigating this issue. I'm trying to track down the history and reasoning for this change, but have not yet completed that research. It looks like a mistake to me to limit the content model so much when we were consciously trying to maintain backwards compatibility unless there were good reasons not to.

Bob Stayton
Sagehill Enterprises

-----

Jürgen Purtz

Btw: Since 16 June 2016 Norman Welsh is no longer chairman of the TC. Now Bob holds this position, Norman changed to a 'normal' member of the TC.

В списке pgsql-docs по дате отправления:

Предыдущее

От: Bruce Momjian
Дата: 02 июля 2016 г., 12:23:28
Сообщение: Re: Pg_upgrade and collation

Следующее

От: meng-y13@mails.tsinghua.edu.cn
Дата: 05 июля 2016 г., 13:40:00
Сообщение: don't know about where the distribution is

Вход в личный кабинет

Восстановление пароля

Подтверждение аккаунта

Изменение пароля

Re: Docbook 5.x

Предыдущее

Следующее