Re: Doc fixes and improvements

Поиск
Список
Период
Сортировка
От Thom Brown
Тема Re: Doc fixes and improvements
Дата
Msg-id AANLkTim-c697aHdEqfNgCBqwoqFoff4Eit+MMtqBux6S@mail.gmail.com
обсуждение исходный текст
Ответ на Re: Doc fixes and improvements  (Tom Lane <tgl@sss.pgh.pa.us>)
Ответы Re: Doc fixes and improvements  (Thom Brown <thom@linux.com>)
Список pgsql-docs
On 29 August 2010 22:36, Tom Lane <tgl@sss.pgh.pa.us> wrote:
> Thom Brown <thom@linux.com> writes:
>> On 29 August 2010 22:21, Tom Lane <tgl@sss.pgh.pa.us> wrote:
>>> What your changes seem to
>>> accomplish is to take the <simplelist> and <informaltable> constructs
>>> outside any <para>, but what is the point of that?
>
>> Well, those can be in their own <para> container too, although I don't
>> think that's an issue.
>
>> But I shalln't pursue it further if you think there's really no issue.
>
> Well, I don't know --- I'm no SGML expert, and I'm not sure whether
> there's a preferred style for that.  But I see in a quick grep that
> every occurrence of <simplelist> in our docs, and all but a few
> occurrences of <informaltable>, are within paras with some surrounding
> text, in precisely the same style as here.  So if this needs to be
> changed then it needs to be changed in a lot of places.  I'm disinclined
> to mess with it unless there's a pretty concrete reason to do so.

Any opinion on the first patch I provided at the beginning of this thread?

--
Thom Brown
Twitter: @darkixion
IRC (freenode): dark_ixion
Registered Linux user: #516935

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

Предыдущее
От: Tom Lane
Дата:
Сообщение: Re: Doc fixes and improvements
Следующее
От: Alvaro Herrera
Дата:
Сообщение: Re: [pgsql-www] Example indenting