Re: Change pg_attribute textual link to an actual link

Поиск
Список
Период
Сортировка
От Daniel Gustafsson
Тема Re: Change pg_attribute textual link to an actual link
Дата
Msg-id 5ABDB96A-B369-4954-AAE0-1354CBBB305F@yesql.se
обсуждение исходный текст
Ответ на Re: Change pg_attribute textual link to an actual link  (Tom Lane <tgl@sss.pgh.pa.us>)
Ответы Re: Change pg_attribute textual link to an actual link  (Michael Paquier <michael@paquier.xyz>)
Список pgsql-docs
> On 22 Oct 2018, at 01:27, Tom Lane <tgl@sss.pgh.pa.us> wrote:
>
> Daniel Gustafsson <daniel@yesql.se> writes:
>> In the System catalog/pg_attrdef documentation, there is a reference to
>> pg_attribute with the text "see below".  That makes sense in the PDF version
>> (and similar renderings), but in the web version it seems a bit odd as
>> pg_attribute is on the next page, not below.
>
>> The attached patch changes it to an actual link instead, but simply removing
>> the "see below" bit is another approach which isn't out of line with other
>> parts of the documentation (I opted for link since I personally prefer that).
>
> I agree with your change, but I wonder if the sentence after this one
> doesn't need some work too.  It seems to predate ALTER COLUMN SET DEFAULT.
> We could add a mention of that, or just stop trying to describe the
> preconditions, and say something like "only columns for which a default
> value has been explicitly set will have an entry here”.

I think your latter suggestion pretty much covers all we need, so updated the
patch with that too.

cheers ./daniel


Вложения

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

Предыдущее
От: PG Doc comments form
Дата:
Сообщение: INSERT INTO RETURNING SYNTAX ERROR
Следующее
От: Liudmila Mantrova
Дата:
Сообщение: Re: Proposed HTML Documentation Styles